platform-types 1.10.696 → 1.10.698

package/dist/cjs/storefrontDesign.js

@@ -76,6 +76,12 @@ exports.STOREFRONT_SECTION_TYPES = [
     'contact',
     'paymentDelivery',
 ];
+/**
+ * The storefront routes a design link may target by name. `incomes` is the
+ * always-available recency listing (`/products/incomes`); `new` is the separate
+ * listing that depends on a feature flag. `brands` and `favorites` map to
+ * `/brands` and `/favorites`.
+ */
 exports.STOREFRONT_BUILTIN_DESTINATIONS = [
     'home',
     'catalogue',
@@ -85,6 +91,9 @@ exports.STOREFRONT_BUILTIN_DESTINATIONS = [
     'cart',
     'account',
     'privacy',
+    'brands',
+    'favorites',
+    'incomes',
 ];
 /**
  * The built-in destinations that must stay reachable whatever a design does with
@@ -164,6 +173,7 @@ exports.STOREFRONT_PREVIEW_READ_OPERATIONS = [
     'productBySlug',
     'productsByIds',
     'products',
+    'incomes',
     'group',
     'related',
     'categories',

package/dist/cjs/storefrontTheme.js

@@ -2,6 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveStorefrontTheme = exports.resolveStorefrontEffectiveSettings = exports.storefrontGlobalSettingsLayer = exports.storefrontContrastRatio = void 0;
 const storefrontDesignRegistry_ts_1 = require("./storefrontDesignRegistry.js");
+/*
+ * 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,
+ * so the tokens and the "design caused it" filter cannot name different settings.
+ */
 const WARNING_SETTING = {
     link: 'primaryColor',
     button: 'primaryColor',
@@ -54,22 +59,23 @@ const ensureContrast = (color, background, minimum) => {
     return target;
 };
 const surfaceTokens = (background, settings, mode, surface, warnings) => {
-    const adjusted = (role, requested, minimum) => {
+    const adjusted = (role, minimum) => {
+        const requested = settings[WARNING_SETTING[role]];
         const effective = ensureContrast(requested, background, minimum);
         if (effective !== requested.toUpperCase())
             warnings.push({ mode, surface, role, requested, effective });
         return effective;
     };
     const text = readableText(background);
-    const button = adjusted('button', settings.primaryColor, 3);
+    const button = adjusted('button', 3);
     const hover = ensureContrast(mix(button, readableText(background), 0.2), background, 3);
     const disabledBackground = mix(background, text, 0.12);
     return {
         background,
         text,
         secondaryText: ensureContrast(mix(background, text, 0.6), background, 4.5),
-        link: adjusted('link', settings.primaryColor, 4.5),
-        focus: adjusted('focus', settings.accentColor, 3),
+        link: adjusted('link', 4.5),
+        focus: adjusted('focus', 3),
         border: ensureContrast(mix(background, text, 0.3), background, 3),
         button: { background: button, text: readableText(button), hover, hoverText: readableText(hover) },
         disabled: { background: disabledBackground, text: readableText(disabledBackground) },
@@ -117,11 +123,8 @@ const resolveStorefrontTheme = (overrides = {}, globalsRow) => {
     const warnings = [];
     const makeMode = (mode) => {
         const background = (requested) => mode === 'light' ? requested.toUpperCase() : mix(requested, '#000000', 0.9);
-        return {
-            page: surfaceTokens(background(settings.backgroundColor), settings, mode, 'page', warnings),
-            header: surfaceTokens(background(settings.headerColor), settings, mode, 'header', warnings),
-            footer: surfaceTokens(background(settings.footerColor), settings, mode, 'footer', warnings),
-        };
+        const surface = (id) => surfaceTokens(background(settings[SURFACE_SETTING[id]]), settings, mode, id, warnings);
+        return { page: surface('page'), header: surface('header'), footer: surface('footer') };
     };
     const scale = { compact: 0.875, standard: 1, large: 1.125 }[settings.textSize];
     return {

package/dist/storefrontDesign.d.ts

@@ -58,7 +58,13 @@ 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_BUILTIN_DESTINATIONS: readonly ["home", "catalogue", "offers", "new", "search", "cart", "account", "privacy"];
+/**
+ * The storefront routes a design link may target by name. `incomes` is the
+ * always-available recency listing (`/products/incomes`); `new` is the separate
+ * listing that depends on a feature flag. `brands` and `favorites` map to
+ * `/brands` and `/favorites`.
+ */
+export declare const STOREFRONT_BUILTIN_DESTINATIONS: readonly ["home", "catalogue", "offers", "new", "search", "cart", "account", "privacy", "brands", "favorites", "incomes"];
 /**
  * The built-in destinations that must stay reachable whatever a design does with
  * its menus: search, cart, account and the required legal page. Reachability is
@@ -352,7 +358,11 @@ declare global {
         /** Always `[]`: an invalid colour, an unmapped Home switch, the banner and every refused or oversized literal fall back to defaults. */
         mappingConflicts: StorefrontDesignMappingConflict[];
         legacySourceRevision: string;
-        /** The store's own logo, offered as a suggestion; init copies it into `branding.logo`, and a copy that cannot complete leaves no logo and no conflict. */
+        /**
+         * The store's own logo, offered as a suggestion; init copies it into `branding.logo`. A logo
+         * that is not adoptable or would exceed the asset capacity leaves no logo and no conflict;
+         * any other copy failure answers 503 `STOREFRONT_DRAFT_UNAVAILABLE`.
+         */
         legacyLogo?: {
             source: 'store.photoURL';
             key: string;
@@ -470,7 +480,11 @@ declare global {
     type StorefrontDesignPublishOperationResult = StorefrontDesignPublishResult;
     type StorefrontDesignPublishOperationResponse = StorefrontDesignPublishResponse;
     interface StorefrontDesignPublishResult {
-        /** Only adjustments to a colour the design itself sets; a default colour is never listed. */
+        /**
+         * 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.
+         */
         changeSummary: {
             contrastAdjustments: StorefrontThemeWarning[];
         };
@@ -536,6 +550,21 @@ declare global {
         inStock?: 'true';
         isNew?: 'true';
         startKey?: string;
+    }
+    /**
+     * Web `GET /products?updatedAt=`'s recency listing (the shop's «Ingresos» page), with the
+     * same rows and cursor shape, in the grant's store: enabled products updated after
+     * `updatedAt` (epoch ms), newest first; `LastEvaluatedKey` resumes as `startKey`. The web
+     * route's one rule: an absent or empty `updatedAt` reads from 0; anything but digits within
+     * `Number.MAX_SAFE_INTEGER` (`1e5`, `-5`, `0x10`, a blank) answers 400 `INVALID_UPDATED_AT`,
+     * on both routes alike. An `updatedAt` over 32 characters or a `startKey` over 2048 answers
+     * 400 `STOREFRONT_PREVIEW_INVALID`; a malformed or foreign `startKey` answers 400
+     * `INVALID_CURSOR`.
+     */
+     | {
+        operation: 'incomes';
+        updatedAt?: string;
+        startKey?: string;
     } | {
         operation: 'group';
         groupId: string;
@@ -581,10 +610,12 @@ declare global {
     /**
      * The codes a catalogue operation answers through its public web route's own core, as that
      * route does: 404 `PRODUCT_NOT_FOUND` / `PRODUCT_GROUP_NOT_FOUND` / `COLLECTION_NOT_FOUND`,
-     * 400 `INVALID_CURSOR` / `INVALID_DISCOVERY_QUERY`, 409 `CURSOR_STALE` (a collection that
-     * changed between the reads bracketing a page) and 503 `PRODUCT_LOOKUP_INCOMPLETE`.
+     * 400 `INVALID_CURSOR` / `INVALID_DISCOVERY_QUERY` / `INVALID_UPDATED_AT` (an `incomes`
+     * `updatedAt` that is not digits within the safe-integer range), 409 `CURSOR_STALE` (a
+     * collection that changed between the reads bracketing a page) and 503
+     * `PRODUCT_LOOKUP_INCOMPLETE`.
      */
-    type StorefrontPreviewCatalogueErrorCode = 'PRODUCT_NOT_FOUND' | 'PRODUCT_GROUP_NOT_FOUND' | 'COLLECTION_NOT_FOUND' | 'INVALID_CURSOR' | 'INVALID_DISCOVERY_QUERY' | 'CURSOR_STALE' | 'PRODUCT_LOOKUP_INCOMPLETE';
+    type StorefrontPreviewCatalogueErrorCode = 'PRODUCT_NOT_FOUND' | 'PRODUCT_GROUP_NOT_FOUND' | 'COLLECTION_NOT_FOUND' | 'INVALID_CURSOR' | 'INVALID_DISCOVERY_QUERY' | 'INVALID_UPDATED_AT' | 'CURSOR_STALE' | 'PRODUCT_LOOKUP_INCOMPLETE';
     interface StorefrontPreviewReadFailure {
         message: string;
         error: StorefrontPreviewReadErrorCode | StorefrontPreviewCatalogueErrorCode;
@@ -746,7 +777,7 @@ declare global {
         data: StorefrontDesignPreviewResult;
     } | StorefrontDesignFailure;
 }
-export declare const STOREFRONT_PREVIEW_READ_OPERATIONS: readonly ["design", "store", "product", "productBySlug", "productsByIds", "products", "group", "related", "categories", "brands", "tags", "collection", "paymentMethods", "deliveryMethods", "asset"];
+export declare const STOREFRONT_PREVIEW_READ_OPERATIONS: readonly ["design", "store", "product", "productBySlug", "productsByIds", "products", "incomes", "group", "related", "categories", "brands", "tags", "collection", "paymentMethods", "deliveryMethods", "asset"];
 /** Checks transport structure and UTF-8 size; unfamiliar section types are skipped, never rendered. */
 export declare function parseStorefrontPreviewDocument(input: unknown): StorefrontPreviewDocument | undefined;
 /** The codes a preview frame may report in an `error` message; the parser accepts exactly these. */

package/dist/storefrontDesign.js

@@ -68,6 +68,12 @@ export const STOREFRONT_SECTION_TYPES = [
     'contact',
     'paymentDelivery',
 ];
+/**
+ * The storefront routes a design link may target by name. `incomes` is the
+ * always-available recency listing (`/products/incomes`); `new` is the separate
+ * listing that depends on a feature flag. `brands` and `favorites` map to
+ * `/brands` and `/favorites`.
+ */
 export const STOREFRONT_BUILTIN_DESTINATIONS = [
     'home',
     'catalogue',
@@ -77,6 +83,9 @@ export const STOREFRONT_BUILTIN_DESTINATIONS = [
     'cart',
     'account',
     'privacy',
+    'brands',
+    'favorites',
+    'incomes',
 ];
 /**
  * The built-in destinations that must stay reachable whatever a design does with
@@ -156,6 +165,7 @@ export const STOREFRONT_PREVIEW_READ_OPERATIONS = [
     'productBySlug',
     'productsByIds',
     'products',
+    'incomes',
     'group',
     'related',
     'categories',

package/dist/storefrontTheme.js

@@ -1,4 +1,9 @@
 import { resolveStorefrontDesignSettings, validateStorefrontDesignSetting, } from "./storefrontDesignRegistry.js";
+/*
+ * 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,
+ * so the tokens and the "design caused it" filter cannot name different settings.
+ */
 const WARNING_SETTING = {
     link: 'primaryColor',
     button: 'primaryColor',
@@ -50,22 +55,23 @@ const ensureContrast = (color, background, minimum) => {
     return target;
 };
 const surfaceTokens = (background, settings, mode, surface, warnings) => {
-    const adjusted = (role, requested, minimum) => {
+    const adjusted = (role, minimum) => {
+        const requested = settings[WARNING_SETTING[role]];
         const effective = ensureContrast(requested, background, minimum);
         if (effective !== requested.toUpperCase())
             warnings.push({ mode, surface, role, requested, effective });
         return effective;
     };
     const text = readableText(background);
-    const button = adjusted('button', settings.primaryColor, 3);
+    const button = adjusted('button', 3);
     const hover = ensureContrast(mix(button, readableText(background), 0.2), background, 3);
     const disabledBackground = mix(background, text, 0.12);
     return {
         background,
         text,
         secondaryText: ensureContrast(mix(background, text, 0.6), background, 4.5),
-        link: adjusted('link', settings.primaryColor, 4.5),
-        focus: adjusted('focus', settings.accentColor, 3),
+        link: adjusted('link', 4.5),
+        focus: adjusted('focus', 3),
         border: ensureContrast(mix(background, text, 0.3), background, 3),
         button: { background: button, text: readableText(button), hover, hoverText: readableText(hover) },
         disabled: { background: disabledBackground, text: readableText(disabledBackground) },
@@ -111,11 +117,8 @@ export const resolveStorefrontTheme = (overrides = {}, globalsRow) => {
     const warnings = [];
     const makeMode = (mode) => {
         const background = (requested) => mode === 'light' ? requested.toUpperCase() : mix(requested, '#000000', 0.9);
-        return {
-            page: surfaceTokens(background(settings.backgroundColor), settings, mode, 'page', warnings),
-            header: surfaceTokens(background(settings.headerColor), settings, mode, 'header', warnings),
-            footer: surfaceTokens(background(settings.footerColor), settings, mode, 'footer', warnings),
-        };
+        const surface = (id) => surfaceTokens(background(settings[SURFACE_SETTING[id]]), settings, mode, id, warnings);
+        return { page: surface('page'), header: surface('header'), footer: surface('footer') };
     };
     const scale = { compact: 0.875, standard: 1, large: 1.125 }[settings.textSize];
     return {

package/package.json

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