@shoplix-ai/block-kit 4.6.0 → 5.16.0

package/README.md

@@ -9,14 +9,17 @@ written against this package and nothing else from the runtime. It holds:
   screen in hand, the Shop's tokens and resolved theme style,
   the buyer's language and text direction with the Shop's default language as
   fallback, `navigate` (the document's action, and the implicit taps: a
-  product, a collection, search, the account), `cart` (how many items the
+  product, a collection, search, the account, and on a host that knows them an
+  order, its tracking, the page Shopify hosts for it and the Address Sheet on
+  one saved address), `cart` (how many items the
   cart holds for a badge, and whether a change is on its way so every block
   goes quiet together; never the cart itself, which a cart Binding resolves),
   `account` (whether a shopper is signed in, the name to greet them by and its
   own pending flag; never the Account Session), and a capability object holding
   only the capabilities the Block Type declared. A Block Type may also declare
   `rows` beside `render` and hand its items to the host instead of drawing them
-  itself.
+  itself; a block of the shopper's own data names the item its rows draw, an
+  order or a line of one.
 - **The registry.** `createBlockRegistry()` keyed by Block Type, one owner per
   type. A second owner is refused; the same owner may register again. Packages
   outside the app register through it. `defineBlock()` is the typed authoring
@@ -34,7 +37,8 @@ written against this package and nothing else from the runtime. It holds:
   notification decision as one host state: whether the invitation is still
   offered, the tap that opens the phone's prompt and the tap that hides it
   until the next completed checkout. Then the nine of the shopper's own
