platform-types 1.10.771 → 1.10.773

package/dist/cjs/storefrontDesign.js

@@ -35,6 +35,10 @@ exports.STOREFRONT_DESIGN_LIMITS = {
     footerLinks: 8,
     faqs: 20,
     benefits: 8,
+    /** Logos in one `logoWall` section; a 25th is `INVALID` at `content.items`. */
+    logoWallItems: 24,
+    /** Photos in one `gallery` section; a 25th is `INVALID` at `content.items`. */
+    galleryItems: 24,
     historyEntries: 20,
     selectedSourceIds: 50,
     /** A `visibility` rule's `priceLists`: the store's own cap on price lists. */
@@ -43,6 +47,8 @@ exports.STOREFRONT_DESIGN_LIMITS = {
     heading: 120,
     label: 80,
     body: 4000,
+    /** The announcement bar's `subtitle`; its `text` is bounded by `heading`. */
+    announcementSubtitle: 240,
     slug: 80,
     seoTitle: 120,
     seoDescription: 320,
@@ -83,6 +89,8 @@ exports.STOREFRONT_SECTION_TYPES = [
     'benefits',
     'contact',
     'paymentDelivery',
+    'logoWall',
+    'gallery',
 ];
 /**
  * The section types a page may repeat, each up to `STOREFRONT_DESIGN_LIMITS.repeatableSectionsPerType`
@@ -329,6 +337,7 @@ function parseStorefrontPreviewDocument(input) {
     const parsedPages = pages.map(previewPage);
     if (!sections || parsedPages.some((page) => page === undefined))
         return undefined;
+    const announcement = previewAnnouncement(input.announcement);
     return {
         schemaVersion: 1,
         templateId: 'standard',
@@ -341,8 +350,16 @@ function parseStorefrontPreviewDocument(input) {
         pages: parsedPages,
         navigation,
         footer,
+        ...(announcement ? { announcement } : {}),
     };
 }
+/** The bar on the transport: an object kept as sent minus a malformed rule; anything else left off. */
+function previewAnnouncement(input) {
+    if (!previewRecord(input))
+        return undefined;
+    const { visibility, ...rest } = input;
+    return { ...rest, ...previewVisibility(visibility) };
+}
 /** The codes a preview frame may report in an `error` message; the parser accepts exactly these. */
 exports.STOREFRONT_PREVIEW_PROTOCOL_ERRORS = [
     'STOREFRONT_PREVIEW_EXPIRED',

package/dist/cjs/storefrontDesignRegistry.js

@@ -50,6 +50,15 @@ exports.STOREFRONT_DESIGN_SETTINGS = {
     textSize: choice('textSize', ['compact', 'standard', 'large'], 'standard', 'Tamaño de texto', 'Escala de texto de la tienda.'),
     cardImageRatio: choice('cardImageRatio', ['square', 'portrait'], 'square', 'Proporción de imágenes', 'Proporción de las imágenes en las tarjetas de productos.'),
     cardDensity: choice('cardDensity', ['compact', 'spacious'], 'spacious', 'Espaciado de tarjetas', 'Espaciado entre los elementos de las tarjetas.'),
+    /*
+     * The three shape settings take values no other setting uses (`compact`, `standard`, `square`,
+     * `large`, `spacious` are taken): the editor labels an option by its value alone. Each default
+     * reproduces the tokens every shop rendered before they existed, so a publication that lacks
+     * them resolves exactly as before and `STOREFRONT_DEFAULTS_VERSION` does not move.
+     */
+    cornerRadius: choice('cornerRadius', ['none', 'soft', 'round'], 'soft', 'Bordes', 'Elegí cuánto se redondean las tarjetas, los botones y los campos.'),
+    buttonStyle: choice('buttonStyle', ['filled', 'outlined', 'pill'], 'filled', 'Estilo de botones', 'Elegí si los botones van rellenos, con contorno o con forma de píldora.'),
+    layoutDensity: choice('layoutDensity', ['comfortable', 'dense'], 'comfortable', 'Densidad', 'Elegí cuánto espacio dejás entre los elementos de toda la tienda.'),
     showBrand: toggle('showBrand', false, 'Mostrar marca', 'Mostrar la marca en las tarjetas de productos.'),
     showSku: toggle('showSku', false, 'Mostrar SKU', 'Mostrar el código SKU en las tarjetas de productos.'),
 };

package/dist/cjs/storefrontTheme.js

@@ -2,6 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveStorefrontTheme = exports.resolveStorefrontEffectiveSettings = exports.storefrontGlobalSettingsLayer = exports.storefrontContrastRatio = void 0;
 const storefrontDesignRegistry_ts_1 = require("./storefrontDesignRegistry.js");
+const CORNER_RADIUS = { none: 0, soft: 4, round: 12 };
+const LAYOUT_SPACING = { comfortable: 8, dense: 6 };
+const PILL_RADIUS = 999;
+const buttonTokens = (style, borderRadius) => style === 'pill' ? { variant: 'filled', borderRadius: PILL_RADIUS } : { variant: style, borderRadius };
+/*
+ * An outlined button draws with the `button` colour as its border and the `link` colour as its
+ * text, so a design that chose `outlined` caused any adjustment to either: both are reported.
+ */
+const OUTLINED_ROLES = new Set(['button', 'link']);
 /*
  * The one binding of a warning role and of a surface to the setting it reads: `surfaceTokens`
  * and `makeMode` read the colours THROUGH these maps, and the `warnings` filter judges by them,
@@ -113,7 +122,8 @@ exports.resolveStorefrontEffectiveSettings = resolveStorefrontEffectiveSettings;
  * already-effective settings as `overrides` rebuilds the same tokens.
  *
  * `warnings` names only adjustments the design itself caused: the adjusted colour, or the
- * background of the surface it sits on, is set in `overrides`. No single colour reads at 4.5:1 on
+ * background of the surface it sits on, is set in `overrides`, or (for the `button` and `link`
+ * roles) `overrides` chose an `outlined` `buttonStyle`, which draws the button with both. No single colour reads at 4.5:1 on
  * both a white page and its dark-mode counterpart, so a platform or GLOBAL default is always
  * adjusted somewhere, and a shop that chose nothing has nothing to act on. Pass the design's own
  * settings, not effective ones, or every default reads as chosen.
@@ -127,6 +137,8 @@ const resolveStorefrontTheme = (overrides = {}, globalsRow) => {
         return { page: surface('page'), header: surface('header'), footer: surface('footer') };
     };
     const scale = { compact: 0.875, standard: 1, large: 1.125 }[settings.textSize];
+    const borderRadius = CORNER_RADIUS[settings.cornerRadius];
+    const outlinedChosen = overrides.buttonStyle !== undefined && settings.buttonStyle === 'outlined';
     return {
         requested: settings,
         light: makeMode('light'),
@@ -144,9 +156,12 @@ const resolveStorefrontTheme = (overrides = {}, globalsRow) => {
             h5: 24 * scale,
             h6: 20 * scale,
         },
-        shape: { borderRadius: 4 },
-        spacing: 8,
-        warnings: warnings.filter(({ role, surface }) => overrides[WARNING_SETTING[role]] !== undefined || overrides[SURFACE_SETTING[surface]] !== undefined),
+        shape: { borderRadius },
+        spacing: LAYOUT_SPACING[settings.layoutDensity],
+        buttons: buttonTokens(settings.buttonStyle, borderRadius),
+        warnings: warnings.filter(({ role, surface }) => overrides[WARNING_SETTING[role]] !== undefined ||
+            overrides[SURFACE_SETTING[surface]] !== undefined ||
+            (outlinedChosen && OUTLINED_ROLES.has(role))),
     };
 };
 exports.resolveStorefrontTheme = resolveStorefrontTheme;

package/dist/cjs/storefrontWebLiteralKeys.js

@@ -461,6 +461,8 @@ exports.STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'COMMON_CANCEL',
     'COMMON_CLOSE',
     'COMMON_CONFIRM',
+    'COMMON_DATE_RANGE_INVERTED',
+    'COMMON_DATE_RANGE_MALFORMED',
     'COMMON_DISMISS_NOTICE',
     'COMMON_DOWNLOAD',
     'COMMON_EXPORT_CSV',
@@ -667,7 +669,10 @@ exports.STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'HOME_HERO_CTA',
     'HOME_HERO_TITLE',
     'HOME_METRICS_BALANCE',
-    'HOME_METRICS_BALANCE_LABEL',
+    'HOME_METRICS_BALANCE_CREDIT',
+    'HOME_METRICS_BALANCE_OWED',
+    'HOME_METRICS_BALANCE_SETTLED',
+    'HOME_METRICS_BALANCE_UNAVAILABLE',
     'HOME_METRICS_BASKET',
     'HOME_METRICS_BASKET_LABEL',
     'HOME_METRICS_CURRENCY',
@@ -719,6 +724,7 @@ exports.STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'INVOICES_COLUMN_TOTAL',
     'INVOICES_COLUMN_TYPE',
     'INVOICES_DATE_FROM',
+    'INVOICES_DATE_UNTIL_LABEL',
     'INVOICES_DOWNLOAD_ERROR',
     'INVOICES_DOWNLOAD_PDF_ARIA',
     'INVOICES_DOWNLOAD_PDF_TOOLTIP',
@@ -867,11 +873,13 @@ exports.STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'ORDERS_COLUMN_STATUS',
     'ORDERS_COLUMN_TOTAL',
     'ORDERS_DATE_FROM_LABEL',
+    'ORDERS_DATE_UNTIL_LABEL',
     'ORDERS_EMPTY',
     'ORDERS_EMPTY_ACTION',
     'ORDERS_ERR_LOAD',
     'ORDERS_FILTERED_CLEAR',
     'ORDERS_FILTERED_EMPTY',
+    'ORDERS_PENDING_ALWAYS_LISTED',
     'ORDERS_REPEAT_ARIA',
     'ORDERS_SEARCH_LABEL',
     'ORDERS_STATUS_CANCELLED_TOOLTIP',
@@ -1011,8 +1019,14 @@ exports.STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'PAYMENTS_COLUMN_MOVEMENT',
     'PAYMENTS_COLUMN_PAYMENT',
     'PAYMENTS_DATE_FROM_LABEL',
+    'PAYMENTS_DATE_UNTIL_LABEL',
     'PAYMENTS_EXPORT_FILENAME',
     'PAYMENTS_LEDGER_UNAVAILABLE',
+    'PAYMENTS_PDF_DOWNLOAD',
+    'PAYMENTS_PDF_ERROR',
+    'PAYMENTS_PDF_FILENAME',
+    'PAYMENTS_PDF_TOO_LONG',
+    'PAYMENTS_PDF_UNAVAILABLE',
     'PAYMENTS_STATEMENT_ERROR',
     'PAYMENTS_STATEMENT_PARTIAL',
     'PAYMENTS_SUBTITLE',

package/dist/storefrontDesign.d.ts

@@ -29,6 +29,10 @@ export declare const STOREFRONT_DESIGN_LIMITS: {
     readonly footerLinks: 8;
     readonly faqs: 20;
     readonly benefits: 8;
+    /** Logos in one `logoWall` section; a 25th is `INVALID` at `content.items`. */
+    readonly logoWallItems: 24;
+    /** Photos in one `gallery` section; a 25th is `INVALID` at `content.items`. */
+    readonly galleryItems: 24;
     readonly historyEntries: 20;
     readonly selectedSourceIds: 50;
     /** A `visibility` rule's `priceLists`: the store's own cap on price lists. */
@@ -37,6 +41,8 @@ export declare const STOREFRONT_DESIGN_LIMITS: {
     readonly heading: 120;
     readonly label: 80;
     readonly body: 4000;
+    /** The announcement bar's `subtitle`; its `text` is bounded by `heading`. */
+    readonly announcementSubtitle: 240;
     readonly slug: 80;
     readonly seoTitle: 120;
     readonly seoDescription: 320;
@@ -65,7 +71,7 @@ export declare const STOREFRONT_DESIGN_LIMITS: {
  */
 export declare const STOREFRONT_PAGE_SLUG_RE: RegExp;
 export declare const isStorefrontPageSlug: (value: unknown) => value is string;
-export declare const STOREFRONT_SECTION_TYPES: readonly ["banner", "imageText", "products", "categories", "brands", "text", "faq", "benefits", "contact", "paymentDelivery"];
+export declare const STOREFRONT_SECTION_TYPES: readonly ["banner", "imageText", "products", "categories", "brands", "text", "faq", "benefits", "contact", "paymentDelivery", "logoWall", "gallery"];
 /**
  * The section types a page may repeat, each up to `STOREFRONT_DESIGN_LIMITS.repeatableSectionsPerType`
  * times (disabled sections count), so a Home can show offers and new arrivals together. Every other
@@ -209,6 +215,36 @@ declare global {
             showPayments?: boolean;
             showDelivery?: boolean;
         };
+        /**
+         * Merchant logos (clients, distributed brands, certifications) that are not catalogue brands.
+         * A logo is never decorative: `image.decorative` is `false`, and `name` (up to `label`) is
+         * its alt text, required to publish. Every projection (the publication, web `GET /store`,
+         * the preview read) writes `name` into `image.alt` when the editor left `alt` blank; an
+         * explicit `alt` wins, and the draft keeps `alt` as authored. Its optional link names a target, so a target that
+         * vanishes drops only the link, never the logo. Once per page.
+         */
+        logoWall: {
+            heading?: string;
+            body?: string;
+            items?: {
+                image: StorefrontDesignImagePlacement & {
+                    decorative: false;
+                };
+                name: string;
+                action?: StorefrontDesignAction & {
+                    target: StorefrontDesignLinkTarget;
+                };
+            }[];
+        };
+        /** Photos, each with `alt` unless decorative and an optional `caption` (up to `heading`). Once per page. */
+        gallery: {
+            heading?: string;
+            body?: string;
+            items?: {
+                image: StorefrontDesignImagePlacement;
+                caption?: string;
+            }[];
+        };
     }
     type StorefrontDesignAudience = (typeof STOREFRONT_DESIGN_AUDIENCES)[number];
     /**
@@ -224,6 +260,36 @@ declare global {
         audiences: StorefrontDesignAudience[];
         priceLists?: number[];
     }
+    /**
+     * The one announcement bar a design carries above every page, never a second. `text` and
+     * `subtitle` are plain text (no control characters; renderers escape markup); `text` is required
+     * to publish while `enabled`. `action` always names a target, so a target that vanishes drops
+     * only the link. `backgroundColor` is a 6-digit hex colour.
+     *
+     * `id` is minted by the server from `text`, `subtitle` and `action`: whatever a client sends is
+     * replaced (an editor adding a bar may send `''`), so it changes whenever the message or its
+     * link does and never when only the rule, colour or dismiss behaviour does. A storefront keys a
+     * remembered dismissal by it, so a dismiss of an old message never hides a new one. Every
+     * document the server answers carries it.
+     *
+     * Every projection drops a disabled bar, as it drops a disabled section. Web `GET /store` also
+     * drops one whose `visibility` the caller does not match; the private preview carries the rule
+     * as authored.
+     */
+    interface StorefrontDesignAnnouncement {
+        id: string;
+        enabled: boolean;
+        text?: string;
+        subtitle?: string;
+        action?: StorefrontDesignAction & {
+            target: StorefrontDesignLinkTarget;
+        };
+        dismissable: boolean;
+        /** Whether a dismissal outlives the browser session; meaningful only with `dismissable`. */
+        persistDismiss: boolean;
+        backgroundColor?: string;
+        visibility?: StorefrontDesignVisibility;
+    }
     type StorefrontDesignSection = {
         [K in StorefrontDesignSectionType]: {
             id: string;
@@ -331,7 +397,8 @@ declare global {
      * Private preview envelopes instead supply `/preview/read?operation=asset&assetId=...`; the
      * preview transport adds a variant query and its in-memory grant, then renders returned bytes.
      *
-     * An item that can carry `visibility` (section, page, navigation entry, footer link) may also
+     * An item that can carry `visibility` (section, page, navigation entry, footer link, the
+     * announcement bar) may also
      * carry `audienceScoped: true`: web `GET /store` sets it on an item it returned because the
      * caller matched that item's rule, and strips every `visibility`. The preview never sets it.
      */
@@ -378,6 +445,8 @@ declare global {
         contact: StorefrontDesignContact;
         seo: StorefrontDesignSeo;
         literalOverrides: Record<string, string>;
+        /** Absent on every document written before the bar existed, and whenever none is authored. */
+        announcement?: StorefrontDesignAnnouncement;
     }
     /**
      * `TOO_LARGE` at path `''` means the whole stored draft would exceed its row budget, not one field.
@@ -535,7 +604,8 @@ declare global {
         /**
          * Only adjustments the design itself caused: the adjusted colour, or the background of the
          * surface it sits on, is set by the design. So a default primary or accent colour IS listed
-         * when the design sets that surface's background.
+         * when the design sets that surface's background, and a default primary's `button` and
+         * `link` adjustments are listed when the design chooses an `outlined` `buttonStyle`.
          */
         changeSummary: {
             contrastAdjustments: StorefrontThemeWarning[];
@@ -731,6 +801,8 @@ declare global {
         contact: Record<string, unknown>;
         seo: object;
         literalOverrides: Record<string, unknown>;
+        /** Carried as sent when it is an object, its `visibility` kept only when well-formed; never applied. */
+        announcement?: object;
     }
     type StorefrontPreviewProtocolError = (typeof STOREFRONT_PREVIEW_PROTOCOL_ERRORS)[number];
     type StorefrontPreviewViewport = 'desktop' | 'mobile';

package/dist/storefrontDesign.js

@@ -28,6 +28,10 @@ export const STOREFRONT_DESIGN_LIMITS = {
     footerLinks: 8,
     faqs: 20,
     benefits: 8,
+    /** Logos in one `logoWall` section; a 25th is `INVALID` at `content.items`. */
+    logoWallItems: 24,
+    /** Photos in one `gallery` section; a 25th is `INVALID` at `content.items`. */
+    galleryItems: 24,
     historyEntries: 20,
     selectedSourceIds: 50,
     /** A `visibility` rule's `priceLists`: the store's own cap on price lists. */
@@ -36,6 +40,8 @@ export const STOREFRONT_DESIGN_LIMITS = {
     heading: 120,
     label: 80,
     body: 4000,
+    /** The announcement bar's `subtitle`; its `text` is bounded by `heading`. */
+    announcementSubtitle: 240,
     slug: 80,
     seoTitle: 120,
     seoDescription: 320,
@@ -75,6 +81,8 @@ export const STOREFRONT_SECTION_TYPES = [
     'benefits',
     'contact',
     'paymentDelivery',
+    'logoWall',
+    'gallery',
 ];
 /**
  * The section types a page may repeat, each up to `STOREFRONT_DESIGN_LIMITS.repeatableSectionsPerType`
@@ -321,6 +329,7 @@ export function parseStorefrontPreviewDocument(input) {
     const parsedPages = pages.map(previewPage);
     if (!sections || parsedPages.some((page) => page === undefined))
         return undefined;
+    const announcement = previewAnnouncement(input.announcement);
     return {
         schemaVersion: 1,
         templateId: 'standard',
@@ -333,8 +342,16 @@ export function parseStorefrontPreviewDocument(input) {
         pages: parsedPages,
         navigation,
         footer,
+        ...(announcement ? { announcement } : {}),
     };
 }
+/** The bar on the transport: an object kept as sent minus a malformed rule; anything else left off. */
+function previewAnnouncement(input) {
+    if (!previewRecord(input))
+        return undefined;
+    const { visibility, ...rest } = input;
+    return { ...rest, ...previewVisibility(visibility) };
+}
 /** The codes a preview frame may report in an `error` message; the parser accepts exactly these. */
 export const STOREFRONT_PREVIEW_PROTOCOL_ERRORS = [
     'STOREFRONT_PREVIEW_EXPIRED',

package/dist/storefrontDesignRegistry.d.ts

@@ -293,6 +293,81 @@ export declare const STOREFRONT_DESIGN_SETTINGS: {
         };
         readonly ownership: "storefront-design";
     };
+    readonly cornerRadius: {
+        readonly key: "cornerRadius";
+        readonly defaultValue: "none" | "soft" | "round";
+        readonly valueType: "string";
+        readonly allowedValues: readonly ["none", "soft", "round"];
+        readonly valueSchema: {
+            readonly type: "string";
+            readonly enum: readonly ["none", "soft", "round"];
+        };
+        readonly description: string;
+        readonly literal: {
+            readonly kind: "text";
+            readonly label: string;
+            readonly help: string;
+        };
+        readonly scope: "storefront";
+        readonly allowedLayers: readonly ["GLOBAL", "WEB", "WEB#store"];
+        readonly audience: "public";
+        readonly lifecycle: "release-owned";
+        readonly storage: {
+            readonly policy: "GLOBALS";
+            readonly override: "design.settings";
+        };
+        readonly ownership: "storefront-design";
+    };
+    readonly buttonStyle: {
+        readonly key: "buttonStyle";
+        readonly defaultValue: "filled" | "outlined" | "pill";
+        readonly valueType: "string";
+        readonly allowedValues: readonly ["filled", "outlined", "pill"];
+        readonly valueSchema: {
+            readonly type: "string";
+            readonly enum: readonly ["filled", "outlined", "pill"];
+        };
+        readonly description: string;
+        readonly literal: {
+            readonly kind: "text";
+            readonly label: string;
+            readonly help: string;
+        };
+        readonly scope: "storefront";
+        readonly allowedLayers: readonly ["GLOBAL", "WEB", "WEB#store"];
+        readonly audience: "public";
+        readonly lifecycle: "release-owned";
+        readonly storage: {
+            readonly policy: "GLOBALS";
+            readonly override: "design.settings";
+        };
+        readonly ownership: "storefront-design";
+    };
+    readonly layoutDensity: {
+        readonly key: "layoutDensity";
+        readonly defaultValue: "comfortable" | "dense";
+        readonly valueType: "string";
+        readonly allowedValues: readonly ["comfortable", "dense"];
+        readonly valueSchema: {
+            readonly type: "string";
+            readonly enum: readonly ["comfortable", "dense"];
+        };
+        readonly description: string;
+        readonly literal: {
+            readonly kind: "text";
+            readonly label: string;
+            readonly help: string;
+        };
+        readonly scope: "storefront";
+        readonly allowedLayers: readonly ["GLOBAL", "WEB", "WEB#store"];
+        readonly audience: "public";
+        readonly lifecycle: "release-owned";
+        readonly storage: {
+            readonly policy: "GLOBALS";
+            readonly override: "design.settings";
+        };
+        readonly ownership: "storefront-design";
+    };
     readonly showBrand: {
         readonly key: "showBrand";
         readonly defaultValue: boolean;
@@ -626,6 +701,81 @@ export declare const STOREFRONT_DESIGN_REGISTRY: {
             };
             readonly ownership: "storefront-design";
         };
+        readonly cornerRadius: {
+            readonly key: "cornerRadius";
+            readonly defaultValue: "none" | "soft" | "round";
+            readonly valueType: "string";
+            readonly allowedValues: readonly ["none", "soft", "round"];
+            readonly valueSchema: {
+                readonly type: "string";
+                readonly enum: readonly ["none", "soft", "round"];
+            };
+            readonly description: string;
+            readonly literal: {
+                readonly kind: "text";
+                readonly label: string;
+                readonly help: string;
+            };
+            readonly scope: "storefront";
+            readonly allowedLayers: readonly ["GLOBAL", "WEB", "WEB#store"];
+            readonly audience: "public";
+            readonly lifecycle: "release-owned";
+            readonly storage: {
+                readonly policy: "GLOBALS";
+                readonly override: "design.settings";
+            };
+            readonly ownership: "storefront-design";
+        };
+        readonly buttonStyle: {
+            readonly key: "buttonStyle";
+            readonly defaultValue: "filled" | "outlined" | "pill";
+            readonly valueType: "string";
+            readonly allowedValues: readonly ["filled", "outlined", "pill"];
+            readonly valueSchema: {
+                readonly type: "string";
+                readonly enum: readonly ["filled", "outlined", "pill"];
+            };
+            readonly description: string;
+            readonly literal: {
+                readonly kind: "text";
+                readonly label: string;
+                readonly help: string;
+            };
+            readonly scope: "storefront";
+            readonly allowedLayers: readonly ["GLOBAL", "WEB", "WEB#store"];
+            readonly audience: "public";
+            readonly lifecycle: "release-owned";
+            readonly storage: {
+                readonly policy: "GLOBALS";
+                readonly override: "design.settings";
+            };
+            readonly ownership: "storefront-design";
+        };
+        readonly layoutDensity: {
+            readonly key: "layoutDensity";
+            readonly defaultValue: "comfortable" | "dense";
+            readonly valueType: "string";
+            readonly allowedValues: readonly ["comfortable", "dense"];
+            readonly valueSchema: {
+                readonly type: "string";
+                readonly enum: readonly ["comfortable", "dense"];
+            };
+            readonly description: string;
+            readonly literal: {
+                readonly kind: "text";
+                readonly label: string;
+                readonly help: string;
+            };
+            readonly scope: "storefront";
+            readonly allowedLayers: readonly ["GLOBAL", "WEB", "WEB#store"];
+            readonly audience: "public";
+            readonly lifecycle: "release-owned";
+            readonly storage: {
+                readonly policy: "GLOBALS";
+                readonly override: "design.settings";
+            };
+            readonly ownership: "storefront-design";
+        };
         readonly showBrand: {
             readonly key: "showBrand";
             readonly defaultValue: boolean;

package/dist/storefrontDesignRegistry.js

@@ -47,6 +47,15 @@ export const STOREFRONT_DESIGN_SETTINGS = {
     textSize: choice('textSize', ['compact', 'standard', 'large'], 'standard', 'Tamaño de texto', 'Escala de texto de la tienda.'),
     cardImageRatio: choice('cardImageRatio', ['square', 'portrait'], 'square', 'Proporción de imágenes', 'Proporción de las imágenes en las tarjetas de productos.'),
     cardDensity: choice('cardDensity', ['compact', 'spacious'], 'spacious', 'Espaciado de tarjetas', 'Espaciado entre los elementos de las tarjetas.'),
+    /*
+     * The three shape settings take values no other setting uses (`compact`, `standard`, `square`,
+     * `large`, `spacious` are taken): the editor labels an option by its value alone. Each default
+     * reproduces the tokens every shop rendered before they existed, so a publication that lacks
+     * them resolves exactly as before and `STOREFRONT_DEFAULTS_VERSION` does not move.
+     */
+    cornerRadius: choice('cornerRadius', ['none', 'soft', 'round'], 'soft', 'Bordes', 'Elegí cuánto se redondean las tarjetas, los botones y los campos.'),
+    buttonStyle: choice('buttonStyle', ['filled', 'outlined', 'pill'], 'filled', 'Estilo de botones', 'Elegí si los botones van rellenos, con contorno o con forma de píldora.'),
+    layoutDensity: choice('layoutDensity', ['comfortable', 'dense'], 'comfortable', 'Densidad', 'Elegí cuánto espacio dejás entre los elementos de toda la tienda.'),
     showBrand: toggle('showBrand', false, 'Mostrar marca', 'Mostrar la marca en las tarjetas de productos.'),
     showSku: toggle('showSku', false, 'Mostrar SKU', 'Mostrar el código SKU en las tarjetas de productos.'),
 };

package/dist/storefrontTheme.d.ts

@@ -43,10 +43,26 @@ export interface StorefrontResolvedTheme {
         h5: number;
         h6: number;
     };
+    /** `cornerRadius`: `none` 0, `soft` 4, `round` 12 px. Cards, buttons and fields share it. */
     shape: {
         borderRadius: number;
     };
+    /**
+     * The MUI spacing unit, from `layoutDensity`: `comfortable` 8, `dense` 6. It scales every
+     * spacing call in the shop (header and sidebar included), so it overlaps `cardDensity`, which
+     * only spaces the product card's own contents.
+     */
     spacing: number;
+    /**
+     * How buttons are drawn, from `buttonStyle`. `filled` and `outlined` take the shape radius;
+     * `pill` is `filled` with a 999 px radius. An `outlined` button has no token of its own: its
+     * border is the surface's `button.background` (at least 3:1 against the surface) and its text
+     * the surface's `link` (at least 4.5:1).
+     */
+    buttons: {
+        variant: 'filled' | 'outlined';
+        borderRadius: number;
+    };
     warnings: StorefrontThemeWarning[];
 }
 export declare const storefrontContrastRatio: (foreground: string, background: string) => number;
@@ -74,7 +90,8 @@ export declare const resolveStorefrontEffectiveSettings: (overrides?: Partial<St
  * already-effective settings as `overrides` rebuilds the same tokens.
  *
  * `warnings` names only adjustments the design itself caused: the adjusted colour, or the
- * background of the surface it sits on, is set in `overrides`. No single colour reads at 4.5:1 on
+ * background of the surface it sits on, is set in `overrides`, or (for the `button` and `link`
+ * roles) `overrides` chose an `outlined` `buttonStyle`, which draws the button with both. No single colour reads at 4.5:1 on
  * both a white page and its dark-mode counterpart, so a platform or GLOBAL default is always
  * adjusted somewhere, and a shop that chose nothing has nothing to act on. Pass the design's own
  * settings, not effective ones, or every default reads as chosen.

package/dist/storefrontTheme.js

@@ -1,4 +1,13 @@
 import { resolveStorefrontDesignSettings, validateStorefrontDesignSetting, } from "./storefrontDesignRegistry.js";
+const CORNER_RADIUS = { none: 0, soft: 4, round: 12 };
+const LAYOUT_SPACING = { comfortable: 8, dense: 6 };
+const PILL_RADIUS = 999;
+const buttonTokens = (style, borderRadius) => style === 'pill' ? { variant: 'filled', borderRadius: PILL_RADIUS } : { variant: style, borderRadius };
+/*
+ * An outlined button draws with the `button` colour as its border and the `link` colour as its
+ * text, so a design that chose `outlined` caused any adjustment to either: both are reported.
+ */
+const OUTLINED_ROLES = new Set(['button', 'link']);
 /*
  * The one binding of a warning role and of a surface to the setting it reads: `surfaceTokens`
  * and `makeMode` read the colours THROUGH these maps, and the `warnings` filter judges by them,
@@ -107,7 +116,8 @@ export const resolveStorefrontEffectiveSettings = (overrides = {}, globalsRow) =
  * already-effective settings as `overrides` rebuilds the same tokens.
  *
  * `warnings` names only adjustments the design itself caused: the adjusted colour, or the
- * background of the surface it sits on, is set in `overrides`. No single colour reads at 4.5:1 on
+ * background of the surface it sits on, is set in `overrides`, or (for the `button` and `link`
+ * roles) `overrides` chose an `outlined` `buttonStyle`, which draws the button with both. No single colour reads at 4.5:1 on
  * both a white page and its dark-mode counterpart, so a platform or GLOBAL default is always
  * adjusted somewhere, and a shop that chose nothing has nothing to act on. Pass the design's own
  * settings, not effective ones, or every default reads as chosen.
@@ -121,6 +131,8 @@ export const resolveStorefrontTheme = (overrides = {}, globalsRow) => {
         return { page: surface('page'), header: surface('header'), footer: surface('footer') };
     };
     const scale = { compact: 0.875, standard: 1, large: 1.125 }[settings.textSize];
+    const borderRadius = CORNER_RADIUS[settings.cornerRadius];
+    const outlinedChosen = overrides.buttonStyle !== undefined && settings.buttonStyle === 'outlined';
     return {
         requested: settings,
         light: makeMode('light'),
@@ -138,8 +150,11 @@ export const resolveStorefrontTheme = (overrides = {}, globalsRow) => {
             h5: 24 * scale,
             h6: 20 * scale,
         },
-        shape: { borderRadius: 4 },
-        spacing: 8,
-        warnings: warnings.filter(({ role, surface }) => overrides[WARNING_SETTING[role]] !== undefined || overrides[SURFACE_SETTING[surface]] !== undefined),
+        shape: { borderRadius },
+        spacing: LAYOUT_SPACING[settings.layoutDensity],
+        buttons: buttonTokens(settings.buttonStyle, borderRadius),
+        warnings: warnings.filter(({ role, surface }) => overrides[WARNING_SETTING[role]] !== undefined ||
+            overrides[SURFACE_SETTING[surface]] !== undefined ||
+            (outlinedChosen && OUTLINED_ROLES.has(role))),
     };
 };

package/dist/storefrontWebLiteralKeys.js

@@ -458,6 +458,8 @@ export const STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'COMMON_CANCEL',
     'COMMON_CLOSE',
     'COMMON_CONFIRM',
+    'COMMON_DATE_RANGE_INVERTED',
+    'COMMON_DATE_RANGE_MALFORMED',
     'COMMON_DISMISS_NOTICE',
     'COMMON_DOWNLOAD',
     'COMMON_EXPORT_CSV',
@@ -664,7 +666,10 @@ export const STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'HOME_HERO_CTA',
     'HOME_HERO_TITLE',
     'HOME_METRICS_BALANCE',
-    'HOME_METRICS_BALANCE_LABEL',
+    'HOME_METRICS_BALANCE_CREDIT',
+    'HOME_METRICS_BALANCE_OWED',
+    'HOME_METRICS_BALANCE_SETTLED',
+    'HOME_METRICS_BALANCE_UNAVAILABLE',
     'HOME_METRICS_BASKET',
     'HOME_METRICS_BASKET_LABEL',
     'HOME_METRICS_CURRENCY',
@@ -716,6 +721,7 @@ export const STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'INVOICES_COLUMN_TOTAL',
     'INVOICES_COLUMN_TYPE',
     'INVOICES_DATE_FROM',
+    'INVOICES_DATE_UNTIL_LABEL',
     'INVOICES_DOWNLOAD_ERROR',
     'INVOICES_DOWNLOAD_PDF_ARIA',
     'INVOICES_DOWNLOAD_PDF_TOOLTIP',
@@ -864,11 +870,13 @@ export const STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'ORDERS_COLUMN_STATUS',
     'ORDERS_COLUMN_TOTAL',
     'ORDERS_DATE_FROM_LABEL',
+    'ORDERS_DATE_UNTIL_LABEL',
     'ORDERS_EMPTY',
     'ORDERS_EMPTY_ACTION',
     'ORDERS_ERR_LOAD',
     'ORDERS_FILTERED_CLEAR',
     'ORDERS_FILTERED_EMPTY',
+    'ORDERS_PENDING_ALWAYS_LISTED',
     'ORDERS_REPEAT_ARIA',
     'ORDERS_SEARCH_LABEL',
     'ORDERS_STATUS_CANCELLED_TOOLTIP',
@@ -1008,8 +1016,14 @@ export const STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'PAYMENTS_COLUMN_MOVEMENT',
     'PAYMENTS_COLUMN_PAYMENT',
     'PAYMENTS_DATE_FROM_LABEL',
+    'PAYMENTS_DATE_UNTIL_LABEL',
     'PAYMENTS_EXPORT_FILENAME',
     'PAYMENTS_LEDGER_UNAVAILABLE',
+    'PAYMENTS_PDF_DOWNLOAD',
+    'PAYMENTS_PDF_ERROR',
+    'PAYMENTS_PDF_FILENAME',
+    'PAYMENTS_PDF_TOO_LONG',
+    'PAYMENTS_PDF_UNAVAILABLE',
     'PAYMENTS_STATEMENT_ERROR',
     'PAYMENTS_STATEMENT_PARTIAL',
     'PAYMENTS_SUBTITLE',

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "platform-types",
-	"version": "1.10.771",
+	"version": "1.10.773",
 	"description": "Shared wire and entity contracts for the platform.",
 	"type": "module",
 	"main": "dist/index.js",