@shoplix-ai/block-kit 4.6.0 → 5.0.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, 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)
@@ -77,7 +81,8 @@ written against this package and nothing else from the runtime. It holds:
   `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.
   `readableInk` is the one rule for words on a colour the merchant chose, so a
@@ -88,7 +93,26 @@ 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.
+  `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; `SHIPMENT_STEPS`
+  and `shipmentStepReached` are the progress rail of a shipment,
+  `fulfillmentEventWord` and `shipmentWord` its words; `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, and
+  `addressControlsOf` which of its three controls a card offers, and whether
+  the card says why it offers no Delete: 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. `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.
   `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
@@ -148,8 +172,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,47 @@
+import { type AccountLinkRow, 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;
+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,EAIL,KAAK,cAAc,EAEnB,KAAK,UAAU,EACf,KAAK,UAAU,EAChB,MAAM,yBAAyB,CAAC;AAKjC;;;;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;AAUD,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"}

package/dist/account-links.js

@@ -0,0 +1,61 @@
+import { componentTokenValue, isDestructiveTarget, shownAccountLinkRows, } from '@shoplix-ai/sdui-schema';
+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_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)),
+    };
+}
+//# 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":"AAAA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,GAKrB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAgB,MAAM,YAAY,CAAC;AAEzD;;;;GAIG;AACH,MAAM,mBAAmB,GAAG;IAC1B,KAAK,EAAE,QAAQ;IACf,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,QAAQ;IACd,SAAS,EAAE,QAAQ;IACnB,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,MAAM;IACb,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE,SAAS;IACtB,mBAAmB,EAAE,QAAQ;CACgC,CAAC;AAMhE,2GAA2G;AAC3G,MAAM,UAAU,kBAAkB,CAAC,KAAiB;IAClD,OAAO,UAAU,CAAC,KAAK,EAAE,eAAe,EAAE,mBAAmB,CAAC,CAAC;AACjE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAiB;IAClD,OAAO,mBAAmB,CAAC,KAAK,EAAE,sBAAsB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,SAAS,GAAwD;IACrE,WAAW,EAAE,gBAAgB;IAC7B,cAAc,EAAE,mBAAmB;IACnC,YAAY,EAAE,iBAAiB;IAC/B,QAAQ,EAAE,kBAAkB;IAC5B,cAAc,EAAE,wBAAwB;CACzC,CAAC;AAcF;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,IAA2C,EAC3C,QAAoB,EACpB,eAA2B;IAE3B,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC;SACrC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACX,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC;QAC9F,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;IAC1F,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;IACvC,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpE,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;KACxE,CAAC;AACJ,CAAC"}

package/dist/address-list.d.ts

@@ -0,0 +1,57 @@
+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 Shopify's own, formatted for the country of the
+ * address: the first titles the card and the rest stand under it. Shopify's
+ * 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, and whether it says why Delete is missing. */
+export interface AddressControls {
+    readonly edit: boolean;
+    readonly remove: boolean;
+    readonly makeDefault: boolean;
+    /**
+     * The merchant left Delete on, and this card is the default, so the card
+     * says another address must be the default first in place of the control.
+     */
+    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. The card says
+ * so in the shopper's own words before the tap instead of after it.
+ */
+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;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,WAAW,CAMlE;AAED,4FAA4F;AAC5F,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;;;OAGG;IACH,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAED;;;;;;GAMG;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 Shopify's own, formatted for the country of the
+ * address: the first titles the card and the rest stand under it. Shopify's
+ * 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. The card says
+ * so in the shopper's own words before the tap instead of after it.
+ */
+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;;;;GAIG;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;AAcD;;;;;;GAMG;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/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
@@ -71,7 +78,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>;

package/dist/capabilities.d.ts.map

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

package/dist/capabilities.js.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,GAKvB,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AA+FvD,MAAM,QAAQ,GAAwB,IAAI,GAAG,CAAoB;IAC/D,SAAS;IACT,WAAW;IACX,QAAQ;CACT,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAI/B;IACA;IAJO,IAAI,GAAG,mBAAmB,CAAC;IAE7C,YACW,OAA0B,EAC1B,QAA2B;QAEpC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAHjD,YAAO,GAAP,OAAO,CAAmB;QAC1B,aAAQ,GAAR,QAAQ,CAAmB;IAGtC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,GAAG,GAAG,KAAkE,CAAC;IAC/E,OAAO,CACL,GAAG,CAAC,IAAI,KAAK,mBAAmB;QAChC,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;QAC/B,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC;QACzB,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC3B,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,CAC7D,CAAC;AACJ,CAAC"}
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,GAKvB,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAuGvD,MAAM,QAAQ,GAAwB,IAAI,GAAG,CAAoB;IAC/D,SAAS;IACT,WAAW;IACX,QAAQ;CACT,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAI/B;IACA;IAJO,IAAI,GAAG,mBAAmB,CAAC;IAE7C,YACW,OAA0B,EAC1B,QAA2B;QAEpC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAHjD,YAAO,GAAP,OAAO,CAAmB;QAC1B,aAAQ,GAAR,QAAQ,CAAmB;IAGtC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,GAAG,GAAG,KAAkE,CAAC;IAC/E,OAAO,CACL,GAAG,CAAC,IAAI,KAAK,mBAAmB;QAChC,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;QAC/B,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC;QACzB,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC3B,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,CAC7D,CAAC;AACJ,CAAC"}

package/dist/contract.d.ts

@@ -1,5 +1,5 @@
 import type { ComponentType } from 'react';
-import type { BindingData, BoundItem, EnvelopeAssets, LocaleCode, ThemeStyle, ThemeTokens } from '@shoplix-ai/sdui-schema';
+import type { BindingData, BoundItem, EnvelopeAssets, LocaleCode, RowItem, ThemeStyle, ThemeTokens } from '@shoplix-ai/sdui-schema';
 import type { CapabilityName, CapabilityObject } from './capabilities.js';
 import type { BlockNavigation } from './navigation.js';
 export type TextDirection = 'ltr' | 'rtl';
@@ -58,11 +58,13 @@ export interface BlockRenderProps<TSettings extends BlockSettings = BlockSetting
 export type BlockRenderer<TSettings extends BlockSettings = BlockSettings, K extends CapabilityName = never> = ComponentType<BlockRenderProps<TSettings, K>>;
 /**
  * What the item renderer of a row receives: everything the block receives,
- * plus the one bound item this cell draws, its place in the Binding's items
- * and the width the host gives the cell.
+ * plus the one item this cell draws, its place in the Binding's items and the
+ * width the host gives the cell. The item is a bound item unless the block
+ * names another: a block of the shopper's own data draws an order, or a line
+ * of one.
  */
-export interface BlockItemRenderProps<TSettings extends BlockSettings = BlockSettings, K extends CapabilityName = never> extends BlockRenderProps<TSettings, K> {
-    readonly item: BoundItem;
+export interface BlockItemRenderProps<TSettings extends BlockSettings = BlockSettings, K extends CapabilityName = never, TItem extends RowItem = BoundItem> extends BlockRenderProps<TSettings, K> {
+    readonly item: TItem;
     readonly index: number;
     readonly width: number;
 }
@@ -70,15 +72,18 @@ export interface BlockItemRenderProps<TSettings extends BlockSettings = BlockSet
  * How a bound block hands its items to the host instead of drawing them
  * itself: an optional header, one item renderer, an optional footer, and how
  * many items stand side by side with how much space between them. `columns`
- * defaults to 1 and `gap` to 0 where the host lays rows out. A host without
- * the row layout ignores all of it and calls `render`.
+ * defaults to 1 and `gap` to 0 where the host lays rows out. `empty` stands in
+ * the place of all of it when the Binding answered no item; without one an
+ * empty block draws nothing. A host without the row layout ignores all of it
+ * and calls `render`.
  */
-export interface BlockRows<TSettings extends BlockSettings = BlockSettings, K extends CapabilityName = never> {
+export interface BlockRows<TSettings extends BlockSettings = BlockSettings, K extends CapabilityName = never, TItem extends RowItem = BoundItem> {
     readonly columns?: (props: BlockRenderProps<TSettings, K>) => number;
     readonly gap?: (props: BlockRenderProps<TSettings, K>) => number;
     readonly header?: BlockRenderer<TSettings, K>;
-    readonly item: ComponentType<BlockItemRenderProps<TSettings, K>>;
+    readonly item: ComponentType<BlockItemRenderProps<TSettings, K, TItem>>;
     readonly footer?: BlockRenderer<TSettings, K>;
+    readonly empty?: BlockRenderer<TSettings, K>;
 }
 /** Who answers for a Block Type: the platform, or the Shop whose package registered it. */
 export type BlockOwner = string;
@@ -91,13 +96,13 @@ export type BlockOwner = string;
  */
 export type BlockChrome = 'header';
 /** The typed authoring shape: settings and capabilities are inferred from the definition. */
-export interface BlockDefinition<TSettings extends BlockSettings = BlockSettings, K extends CapabilityName = never> {
+export interface BlockDefinition<TSettings extends BlockSettings = BlockSettings, K extends CapabilityName = never, TItem extends RowItem = BoundItem> {
     readonly type: string;
     readonly owner: BlockOwner;
     readonly capabilities?: readonly K[];
     readonly chrome?: BlockChrome;
     readonly render: BlockRenderer<TSettings, K>;
-    readonly rows?: BlockRows<TSettings, K> | undefined;
+    readonly rows?: BlockRows<TSettings, K, TItem> | undefined;
 }
 /**
  * The shape a registry stores and a host renders: one entry per Block Type.
@@ -119,8 +124,9 @@ export interface BlockRegistration {
 }
 /**
  * Turns a typed definition into a registration. The settings a renderer
- * receives come from a document parsed against the schema for its type, so
- * the widening to the stored shape happens here, once, and nowhere else.
+ * receives come from a document parsed against the schema for its type, and
+ * the items its rows draw from the Binding its type is welded to, so the
+ * widening to the stored shape happens here, once, and nowhere else.
  */
-export declare function defineBlock<TSettings extends BlockSettings = BlockSettings, const K extends CapabilityName = never>(definition: BlockDefinition<TSettings, K>): BlockRegistration;
+export declare function defineBlock<TSettings extends BlockSettings = BlockSettings, const K extends CapabilityName = never, TItem extends RowItem = BoundItem>(definition: BlockDefinition<TSettings, K, TItem>): BlockRegistration;
 //# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

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

package/dist/contract.js

@@ -1,7 +1,8 @@
 /**
  * Turns a typed definition into a registration. The settings a renderer
- * receives come from a document parsed against the schema for its type, so
- * the widening to the stored shape happens here, once, and nowhere else.
+ * receives come from a document parsed against the schema for its type, and
+ * the items its rows draw from the Binding its type is welded to, so the
+ * widening to the stored shape happens here, once, and nowhere else.
  */
 export function defineBlock(definition) {
     return {

package/dist/contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AA0JA;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAGzB,UAAyC;IACzC,OAAO;QACL,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,YAAY,EAAE,UAAU,CAAC,YAAY,IAAI,EAAE;QAC3C,GAAG,CAAC,UAAU,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;QACzE,MAAM,EAAE,UAAU,CAAC,MAAkC;QACrD,IAAI,EAAE,UAAU,CAAC,IAAwC;KAC1D,CAAC;AACJ,CAAC"}
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAmKA;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAIzB,UAAgD;IAChD,OAAO;QACL,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,YAAY,EAAE,UAAU,CAAC,YAAY,IAAI,EAAE;QAC3C,GAAG,CAAC,UAAU,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;QACzE,MAAM,EAAE,UAAU,CAAC,MAAkC;QACrD,IAAI,EAAE,UAAU,CAAC,IAAwC;KAC1D,CAAC;AACJ,CAAC"}

package/dist/hero-banner.d.ts

@@ -1,4 +1,4 @@
-import { type ThemeStyle } from '@shoplix-ai/sdui-schema';
+import { type LocaleCode, type ThemeStyle } from '@shoplix-ai/sdui-schema';
 /** The parts of the hero banner, each with the theme role it draws unless a component token names another. */
 declare const HERO_BANNER_ROLES: {
     readonly artwork: "sunken";
@@ -23,5 +23,14 @@ export declare function heroBannerColors(theme: ThemeStyle): HeroBannerColors;
  * than its cards.
  */
 export declare function heroBannerRadius(theme: ThemeStyle): number;
+/**
+ * What the page indicator says out loud: which page of how many the carousel
+ * rests on, in the buyer's language. The page is the one the carousel holds,
+ * by its own index, and the word writes it from one because a buyer counts the
+ * first page as one. The marks themselves carry no words, so without this a
+ * buyer who cannot see them is never told the hero has more pages, nor which
+ * one is on screen.
+ */
+export declare function heroPageLabel(pageIndex: number, pages: number, language: LocaleCode, defaultLanguage: LocaleCode): string;
 export {};
 //# sourceMappingURL=hero-banner.d.ts.map

package/dist/hero-banner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hero-banner.d.ts","sourceRoot":"","sources":["../src/hero-banner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG/E,8GAA8G;AAC9G,QAAA,MAAM,iBAAiB;;;;;;;CAOwC,CAAC;AAEhE,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,iBAAiB,CAAC;AAE5D,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;AAExE;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,gBAAgB,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAE1D"}
+{"version":3,"file":"hero-banner.d.ts","sourceRoot":"","sources":["../src/hero-banner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAIhG,8GAA8G;AAC9G,QAAA,MAAM,iBAAiB;;;;;;;CAOwC,CAAC;AAEhE,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,iBAAiB,CAAC;AAE5D,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;AAExE;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,gBAAgB,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAE1D;AAKD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,UAAU,EACpB,eAAe,EAAE,UAAU,GAC1B,MAAM,CAKR"}

package/dist/hero-banner.js

@@ -1,5 +1,6 @@
 import { componentTokenValue } from '@shoplix-ai/sdui-schema';
 import { partColors } from './part-colors.js';
+import { platformWords } from './words.js';
 /** The parts of the hero banner, each with the theme role it draws unless a component token names another. */
 const HERO_BANNER_ROLES = {
     artwork: 'sunken',
@@ -26,4 +27,20 @@ export function heroBannerColors(theme) {
 export function heroBannerRadius(theme) {
     return componentTokenValue(theme, 'hero_banner.radius', theme.radius);
 }
+const PAGE_SLOT = '{page}';
+const PAGES_SLOT = '{pages}';
+/**
+ * What the page indicator says out loud: which page of how many the carousel
+ * rests on, in the buyer's language. The page is the one the carousel holds,
+ * by its own index, and the word writes it from one because a buyer counts the
+ * first page as one. The marks themselves carry no words, so without this a
+ * buyer who cannot see them is never told the hero has more pages, nor which
+ * one is on screen.
+ */
+export function heroPageLabel(pageIndex, pages, language, defaultLanguage) {
+    return platformWords(language, defaultLanguage)
+        .own('hero.page_of')
+        .replaceAll(PAGE_SLOT, String(pageIndex + 1))
+        .replaceAll(PAGES_SLOT, String(pages));
+}
 //# sourceMappingURL=hero-banner.js.map

package/dist/hero-banner.js.map

@@ -1 +1 @@
-{"version":3,"file":"hero-banner.js","sourceRoot":"","sources":["../src/hero-banner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAmB,MAAM,yBAAyB,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,8GAA8G;AAC9G,MAAM,iBAAiB,GAAG;IACxB,OAAO,EAAE,QAAQ;IACjB,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,MAAM;IACb,QAAQ,EAAE,QAAQ;IAClB,IAAI,EAAE,QAAQ;IACd,SAAS,EAAE,QAAQ;CAC0C,CAAC;AAMhE;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAiB;IAChD,OAAO,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,iBAAiB,CAAC,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAiB;IAChD,OAAO,mBAAmB,CAAC,KAAK,EAAE,oBAAoB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;AACxE,CAAC"}
+{"version":3,"file":"hero-banner.js","sourceRoot":"","sources":["../src/hero-banner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAoC,MAAM,yBAAyB,CAAC;AAChG,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,8GAA8G;AAC9G,MAAM,iBAAiB,GAAG;IACxB,OAAO,EAAE,QAAQ;IACjB,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,MAAM;IACb,QAAQ,EAAE,QAAQ;IAClB,IAAI,EAAE,QAAQ;IACd,SAAS,EAAE,QAAQ;CAC0C,CAAC;AAMhE;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAiB;IAChD,OAAO,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,iBAAiB,CAAC,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAiB;IAChD,OAAO,mBAAmB,CAAC,KAAK,EAAE,oBAAoB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,SAAS,GAAG,QAAQ,CAAC;AAC3B,MAAM,UAAU,GAAG,SAAS,CAAC;AAE7B;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAC3B,SAAiB,EACjB,KAAa,EACb,QAAoB,EACpB,eAA2B;IAE3B,OAAO,aAAa,CAAC,QAAQ,EAAE,eAAe,CAAC;SAC5C,GAAG,CAAC,cAAc,CAAC;SACnB,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;SAC5C,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AAC3C,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { CAPABILITY_NAMES, CapabilityRefusal, isCapabilityRefusal } from './capabilities.js';
-export type { AddressInput, AddressUpdateInput, Capabilities, CapabilityName, CapabilityObject, CapabilityOutcome, CartLineAttributesInput, CartLineInput, CartLineQuantityInput, NotificationInvitation, ProfileUpdateInput, } from './capabilities.js';
+export type { AddressInput, AddressUpdateInput, Capabilities, CapabilityName, CapabilityObject, CapabilityOutcome, CartLineAttributesInput, CartLineInput, CartLineQuantityInput, NotificationInvitation, ProfileUpdateInput, SignInInput, } from './capabilities.js';
 export { defineBlock } from './contract.js';
 export type { AccountSummary, BlockChrome, BlockDefinition, BlockItemRenderProps, BlockOwner, BlockRegistration, BlockRenderProps, BlockRenderer, BlockRows, BlockSettings, CartSummary, TextDirection, } from './contract.js';
 export type { BlockNavigation } from './navigation.js';
@@ -35,9 +35,9 @@ export { cartSavings, cartSummaryColors } from './cart-summary.js';
 export type { CartSummaryColors, CartSummaryPart } from './cart-summary.js';
 export { checkoutButtonColors } from './checkout-button.js';
 export type { CheckoutButtonColors, CheckoutButtonPart } from './checkout-button.js';
-export { heroBannerColors, heroBannerRadius } from './hero-banner.js';
+export { heroBannerColors, heroBannerRadius, heroPageLabel } from './hero-banner.js';
 export type { HeroBannerColors, HeroBannerPart } from './hero-banner.js';
-export { promoBannerColors, promoBannerRadius } from './promo-banner.js';
+export { promoBannerColors, promoBannerRadius, promoCardLabel, promoSetLabel, } from './promo-banner.js';
 export type { PromoBannerColors, PromoBannerPart } from './promo-banner.js';
 export { sectionHeaderColors } from './section-header.js';
 export { featureStripColors } from './feature-strip.js';
@@ -49,6 +49,16 @@ export { announcementBarColors } from './announcement-bar.js';
 export { aroundAmount, shippingProgress, shippingProgressColors } from './shipping-progress.js';
 export { cartBadgeCount, storeHeaderColors } from './store-header.js';
 export type { StoreHeaderColors, StoreHeaderPart } from './store-header.js';
+export { signInColors } from './sign-in.js';
+export type { SignInColors, SignInPart } from './sign-in.js';
+export { customerInitials, profileHeaderColors } from './profile-header.js';
+export type { ProfileHeaderColors, ProfileHeaderPart } from './profile-header.js';
+export { accountLinkRows, accountLinksColors, accountLinksRadius } from './account-links.js';
+export type { AccountLinkRows, AccountLinksColors, AccountLinksPart, NamedAccountLink, } from './account-links.js';
+export { addressCardOf, addressControlsOf, addressListColors, addressListRadius, } from './address-list.js';
+export type { AddressCard, AddressControls, AddressListColors, AddressListPart, } from './address-list.js';
+export { SHIPMENT_STEPS, fulfillmentEventWord, fulfillmentPillOf, orderColors, orderDay, orderMoneyRows, orderPillColors, orderRadius, orderTime, paymentPillOf, shipmentStepReached, shipmentWord, } from './orders.js';
+export type { OrderColors, OrderMoneyRow, OrderPart, OrderPill, OrderPillColors, OrderPillTone, ShipmentStep, } from './orders.js';
 export { readableInk } from './readable.js';
 export type { SectionHeaderColors, SectionHeaderPart } from './section-header.js';
 export type { FeatureStripColors, FeatureStripPart } from './feature-strip.js';
@@ -62,6 +72,6 @@ export { imageSourceFor } from './renditions.js';
 export type { ImageSource } from './renditions.js';
 export { localize, pickLocale, textDirection } from './locale.js';
 export type { ShopLanguages } from './locale.js';
-export { CATALOG_LANGUAGES, WORD_KEYS, cartItemCount, platformWords } from './words.js';
+export { CATALOG_LANGUAGES, DELETION_FACTS, WORD_KEYS, cartItemCount, platformWords, } from './words.js';
 export type { PlatformWords, WordKey } from './words.js';
 //# sourceMappingURL=index.d.ts.map