platform-types 1.10.694 → 1.10.696

package/dist/cart.d.ts

@@ -197,7 +197,9 @@ declare global {
          * ⚠️ It is the value AFTER the cost floor. A cashier who types below cost
          * gets the cost, and the cost is what is remembered — so the floor is
          * re-applied against the CURRENT product cost on every later rebuild and a
-         * pinned price can never drift below margin as costs rise.
+         * pinned price can never drift below margin as costs rise. That also means
+         * it can exceed 1,000,000,000 (the cap a TYPED price answers to), because
+         * the cost is catalogue-derived; echoing it back unchanged is never refused.
          *
          * ⚠️ It SURVIVES every later write to the cart — another line being added, a
          * coupon applied, this line's own quantity changed, the price list moving to
@@ -849,6 +851,11 @@ declare global {
          * on, and the result is floored at the product's own `cost` — a counter
          * price may discount and never sell below margin.
          *
+         * ⚠️ An HONOURED number above 1,000,000,000 — the line price order edit
+         * accepts — is refused `400 VALIDATION_FAILED` naming `price`. A number the
+         * surface or the store switch discards is never refused, however large, so
+         * a storefront or `changePrice`-off till may echo any list price.
+         *
          * ⚠️ THREE values, three different instructions:
          *
          *  - ABSENT — say nothing about price. A line already pinned to a staff

package/dist/cjs/serviceOrder.js

@@ -197,6 +197,10 @@ exports.MAX_SERVICE_PICTURES = 20;
  *   the ticket (`data.basketCurrency`, `data.serviceCurrency`). Nothing was
  *   written and no order number was minted; bill the cart separately or resend
  *   with `includeBasket: false`.
+ * - `SERVICE_LINE_PRICE_TOO_LARGE` · 400 — the `ready → delivered` handover
+ *   would mint an order line (`data.line`: `'labor'` or `'parts'`, at
+ *   `data.amount`) above `data.max`, the line price order edit accepts. Nothing
+ *   was written and no order number was minted; split the work across tickets.
  * - `SERVICE_RENOTIFY_*` — `mode: 'renotify'`. `_TOO_SOON` (429) carries
  *   `lastNotifiedAt` and `retryAfterMs`; `_IMPERSONATED` (403) means a support
  *   session cannot message the customer — the store must resend it itself;
@@ -337,6 +341,7 @@ exports.SERVICE_ORDER_ERROR_CODES = [
     'PRODUCT_SALE_LIMIT_INVALID',
     'FX_CONVERSION_UNAVAILABLE',
     'TRANSACT_ITEMS_LIMIT_EXCEEDED',
+    'SERVICE_LINE_PRICE_TOO_LARGE',
     // Parts
     'SERVICE_PARTS_RESTORE_EXCEEDS_CONSUMED',
     'SERVICE_PARTS_RESTORE_EXCEEDS_AMOUNT',

package/dist/cjs/storefrontTheme.js

@@ -2,6 +2,16 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveStorefrontTheme = exports.resolveStorefrontEffectiveSettings = exports.storefrontGlobalSettingsLayer = exports.storefrontContrastRatio = void 0;
 const storefrontDesignRegistry_ts_1 = require("./storefrontDesignRegistry.js");
+const WARNING_SETTING = {
+    link: 'primaryColor',
+    button: 'primaryColor',
+    focus: 'accentColor',
+};
+const SURFACE_SETTING = {
+    page: 'backgroundColor',
+    header: 'headerColor',
+    footer: 'footerColor',
+};
 const channels = (color) => [
     Number.parseInt(color.slice(1, 3), 16),
     Number.parseInt(color.slice(3, 5), 16),
@@ -94,7 +104,13 @@ exports.resolveStorefrontEffectiveSettings = resolveStorefrontEffectiveSettings;
  * resolves defaults plus the design only — correct solely while no GLOBAL design setting
  * is set, so a caller serving or reporting on a storefront passes the row (the edge
  * renderer's `theme-color` is the one exception, design-only by its read grant). Passing
- * already-effective settings as `overrides` rebuilds the same theme.
+ * 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
+ * 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.
  */
 const resolveStorefrontTheme = (overrides = {}, globalsRow) => {
     const settings = (0, exports.resolveStorefrontEffectiveSettings)(overrides, globalsRow);
@@ -127,7 +143,7 @@ const resolveStorefrontTheme = (overrides = {}, globalsRow) => {
         },
         shape: { borderRadius: 4 },
         spacing: 8,
-        warnings,
+        warnings: warnings.filter(({ role, surface }) => overrides[WARNING_SETTING[role]] !== undefined || overrides[SURFACE_SETTING[surface]] !== undefined),
     };
 };
 exports.resolveStorefrontTheme = resolveStorefrontTheme;

package/dist/order.d.ts

@@ -1774,7 +1774,8 @@ declare global {
          * cart path, where the price is the catalogue's. It is not a licence to set
          * any price: a store with `changePrice: false` refuses a line whose price
          * differs from the catalogue price, and a non-positive price is refused
-         * everywhere.
+         * everywhere. A price above 1,000,000,000 is refused too, the cap order
+         * edit puts on a line price, so the order can always be edited.
          */
         price: number;
         /** Per-line discount, subject to the same operator capability as a cart discount. */

package/dist/serviceOrder.d.ts

@@ -1311,6 +1311,10 @@ export declare const MAX_SERVICE_PICTURES = 20;
  *   the ticket (`data.basketCurrency`, `data.serviceCurrency`). Nothing was
  *   written and no order number was minted; bill the cart separately or resend
  *   with `includeBasket: false`.
+ * - `SERVICE_LINE_PRICE_TOO_LARGE` · 400 — the `ready → delivered` handover
+ *   would mint an order line (`data.line`: `'labor'` or `'parts'`, at
+ *   `data.amount`) above `data.max`, the line price order edit accepts. Nothing
+ *   was written and no order number was minted; split the work across tickets.
  * - `SERVICE_RENOTIFY_*` — `mode: 'renotify'`. `_TOO_SOON` (429) carries
  *   `lastNotifiedAt` and `retryAfterMs`; `_IMPERSONATED` (403) means a support
  *   session cannot message the customer — the store must resend it itself;
@@ -1377,6 +1381,6 @@ export declare const MAX_SERVICE_PICTURES = 20;
  * check `GATING_ERROR_CODES` in addition. The deposit's opt-in idempotency
  * refusals are included here.
  */
-export declare const SERVICE_ORDER_ERROR_CODES: readonly ["UNIT_QUANTITY_NOT_WHOLE", "UNIT_REVISION_STALE", "ROLE_FORBIDDEN", "PARENT_FILTER_CONFLICT", "VALIDATION_FAILED", "INVALID_CURSOR", "INVALID_FROM_DATE", "INVALID_TO_DATE", "INVALID_DATE_RANGE", "REWORK_INDEX_UNAVAILABLE", "STORE_NOT_FOUND", "SERVICE_ORDER_NOT_FOUND", "CUSTOMER_NOT_FOUND", "PARENT_SERVICE_ORDER_NOT_FOUND", "SERVICE_TEMPLATE_NOT_FOUND", "SERVICE_TYPE_REQUIRED", "INVALID_IMAGE_REFERENCE", "MISSING_STORE_CONTEXT", "WARRANTY_BELOW_LEGAL_MINIMUM", "TECHNICIAN_NOT_FOUND", "TECHNICIAN_NOT_ELIGIBLE", "CUSTODY_ILLEGAL_TRANSITION", "SERVICE_ORDER_BILLABLE_FROZEN", "SERVICE_ORDER_EDIT_CHANGED", "SERVICE_ORDER_DISABLED_STATE_UNCHANGED", "APPOINTMENT_NOT_FOUND", "APPOINTMENT_NOT_LINKABLE", "APPOINTMENT_NOT_OPEN", "APPOINTMENT_CUSTOMER_MISMATCH", "APPOINTMENT_VERSION_CONFLICT", "SERVICE_ORDER_TERMINAL", "SERVICE_ORDER_DISABLED", "SERVICE_ORDER_ILLEGAL_TRANSITION", "SERVICE_ORDER_STATUS_CHANGED", "SERVICE_ORDER_OUTCOME_REQUIRED", "SERVICE_ORDER_OUTCOME_NOT_ALLOWED", "SERVICE_ORDER_CUSTODY_NOT_RECEIVED", "SERVICE_ORDER_BILLABLE_NOT_AT_THIS_TRANSITION", "PAYMENT_METHODS_NOT_CONFIGURED", "PAYMENT_METHOD_NOT_FOUND", "SERVICE_ORDER_DEPOSIT_CHANGED", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSE", "IDEMPOTENCY_IN_PROGRESS", "IDEMPOTENCY_KEY_FAILED", "IDEMPOTENCY_LOCK_CONTENTION", "SERVICE_DEPOSIT_CURRENCY_MISMATCH", "SERVICE_DEPOSIT_INVALID", "INVALID_AMOUNT", "DEFAULT_DRAWER_UNAVAILABLE", "CURRENCY_MISMATCH", "SHIFT_NOT_OPEN", "SERVICE_BILLING_PRODUCTS_UNAVAILABLE", "CATEGORY_NOT_FOUND", "CATEGORY_DISABLED", "CATEGORY_DISABLE_IN_PROGRESS", "SERVICE_BILLING_PRODUCT_IN_BASKET", "SERVICE_DELIVERY_BASKET_DECISION_REQUIRED", "SERVICE_DELIVERY_BASKET_CURRENCY_MISMATCH", "PRODUCT_NOT_AVAILABLE", "PRODUCT_SALE_LIMIT_EXCEEDED", "PRODUCT_SALE_LIMIT_INVALID", "FX_CONVERSION_UNAVAILABLE", "TRANSACT_ITEMS_LIMIT_EXCEEDED", "SERVICE_PARTS_RESTORE_EXCEEDS_CONSUMED", "SERVICE_PARTS_RESTORE_EXCEEDS_AMOUNT", "SERVICE_PARTS_STOCK_INSUFFICIENT", "SERVICE_PARTS_PRODUCT_NOT_FOUND", "SERVICE_PARTS_LEDGER_FULL", "SERVICE_PARTS_TOO_MANY", "SERVICE_ORDER_PARTS_CHANGED", "SERVICE_QUOTE_NOT_FOUND", "SERVICE_QUOTE_NOT_OFFERABLE", "SERVICE_QUOTE_HOLDS_TOO_MANY", "SERVICE_QUOTE_SUPERSEDED", "SERVICE_QUOTE_ALREADY_RESOLVED", "SERVICE_QUOTE_LAPSED", "SERVICE_QUOTE_CHANNEL_RESERVED", "SERVICE_QUOTE_CHANNEL_NOT_APPLICABLE", "SERVICE_QUOTE_REASON_NOT_APPLICABLE", "SERVICE_ORDER_QUOTE_CHANGED", "SERVICE_ORDER_NOT_READY", "SERVICE_RENOTIFY_IMPERSONATED", "SERVICE_RENOTIFY_TOO_SOON", "SERVICE_RENOTIFY_CONFLICT", "SERVICE_RENOTIFY_NOT_RECORDED", "SERVICE_RENOTIFY_LEDGER_UNREADABLE", "SERVICE_RENOTIFY_NOT_DISPATCHED", "SERVICE_TIMER_ALREADY_RUNNING", "SERVICE_TIMER_NOT_RUNNING", "SERVICE_TIMER_STOP_CONFLICT", "TECHNICIAN_NOT_CLOCKED_IN", "SERVICE_ORDER_GONE", "SERVICE_WORKLOG_NOT_FOUND", "SERVICE_WORKLOG_NOT_REVERSIBLE", "SERVICE_WORKLOG_ALREADY_REVERSED", "SERVICE_ORDER_WORKLOG_CHANGED", "CART_PROMOTION_UNAVAILABLE", "COUPON_NOT_FOUND", "COUPON_NOT_ACTIVE", "COUPON_EXPIRED", "COUPON_EXHAUSTED", "COUPON_EXHAUSTED_AT_CHECKOUT", "COUPON_MIN_SUBTOTAL", "COUPON_REQUIRES_CUSTOMER", "COUPON_BUDGET_EXHAUSTED", "COUPON_CURRENCY_MISMATCH"];
+export declare const SERVICE_ORDER_ERROR_CODES: readonly ["UNIT_QUANTITY_NOT_WHOLE", "UNIT_REVISION_STALE", "ROLE_FORBIDDEN", "PARENT_FILTER_CONFLICT", "VALIDATION_FAILED", "INVALID_CURSOR", "INVALID_FROM_DATE", "INVALID_TO_DATE", "INVALID_DATE_RANGE", "REWORK_INDEX_UNAVAILABLE", "STORE_NOT_FOUND", "SERVICE_ORDER_NOT_FOUND", "CUSTOMER_NOT_FOUND", "PARENT_SERVICE_ORDER_NOT_FOUND", "SERVICE_TEMPLATE_NOT_FOUND", "SERVICE_TYPE_REQUIRED", "INVALID_IMAGE_REFERENCE", "MISSING_STORE_CONTEXT", "WARRANTY_BELOW_LEGAL_MINIMUM", "TECHNICIAN_NOT_FOUND", "TECHNICIAN_NOT_ELIGIBLE", "CUSTODY_ILLEGAL_TRANSITION", "SERVICE_ORDER_BILLABLE_FROZEN", "SERVICE_ORDER_EDIT_CHANGED", "SERVICE_ORDER_DISABLED_STATE_UNCHANGED", "APPOINTMENT_NOT_FOUND", "APPOINTMENT_NOT_LINKABLE", "APPOINTMENT_NOT_OPEN", "APPOINTMENT_CUSTOMER_MISMATCH", "APPOINTMENT_VERSION_CONFLICT", "SERVICE_ORDER_TERMINAL", "SERVICE_ORDER_DISABLED", "SERVICE_ORDER_ILLEGAL_TRANSITION", "SERVICE_ORDER_STATUS_CHANGED", "SERVICE_ORDER_OUTCOME_REQUIRED", "SERVICE_ORDER_OUTCOME_NOT_ALLOWED", "SERVICE_ORDER_CUSTODY_NOT_RECEIVED", "SERVICE_ORDER_BILLABLE_NOT_AT_THIS_TRANSITION", "PAYMENT_METHODS_NOT_CONFIGURED", "PAYMENT_METHOD_NOT_FOUND", "SERVICE_ORDER_DEPOSIT_CHANGED", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSE", "IDEMPOTENCY_IN_PROGRESS", "IDEMPOTENCY_KEY_FAILED", "IDEMPOTENCY_LOCK_CONTENTION", "SERVICE_DEPOSIT_CURRENCY_MISMATCH", "SERVICE_DEPOSIT_INVALID", "INVALID_AMOUNT", "DEFAULT_DRAWER_UNAVAILABLE", "CURRENCY_MISMATCH", "SHIFT_NOT_OPEN", "SERVICE_BILLING_PRODUCTS_UNAVAILABLE", "CATEGORY_NOT_FOUND", "CATEGORY_DISABLED", "CATEGORY_DISABLE_IN_PROGRESS", "SERVICE_BILLING_PRODUCT_IN_BASKET", "SERVICE_DELIVERY_BASKET_DECISION_REQUIRED", "SERVICE_DELIVERY_BASKET_CURRENCY_MISMATCH", "PRODUCT_NOT_AVAILABLE", "PRODUCT_SALE_LIMIT_EXCEEDED", "PRODUCT_SALE_LIMIT_INVALID", "FX_CONVERSION_UNAVAILABLE", "TRANSACT_ITEMS_LIMIT_EXCEEDED", "SERVICE_LINE_PRICE_TOO_LARGE", "SERVICE_PARTS_RESTORE_EXCEEDS_CONSUMED", "SERVICE_PARTS_RESTORE_EXCEEDS_AMOUNT", "SERVICE_PARTS_STOCK_INSUFFICIENT", "SERVICE_PARTS_PRODUCT_NOT_FOUND", "SERVICE_PARTS_LEDGER_FULL", "SERVICE_PARTS_TOO_MANY", "SERVICE_ORDER_PARTS_CHANGED", "SERVICE_QUOTE_NOT_FOUND", "SERVICE_QUOTE_NOT_OFFERABLE", "SERVICE_QUOTE_HOLDS_TOO_MANY", "SERVICE_QUOTE_SUPERSEDED", "SERVICE_QUOTE_ALREADY_RESOLVED", "SERVICE_QUOTE_LAPSED", "SERVICE_QUOTE_CHANNEL_RESERVED", "SERVICE_QUOTE_CHANNEL_NOT_APPLICABLE", "SERVICE_QUOTE_REASON_NOT_APPLICABLE", "SERVICE_ORDER_QUOTE_CHANGED", "SERVICE_ORDER_NOT_READY", "SERVICE_RENOTIFY_IMPERSONATED", "SERVICE_RENOTIFY_TOO_SOON", "SERVICE_RENOTIFY_CONFLICT", "SERVICE_RENOTIFY_NOT_RECORDED", "SERVICE_RENOTIFY_LEDGER_UNREADABLE", "SERVICE_RENOTIFY_NOT_DISPATCHED", "SERVICE_TIMER_ALREADY_RUNNING", "SERVICE_TIMER_NOT_RUNNING", "SERVICE_TIMER_STOP_CONFLICT", "TECHNICIAN_NOT_CLOCKED_IN", "SERVICE_ORDER_GONE", "SERVICE_WORKLOG_NOT_FOUND", "SERVICE_WORKLOG_NOT_REVERSIBLE", "SERVICE_WORKLOG_ALREADY_REVERSED", "SERVICE_ORDER_WORKLOG_CHANGED", "CART_PROMOTION_UNAVAILABLE", "COUPON_NOT_FOUND", "COUPON_NOT_ACTIVE", "COUPON_EXPIRED", "COUPON_EXHAUSTED", "COUPON_EXHAUSTED_AT_CHECKOUT", "COUPON_MIN_SUBTOTAL", "COUPON_REQUIRES_CUSTOMER", "COUPON_BUDGET_EXHAUSTED", "COUPON_CURRENCY_MISMATCH"];
 export type ServiceOrderErrorCode = (typeof SERVICE_ORDER_ERROR_CODES)[number];
 export {};

package/dist/serviceOrder.js

@@ -194,6 +194,10 @@ export const MAX_SERVICE_PICTURES = 20;
  *   the ticket (`data.basketCurrency`, `data.serviceCurrency`). Nothing was
  *   written and no order number was minted; bill the cart separately or resend
  *   with `includeBasket: false`.
+ * - `SERVICE_LINE_PRICE_TOO_LARGE` · 400 — the `ready → delivered` handover
+ *   would mint an order line (`data.line`: `'labor'` or `'parts'`, at
+ *   `data.amount`) above `data.max`, the line price order edit accepts. Nothing
+ *   was written and no order number was minted; split the work across tickets.
  * - `SERVICE_RENOTIFY_*` — `mode: 'renotify'`. `_TOO_SOON` (429) carries
  *   `lastNotifiedAt` and `retryAfterMs`; `_IMPERSONATED` (403) means a support
  *   session cannot message the customer — the store must resend it itself;
@@ -334,6 +338,7 @@ export const SERVICE_ORDER_ERROR_CODES = [
     'PRODUCT_SALE_LIMIT_INVALID',
     'FX_CONVERSION_UNAVAILABLE',
     'TRANSACT_ITEMS_LIMIT_EXCEEDED',
+    'SERVICE_LINE_PRICE_TOO_LARGE',
     // Parts
     'SERVICE_PARTS_RESTORE_EXCEEDS_CONSUMED',
     'SERVICE_PARTS_RESTORE_EXCEEDS_AMOUNT',

package/dist/storefrontDesign.d.ts

@@ -336,6 +336,11 @@ declare global {
     type StorefrontDesignErrorCode = 'STOREFRONT_DESIGN_INVALID' | 'STOREFRONT_SCHEMA_UNSUPPORTED' | 'STOREFRONT_REVISION_CONFLICT' | 'STOREFRONT_DRAFT_NOT_INITIALIZED' | 'STOREFRONT_REQUEST_EXPIRED' | 'STOREFRONT_PUBLICATION_NOT_FOUND'
     /** Web `GET /store` and `GET /literals` `503`: the stored publication cannot be served; retry later. */
      | 'STOREFRONT_PUBLICATION_UNAVAILABLE' | 'STOREFRONT_OPERATION_NOT_FOUND' | 'STOREFRONT_DRAFT_UNAVAILABLE' | 'IDEMPOTENCY_CONFLICT' | 'STOREFRONT_EDITOR_REQUIRED' | 'STOREFRONT_ASSET_NOT_READY' | 'STOREFRONT_PREVIEW_EXPIRED' | 'STOREFRONT_PREVIEW_REVOKED' | 'STOREFRONT_PREVIEW_FORBIDDEN' | 'STOREFRONT_PREVIEW_UNAVAILABLE';
+    /**
+     * A legacy value the editor baseline could not carry. The baseline no longer reports one: every
+     * such value falls back to its default, so a fresh `mappingConflicts` is `[]`. The type stays for a
+     * draft stored before that change, which keeps its conflicts until it is discarded.
+     */
     interface StorefrontDesignMappingConflict {
         path: string;
         code: 'LEGACY_MULTIPLE_PRODUCT_FEEDS' | 'LEGACY_UNMAPPED_CONTENT';
@@ -344,8 +349,10 @@ declare global {
     interface StorefrontEditorBaseline {
         legacyRevision?: number;
         document: StorefrontDesignV1;
+        /** 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. */
         legacyLogo?: {
             source: 'store.photoURL';
             key: string;
@@ -386,6 +393,7 @@ declare global {
         publishedRevision: null;
         document: StorefrontDesignV1;
         dirty: false;
+        /** Always `[]` (see `StorefrontEditorBaseline`). */
         mappingConflicts: StorefrontDesignMappingConflict[];
         legacySourceRevision: string;
     }
@@ -425,6 +433,7 @@ declare global {
         publishedRevision: string | null;
         document: StorefrontDesignV1;
         dirty: boolean;
+        /** Empty for a draft seeded now; only a draft stored before the baseline stopped reporting conflicts carries any. */
         mappingConflicts: StorefrontDesignMappingConflict[];
         legacySourceRevision: string;
         /**
@@ -440,7 +449,7 @@ declare global {
          * content, a link to a disabled or missing page (`DANGLING_REFERENCE`), a slug a published
          * page still owns (`ALIAS_CONFLICT`), a page out of aliases (`ALIAS_LIMIT`), and one
          * `MAPPING_CONFLICT` per unresolved `mappingConflicts` entry, at that entry's path (the
-         * publish refusal itself names the single path `mappingConflicts`). Empty when publishable.
+         * publish refusal itself names the single path `mappingConflicts`; a draft seeded now has none). Empty when publishable.
          * Never blocks a save, and never covers asset readiness, which publish probes on its own
          * (`STOREFRONT_ASSET_NOT_READY`).
          */
@@ -461,6 +470,7 @@ 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. */
         changeSummary: {
             contrastAdjustments: StorefrontThemeWarning[];
         };

package/dist/storefrontTheme.d.ts

@@ -71,7 +71,13 @@ export declare const resolveStorefrontEffectiveSettings: (overrides?: Partial<St
  * resolves defaults plus the design only — correct solely while no GLOBAL design setting
  * is set, so a caller serving or reporting on a storefront passes the row (the edge
  * renderer's `theme-color` is the one exception, design-only by its read grant). Passing
- * already-effective settings as `overrides` rebuilds the same theme.
+ * 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
+ * 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.
  */
 export declare const resolveStorefrontTheme: (overrides?: Partial<StorefrontDesignSettings>, globalsRow?: Record<string, unknown>) => StorefrontResolvedTheme;
 export {};

package/dist/storefrontTheme.js

@@ -1,4 +1,14 @@
 import { resolveStorefrontDesignSettings, validateStorefrontDesignSetting, } from "./storefrontDesignRegistry.js";
+const WARNING_SETTING = {
+    link: 'primaryColor',
+    button: 'primaryColor',
+    focus: 'accentColor',
+};
+const SURFACE_SETTING = {
+    page: 'backgroundColor',
+    header: 'headerColor',
+    footer: 'footerColor',
+};
 const channels = (color) => [
     Number.parseInt(color.slice(1, 3), 16),
     Number.parseInt(color.slice(3, 5), 16),
@@ -88,7 +98,13 @@ export const resolveStorefrontEffectiveSettings = (overrides = {}, globalsRow) =
  * resolves defaults plus the design only — correct solely while no GLOBAL design setting
  * is set, so a caller serving or reporting on a storefront passes the row (the edge
  * renderer's `theme-color` is the one exception, design-only by its read grant). Passing
- * already-effective settings as `overrides` rebuilds the same theme.
+ * 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
+ * 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.
  */
 export const resolveStorefrontTheme = (overrides = {}, globalsRow) => {
     const settings = resolveStorefrontEffectiveSettings(overrides, globalsRow);
@@ -121,6 +137,6 @@ export const resolveStorefrontTheme = (overrides = {}, globalsRow) => {
         },
         shape: { borderRadius: 4 },
         spacing: 8,
-        warnings,
+        warnings: warnings.filter(({ role, surface }) => overrides[WARNING_SETTING[role]] !== undefined || overrides[SURFACE_SETTING[surface]] !== undefined),
     };
 };

package/package.json

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