Skip to content

An open source design system that's fully customizable and agent ready

TypeScript

fix(docsite): use CORS-safe demo media for Thumbnail image examples (#3227)

Cindy Zhang41b27ebde735
diff --git a/package.json b/package.json
index 0551cc7f36..6b45c8ec4f 100644
--- a/package.json
+++ b/package.json
@@ -11,8 +11,9 @@
"test:watch": "vitest",
"test:coverage": "vitest --coverage",
"check:package-boundaries": "node scripts/check-package-boundaries.js",
- "check:repo": "pnpm check:sync && pnpm check:package-boundaries && pnpm check:changesets",
+ "check:repo": "pnpm check:sync && pnpm check:package-boundaries && pnpm check:changesets && pnpm check:demo-media",
"check:changesets": "node scripts/check-changesets.mjs",
+ "check:demo-media": "node scripts/check-demo-media.mjs",
"check:sync": "node scripts/check-sync.js",
"lint": "pnpm check:repo && eslint . --cache",
"lint:strict": "pnpm check:repo && ASTRYX_STRICT_LINT=1 eslint . --cache",
diff --git a/packages/cli/templates/blocks/components/Thumbnail/ThumbnailDisabled.tsx b/packages/cli/templates/blocks/components/Thumbnail/ThumbnailDisabled.tsx
index 5a499a4f6b..6a3173a3be 100644
--- a/packages/cli/templates/blocks/components/Thumbnail/ThumbnailDisabled.tsx
+++ b/packages/cli/templates/blocks/components/Thumbnail/ThumbnailDisabled.tsx
@@ -6,6 +6,11 @@ import {Thumbnail} from '@astryxdesign/core/Thumbnail';
import {Stack} from '@astryxdesign/core/Layout';
import {Text} from '@astryxdesign/core/Text';
+// Inline same-origin data URI so the example is self-contained — see
+// ThumbnailRemovable for why image-backed Thumbnails avoid cross-origin URLs.
+const GOLDEN_SUNSET =
+ 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAMAAACdt4HsAAAAkFBMVEX/+uv/7sj6tFr3sVn1r1nzrVjxq1jvqVftp1frpVbpo1bnoVXln1XjnVThm1TfmVPdl1PblVLZk1LXkVLVj1HTjVHRi1DPiVDNh0/LhU/Jg07HgU7Ff03DfU3Be0y/eUy9d0u7dUu5c0u2cEq0bkqybEmwakmuaEisZkiqZEeoYkemYEakXkaiXEVgLjQ8HCjaJlMkAAABI0lEQVR42u3Mx3qDMBSE0Z/03nsvdhxjcnn/twsYjISR5MUkO5+V9N2ZYUPEpogtEdsidkTsitgTsS/iQMShiCMRxyJORJyKOBNxLuJCxKWIKxHXIm5E3Iq4E3Ev4kHEo4gnEc8iXkS8inhLymrJBO8J2UIiw0dc5sRDfEbVRWr1o/pbMMWox9yz6zcLIzMbBTD2VaHu7fr1gjXGA3w5baj5+H0w6x09TDpdaP7rDZhn0sd3y89Y9fcHbPnoYdroZ2w6dQNmg6OHfG4QyrsBC8gdZpVQxtqF4M1mjepFURThTLNgMYsePxaX2WqY6D8GSm2grK2slbGBciHZ9hOE2smNpTuxenhieCdeH06E7qTqvYnImWTbbUSPlKL1wHrgTwZ+AWq+3H5MpRkwAAAAAElFTkSuQmCC';
+
export default function ThumbnailDisabled() {
return (
<Stack direction="vertical" gap={4}>
@@ -15,9 +20,9 @@ export default function ThumbnailDisabled() {
</Text>
<Stack direction="horizontal" gap={3} vAlign="center">
<Thumbnail
- src="https://lookaside.facebook.com/assets/astryx/moody-scene-vertical-2.png"
- alt="Bright landscape"
- label="landscape.jpg"
+ src={GOLDEN_SUNSET}
+ alt="Golden sunset over mountains"
+ label="golden-sunset.jpg"
onRemove={() => {}}
/>
<Thumbnail label="document.pdf" onRemove={() => {}} />
@@ -29,9 +34,9 @@ export default function ThumbnailDisabled() {
</Text>
<Stack direction="horizontal" gap={3} vAlign="center">
<Thumbnail
- src="https://lookaside.facebook.com/assets/astryx/moody-scene-vertical-2.png"
- alt="Bright landscape"
- label="landscape.jpg"
+ src={GOLDEN_SUNSET}
+ alt="Golden sunset over mountains"
+ label="golden-sunset.jpg"
onRemove={() => {}}
isDisabled
/>
diff --git a/packages/cli/templates/blocks/components/Thumbnail/ThumbnailGallery.tsx b/packages/cli/templates/blocks/components/Thumbnail/ThumbnailGallery.tsx
index fd1e62b718..abb32e114a 100644
--- a/packages/cli/templates/blocks/components/Thumbnail/ThumbnailGallery.tsx
+++ b/packages/cli/templates/blocks/components/Thumbnail/ThumbnailGallery.tsx
@@ -7,30 +7,46 @@ import {Thumbnail} from '@astryxdesign/core/Thumbnail';
import {Stack} from '@astryxdesign/core/Layout';
import {Text} from '@astryxdesign/core/Text';
+// Demo imagery is inlined as same-origin data URIs so the example is
+// self-contained. Thumbnail's remove-button overlay uses useImageMode, which
+// FETCHES the image to sample pixels (APCA) for contrast — a cross-origin CDN
+// URL without CORS headers cannot be fetched/sampled, so contrast detection
+// fails silently in hosted previews. These scenes are shared verbatim across
+// the Thumbnail examples and span a luminance ramp (night → snow) so the
+// overlay's contrast adaptation is visible.
+const NIGHT_FOREST =
+ 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAMAAACdt4HsAAAAwFBMVEX18+H08uDy8d/y8N/v7t/m5NXl49Tk4tPc3NDX1cnW1cnW1cjW1MjV1MjV1MfR0cXIyLzEw7m8vLC3t68wM0QvM0MvM0IvMkIuMkEtMEErLz8iJjkhJTggJTcgJDcfJDYfIzYeIjUcITMbHzIWHiwYGzIXGjEWGjAWGTAVGS8VGC8UGC4UGC0UFy4TFy0TFywTFi0SFiwRFSsQFSkNFR4QFCoPFCkPFCgPEykOEygOEigNEicNEScMESYIDw8ECgr+gzZIAAABqElEQVR42uWQ61aCQBRGD5GylNBMKS9FZgNdNE0cyUvB+79VM8MoF9Fgplau2j/8nO8c9hqAD0ngDwjeJYH1lrfBWoCtYDboNu/Zv7qQYNap1bpCN1gxFh1dNe5WAsCScWqoWttbChAKvHZZ0W6XQoIFpW8ooFmLCG2Rl1BgaZAU5Ac8yg0RlC9nngCRQDFuhQRzinWmkCuYk3lxQoFrlskVqlcTMcEFvYIKoFbNfmEFuIypWaGGkt66tqZuEbjAHZl6SQVF1WqNvpDAHVktXTvR9JbgDZii1+tZI7cYMJXkCASvksB4L5VxHmAsibzgRRIYbjgfCgFDSeBZkh8W1HMIniSBR0mOQPCQA3RgBk4M5DhNZwdEcbKgLXy5iDiZg5gApRYbqTql2FZgMxAKeEWSNUFYx3s2SfU28HPWItrpySSwE2cEdqrYtxgmxgHGScFmHrAGk8SxczIxZnNC1McFOGshShyb4yxB9sI3CXDGnH0MLsD7F5LvvptEgH12Zg1Pn2WuHsjvrwt8308t+nwxT38sgiAE8/RTeagH+vx/F8SeF0Ja8Ak14ia/LgmpZQAAAABJRU5ErkJggg==';
+const MISTY_VALLEY =
+ 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAMAAACdt4HsAAAAwFBMVEWPnaqJmKSIlaKHlaGGlaKGk6CEkp6Ckp+Cj5uAj51/jZp6i5h8ipd7iZZ4hpR1g5FzhpdzhJN0g5FuhZdsgpVqgZRpgJNpf5JmfpFufYxufYtlfJBpe4tke49neo1ieo5kd4tndoZidopheY1geIxfd4tmdYVddYpcdIlbc4hgcoNebn5ZcodYcYZXb4VVboRUbYNTbIJaantWaXxRa4FQaYBPaH9NZ35UZXZQY3dMZn1LZXxKZHxMYHRKXnIoOEh3WzsBAAABeElEQVR42u3T11oCQQyG4R9FEREFqVJEgh17xbZ7/3cl29gpmQGeeOh7OF+Ss8G3EL6E8CmEdyG8CeFVCC9CeBTCgxDuhXAnhFsh3AjhSgiXQrgQwtlayHrB6TqIyHzCREMTH4rpbxip5nnkRintEUNF0oc8yqnP6Oey3ueQSnlHN6P0ro0Mi4BOSu8dA1mygnbC7G0NMdKEVszuLQXx4oZmhO3NDLlEEY05R280PDGbgD0RaBeI/Bdg7weBMkDLwF4PtBOcwH0gCJZf0DPYdd8Jo8K177hgZbjW+RN2hWffusBVnMR+XE5yfMRx5MPtOOOI0Xd+9ot/rTOiVrtepuabwcDwNFgP6przSH0dqKiOUhUfvaKcO8yVncyM0sK+psSyK4qpPUvRwlUUYrusgoaviG27YMFXNz38I0nc8PNPAFtC2BFClRFWV4cDU5g4WEE0hJ4q1PU8sgmMF0LOmKN2TBOh21RjRsxms3C5WYwrCIX+D/zBgV8HCFv4gVKf1AAAAABJRU5ErkJggg==';
+const GOLDEN_SUNSET =
+ 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAMAAACdt4HsAAAAkFBMVEX/+uv/7sj6tFr3sVn1r1nzrVjxq1jvqVftp1frpVbpo1bnoVXln1XjnVThm1TfmVPdl1PblVLZk1LXkVLVj1HTjVHRi1DPiVDNh0/LhU/Jg07HgU7Ff03DfU3Be0y/eUy9d0u7dUu5c0u2cEq0bkqybEmwakmuaEisZkiqZEeoYkemYEakXkaiXEVgLjQ8HCjaJlMkAAABI0lEQVR42u3Mx3qDMBSE0Z/03nsvdhxjcnn/twsYjISR5MUkO5+V9N2ZYUPEpogtEdsidkTsitgTsS/iQMShiCMRxyJORJyKOBNxLuJCxKWIKxHXIm5E3Iq4E3Ev4kHEo4gnEc8iXkS8inhLymrJBO8J2UIiw0dc5sRDfEbVRWr1o/pbMMWox9yz6zcLIzMbBTD2VaHu7fr1gjXGA3w5baj5+H0w6x09TDpdaP7rDZhn0sd3y89Y9fcHbPnoYdroZ2w6dQNmg6OHfG4QyrsBC8gdZpVQxtqF4M1mjepFURThTLNgMYsePxaX2WqY6D8GSm2grK2slbGBciHZ9hOE2smNpTuxenhieCdeH06E7qTqvYnImWTbbUSPlKL1wHrgTwZ+AWq+3H5MpRkwAAAAAElFTkSuQmCC';
+const SNOWY_PEAKS =
+ 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAMAAACdt4HsAAAAwFBMVEX////6/P/4+//g7vjf7fbf7fTe7fje7fTe7PTd7Pjc7Pfd7PTc6/Xc6/Pb6/fb6/Xb6vTa6/fa6/Xa6vfZ6vfZ6vba6vTZ6fXY6vfY6vbY6ffY6fXX6fbX6fTW6fbX6PXW6PbW6PTV6PbV6PXU6PbV5/XU5/bU5/TU5vXT5/bS5/XT5vTS5vXS5vTR5vXR5fXQ5fXP5fXP5PXO5PXO5PTN5PTN4/TM4/TL4/TM4vTL4vTK4vTO3OqqvtKbrsFcfGgMVnjaAAAC7klEQVR42u2Ta3eaQBCGp0kbTbBBMWDMoiCWEOsFtV4SdcP//1edYQUWwSye9kNOT58POVlm3mdmUWG/3+9et5vVYj6bjoMgGE9n88Vqs33d7SsBcX67WmI+EKBhudpWNcBu94bzlyGO9weEj0uES9zhbVcFSPMYdxzmOKi4xACbNa0/DgY91rGIDusNgjFdY72tAKzXq0U4pTyGm80m/iXDNFys1psqApwf4nwc32x+J9DRYbhDuMRrqIF5vD+zKK0R5LBYfIvFcqUEBZPRsNex9IaW0NCtTm84mqDglxIIQ3z/uEBDqydoDVrBH4d4CyUwowUsA+fXa4I67mBYtAJeQglM4jeg0wLfBLSCLt5COFcC4xffYVZ8gVSABos5/sskVAOjYNjvWrqWxGOFplvd/jD4OZkpgSAYiA1yAtpgGIzGEyW0wYCZeqOeGer1hm6yQUXBD8+1uySofU2okaBre97zSA34nuswk74GqYC+CCZzXM9/VgO+77o2M+LPUcTpUzSYXS3/DB7m4ztomrhEjb7LeAPbdb0KgOe5fTIY6Y8B51O+Xynvgeu6js2Yaep6Q6DrpsmY7biVABthXdPEFfRj3sBTl9nl8JNzLMANSGEahm5QGuNn8/zEAE8xD0g7hrfbdHgqhxO5J/B4BEMtBOv43+M5YkHuCTxk0HwuDGfgvNAAbZljQ/sMnEOhAVoSPKFVCuYBThvgXiKdcF8GlwRZB+Tz8IEhLhca4C6F8yusH0TDXYFjPjEkj+E2gecm8NsT+IkgaQBVQ6F80gA3Ai4uANkl+I0ElYlDjNwAhXyp4Zg/Cg4FAS+dwAsLiPq7PAGuEc5LJ3B+LUjLSf2Q1aGk4V1uyJVTQdYAqgZ5v7T+nu0IuXwmkAwf1yE3IJuQjZDLkiBpAK5o4BUEV6UNh5J8SR1y9VzDoZgvqasFV2frByFQNCgFX/6Q/4J/SxDJTy84/DVBFEmlSw6fRhBFUumiw2cRRJFUuuzwG+qew9oBo+n5AAAAAElFTkSuQmCC';
+
const ATTACHMENTS = [
{
id: 1,
- src: 'https://lookaside.facebook.com/assets/astryx/illustrative-vertical-1.png',
- alt: 'River through a valley',
- label: 'valley.jpg',
+ src: NIGHT_FOREST,
+ alt: 'Forest at night under a crescent moon',
+ label: 'forest-night.jpg',
},
{
id: 2,
- src: 'https://lookaside.facebook.com/assets/astryx/illustrative-vertical-2.png',
- alt: 'Foggy mountain peak',
- label: 'mountain.jpg',
+ src: MISTY_VALLEY,
+ alt: 'Misty mountain valley',
+ label: 'misty-valley.jpg',
},
{
id: 3,
- src: 'https://lookaside.facebook.com/assets/astryx/illustrative-vertical-3.png',
- alt: 'Golden retriever puppy',
- label: 'puppy.jpg',
+ src: GOLDEN_SUNSET,
+ alt: 'Golden sunset over mountains',
+ label: 'golden-sunset.jpg',
},
{
id: 4,
- src: 'https://lookaside.facebook.com/assets/astryx/illustrative-vertical-4.png',
- alt: 'Bridge at sunset',
- label: 'bridge.jpg',
+ src: SNOWY_PEAKS,
+ alt: 'Snowy mountain peaks',
+ label: 'snowy-peaks.jpg',
},
];
@@ -57,9 +73,9 @@ export default function ThumbnailGallery() {
/>
))}
</Stack>
- {selected != null && (
- <Text type="supporting" color="accent">
- Previewing: {selected}
+ {selected && (
+ <Text type="supporting" color="secondary">
+ Selected: {selected}
</Text>
)}
</Stack>
diff --git a/packages/cli/templates/blocks/components/Thumbnail/ThumbnailRemovable.tsx b/packages/cli/templates/blocks/components/Thumbnail/ThumbnailRemovable.tsx
index 5e3d676d61..02d75af854 100644
--- a/packages/cli/templates/blocks/components/Thumbnail/ThumbnailRemovable.tsx
+++ b/packages/cli/templates/blocks/components/Thumbnail/ThumbnailRemovable.tsx
@@ -7,10 +7,47 @@ import {Thumbnail} from '@astryxdesign/core/Thumbnail';
import {Stack} from '@astryxdesign/core/Layout';
import {Text} from '@astryxdesign/core/Text';
+// Demo imagery is inlined as same-origin data URIs so the example is
+// self-contained. Thumbnail's remove-button overlay uses useImageMode, which
+// FETCHES the image to sample pixels (APCA) for contrast — a cross-origin CDN
+// URL without CORS headers cannot be fetched/sampled, so contrast detection
+// fails silently in hosted previews. These scenes are shared verbatim across
+// the Thumbnail examples and span a luminance ramp (night → snow) so the
+// overlay's contrast adaptation is visible.
+const NIGHT_FOREST =
+ 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAMAAACdt4HsAAAAwFBMVEX18+H08uDy8d/y8N/v7t/m5NXl49Tk4tPc3NDX1cnW1cnW1cjW1MjV1MjV1MfR0cXIyLzEw7m8vLC3t68wM0QvM0MvM0IvMkIuMkEtMEErLz8iJjkhJTggJTcgJDcfJDYfIzYeIjUcITMbHzIWHiwYGzIXGjEWGjAWGTAVGS8VGC8UGC4UGC0UFy4TFy0TFywTFi0SFiwRFSsQFSkNFR4QFCoPFCkPFCgPEykOEygOEigNEicNEScMESYIDw8ECgr+gzZIAAABqElEQVR42uWQ61aCQBRGD5GylNBMKS9FZgNdNE0cyUvB+79VM8MoF9Fgplau2j/8nO8c9hqAD0ngDwjeJYH1lrfBWoCtYDboNu/Zv7qQYNap1bpCN1gxFh1dNe5WAsCScWqoWttbChAKvHZZ0W6XQoIFpW8ooFmLCG2Rl1BgaZAU5Ac8yg0RlC9nngCRQDFuhQRzinWmkCuYk3lxQoFrlskVqlcTMcEFvYIKoFbNfmEFuIypWaGGkt66tqZuEbjAHZl6SQVF1WqNvpDAHVktXTvR9JbgDZii1+tZI7cYMJXkCASvksB4L5VxHmAsibzgRRIYbjgfCgFDSeBZkh8W1HMIniSBR0mOQPCQA3RgBk4M5DhNZwdEcbKgLXy5iDiZg5gApRYbqTql2FZgMxAKeEWSNUFYx3s2SfU28HPWItrpySSwE2cEdqrYtxgmxgHGScFmHrAGk8SxczIxZnNC1McFOGshShyb4yxB9sI3CXDGnH0MLsD7F5LvvptEgH12Zg1Pn2WuHsjvrwt8308t+nwxT38sgiAE8/RTeagH+vx/F8SeF0Ja8Ak14ia/LgmpZQAAAABJRU5ErkJggg==';
+const MISTY_VALLEY =
+ 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAMAAACdt4HsAAAAwFBMVEWPnaqJmKSIlaKHlaGGlaKGk6CEkp6Ckp+Cj5uAj51/jZp6i5h8ipd7iZZ4hpR1g5FzhpdzhJN0g5FuhZdsgpVqgZRpgJNpf5JmfpFufYxufYtlfJBpe4tke49neo1ieo5kd4tndoZidopheY1geIxfd4tmdYVddYpcdIlbc4hgcoNebn5ZcodYcYZXb4VVboRUbYNTbIJaantWaXxRa4FQaYBPaH9NZ35UZXZQY3dMZn1LZXxKZHxMYHRKXnIoOEh3WzsBAAABeElEQVR42u3T11oCQQyG4R9FEREFqVJEgh17xbZ7/3cl29gpmQGeeOh7OF+Ss8G3EL6E8CmEdyG8CeFVCC9CeBTCgxDuhXAnhFsh3AjhSgiXQrgQwtlayHrB6TqIyHzCREMTH4rpbxip5nnkRintEUNF0oc8yqnP6Oey3ueQSnlHN6P0ro0Mi4BOSu8dA1mygnbC7G0NMdKEVszuLQXx4oZmhO3NDLlEEY05R280PDGbgD0RaBeI/Bdg7weBMkDLwF4PtBOcwH0gCJZf0DPYdd8Jo8K177hgZbjW+RN2hWffusBVnMR+XE5yfMRx5MPtOOOI0Xd+9ot/rTOiVrtepuabwcDwNFgP6przSH0dqKiOUhUfvaKcO8yVncyM0sK+psSyK4qpPUvRwlUUYrusgoaviG27YMFXNz38I0nc8PNPAFtC2BFClRFWV4cDU5g4WEE0hJ4q1PU8sgmMF0LOmKN2TBOh21RjRsxms3C5WYwrCIX+D/zBgV8HCFv4gVKf1AAAAABJRU5ErkJggg==';
+const GOLDEN_SUNSET =
+ 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAMAAACdt4HsAAAAkFBMVEX/+uv/7sj6tFr3sVn1r1nzrVjxq1jvqVftp1frpVbpo1bnoVXln1XjnVThm1TfmVPdl1PblVLZk1LXkVLVj1HTjVHRi1DPiVDNh0/LhU/Jg07HgU7Ff03DfU3Be0y/eUy9d0u7dUu5c0u2cEq0bkqybEmwakmuaEisZkiqZEeoYkemYEakXkaiXEVgLjQ8HCjaJlMkAAABI0lEQVR42u3Mx3qDMBSE0Z/03nsvdhxjcnn/twsYjISR5MUkO5+V9N2ZYUPEpogtEdsidkTsitgTsS/iQMShiCMRxyJORJyKOBNxLuJCxKWIKxHXIm5E3Iq4E3Ev4kHEo4gnEc8iXkS8inhLymrJBO8J2UIiw0dc5sRDfEbVRWr1o/pbMMWox9yz6zcLIzMbBTD2VaHu7fr1gjXGA3w5baj5+H0w6x09TDpdaP7rDZhn0sd3y89Y9fcHbPnoYdroZ2w6dQNmg6OHfG4QyrsBC8gdZpVQxtqF4M1mjepFURThTLNgMYsePxaX2WqY6D8GSm2grK2slbGBciHZ9hOE2smNpTuxenhieCdeH06E7qTqvYnImWTbbUSPlKL1wHrgTwZ+AWq+3H5MpRkwAAAAAElFTkSuQmCC';
+const SNOWY_PEAKS =
+ 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAMAAACdt4HsAAAAwFBMVEX////6/P/4+//g7vjf7fbf7fTe7fje7fTe7PTd7Pjc7Pfd7PTc6/Xc6/Pb6/fb6/Xb6vTa6/fa6/Xa6vfZ6vfZ6vba6vTZ6fXY6vfY6vbY6ffY6fXX6fbX6fTW6fbX6PXW6PbW6PTV6PbV6PXU6PbV5/XU5/bU5/TU5vXT5/bS5/XT5vTS5vXS5vTR5vXR5fXQ5fXP5fXP5PXO5PXO5PTN5PTN4/TM4/TL4/TM4vTL4vTK4vTO3OqqvtKbrsFcfGgMVnjaAAAC7klEQVR42u2Ta3eaQBCGp0kbTbBBMWDMoiCWEOsFtV4SdcP//1edYQUWwSye9kNOT58POVlm3mdmUWG/3+9et5vVYj6bjoMgGE9n88Vqs33d7SsBcX67WmI+EKBhudpWNcBu94bzlyGO9weEj0uES9zhbVcFSPMYdxzmOKi4xACbNa0/DgY91rGIDusNgjFdY72tAKzXq0U4pTyGm80m/iXDNFys1psqApwf4nwc32x+J9DRYbhDuMRrqIF5vD+zKK0R5LBYfIvFcqUEBZPRsNex9IaW0NCtTm84mqDglxIIQ3z/uEBDqydoDVrBH4d4CyUwowUsA+fXa4I67mBYtAJeQglM4jeg0wLfBLSCLt5COFcC4xffYVZ8gVSABos5/sskVAOjYNjvWrqWxGOFplvd/jD4OZkpgSAYiA1yAtpgGIzGEyW0wYCZeqOeGer1hm6yQUXBD8+1uySofU2okaBre97zSA34nuswk74GqYC+CCZzXM9/VgO+77o2M+LPUcTpUzSYXS3/DB7m4ztomrhEjb7LeAPbdb0KgOe5fTIY6Y8B51O+Xynvgeu6js2Yaep6Q6DrpsmY7biVABthXdPEFfRj3sBTl9nl8JNzLMANSGEahm5QGuNn8/zEAE8xD0g7hrfbdHgqhxO5J/B4BEMtBOv43+M5YkHuCTxk0HwuDGfgvNAAbZljQ/sMnEOhAVoSPKFVCuYBThvgXiKdcF8GlwRZB+Tz8IEhLhca4C6F8yusH0TDXYFjPjEkj+E2gecm8NsT+IkgaQBVQ6F80gA3Ai4uANkl+I0ElYlDjNwAhXyp4Zg/Cg4FAS+dwAsLiPq7PAGuEc5LJ3B+LUjLSf2Q1aGk4V1uyJVTQdYAqgZ5v7T+nu0IuXwmkAwf1yE3IJuQjZDLkiBpAK5o4BUEV6UNh5J8SR1y9VzDoZgvqasFV2frByFQNCgFX/6Q/4J/SxDJTy84/DVBFEmlSw6fRhBFUumiw2cRRJFUuuzwG+qew9oBo+n5AAAAAElFTkSuQmCC';
+
const IMAGES = [
- {id: 1, src: 'https://lookaside.facebook.com/assets/astryx/moody-scene-vertical-1.png', alt: 'Dark cityscape at night', label: 'dark-city.jpg'},
- {id: 2, src: 'https://lookaside.facebook.com/assets/astryx/moody-scene-vertical-2.png', alt: 'Bright snowy landscape', label: 'snow.jpg'},
- {id: 3, src: 'https://lookaside.facebook.com/assets/astryx/moody-home-vertical-1.png', alt: 'Warm sunset over mountains', label: 'sunset.jpg'},
+ {
+ id: 1,
+ src: NIGHT_FOREST,
+ alt: 'Forest at night under a crescent moon',
+ label: 'forest-night.jpg',
+ },
+ {
+ id: 2,
+ src: MISTY_VALLEY,
+ alt: 'Misty mountain valley',
+ label: 'misty-valley.jpg',
+ },
+ {
+ id: 3,
+ src: GOLDEN_SUNSET,
+ alt: 'Golden sunset over mountains',
+ label: 'golden-sunset.jpg',
+ },
+ {
+ id: 4,
+ src: SNOWY_PEAKS,
+ alt: 'Snowy mountain peaks',
+ label: 'snowy-peaks.jpg',
+ },
];
export default function ThumbnailRemovable() {
diff --git a/packages/cli/templates/blocks/components/Thumbnail/ThumbnailShowcase.tsx b/packages/cli/templates/blocks/components/Thumbnail/ThumbnailShowcase.tsx
index a01548ae8c..f1c204cc3f 100644
--- a/packages/cli/templates/blocks/components/Thumbnail/ThumbnailShowcase.tsx
+++ b/packages/cli/templates/blocks/components/Thumbnail/ThumbnailShowcase.tsx
@@ -4,12 +4,13 @@
import {Thumbnail} from '@astryxdesign/core/Thumbnail';
+// Inline same-origin data URI so the example is self-contained — see
+// ThumbnailRemovable for why image-backed Thumbnails avoid cross-origin URLs.
+const SNOWY_PEAKS =
+ 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAMAAACdt4HsAAAAwFBMVEX////6/P/4+//g7vjf7fbf7fTe7fje7fTe7PTd7Pjc7Pfd7PTc6/Xc6/Pb6/fb6/Xb6vTa6/fa6/Xa6vfZ6vfZ6vba6vTZ6fXY6vfY6vbY6ffY6fXX6fbX6fTW6fbX6PXW6PbW6PTV6PbV6PXU6PbV5/XU5/bU5/TU5vXT5/bS5/XT5vTS5vXS5vTR5vXR5fXQ5fXP5fXP5PXO5PXO5PTN5PTN4/TM4/TL4/TM4vTL4vTK4vTO3OqqvtKbrsFcfGgMVnjaAAAC7klEQVR42u2Ta3eaQBCGp0kbTbBBMWDMoiCWEOsFtV4SdcP//1edYQUWwSye9kNOT58POVlm3mdmUWG/3+9et5vVYj6bjoMgGE9n88Vqs33d7SsBcX67WmI+EKBhudpWNcBu94bzlyGO9weEj0uES9zhbVcFSPMYdxzmOKi4xACbNa0/DgY91rGIDusNgjFdY72tAKzXq0U4pTyGm80m/iXDNFys1psqApwf4nwc32x+J9DRYbhDuMRrqIF5vD+zKK0R5LBYfIvFcqUEBZPRsNex9IaW0NCtTm84mqDglxIIQ3z/uEBDqydoDVrBH4d4CyUwowUsA+fXa4I67mBYtAJeQglM4jeg0wLfBLSCLt5COFcC4xffYVZ8gVSABos5/sskVAOjYNjvWrqWxGOFplvd/jD4OZkpgSAYiA1yAtpgGIzGEyW0wYCZeqOeGer1hm6yQUXBD8+1uySofU2okaBre97zSA34nuswk74GqYC+CCZzXM9/VgO+77o2M+LPUcTpUzSYXS3/DB7m4ztomrhEjb7LeAPbdb0KgOe5fTIY6Y8B51O+Xynvgeu6js2Yaep6Q6DrpsmY7biVABthXdPEFfRj3sBTl9nl8JNzLMANSGEahm5QGuNn8/zEAE8xD0g7hrfbdHgqhxO5J/B4BEMtBOv43+M5YkHuCTxk0HwuDGfgvNAAbZljQ/sMnEOhAVoSPKFVCuYBThvgXiKdcF8GlwRZB+Tz8IEhLhca4C6F8yusH0TDXYFjPjEkj+E2gecm8NsT+IkgaQBVQ6F80gA3Ai4uANkl+I0ElYlDjNwAhXyp4Zg/Cg4FAS+dwAsLiPq7PAGuEc5LJ3B+LUjLSf2Q1aGk4V1uyJVTQdYAqgZ5v7T+nu0IuXwmkAwf1yE3IJuQjZDLkiBpAK5o4BUEV6UNh5J8SR1y9VzDoZgvqasFV2frByFQNCgFX/6Q/4J/SxDJTy84/DVBFEmlSw6fRhBFUumiw2cRRJFUuuzwG+qew9oBo+n5AAAAAElFTkSuQmCC';
+
export default function ThumbnailShowcase() {
return (
- <Thumbnail
- src="https://lookaside.facebook.com/assets/astryx/moody-scene-vertical-2.png"
- alt="Sample image"
- label="photo.jpg"
- />
+ <Thumbnail src={SNOWY_PEAKS} alt="Snowy mountain peaks" label="snowy-peaks.jpg" />
);
}
diff --git a/packages/cli/templates/blocks/components/Thumbnail/ThumbnailStates.tsx b/packages/cli/templates/blocks/components/Thumbnail/ThumbnailStates.tsx
index 609e72eebc..906bd663a0 100644
--- a/packages/cli/templates/blocks/components/Thumbnail/ThumbnailStates.tsx
+++ b/packages/cli/templates/blocks/components/Thumbnail/ThumbnailStates.tsx
@@ -6,6 +6,11 @@ import {Thumbnail} from '@astryxdesign/core/Thumbnail';
import {Stack} from '@astryxdesign/core/Layout';
import {Text} from '@astryxdesign/core/Text';
+// Inline same-origin data URI so the example is self-contained — see
+// ThumbnailRemovable for why image-backed Thumbnails avoid cross-origin URLs.
+const MISTY_VALLEY =
+ 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAMAAACdt4HsAAAAwFBMVEWPnaqJmKSIlaKHlaGGlaKGk6CEkp6Ckp+Cj5uAj51/jZp6i5h8ipd7iZZ4hpR1g5FzhpdzhJN0g5FuhZdsgpVqgZRpgJNpf5JmfpFufYxufYtlfJBpe4tke49neo1ieo5kd4tndoZidopheY1geIxfd4tmdYVddYpcdIlbc4hgcoNebn5ZcodYcYZXb4VVboRUbYNTbIJaantWaXxRa4FQaYBPaH9NZ35UZXZQY3dMZn1LZXxKZHxMYHRKXnIoOEh3WzsBAAABeElEQVR42u3T11oCQQyG4R9FEREFqVJEgh17xbZ7/3cl29gpmQGeeOh7OF+Ss8G3EL6E8CmEdyG8CeFVCC9CeBTCgxDuhXAnhFsh3AjhSgiXQrgQwtlayHrB6TqIyHzCREMTH4rpbxip5nnkRintEUNF0oc8yqnP6Oey3ueQSnlHN6P0ro0Mi4BOSu8dA1mygnbC7G0NMdKEVszuLQXx4oZmhO3NDLlEEY05R280PDGbgD0RaBeI/Bdg7weBMkDLwF4PtBOcwH0gCJZf0DPYdd8Jo8K177hgZbjW+RN2hWffusBVnMR+XE5yfMRx5MPtOOOI0Xd+9ot/rTOiVrtepuabwcDwNFgP6przSH0dqKiOUhUfvaKcO8yVncyM0sK+psSyK4qpPUvRwlUUYrusgoaviG27YMFXNz38I0nc8PNPAFtC2BFClRFWV4cDU5g4WEE0hJ4q1PU8sgmMF0LOmKN2TBOh21RjRsxms3C5WYwrCIX+D/zBgV8HCFv4gVKf1AAAAABJRU5ErkJggg==';
+
export default function ThumbnailStates() {
return (
<Stack direction="vertical" gap={4}>
@@ -28,10 +33,10 @@ export default function ThumbnailStates() {
</Stack>
<Stack direction="vertical" gap={1} hAlign="center">
<Thumbnail
- src="https://lookaside.facebook.com/assets/astryx/moody-home-vertical-1.png"
- alt="Mountain landscape"
+ src={MISTY_VALLEY}
+ alt="Misty mountain valley"
isLoading
- label="landscape.jpg"
+ label="misty-valley.jpg"
/>
<Text type="supporting" color="secondary">
Uploading
@@ -39,9 +44,9 @@ export default function ThumbnailStates() {
</Stack>
<Stack direction="vertical" gap={1} hAlign="center">
<Thumbnail
- src="https://lookaside.facebook.com/assets/astryx/moody-home-vertical-1.png"
- alt="Mountain landscape"
- label="landscape.jpg"
+ src={MISTY_VALLEY}
+ alt="Misty mountain valley"
+ label="misty-valley.jpg"
/>
<Text type="supporting" color="secondary">
Loaded
diff --git a/packages/core/src/hooks/useImageMode.test.ts b/packages/core/src/hooks/useImageMode.test.ts
new file mode 100644
index 0000000000..c46b260b1d
--- /dev/null
+++ b/packages/core/src/hooks/useImageMode.test.ts
@@ -0,0 +1,133 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file useImageMode.test.ts
+ * @input Uses vitest, @testing-library/react, useImageMode hook
+ * @output Unit tests for useImageMode hook
+ * @position Testing; validates useImageMode.ts pixel-sampling + CORS behavior
+ *
+ * SYNC: When useImageMode.ts changes, update tests to match new behavior
+ */
+
+import {describe, it, expect, vi, beforeEach, afterEach} from 'vitest';
+import {renderHook, waitFor, act} from '@testing-library/react';
+import {useImageMode} from './useImageMode';
+
+// jsdom has no fetch/createImageBitmap/OffscreenCanvas — stub them per test so
+// we can exercise the sampling path and the cross-origin failure path.
+
+/** Fill the sampled canvas with a flat RGB so perceptualLightness is deterministic. */
+function stubSamplingPipeline(rgb: [number, number, number]) {
+ // fetch resolves to a blob (same-origin / CORS-enabled image)
+ vi.stubGlobal(
+ 'fetch',
+ vi.fn(async () => ({blob: async () => ({}) as Blob})),
+ );
+ vi.stubGlobal(
+ 'createImageBitmap',
+ vi.fn(async () => ({width: 100, height: 100}) as ImageBitmap),
+ );
+ const [r, g, b] = rgb;
+ class FakeOffscreenCanvas {
+ constructor(
+ public width: number,
+ public height: number,
+ ) {}
+ getContext() {
+ return {
+ drawImage: vi.fn(),
+ getImageData: (_x: number, _y: number, w: number, h: number) => {
+ const data = new Uint8ClampedArray(w * h * 4);
+ for (let i = 0; i < data.length; i += 4) {
+ data[i] = r;
+ data[i + 1] = g;
+ data[i + 2] = b;
+ data[i + 3] = 255;
+ }
+ return {data};
+ },
+ };
+ }
+ }
+ vi.stubGlobal('OffscreenCanvas', FakeOffscreenCanvas);
+}
+
+/** Simulate a cross-origin image with no CORS headers: fetch rejects. */
+function stubCorsBlockedFetch() {
+ vi.stubGlobal(
+ 'fetch',
+ vi.fn(async () => {
+ throw new TypeError(
+ 'Failed to fetch: No Access-Control-Allow-Origin header',
+ );
+ }),
+ );
+ vi.stubGlobal('createImageBitmap', vi.fn());
+ vi.stubGlobal('OffscreenCanvas', class {});
+}
+
+describe('useImageMode', () => {
+ beforeEach(() => {
+ vi.restoreAllMocks();
+ });
+ afterEach(() => {
+ vi.unstubAllGlobals();
+ });
+
+ it('returns the fallback while no src is provided', () => {
+ const {result} = renderHook(() => useImageMode(null, {fallback: 'dark'}));
+ expect(result.current).toBe('dark');
+ });
+
+ it('samples a dark image and reports "dark"', async () => {
+ stubSamplingPipeline([10, 10, 10]);
+ const {result} = renderHook(() =>
+ useImageMode('data:image/png;base64,AAAA'),
+ );
+ await waitFor(() => expect(result.current).toBe('dark'));
+ });
+
+ it('samples a light image and reports "light"', async () => {
+ stubSamplingPipeline([240, 240, 240]);
+ const {result} = renderHook(() =>
+ useImageMode('data:image/png;base64,AAAA'),
+ );
+ await waitFor(() => expect(result.current).toBe('light'));
+ });
+
+ // ── Reproduction for BB-001 (cluster C6) ────────────────────────────────
+ // A cross-origin image with no `Access-Control-Allow-Origin` header cannot be
+ // fetched with `mode: 'cors'`, so the APCA sampling pipeline never runs and the
+ // hook silently stays on its fallback. This is why image-backed Thumbnail
+ // overlay/remove-button contrast is unreliable for hosted demo examples that
+ // point `src` at a non-CORS CDN URL.
+ it('stays on fallback when a cross-origin image cannot be sampled (CORS)', async () => {
+ stubCorsBlockedFetch();
+ const {result} = renderHook(() =>
+ useImageMode(
+ 'https://lookaside.facebook.com/assets/astryx/moody-scene-vertical-2.png',
+ {fallback: null},
+ ),
+ );
+ // Give the rejected fetch + state update a chance to flush.
+ await act(async () => {
+ await new Promise(r => setTimeout(r, 0));
+ });
+ expect(result.current).toBeNull();
+ });
+
+ it('requests the image with CORS mode (the constraint that fails for non-CORS hosts)', async () => {
+ const fetchSpy = vi.fn(async () => {
+ throw new TypeError('CORS');
+ });
+ vi.stubGlobal('fetch', fetchSpy);
+ vi.stubGlobal('createImageBitmap', vi.fn());
+ vi.stubGlobal('OffscreenCanvas', class {});
+ renderHook(() => useImageMode('https://cross-origin.example/x.png'));
+ await waitFor(() => expect(fetchSpy).toHaveBeenCalled());
+ expect(fetchSpy).toHaveBeenCalledWith(
+ 'https://cross-origin.example/x.png',
+ {mode: 'cors'},
+ );
+ });
+});
diff --git a/scripts/check-demo-media.mjs b/scripts/check-demo-media.mjs
new file mode 100644
index 0000000000..d960b30db0
--- /dev/null
+++ b/scripts/check-demo-media.mjs
@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * Source check: Thumbnail block examples must use CORS-safe demo media.
+ *
+ * Thumbnail's remove-button overlay uses useImageMode, which FETCHES the image
+ * (`fetch(src, {mode: 'cors'})` -> createImageBitmap -> OffscreenCanvas
+ * getImageData) to sample pixels for APCA contrast. A cross-origin CDN URL
+ * without `Access-Control-Allow-Origin` cannot be fetched/sampled, so contrast
+ * detection fails silently and logs CORS errors in hosted previews. These
+ * image-backed examples must use a self-contained, same-origin, samplable
+ * source (a data: URI) instead of a cross-origin lookaside URL.
+ *
+ * Usage: node scripts/check-demo-media.mjs
+ */
+import fs from 'fs';
+import path from 'path';
+import {fileURLToPath} from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const THUMBNAIL_BLOCK_DIR = path.resolve(
+ __dirname,
+ '../packages/cli/templates/blocks/components/Thumbnail',
+);
+
+// Cross-origin demo CDN that cannot be CORS-sampled by useImageMode.
+const CROSS_ORIGIN_MEDIA = 'lookaside.facebook.com';
+
+const errors = [];
+let checked = 0;
+
+const files = fs.existsSync(THUMBNAIL_BLOCK_DIR)
+ ? fs.readdirSync(THUMBNAIL_BLOCK_DIR).filter(f => f.endsWith('.tsx'))
+ : [];
+
+for (const file of files) {
+ const full = path.join(THUMBNAIL_BLOCK_DIR, file);
+ const source = fs.readFileSync(full, 'utf-8');
+
+ // Only the examples that actually render an image-backed Thumbnail drive the
+ // useImageMode sampling path; skip examples with no image src.
+ if (!source.includes('src=') && !source.includes('src:')) continue;
+ checked++;
+
+ if (source.includes(CROSS_ORIGIN_MEDIA)) {
+ errors.push({
+ file,
+ issue: `references cross-origin ${CROSS_ORIGIN_MEDIA} media — useImageMode cannot CORS-sample it for the remove-button overlay`,
+ });
+ }
+}
+
+if (errors.length > 0) {
+ console.error('❌ Thumbnail demo-media errors:\n');
+ for (const {file, issue} of errors) {
+ console.error(` ${file}: ${issue}`);
+ }
+ console.error(
+ `\n${errors.length} error(s). Fix: use a same-origin, samplable data: URI for image-backed Thumbnail examples.`,
+ );
+ process.exit(1);
+}
+
+console.log(
+ `✅ ${checked} image-backed Thumbnail example(s) checked — all use CORS-safe demo media.`,
+);