platform-types 1.10.686 → 1.10.688

package/dist/cjs/storefrontAssets.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MAX_STOREFRONT_ASSETS = exports.STOREFRONT_ASSET_VARIANTS = void 0;
+exports.MAX_STOREFRONT_ASSETS = exports.STOREFRONT_ASSET_VARIANT_FIT = exports.STOREFRONT_ASSET_VARIANTS = void 0;
 const storefrontDesign_ts_1 = require("./storefrontDesign.js");
 exports.STOREFRONT_ASSET_VARIANTS = [
     'original',
@@ -9,6 +9,31 @@ exports.STOREFRONT_ASSET_VARIANTS = [
     '800x800',
     '1200x1200',
     '1600x1600',
+    '1200x630',
+    '192x192',
+    '512x512',
 ];
+/**
+ * How each variant is rendered from the stored original. `original` is the
+ * stored image unchanged in size. `inside` is a thumbnail: it fits inside the
+ * box keeping its aspect and never enlarges, so a small original comes back at
+ * its own size. `1200x630` is `cover`: an EXACT-size crop for share images
+ * (`og:image`), enlarged when the original is smaller. `192x192` and `512x512`
+ * are `contain`: EXACT-size icons (favicon, PWA manifest), not thumbnails —
+ * the whole original is scaled to fit and the rest of the square is padded
+ * transparent, so nothing is cropped; they are always PNG, or WebP when the
+ * client accepts it, because a JPEG cannot carry the transparent padding.
+ */
+exports.STOREFRONT_ASSET_VARIANT_FIT = {
+    original: 'original',
+    '200x200': 'inside',
+    '400x400': 'inside',
+    '800x800': 'inside',
+    '1200x1200': 'inside',
+    '1600x1600': 'inside',
+    '1200x630': 'cover',
+    '192x192': 'contain',
+    '512x512': 'contain',
+};
 /** The active-asset cap, the same value as `STOREFRONT_DESIGN_LIMITS.activeImages` by construction. */
 exports.MAX_STOREFRONT_ASSETS = storefrontDesign_ts_1.STOREFRONT_DESIGN_LIMITS.activeImages;

package/dist/cjs/storefrontDesign.js

@@ -7,6 +7,8 @@ exports.parseStorefrontPreviewMessage = parseStorefrontPreviewMessage;
 exports.acceptStorefrontPreviewMessage = acceptStorefrontPreviewMessage;
 exports.STOREFRONT_DESIGN_LIMITS = {
     customPages: 20,
+    pageAliases: 20,
+    pageAliasMetadataBytes: 64 * 1024,
     sectionsPerPage: 10,
     productCountMin: 4,
     productCountMax: 24,
@@ -166,10 +168,28 @@ const previewRecord = (value) => value !== null &&
     typeof value === 'object' &&
     !Array.isArray(value) &&
     (Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null);
+// UTF-8 length without TextEncoder: the contracts compile with no DOM or Node lib, so a
+// runtime global here breaks every program that type-checks them. A lone surrogate
+// counts 3, as TextEncoder's U+FFFD replacement does.
+function previewUtf8Bytes(text) {
+    let bytes = 0;
+    for (const char of text) {
+        const code = char.codePointAt(0) ?? 0;
+        if (code < 0x80)
+            bytes += 1;
+        else if (code < 0x800)
+            bytes += 2;
+        else if (code < 0x10000)
+            bytes += 3;
+        else
+            bytes += 4;
+    }
+    return bytes;
+}
 function previewWithinBytes(value, maximum) {
     try {
         const serialized = JSON.stringify(value);
-        return serialized !== undefined && new TextEncoder().encode(serialized).byteLength <= maximum;
+        return serialized !== undefined && previewUtf8Bytes(serialized) <= maximum;
     }
     catch {
         return false;

package/dist/storefrontAssets.d.ts

@@ -1,4 +1,26 @@
-export declare const STOREFRONT_ASSET_VARIANTS: readonly ["original", "200x200", "400x400", "800x800", "1200x1200", "1600x1600"];
+export declare const STOREFRONT_ASSET_VARIANTS: readonly ["original", "200x200", "400x400", "800x800", "1200x1200", "1600x1600", "1200x630", "192x192", "512x512"];
+/**
+ * How each variant is rendered from the stored original. `original` is the
+ * stored image unchanged in size. `inside` is a thumbnail: it fits inside the
+ * box keeping its aspect and never enlarges, so a small original comes back at
+ * its own size. `1200x630` is `cover`: an EXACT-size crop for share images
+ * (`og:image`), enlarged when the original is smaller. `192x192` and `512x512`
+ * are `contain`: EXACT-size icons (favicon, PWA manifest), not thumbnails —
+ * the whole original is scaled to fit and the rest of the square is padded
+ * transparent, so nothing is cropped; they are always PNG, or WebP when the
+ * client accepts it, because a JPEG cannot carry the transparent padding.
+ */
+export declare const STOREFRONT_ASSET_VARIANT_FIT: {
+    readonly original: "original";
+    readonly '200x200': "inside";
+    readonly '400x400': "inside";
+    readonly '800x800': "inside";
+    readonly '1200x1200': "inside";
+    readonly '1600x1600': "inside";
+    readonly '1200x630': "cover";
+    readonly '192x192': "contain";
+    readonly '512x512': "contain";
+};
 /** The active-asset cap, the same value as `STOREFRONT_DESIGN_LIMITS.activeImages` by construction. */
 export declare const MAX_STOREFRONT_ASSETS: 200;
 declare global {

package/dist/storefrontAssets.js

@@ -6,6 +6,31 @@ export const STOREFRONT_ASSET_VARIANTS = [
     '800x800',
     '1200x1200',
     '1600x1600',
+    '1200x630',
+    '192x192',
+    '512x512',
 ];
+/**
+ * How each variant is rendered from the stored original. `original` is the
+ * stored image unchanged in size. `inside` is a thumbnail: it fits inside the
+ * box keeping its aspect and never enlarges, so a small original comes back at
+ * its own size. `1200x630` is `cover`: an EXACT-size crop for share images
+ * (`og:image`), enlarged when the original is smaller. `192x192` and `512x512`
+ * are `contain`: EXACT-size icons (favicon, PWA manifest), not thumbnails —
+ * the whole original is scaled to fit and the rest of the square is padded
+ * transparent, so nothing is cropped; they are always PNG, or WebP when the
+ * client accepts it, because a JPEG cannot carry the transparent padding.
+ */
+export const STOREFRONT_ASSET_VARIANT_FIT = {
+    original: 'original',
+    '200x200': 'inside',
+    '400x400': 'inside',
+    '800x800': 'inside',
+    '1200x1200': 'inside',
+    '1600x1600': 'inside',
+    '1200x630': 'cover',
+    '192x192': 'contain',
+    '512x512': 'contain',
+};
 /** The active-asset cap, the same value as `STOREFRONT_DESIGN_LIMITS.activeImages` by construction. */
 export const MAX_STOREFRONT_ASSETS = STOREFRONT_DESIGN_LIMITS.activeImages;

package/dist/storefrontDesign.d.ts

@@ -1,6 +1,8 @@
 import type { StorefrontThemeWarning } from './storefrontTheme.ts';
 export declare const STOREFRONT_DESIGN_LIMITS: {
     readonly customPages: 20;
+    readonly pageAliases: 20;
+    readonly pageAliasMetadataBytes: number;
     readonly sectionsPerPage: 10;
     readonly productCountMin: 4;
     readonly productCountMax: 24;
@@ -180,7 +182,12 @@ declare global {
             content: StorefrontDesignSectionContent[K];
         };
     }[StorefrontDesignSectionType];
+    interface StorefrontDesignPublicationMetadata {
+        pageAliases: Record<string, string[]>;
+        pageSlugs: Record<string, string>;
+    }
     interface StorefrontDesignSeo {
+        noindex?: boolean;
         title?: string;
         description?: string;
         image?: StorefrontDesignImagePlacement;
@@ -213,6 +220,7 @@ declare global {
         links: StorefrontDesignMenuLink[];
     }
     interface StorefrontContactHours {
+        /** `days` are ISO 8601 weekdays, 1 = Monday … 7 = Sunday (unique per row); `opens` is before `closes`. */
         rows: {
             days: number[];
             opens: string;
@@ -310,7 +318,8 @@ declare global {
         seo: StorefrontDesignSeo;
         literalOverrides: Record<string, string>;
     }
-    type StorefrontDesignFieldErrorCode = 'INVALID' | 'REQUIRED' | 'UNKNOWN_KEY' | 'DUPLICATE' | 'RESERVED_SLUG' | 'DANGLING_REFERENCE' | 'MAPPING_CONFLICT' | 'TOO_LARGE';
+    /** `TOO_LARGE` at path `''` means the whole stored draft would exceed its row budget, not one field. */
+    type StorefrontDesignFieldErrorCode = 'INVALID' | 'REQUIRED' | 'UNKNOWN_KEY' | 'DUPLICATE' | 'RESERVED_SLUG' | 'ALIAS_CONFLICT' | 'ALIAS_LIMIT' | 'DANGLING_REFERENCE' | 'MAPPING_CONFLICT' | 'TOO_LARGE';
     interface StorefrontDesignFieldError {
         path: string;
         code: StorefrontDesignFieldErrorCode;
@@ -359,6 +368,10 @@ declare global {
     interface StorefrontDesignPreviewInput {
         draftRevision: string;
     }
+    /**
+     * GET draft answers a baseline built without copying the legacy logo, while POST init copies it,
+     * so `document.branding.logo` can differ between them: clients rebase onto init's document.
+     */
     interface StorefrontDesignBaselineResult {
         draftRevision: null;
         publishedRevision: null;

package/dist/storefrontDesign.js

@@ -1,5 +1,7 @@
 export const STOREFRONT_DESIGN_LIMITS = {
     customPages: 20,
+    pageAliases: 20,
+    pageAliasMetadataBytes: 64 * 1024,
     sectionsPerPage: 10,
     productCountMin: 4,
     productCountMax: 24,
@@ -159,10 +161,28 @@ const previewRecord = (value) => value !== null &&
     typeof value === 'object' &&
     !Array.isArray(value) &&
     (Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null);
+// UTF-8 length without TextEncoder: the contracts compile with no DOM or Node lib, so a
+// runtime global here breaks every program that type-checks them. A lone surrogate
+// counts 3, as TextEncoder's U+FFFD replacement does.
+function previewUtf8Bytes(text) {
+    let bytes = 0;
+    for (const char of text) {
+        const code = char.codePointAt(0) ?? 0;
+        if (code < 0x80)
+            bytes += 1;
+        else if (code < 0x800)
+            bytes += 2;
+        else if (code < 0x10000)
+            bytes += 3;
+        else
+            bytes += 4;
+    }
+    return bytes;
+}
 function previewWithinBytes(value, maximum) {
     try {
         const serialized = JSON.stringify(value);
-        return serialized !== undefined && new TextEncoder().encode(serialized).byteLength <= maximum;
+        return serialized !== undefined && previewUtf8Bytes(serialized) <= maximum;
     }
     catch {
         return false;

package/package.json

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