-  account: `signIn`, `signOut`, `updateProfile` (the names, the email marketing
+  account: `signIn` (with the email the shopper typed, where a block has one,
+  as the hint Shopify's hosted step opens with), `signOut`, `updateProfile` (the names, the email marketing
   choice and the Profile Fields), `addAddress`, `updateAddress`,
   `deleteAddress`, `setDefaultAddress` (each address by its id, the fields the
   Address Sheet sends), `buyAgain` (an order's own lines back into the cart)
@@ -46,7 +50,10 @@ written against this package and nothing else from the runtime. It holds:
   stock is clamped by Shopify and not refused, and the host names what is
   left; a shopper who holds no Account Session gets the refusal too, so a
   block never has to ask whether a capability is reachable before it calls
-  one. `isCapabilityRefusal` tells a refusal apart from any other rejection.
+  one. `signOut` asks the shopper first, in the host's Log-out Sheet, which no
+  block can skip: it resolves once they chose to log out and the sign-out
+  landed, and rejects with the `refused` outcome when they stay signed in.
+  `isCapabilityRefusal` tells a refusal apart from any other rejection.
   Nothing repaints before Shopify's answer, and the block decides how to show
   a refusal.
 - **The authoring shape of a Code Block.** `defineSettings()` and
@@ -73,13 +80,37 @@ written against this package and nothing else from the runtime. It holds:
   `moneyAmount` and `discountPercent`, the money presentation below, and
   `productCardColors`, `collectionTileColors`, `heroBannerColors` beside
   `heroBannerRadius`, `promoBannerColors` beside `promoBannerRadius`,
-  `sectionHeaderColors`, `featureStripColors`, `storeHeaderColors`,
+  `sectionHeaderColors`, `featureStripColors`, `storeHeaderColors` (its
+  `drawer_group` part paints the card an open menu parent stands on) beside
+  `storeMenuMetrics` and `STORE_MENU_DIM`,
   `brandRailColors`, `buyBoxColors`, `announcementBarColors`, `shippingProgressColors`, `productGalleryColors`,
   `productSummaryColors`, `productSpecsColors`, `reviewsSlotColors`,
   `cartLinesColors`, `cartEmptyColors`, `cartDiscountCodeColors`,
-  `cartSummaryColors` and `checkoutButtonColors`, the colour tables the
+  `cartSummaryColors`, `checkoutButtonColors`, `signInColors`,
+  `profileHeaderColors` and `accountLinksColors`, the colour tables the
   promoted blocks read on the phone and on the web alike: a theme role per part
-  of the block, with a component token at `<block>.<part>` over it.
+  of the block, with a component token at `<block>.<part>` over it. The
+  sign-in block is retired, so `signInColors` is deprecated and stays until the
+  next major; the profile header's table carries the title, the subtitle and
+  the button it draws while nobody is signed in.
+  The three sections of the product page read the specs' table:
+  `productSpecsColors` takes the surface a merchant chose for one of them over
+  its own, `productSectionTitle` writes a section's title, the merchant's or
+  the catalog's (`PRODUCT_SECTION_TITLES`), `productSpecRows` lists the
+  facts, the merchant's rows or the vendor and the type, and `shippingRowsOf`
+  the shipping rows the buyer can read. The plain look of the product page
+  reads `contentDirection` (a product's own words laid out the way they were
+  written), `descriptionParts` and `shownDescriptionParts` (the merchant's
+  description markup as paragraphs, lists and tables, with nothing of the
+  markup kept), `descriptionFacts` (the facts of those tables, which
+  `productSpecRows` leads with where a block asks), `chosenPrice` (the chosen
+  variant's price, never the cheapest's), `savingText` (the saving the
+  summary says, as an amount, a percent or nothing), `descriptionPartsOf` (what
+  a description block draws, the one rule the phone, the twin and the canvas
+  read), `variantRows` and `variantLabel` (one priced row per variant, a
+  variant in one line), and `valuesAfterEarlierChoices` and `choicesAfterPick`
+  (a later option offers only what the earlier choices leave, and a pick moves
+  the later choices to a variant for sale).
   `readableInk` is the one rule for words on a colour the merchant chose, so a
   bar cannot be white on the phone and dark on the canvas. `shippingProgress`
   reads how far a held cart is from a free shipping threshold, `cartSavings`
@@ -88,7 +119,71 @@ written against this package and nothing else from the runtime. It holds:
   items it holds in the form the buyer's language counts that number in, and
   `cartBadgeCount` what a cart badge writes over a glyph, capped at 99+, and
   `BUY_QUANTITY_CEILING` the most of one variant a buy control offers to add in
-  one tap.
+  one tap. `customerInitials` is the letters an avatar draws for a shopper,
+  and `accountLinkRows` the rows of the account links as both renderers draw
+  them: named, the hidden ones left out, sign out and delete set apart. The
+  Sign in row reads the platform's `account.sign_in`.
+  `accountLinksLayout` lays those rows out for the shopper's state, the one
+  filter both renderers share: handed `signed_in` or `signed_out`, it keeps
+  only the rows the schema's `ACCOUNT_LINK_ROW_STATES` lets draw in it, then
+  puts consecutive rows of one section on one card under its title, the
+  destructive rows in the list, and the log-out as a pill or pinned at the
+  foot of the hub where the merchant says so; handed no state, it keeps every
+  row. `accountLinksCard` is the card they stand on and the circle behind a
+  glyph.
+  `orderColors` and `orderRadius` are the one table and the one corner the
+  eight order blocks share at `order.<part>`; `fulfillmentPillOf` and
+  `paymentPillOf` are the two pills of an order, a word and one of four tones,
+  and `orderPillColors` the ink and the surface of a tone, read from the pair
+  the theme names for the tone's state at `status.pending`, `status.delivered`
+  or `status.cancelled` (a `label` and a `surface`), which `orderStatusColors`
+  hands an editor whole. `orderListCards` is the card a row of the orders list
+  stands on and the card its first line stands on, `orderLineCard` the card a
+  line stands on in the list and on the order screen alike, `orderSummaryBox`
+  the box of the money rows, `orderItemsOf` the first line of an order, how
+  many lines follow it and how many items it holds, `orderItemCount` that
+  count in the buyer's language and `orderSubtotalLabel` the subtotal that
+  names it, and `orderHasShipments` whether Shopify holds a shipment to
+  track; `SHIPMENT_STEPS`
+  and `shipmentStepReached` are the progress rail of a shipment,
+  `fulfillmentEventWord` and `shipmentWord` its words, Delivered where its
+  newest event says it arrived, the one reading `fulfillmentPillOf` makes of
+  every live shipment, on a row of the list as on the opened order; `orderMoneyRows` lists
+  the money rows Shopify wrote, and `orderDay` and `orderTime` write a
+  timestamp as a shopper reads it. `addressListColors` and `addressListRadius`
+  are the table and the corner of the address list at `address_list.<part>`,
+  `addressCardOf` the title and the lines of one saved address, the lines the
+  Provider composed in the standard postal shape, and `addressControlsOf`
+  which of its three controls a card offers: the default address is never
+  offered Delete, because Shopify refuses that delete in English in every
+  language and refuses it for the only saved address too. The card draws no
+  note about it; `defaultLocked` and the `address.default_before_delete` word
+  stay in the contract, unused by the platform, until its next major. `heroPageLabel` says which page of how many a hero carousel rests
+  on, because its marks carry no words of their own. `promoSetLabel` says how
+  many promotions a promo banner stacks, and `promoCardLabel` which of them a
+  card is, beside the merchant's words or in place of them.
+  `categoryTileOf` is the tile of one collection a category grid's Binding
+  answered, with what the merchant changed on it over the collection's own:
+  the words, a picture or an icon, and where a tap goes, the collection where
+  they pointed it nowhere. `categoryGridRow` is how many tiles stand in a row
+  and the gap between them, `categoryTileWidth` the width a row hands a tile,
+  `categoryGridLook` every measure of a tile at that width, and
+  `categoryGridColors` its colours, the tile on the role the merchant chose
+  and the icon in whichever of ink and paper stands out on it.
+  `listingToolbarLook` and `listingToolbarColors` are the listing toolbar's
+  parts, measures and colours at `listing_toolbar.<part>`, the role the
+  merchant chose for the bar, its stroke, its words or the switch's track over
+  them; `listingCount` is the count of the products a listing has loaded,
+  "24+" while Shopify names more, with its word in the form the buyer's
+  language counts it in; `listingSortRows` and `listingSortLabel` are the
+  sorts the sheet offers in the merchant's order and words, the catalog's
+  `listing.sort.<key>` where they wrote none; `listingFilterRows` is the filter
+  sheet's rows out of the filters Shopify offers the collection, a switch, a
+  price range or a list, in the merchant's order and words; `activeFilterOf`
+  and `activePriceFilter` are a filter the shopper turned on, Shopify's own
+  input for a value unchanged or the price range they gave, with the words of
+  its chip; `listingFilterWords` the words of the button, the sheet and the
+  chips; and `PRODUCT_ROW_LOOK` is the row a product takes in a list.
   `derivedPrice` writes a figure a block worked out for itself, in the style the
   theme chose and at the currency's own places so it lines up in a column with
   the ones Shopify sent; `derivedMoney` is the same figure with an empty
@@ -127,6 +222,14 @@ fallback is always a theme role, never a literal: a merchant who names nothing
 still gets their own palette, and the token is the escape hatch over it. A
 token of another type is not drawn, the fallback is.
 
+One colour is the exception, by the owner's decision: the dim behind the store
+header's open menu. A theme's `overlay` role may be a light wash, and the menu
+must dim the screen dark on every theme, so `storeHeaderColors` falls back to
+`STORE_MENU_DIM` (the Cart Drawer's dim) with `store_header.scrim` over it.
+Sizes are not colours: `storeMenuMetrics` answers the menu's row height and
+label size, 48 and 16 points, with `store_header.menu_row_height` and
+`store_header.menu_text_size` over them.
+
 ## The words a renderer owns
 
 A renderer never carries its own literal. Every functional word the platform
@@ -148,8 +251,11 @@ when they wrote a language the buyer reads and the catalog's word otherwise.
 
 The name a screen reader reads is functional too, whatever the drawing shows.
 A promotion the buyer can tap that carries no words of the merchant's own is
-announced as `promo.promotion` rather than as a button with no name; the
-merchant's headline still wins wherever they wrote one.
+announced by which of how many it is, or as `promo.promotion` when it stands
+alone, rather than as a button with no name; the merchant's headline still wins
+wherever they wrote one, with its place in the set beside it. A horizontal rail
+of more than one item is named by `rail.scroll_hint`, so a buyer who cannot see
+it is told it scrolls sideways.
 
 The catalog answers in English, Arabic and Turkish. A language it does not
 carry falls back to English, written down here rather than left to whichever

package/dist/account-links.d.ts

@@ -0,0 +1,96 @@
+import { type AccountLinkRow, type AccountLinksBlock, type AccountLinkState, type LocaleCode, type ThemeStyle } from '@shoplix-ai/sdui-schema';
+/**
+ * The parts of the account links, each with the theme role it draws unless a
+ * component token names another. No theme role is a red, so the destructive
+ * rows draw the warning role until a design names its own.
+ */
+declare const ACCOUNT_LINKS_ROLES: {
+    readonly title: "subtle";
+    readonly group: "surface";
+    readonly rule: "border";
+    readonly icon_well: "sunken";
+    readonly icon: "text";
+    readonly label: "text";
+    readonly chevron: "muted";
+    readonly destructive: "warning";
+    readonly destructive_surface: "sunken";
+};
+export type AccountLinksPart = keyof typeof ACCOUNT_LINKS_ROLES;
+export type AccountLinksColors = Readonly<Record<AccountLinksPart, string>>;
+/** Every colour the account links draw, one per part, with `account_links.<part>` over each theme role. */
+export declare function accountLinksColors(theme: ThemeStyle): AccountLinksColors;
+/**
+ * The corner the group and a destructive row are cut with: the merchant's own,
+ * with `account_links.radius` over it for a design whose lists are softer than
+ * its buttons.
+ */
+export declare function accountLinksRadius(theme: ThemeStyle): number;
+/** One row as it is drawn: the row of the document and the words a shopper reads on it. */
+export interface NamedAccountLink {
+    readonly row: AccountLinkRow;
+    readonly label: string;
+}
+/** The rows a shopper is shown: the group, and the rows that take something from them, drawn apart. */
+export interface AccountLinkRows {
+    readonly grouped: readonly NamedAccountLink[];
+    readonly destructive: readonly NamedAccountLink[];
+}
+/**
+ * The rows of the account links as both renderers draw them, in the
+ * merchant's order. A row the merchant left unnamed reads the platform's word
+ * for where it leads; a custom screen and a web address have no such word, so
+ * one of those with no label in a language the buyer reads is left out rather
+ * than drawn blank. Sign out and delete are set apart from the group.
+ */
+export declare function accountLinkRows(rows: readonly AccountLinkRow[] | undefined, language: LocaleCode, defaultLanguage: LocaleCode): AccountLinkRows;
+/** The card the rows stand on, and the circle behind each row's glyph, as both renderers draw them. */
+export interface AccountLinksCard {
+    readonly surface: string;
+    /** The line around the card; none, and the card stands on its surface alone. */
+    readonly stroke: string | null;
+    readonly radius: number;
+    readonly shadow: boolean;
+    readonly iconCircle: string;
+}
+/**
+ * The card of the account links: what the merchant set, and the theme's own
+ * look for every part they left out, which is the look the links had before
+ * the card was a setting: the links' surface, no stroke, their own corner and
+ * the soft shadow. The corner is the block's one corner, so the destructive
+ * rows and the log-out pill are cut with it too.
+ */
+export declare function accountLinksCard(theme: ThemeStyle, settings: AccountLinksBlock['props']): AccountLinksCard;
+/** One run of consecutive rows on one card, under the title of the section they name; none, and no title. */
+export interface AccountLinkSection {
+    readonly title: string;
+    readonly rows: readonly NamedAccountLink[];
+}
+/** How a destructive row draws: a row like the others, or the design's centred pill. */
+export type AccountLinkShape = 'row' | 'pill';
+export interface DestructiveAccountLink extends NamedAccountLink {
+    readonly shape: AccountLinkShape;
+}
+/**
+ * The account links as both renderers lay them out: the sections on their
+ * cards, the destructive rows drawn in the list under them, and the log-out
+ * the merchant pinned below the hub's scrolling content.
+ */
+export interface AccountLinksLayout {
+    readonly sections: readonly AccountLinkSection[];
+    readonly destructive: readonly DestructiveAccountLink[];
+    readonly pinned: DestructiveAccountLink | null;
+}
+/**
+ * The layout of the account links, in the merchant's order. Handed the
+ * shopper's state, it keeps only the rows `ACCOUNT_LINK_ROW_STATES` lets draw
+ * in it, before anything is laid out; handed none, it keeps every row.
+ * Consecutive rows that name the same section, as the buyer reads it, share
+ * one card under its title; a section named again further down starts a card
+ * of its own. The two log-out settings move the first log-out row alone: the
+ * pill style draws it as the centred pill, the bottom placement pins it below
+ * the hub's scrolling content. Delete is always a row in the list, so it is
+ * always reachable.
+ */
+export declare function accountLinksLayout(settings: AccountLinksBlock['props'], language: LocaleCode, defaultLanguage: LocaleCode, state?: AccountLinkState): AccountLinksLayout;
+export {};
+//# sourceMappingURL=account-links.d.ts.map

package/dist/account-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-links.d.ts","sourceRoot":"","sources":["../src/account-links.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EAErB,KAAK,UAAU,EACf,KAAK,UAAU,EAChB,MAAM,yBAAyB,CAAC;AAMjC;;;;GAIG;AACH,QAAA,MAAM,mBAAmB;;;;;;;;;;CAUsC,CAAC;AAEhE,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,mBAAmB,CAAC;AAEhE,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC;AAE5E,2GAA2G;AAC3G,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,kBAAkB,CAExE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAE5D;AAWD,2FAA2F;AAC3F,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,uGAAuG;AACvG,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC9C,QAAQ,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACnD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,SAAS,cAAc,EAAE,GAAG,SAAS,EAC3C,QAAQ,EAAE,UAAU,EACpB,eAAe,EAAE,UAAU,GAC1B,eAAe,CAajB;AAED,uGAAuG;AACvG,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gFAAgF;IAChF,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,iBAAiB,CAAC,OAAO,CAAC,GACnC,gBAAgB,CAUlB;AAED,6GAA6G;AAC7G,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC5C;AAED,wFAAwF;AACxF,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,MAAM,CAAC;AAE9C,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;IAC9D,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;CAClC;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACjD,QAAQ,CAAC,WAAW,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACxD,QAAQ,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAAC;CAChD;AAkBD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,iBAAiB,CAAC,OAAO,CAAC,EACpC,QAAQ,EAAE,UAAU,EACpB,eAAe,EAAE,UAAU,EAC3B,KAAK,CAAC,EAAE,gBAAgB,GACvB,kBAAkB,CAiBpB"}

package/dist/account-links.js

@@ -0,0 +1,121 @@
+import { accountLinkRowDraws, componentTokenValue, isDestructiveTarget, shownAccountLinkRows, } from '@shoplix-ai/sdui-schema';
+import { colorChoiceOf } from './color-choice.js';
+import { localize } from './locale.js';
+import { partColors } from './part-colors.js';
+import { platformWords } from './words.js';
+/**
+ * The parts of the account links, each with the theme role it draws unless a
+ * component token names another. No theme role is a red, so the destructive
+ * rows draw the warning role until a design names its own.
+ */
+const ACCOUNT_LINKS_ROLES = {
+    title: 'subtle',
+    group: 'surface',
+    rule: 'border',
+    icon_well: 'sunken',
+    icon: 'text',
+    label: 'text',
+    chevron: 'muted',
+    destructive: 'warning',
+    destructive_surface: 'sunken',
+};
+/** Every colour the account links draw, one per part, with `account_links.<part>` over each theme role. */
+export function accountLinksColors(theme) {
+    return partColors(theme, 'account_links', ACCOUNT_LINKS_ROLES);
+}
+/**
+ * The corner the group and a destructive row are cut with: the merchant's own,
+ * with `account_links.radius` over it for a design whose lists are softer than
+ * its buttons.
+ */
+export function accountLinksRadius(theme) {
+    return componentTokenValue(theme, 'account_links.radius', theme.radius);
+}
+const ROW_WORDS = {
+    open_orders: 'account.orders',
+    open_addresses: 'account.addresses',
+    open_profile: 'account.profile',
+    sign_in: 'account.sign_in',
+    sign_out: 'account.sign_out',
+    delete_account: 'account.delete_account',
+};
+/**
+ * The rows of the account links as both renderers draw them, in the
+ * merchant's order. A row the merchant left unnamed reads the platform's word
+ * for where it leads; a custom screen and a web address have no such word, so
+ * one of those with no label in a language the buyer reads is left out rather
+ * than drawn blank. Sign out and delete are set apart from the group.
+ */
+export function accountLinkRows(rows, language, defaultLanguage) {
+    const words = platformWords(language, defaultLanguage);
+    const named = shownAccountLinkRows(rows)
+        .map((row) => {
+        const word = ROW_WORDS[row.target.type];
+        const written = row.label === undefined ? '' : localize(row.label, language, defaultLanguage);
+        return { row, label: word === undefined ? written : words.merchantOr(row.label, word) };
+    })
+        .filter(({ label }) => label !== '');
+    return {
+        grouped: named.filter(({ row }) => !isDestructiveTarget(row.target)),
+        destructive: named.filter(({ row }) => isDestructiveTarget(row.target)),
+    };
+}
+/**
+ * The card of the account links: what the merchant set, and the theme's own
+ * look for every part they left out, which is the look the links had before
+ * the card was a setting: the links' surface, no stroke, their own corner and
+ * the soft shadow. The corner is the block's one corner, so the destructive
+ * rows and the log-out pill are cut with it too.
+ */
+export function accountLinksCard(theme, settings) {
+    const colors = accountLinksColors(theme);
+    const card = settings.card ?? {};
+    return {
+        surface: colorChoiceOf(theme, card.surface) ?? colors.group,
+        stroke: colorChoiceOf(theme, card.stroke) ?? null,
+        radius: card.radius ?? accountLinksRadius(theme),
+        shadow: card.shadow ?? true,
+        iconCircle: colorChoiceOf(theme, settings.iconCircle) ?? colors.icon_well,
+    };
+}
+function sectionsOf(grouped, language, defaultLanguage) {
+    const sections = [];
+    for (const link of grouped) {
+        const section = link.row.section;
+        const title = section === undefined ? '' : localize(section, language, defaultLanguage);
+        const last = sections[sections.length - 1];
+        if (last !== undefined && last.title === title)
+            last.rows.push(link);
+        else
+            sections.push({ title, rows: [link] });
+    }
+    return sections;
+}
+/**
+ * The layout of the account links, in the merchant's order. Handed the
+ * shopper's state, it keeps only the rows `ACCOUNT_LINK_ROW_STATES` lets draw
+ * in it, before anything is laid out; handed none, it keeps every row.
+ * Consecutive rows that name the same section, as the buyer reads it, share
+ * one card under its title; a section named again further down starts a card
+ * of its own. The two log-out settings move the first log-out row alone: the
+ * pill style draws it as the centred pill, the bottom placement pins it below
+ * the hub's scrolling content. Delete is always a row in the list, so it is
+ * always reachable.
+ */
+export function accountLinksLayout(settings, language, defaultLanguage, state) {
+    const rows = state === undefined
+        ? settings.rows
+        : settings.rows?.filter((row) => accountLinkRowDraws(row.target, state));
+    const { grouped, destructive } = accountLinkRows(rows, language, defaultLanguage);
+    const logOut = destructive.find(({ row }) => row.target.type === 'sign_out');
+    const shapeOf = (link) => link === logOut && settings.destructiveStyle === 'pill' ? 'pill' : 'row';
+    const pinned = settings.destructivePlacement === 'bottom' ? logOut : undefined;
+    return {
+        sections: sectionsOf(grouped, language, defaultLanguage),
+        destructive: destructive
+            .filter((link) => link !== pinned)
+            .map((link) => ({ ...link, shape: shapeOf(link) })),
+        pinned: pinned === undefined ? null : { ...pinned, shape: shapeOf(pinned) },
+    };
+}
+//# sourceMappingURL=account-links.js.map

package/dist/account-links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-links.js","sourceRoot":"","sources":["../src/account-links.ts"],"names":[],"mappings":"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"}

package/dist/address-list.d.ts

@@ -0,0 +1,58 @@
+import { type AddressDisplay, type AddressListBlock, type ThemeStyle } from '@shoplix-ai/sdui-schema';
+/**
+ * The parts of the address list, each with the theme role it draws unless a
+ * component token names another. No theme role is a red, so the delete control
+ * draws the warning role until a design names its own.
+ */
+declare const ADDRESS_LIST_ROLES: {
+    readonly card: "sunken";
+    readonly strip: "elevated";
+    readonly well: "sunken";
+    readonly glyph: "text";
+    readonly title: "text";
+    readonly body: "text";
+    readonly link: "muted";
+    readonly mark: "success";
+    readonly mark_surface: "elevated";
+    readonly destructive: "warning";
+    readonly empty: "muted";
+};
+export type AddressListPart = keyof typeof ADDRESS_LIST_ROLES;
+export type AddressListColors = Readonly<Record<AddressListPart, string>>;
+/** Every colour the address list draws, one per part, with `address_list.<part>` over each theme role. */
+export declare function addressListColors(theme: ThemeStyle): AddressListColors;
+/** The corner an address card is cut with: the merchant's own, with `address_list.radius` over it. */
+export declare function addressListRadius(theme: ThemeStyle): number;
+/** One address as both renderers draw it: the line over the card, and the lines under it. */
+export interface AddressCard {
+    readonly title: string;
+    readonly lines: readonly string[];
+}
+/**
+ * The lines of a card are the ones the Provider composed in the standard
+ * postal shape from the address's own fields: the first, the name, titles
+ * the card and the rest stand under it. Those lines carry no phone, so the one
+ * the shopper wrote is drawn last.
+ */
+export declare function addressCardOf(address: AddressDisplay): AddressCard;
+/** Which of the three controls a card offers. */
+export interface AddressControls {
+    readonly edit: boolean;
+    readonly remove: boolean;
+    readonly makeDefault: boolean;
+    /**
+     * The merchant left Delete on, and this card is the default. The platform's
+     * renderers draw nothing for it any more: the default card simply offers no
+     * Delete. It stays in the contract until its next major.
+     */
+    readonly defaultLocked: boolean;
+}
+/**
+ * Each control is offered unless the merchant hid it. The default address is
+ * offered neither the control that would make it the default nor the one that
+ * would delete it: Shopify refuses to delete a default address, in English in
+ * every language, and refuses it for the only saved address too.
+ */
+export declare function addressControlsOf(address: AddressDisplay, settings: AddressListBlock['props']): AddressControls;
+export {};
+//# sourceMappingURL=address-list.d.ts.map

package/dist/address-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address-list.d.ts","sourceRoot":"","sources":["../src/address-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EAChB,MAAM,yBAAyB,CAAC;AAGjC;;;;GAIG;AACH,QAAA,MAAM,kBAAkB;;;;;;;;;;;;CAYuC,CAAC;AAEhE,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,kBAAkB,CAAC;AAE9D,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC;AAE1E,0GAA0G;AAC1G,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,iBAAiB,CAEtE;AAED,sGAAsG;AACtG,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAE3D;AAED,6FAA6F;AAC7F,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,WAAW,CAMlE;AAED,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,gBAAgB,CAAC,OAAO,CAAC,GAClC,eAAe,CAQjB"}

package/dist/address-list.js

@@ -0,0 +1,57 @@
+import { componentTokenValue, } from '@shoplix-ai/sdui-schema';
+import { partColors } from './part-colors.js';
+/**
+ * The parts of the address list, each with the theme role it draws unless a
+ * component token names another. No theme role is a red, so the delete control
+ * draws the warning role until a design names its own.
+ */
+const ADDRESS_LIST_ROLES = {
+    card: 'sunken',
+    strip: 'elevated',
+    well: 'sunken',
+    glyph: 'text',
+    title: 'text',
+    body: 'text',
+    link: 'muted',
+    mark: 'success',
+    mark_surface: 'elevated',
+    destructive: 'warning',
+    empty: 'muted',
+};
+/** Every colour the address list draws, one per part, with `address_list.<part>` over each theme role. */
+export function addressListColors(theme) {
+    return partColors(theme, 'address_list', ADDRESS_LIST_ROLES);
+}
+/** The corner an address card is cut with: the merchant's own, with `address_list.radius` over it. */
+export function addressListRadius(theme) {
+    return componentTokenValue(theme, 'address_list.radius', theme.radius);
+}
+/**
+ * The lines of a card are the ones the Provider composed in the standard
+ * postal shape from the address's own fields: the first, the name, titles
+ * the card and the rest stand under it. Those lines carry no phone, so the one
+ * the shopper wrote is drawn last.
+ */
+export function addressCardOf(address) {
+    const [title = '', ...rest] = address.formatted;
+    return {
+        title,
+        lines: address.phoneNumber === undefined ? rest : [...rest, address.phoneNumber],
+    };
+}
+/**
+ * Each control is offered unless the merchant hid it. The default address is
+ * offered neither the control that would make it the default nor the one that
+ * would delete it: Shopify refuses to delete a default address, in English in
+ * every language, and refuses it for the only saved address too.
+ */
+export function addressControlsOf(address, settings) {
+    const deletable = settings.deleteControl !== false;
+    return {
+        edit: settings.editControl !== false,
+        remove: deletable && !address.isDefault,
+        makeDefault: settings.defaultControl !== false && !address.isDefault,
+        defaultLocked: deletable && address.isDefault,
+    };
+}
+//# sourceMappingURL=address-list.js.map

package/dist/address-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address-list.js","sourceRoot":"","sources":["../src/address-list.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,GAIpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;;;GAIG;AACH,MAAM,kBAAkB,GAAG;IACzB,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,UAAU;IACjB,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,MAAM;IACb,KAAK,EAAE,MAAM;IACb,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,SAAS;IACf,YAAY,EAAE,UAAU;IACxB,WAAW,EAAE,SAAS;IACtB,KAAK,EAAE,OAAO;CAC+C,CAAC;AAMhE,0GAA0G;AAC1G,MAAM,UAAU,iBAAiB,CAAC,KAAiB;IACjD,OAAO,UAAU,CAAC,KAAK,EAAE,cAAc,EAAE,kBAAkB,CAAC,CAAC;AAC/D,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,iBAAiB,CAAC,KAAiB;IACjD,OAAO,mBAAmB,CAAC,KAAK,EAAE,qBAAqB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;AACzE,CAAC;AAQD;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,OAAuB;IACnD,MAAM,CAAC,KAAK,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAChD,OAAO;QACL,KAAK;QACL,KAAK,EAAE,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC;KACjF,CAAC;AACJ,CAAC;AAeD;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAuB,EACvB,QAAmC;IAEnC,MAAM,SAAS,GAAG,QAAQ,CAAC,aAAa,KAAK,KAAK,CAAC;IACnD,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,WAAW,KAAK,KAAK;QACpC,MAAM,EAAE,SAAS,IAAI,CAAC,OAAO,CAAC,SAAS;QACvC,WAAW,EAAE,QAAQ,CAAC,cAAc,KAAK,KAAK,IAAI,CAAC,OAAO,CAAC,SAAS;QACpE,aAAa,EAAE,SAAS,IAAI,OAAO,CAAC,SAAS;KAC9C,CAAC;AACJ,CAAC"}

package/dist/buy-box.d.ts

@@ -24,6 +24,14 @@ declare const BUY_BOX_ROLES: {
     readonly buy: "action";
     readonly notify: "text";
     readonly notify_done: "success";
+    readonly primary: "action";
+    readonly secondary: "text";
+    readonly secondary_hint: "muted";
+    readonly choice: "text";
+    readonly row_selected: "sunken";
+    readonly radio: "subtle";
+    readonly bar: "elevated";
+    readonly bar_border: "border";
 };
 export type BuyBoxPart = keyof typeof BUY_BOX_ROLES;
 export type BuyBoxColors = Readonly<Record<BuyBoxPart, string>>;

package/dist/buy-box.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buy-box.d.ts","sourceRoot":"","sources":["../src/buy-box.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,UAAU,EAChB,MAAM,yBAAyB,CAAC;AAGjC,mHAAmH;AACnH,QAAA,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;CAwB4C,CAAC;AAEhE,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,aAAa,CAAC;AAEpD,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;AAEhE;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,YAAY,CAE5D;AAED;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAKvC;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,WAAW,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAI9F;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,SAAS,YAAY,EAAE,GAAG,SAAS,EAC7C,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,IAAI,CAWf"}
+{"version":3,"file":"buy-box.d.ts","sourceRoot":"","sources":["../src/buy-box.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,UAAU,EAChB,MAAM,yBAAyB,CAAC;AAGjC,mHAAmH;AACnH,QAAA,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgC4C,CAAC;AAEhE,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,aAAa,CAAC;AAEpD,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;AAEhE;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,YAAY,CAE5D;AAED;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAKvC;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,WAAW,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAI9F;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,SAAS,YAAY,EAAE,GAAG,SAAS,EAC7C,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,IAAI,CAWf"}

package/dist/buy-box.js

@@ -25,6 +25,14 @@ const BUY_BOX_ROLES = {
     buy: 'action',
     notify: 'text',
     notify_done: 'success',
+    primary: 'action',
+    secondary: 'text',
+    secondary_hint: 'muted',
+    choice: 'text',
+    row_selected: 'sunken',
+    radio: 'subtle',
+    bar: 'elevated',
+    bar_border: 'border',
 };
 /**
  * Every colour the welded panel draws, one per part, with `buy_box.<part>` as

package/dist/buy-box.js.map

@@ -1 +1 @@
-{"version":3,"file":"buy-box.js","sourceRoot":"","sources":["../src/buy-box.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,GAIf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,mHAAmH;AACnH,MAAM,aAAa,GAAG;IACpB,KAAK,EAAE,UAAU;IACjB,OAAO,EAAE,MAAM;IACf,YAAY,EAAE,QAAQ;IACtB,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,QAAQ;IACrB,QAAQ,EAAE,MAAM;IAChB,aAAa,EAAE,QAAQ;IACvB,qBAAqB,EAAE,QAAQ;IAC/B,SAAS,EAAE,QAAQ;IACnB,aAAa,EAAE,QAAQ;IACvB,YAAY,EAAE,UAAU;IACxB,WAAW,EAAE,QAAQ;IACrB,QAAQ,EAAE,MAAM;IAChB,SAAS,EAAE,QAAQ;IACnB,QAAQ,EAAE,QAAQ;IAClB,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,QAAQ;IACrB,KAAK,EAAE,MAAM;IACb,GAAG,EAAE,QAAQ;IACb,WAAW,EAAE,QAAQ;IACrB,GAAG,EAAE,QAAQ;IACb,MAAM,EAAE,MAAM;IACd,WAAW,EAAE,SAAS;CACuC,CAAC;AAMhE;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,KAAiB;IAC5C,OAAO,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;AACrD,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEvC,gFAAgF;AAChF,MAAM,SAAS,GAAG,eAAe,CAAC;AAElC;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,OAAuB;IACpD,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,MAAM,CACnC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CACzE,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CACzB,KAAiB,EACjB,QAA6C,EAC7C,KAAa;IAEb,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC1C,MAAM,GAAG,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAC9C,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,CACjC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,MAAM,CACrE,CACF,CAAC;IACF,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC,KAAK,CAAC;IACpD,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpD,OAAO,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAClF,CAAC"}
+{"version":3,"file":"buy-box.js","sourceRoot":"","sources":["../src/buy-box.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,GAIf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,mHAAmH;AACnH,MAAM,aAAa,GAAG;IACpB,KAAK,EAAE,UAAU;IACjB,OAAO,EAAE,MAAM;IACf,YAAY,EAAE,QAAQ;IACtB,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,QAAQ;IACrB,QAAQ,EAAE,MAAM;IAChB,aAAa,EAAE,QAAQ;IACvB,qBAAqB,EAAE,QAAQ;IAC/B,SAAS,EAAE,QAAQ;IACnB,aAAa,EAAE,QAAQ;IACvB,YAAY,EAAE,UAAU;IACxB,WAAW,EAAE,QAAQ;IACrB,QAAQ,EAAE,MAAM;IAChB,SAAS,EAAE,QAAQ;IACnB,QAAQ,EAAE,QAAQ;IAClB,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,QAAQ;IACrB,KAAK,EAAE,MAAM;IACb,GAAG,EAAE,QAAQ;IACb,WAAW,EAAE,QAAQ;IACrB,GAAG,EAAE,QAAQ;IACb,MAAM,EAAE,MAAM;IACd,WAAW,EAAE,SAAS;IACtB,OAAO,EAAE,QAAQ;IACjB,SAAS,EAAE,MAAM;IACjB,cAAc,EAAE,OAAO;IACvB,MAAM,EAAE,MAAM;IACd,YAAY,EAAE,QAAQ;IACtB,KAAK,EAAE,QAAQ;IACf,GAAG,EAAE,UAAU;IACf,UAAU,EAAE,QAAQ;CACyC,CAAC;AAMhE;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,KAAiB;IAC5C,OAAO,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;AACrD,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEvC,gFAAgF;AAChF,MAAM,SAAS,GAAG,eAAe,CAAC;AAElC;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,OAAuB;IACpD,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,MAAM,CACnC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CACzE,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CACzB,KAAiB,EACjB,QAA6C,EAC7C,KAAa;IAEb,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC1C,MAAM,GAAG,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAC9C,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,CACjC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,MAAM,CACrE,CACF,CAAC;IACF,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC,KAAK,CAAC;IACpD,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpD,OAAO,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAClF,CAAC"}

package/dist/capabilities.d.ts

@@ -40,6 +40,13 @@ export interface AddressUpdateInput {
     readonly addressId: string;
     readonly address: AddressInput;
 }
+/**
+ * What a block may hand a sign-in: the email the shopper typed, which Shopify's
+ * hosted step opens with already in its field. None, and that step asks for it.
+ */
+export interface SignInInput {
+    readonly email?: string;
+}
 /**
  * The Notification Invitation as a renderer sees it: whether there is still
  * anything to ask, the tap that opens the phone's own prompt, and the tap
@@ -58,7 +65,10 @@ export interface NotificationInvitation {
  * repaint only on Shopify's answer, never before. A sign-in resolves once the
  * shopper holds an Account Session, and each account write once Shopify wrote
  * it; a shopper who is not signed in gets the refusal, so a block never has to
- * ask whether a capability is reachable before it calls one.
+ * ask whether a capability is reachable before it calls one. A sign-out asks
+ * the shopper first, in the host's own sheet that no block can skip: it
+ * resolves once they chose to log out and the sign-out landed, and rejects
+ * with the `refused` outcome when they stay signed in.
  */
 export interface Capabilities {
     readonly addToCart: (line: CartLineInput) => Promise<void>;
@@ -71,7 +81,7 @@ export interface Capabilities {
     readonly setCartNote: (note: string) => Promise<void>;
     readonly setLineAttributes: (input: CartLineAttributesInput) => Promise<void>;
     readonly notificationInvitation: NotificationInvitation;
-    readonly signIn: () => Promise<void>;
+    readonly signIn: (input?: SignInInput) => Promise<void>;
     readonly signOut: () => Promise<void>;
     readonly updateProfile: (input: ProfileUpdateInput) => Promise<void>;
     readonly addAddress: (input: AddressInput) => Promise<void>;