@open-mercato/core 0.7.1-develop.7202.1.a52dc6707c → 0.8.0

package/dist/modules/push_notifications/lib/queue.js

@@ -1,10 +1,7 @@
 import { createModuleQueue } from "@open-mercato/queue";
-import { createLogger } from "@open-mercato/shared/lib/logger";
-const logger = createLogger("push_notifications");
 const PUSH_DELIVERIES_QUEUE = "push-deliveries";
 const PUSH_STUCK_RECLAIM_QUEUE = "push-stuck-reclaim";
 const queues = /* @__PURE__ */ new Map();
-const LOCAL_WORKER_PROMISE_KEY = "__openMercatoPushLocalWorkerPromise__";
 function getPushQueue(queueName = PUSH_DELIVERIES_QUEUE) {
   const existing = queues.get(queueName);
   if (existing) return existing;
@@ -13,36 +10,9 @@ function getPushQueue(queueName = PUSH_DELIVERIES_QUEUE) {
   queues.set(queueName, created);
   return created;
 }
-async function ensureLocalPushQueueWorkerStarted() {
-  if (process.env.QUEUE_STRATEGY === "async") return;
-  const globalStore = globalThis;
-  if (globalStore[LOCAL_WORKER_PROMISE_KEY]) {
-    await globalStore[LOCAL_WORKER_PROMISE_KEY];
-    return;
-  }
-  globalStore[LOCAL_WORKER_PROMISE_KEY] = (async () => {
-    const queue = getPushQueue();
-    await queue.process(async (job) => {
-      const [{ createRequestContainer }, { processPushDeliveryJob }] = await Promise.all([
-        import("@open-mercato/shared/lib/di/container"),
-        import("./push-delivery.js")
-      ]);
-      const container = await createRequestContainer();
-      const em = container.resolve("em").fork();
-      await processPushDeliveryJob(em, job.payload, (name) => container.resolve(name));
-    });
-  })().catch((error) => {
-    delete globalStore[LOCAL_WORKER_PROMISE_KEY];
-    logger.error("Failed to start local delivery worker", { error });
-    throw error;
-  });
-  await globalStore[LOCAL_WORKER_PROMISE_KEY];
-}
 async function enqueuePushDelivery(job, delayMs) {
   const queue = getPushQueue();
-  const jobId = await queue.enqueue(job, delayMs && delayMs > 0 ? { delayMs } : void 0);
-  await ensureLocalPushQueueWorkerStarted();
-  return jobId;
+  return queue.enqueue(job, delayMs && delayMs > 0 ? { delayMs } : void 0);
 }
 export {
   PUSH_DELIVERIES_QUEUE,

package/dist/modules/push_notifications/lib/queue.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/push_notifications/lib/queue.ts"],
-  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport { createModuleQueue, type Queue } from '@open-mercato/queue'\nimport { createLogger } from '@open-mercato/shared/lib/logger'\n\nconst logger = createLogger('push_notifications')\n\nexport interface PushDeliveryJob {\n  deliveryId: string\n  tenantId: string\n  organizationId: string | null\n}\n\nexport const PUSH_DELIVERIES_QUEUE = 'push-deliveries'\n// Scheduler-driven tick that recovers rows stranded in `sending` by a crashed worker (see\n// lib/push-reaper.ts). The `@open-mercato/scheduler` interval entry registered in setup.ts enqueues\n// one tick per tenant onto this queue; the reclaim-stuck worker processes it.\nexport const PUSH_STUCK_RECLAIM_QUEUE = 'push-stuck-reclaim'\n\nconst queues = new Map<string, Queue<PushDeliveryJob>>()\nconst LOCAL_WORKER_PROMISE_KEY = '__openMercatoPushLocalWorkerPromise__'\n\nexport function getPushQueue(queueName: string = PUSH_DELIVERIES_QUEUE): Queue<PushDeliveryJob> {\n  const existing = queues.get(queueName)\n  if (existing) return existing\n\n  const concurrency = Math.max(1, Number.parseInt(process.env.PUSH_QUEUE_CONCURRENCY ?? '8', 10) || 8)\n  const created = createModuleQueue<PushDeliveryJob>(queueName, { concurrency })\n\n  queues.set(queueName, created)\n  return created\n}\n\n// In local (dev/test) queue mode jobs are processed in-process. In async mode the\n// auto-discovered `workers/send-push.worker.ts` handles them, so this is a no-op there.\nasync function ensureLocalPushQueueWorkerStarted(): Promise<void> {\n  if (process.env.QUEUE_STRATEGY === 'async') return\n\n  const globalStore = globalThis as typeof globalThis & {\n    [LOCAL_WORKER_PROMISE_KEY]?: Promise<void>\n  }\n\n  if (globalStore[LOCAL_WORKER_PROMISE_KEY]) {\n    await globalStore[LOCAL_WORKER_PROMISE_KEY]\n    return\n  }\n\n  globalStore[LOCAL_WORKER_PROMISE_KEY] = (async () => {\n    const queue = getPushQueue()\n\n    await queue.process(async (job) => {\n      const [{ createRequestContainer }, { processPushDeliveryJob }] = await Promise.all([\n        import('@open-mercato/shared/lib/di/container'),\n        import('./push-delivery'),\n      ])\n\n      const container = await createRequestContainer()\n      const em = (container.resolve('em') as EntityManager).fork()\n      await processPushDeliveryJob(em, job.payload, (name) => container.resolve(name))\n    })\n  })().catch((error) => {\n    delete globalStore[LOCAL_WORKER_PROMISE_KEY]\n    logger.error('Failed to start local delivery worker', { error })\n    throw error\n  })\n\n  await globalStore[LOCAL_WORKER_PROMISE_KEY]\n}\n\nexport async function enqueuePushDelivery(job: PushDeliveryJob, delayMs?: number): Promise<string> {\n  const queue = getPushQueue()\n  const jobId = await queue.enqueue(job, delayMs && delayMs > 0 ? { delayMs } : undefined)\n  await ensureLocalPushQueueWorkerStarted()\n  return jobId\n}\n"],
-  "mappings": "AACA,SAAS,yBAAqC;AAC9C,SAAS,oBAAoB;AAE7B,MAAM,SAAS,aAAa,oBAAoB;AAQzC,MAAM,wBAAwB;AAI9B,MAAM,2BAA2B;AAExC,MAAM,SAAS,oBAAI,IAAoC;AACvD,MAAM,2BAA2B;AAE1B,SAAS,aAAa,YAAoB,uBAA+C;AAC9F,QAAM,WAAW,OAAO,IAAI,SAAS;AACrC,MAAI,SAAU,QAAO;AAErB,QAAM,cAAc,KAAK,IAAI,GAAG,OAAO,SAAS,QAAQ,IAAI,0BAA0B,KAAK,EAAE,KAAK,CAAC;AACnG,QAAM,UAAU,kBAAmC,WAAW,EAAE,YAAY,CAAC;AAE7E,SAAO,IAAI,WAAW,OAAO;AAC7B,SAAO;AACT;AAIA,eAAe,oCAAmD;AAChE,MAAI,QAAQ,IAAI,mBAAmB,QAAS;AAE5C,QAAM,cAAc;AAIpB,MAAI,YAAY,wBAAwB,GAAG;AACzC,UAAM,YAAY,wBAAwB;AAC1C;AAAA,EACF;AAEA,cAAY,wBAAwB,KAAK,YAAY;AACnD,UAAM,QAAQ,aAAa;AAE3B,UAAM,MAAM,QAAQ,OAAO,QAAQ;AACjC,YAAM,CAAC,EAAE,uBAAuB,GAAG,EAAE,uBAAuB,CAAC,IAAI,MAAM,QAAQ,IAAI;AAAA,QACjF,OAAO,uCAAuC;AAAA,QAC9C,OAAO,iBAAiB;AAAA,MAC1B,CAAC;AAED,YAAM,YAAY,MAAM,uBAAuB;AAC/C,YAAM,KAAM,UAAU,QAAQ,IAAI,EAAoB,KAAK;AAC3D,YAAM,uBAAuB,IAAI,IAAI,SAAS,CAAC,SAAS,UAAU,QAAQ,IAAI,CAAC;AAAA,IACjF,CAAC;AAAA,EACH,GAAG,EAAE,MAAM,CAAC,UAAU;AACpB,WAAO,YAAY,wBAAwB;AAC3C,WAAO,MAAM,yCAAyC,EAAE,MAAM,CAAC;AAC/D,UAAM;AAAA,EACR,CAAC;AAED,QAAM,YAAY,wBAAwB;AAC5C;AAEA,eAAsB,oBAAoB,KAAsB,SAAmC;AACjG,QAAM,QAAQ,aAAa;AAC3B,QAAM,QAAQ,MAAM,MAAM,QAAQ,KAAK,WAAW,UAAU,IAAI,EAAE,QAAQ,IAAI,MAAS;AACvF,QAAM,kCAAkC;AACxC,SAAO;AACT;",
+  "sourcesContent": ["import { createModuleQueue, type Queue } from '@open-mercato/queue'\n\nexport interface PushDeliveryJob {\n  deliveryId: string\n  tenantId: string\n  organizationId: string | null\n}\n\nexport const PUSH_DELIVERIES_QUEUE = 'push-deliveries'\n// Scheduler-driven tick that recovers rows stranded in `sending` by a crashed worker (see\n// lib/push-reaper.ts). The `@open-mercato/scheduler` interval entry registered in setup.ts enqueues\n// one tick per tenant onto this queue; the reclaim-stuck worker processes it.\nexport const PUSH_STUCK_RECLAIM_QUEUE = 'push-stuck-reclaim'\n\nconst queues = new Map<string, Queue<PushDeliveryJob>>()\n\nexport function getPushQueue(queueName: string = PUSH_DELIVERIES_QUEUE): Queue<PushDeliveryJob> {\n  const existing = queues.get(queueName)\n  if (existing) return existing\n\n  const concurrency = Math.max(1, Number.parseInt(process.env.PUSH_QUEUE_CONCURRENCY ?? '8', 10) || 8)\n  const created = createModuleQueue<PushDeliveryJob>(queueName, { concurrency })\n\n  queues.set(queueName, created)\n  return created\n}\n\n/**\n * Enqueue only. The send is owned by the auto-discovered `workers/send-push.worker.ts`\n * in BOTH queue strategies \u2014 a worker process in `async` mode, the local worker runner\n * (`yarn dev`, `drainIntegrationQueue`) in local mode.\n *\n * This deliberately never starts a consumer itself. Booting one from the request path\n * deadlocked the caller: the local strategy's `process()` does not return until its\n * first drain finishes, so awaiting it ran the send handler INSIDE the enqueueing\n * request \u2014 and a retryable send re-enqueues from within that handler, which awaited\n * the very bootstrap promise it was running under. The first push whose delivery failed\n * retryably therefore wedged `POST /api/notifications` forever, and because the promise\n * was cached on `globalThis` every later push in the process awaited it too. It also put\n * a second consumer on a queue directory the local strategy documents as single-consumer.\n */\nexport async function enqueuePushDelivery(job: PushDeliveryJob, delayMs?: number): Promise<string> {\n  const queue = getPushQueue()\n  return queue.enqueue(job, delayMs && delayMs > 0 ? { delayMs } : undefined)\n}\n"],
+  "mappings": "AAAA,SAAS,yBAAqC;AAQvC,MAAM,wBAAwB;AAI9B,MAAM,2BAA2B;AAExC,MAAM,SAAS,oBAAI,IAAoC;AAEhD,SAAS,aAAa,YAAoB,uBAA+C;AAC9F,QAAM,WAAW,OAAO,IAAI,SAAS;AACrC,MAAI,SAAU,QAAO;AAErB,QAAM,cAAc,KAAK,IAAI,GAAG,OAAO,SAAS,QAAQ,IAAI,0BAA0B,KAAK,EAAE,KAAK,CAAC;AACnG,QAAM,UAAU,kBAAmC,WAAW,EAAE,YAAY,CAAC;AAE7E,SAAO,IAAI,WAAW,OAAO;AAC7B,SAAO;AACT;AAgBA,eAAsB,oBAAoB,KAAsB,SAAmC;AACjG,QAAM,QAAQ,aAAa;AAC3B,SAAO,MAAM,QAAQ,KAAK,WAAW,UAAU,IAAI,EAAE,QAAQ,IAAI,MAAS;AAC5E;",
   "names": []
 }

package/jest.config.cjs

@@ -9,6 +9,7 @@ module.exports = {
   rootDir: '.',
   moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json'],
   moduleNameMapper: {
+    '\\.(png|svg)$': '<rootDir>/jest.mocks/image.js',
     '^#generated/entities\\.ids\\.generated$': '<rootDir>/jest.mocks/entities.ids.generated.js',
     '^#generated/(.*)$': '<rootDir>/generated/$1',
     '^@open-mercato/core/generated/entities\\.ids\\.generated$': '<rootDir>/jest.mocks/entities.ids.generated.js',

package/jest.mocks/image.js

@@ -0,0 +1 @@
+module.exports = '/__fixtures__/image.png'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-mercato/core",
-  "version": "0.7.1-develop.7202.1.a52dc6707c",
+  "version": "0.8.0",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
@@ -253,16 +253,16 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@open-mercato/ai-assistant": "0.7.1-develop.7202.1.a52dc6707c",
-    "@open-mercato/shared": "0.7.1-develop.7202.1.a52dc6707c",
-    "@open-mercato/ui": "0.7.1-develop.7202.1.a52dc6707c",
+    "@open-mercato/ai-assistant": "0.8.0",
+    "@open-mercato/shared": "0.8.0",
+    "@open-mercato/ui": "0.8.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@open-mercato/ai-assistant": "0.7.1-develop.7202.1.a52dc6707c",
-    "@open-mercato/shared": "0.7.1-develop.7202.1.a52dc6707c",
-    "@open-mercato/ui": "0.7.1-develop.7202.1.a52dc6707c",
+    "@open-mercato/ai-assistant": "0.8.0",
+    "@open-mercato/shared": "0.8.0",
+    "@open-mercato/ui": "0.8.0",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/jest-dom": "^7.0.1",
     "@testing-library/react": "^16.3.3",
@@ -285,6 +285,5 @@
     "type": "git",
     "url": "https://github.com/open-mercato/open-mercato",
     "directory": "packages/core"
-  },
-  "stableVersion": "0.7.0"
+  }
 }

package/src/modules/catalog/backend/catalog/products/[id]/page.tsx

@@ -830,6 +830,26 @@ export default function EditCatalogProductPage({
     };
   }, []);
 
+  // The browser's default `history.scrollRestoration` ("auto") tries to restore the
+  // previous session's pixel scroll offset on a full reload. This page's form sections
+  // (variants, options, unit-of-measure, ...) mount progressively as data loads, so the
+  // restore fires before the page has grown to its final height, then that same pixel
+  // offset lines up with a different, further-down section once loading finishes —
+  // landing the reload mid-page instead of at the top (#6171). Opt this page out of
+  // native scroll restoration and start every load at the top unless a hash target
+  // (handled by the effect below) asks for a specific section.
+  React.useEffect(() => {
+    if (typeof window === "undefined" || !window.history) return
+    const previousScrollRestoration = window.history.scrollRestoration
+    window.history.scrollRestoration = "manual"
+    if (!window.location.hash) {
+      window.scrollTo(0, 0)
+    }
+    return () => {
+      window.history.scrollRestoration = previousScrollRestoration
+    }
+  }, [])
+
   // Next.js client-side navigation does not scroll to hash targets.
   // Runs without a dependency array intentionally: the target element is rendered
   // asynchronously by CrudForm, so we need to retry until it exists in the DOM.
@@ -1361,6 +1381,36 @@ export default function EditCatalogProductPage({
         }
       }
       await updateCrud("catalog/products", payload);
+      // The update route only returns `{ ok: true }`, so re-fetch the record to pick
+      // up the server-bumped updatedAt and refresh the optimistic-lock token — without
+      // this, a second consecutive save reuses the stale pre-edit updatedAt and the
+      // lock guard falsely reports a conflict (#5985).
+      const refreshedProductRes = await apiCall<ProductResponse>(
+        `/api/catalog/products?id=${encodeURIComponent(productId)}&page=1&pageSize=1&withDeleted=false`,
+      );
+      const refreshedRecord = Array.isArray(refreshedProductRes.result?.items)
+        ? refreshedProductRes.result?.items?.[0]
+        : undefined;
+      const refreshedUpdatedAt =
+        typeof refreshedRecord?.updatedAt === "string"
+          ? refreshedRecord.updatedAt
+          : typeof refreshedRecord?.updated_at === "string"
+            ? refreshedRecord.updated_at
+            : null;
+      // Merge the just-submitted `values` back into `initialValues` too, not only
+      // `updatedAt` — CrudForm re-syncs its visible fields from `initialValues`
+      // whenever that prop's identity changes, so leaving the other fields at
+      // their stale pre-edit snapshot here made a successful save visually
+      // revert the field the user just changed back to its old value (#6170).
+      setInitialValues((prev) =>
+        prev
+          ? {
+              ...prev,
+              ...values,
+              updatedAt: refreshedUpdatedAt ?? prev.updatedAt,
+            }
+          : prev,
+      );
       const previousConversionIds = new Set(
         initialConversionsRef.current
           .map((entry) => toTrimmedOrNull(entry.id))

package/src/modules/customers/backend/customers/companies/[id]/page.tsx

@@ -39,6 +39,7 @@ import { normalizeCustomFieldSubmitValue } from '../../../../components/detail/c
 import { InlineDictionaryEditor, renderMultilineMarkdownDisplay } from '../../../../components/detail/InlineEditors'
 import { formatTemplate } from '../../../../components/detail/utils'
 import { coerceDisplayName } from '../../../../lib/displayName'
+import { isDetailNotFoundStatus } from '@open-mercato/core/modules/customers/lib/detailHelpers'
 import { createTranslatorWithFallback } from '@open-mercato/shared/lib/i18n/translate'
 import {
   CompanyPeopleSection,
@@ -306,7 +307,7 @@ export default function CustomerCompanyDetailPage({ params }: { params?: { id?:
         setData(payload as CompanyOverview)
       } catch (err) {
         if (cancelled) return
-        if ((err as { status?: number }).status === 404) {
+        if (isDetailNotFoundStatus((err as { status?: number }).status)) {
           setIsNotFound(true)
         } else {
           const message = err instanceof Error ? err.message : t('customers.companies.detail.error.load', 'Failed to load company.')

package/src/modules/customers/backend/customers/companies-v2/[id]/page.tsx

@@ -30,6 +30,7 @@ import { CompanyPeopleSection, type CompanyPersonSummary } from '../../../../com
 import type { TagSummary } from '../../../../components/detail/types'
 import type { TagsSectionController } from '@open-mercato/ui/backend/detail'
 import { coerceDisplayName } from '../../../../lib/displayName'
+import { isDetailNotFoundStatus } from '@open-mercato/core/modules/customers/lib/detailHelpers'
 import { CompanyDetailHeader } from '../../../../components/detail/CompanyDetailHeader'
 import { CompanyDetailTabs, resolveLegacyTab, type CompanyTabId } from '../../../../components/detail/CompanyDetailTabs'
 import { useDealsAccess } from '../../../../components/detail/useDealsAccess'
@@ -152,7 +153,7 @@ export default function CompanyDetailV2Page({ params }: { params?: { id?: string
       )
       setData(payload as CompanyOverview)
     } catch (err) {
-      if ((err as { status?: number }).status === 404) {
+      if (isDetailNotFoundStatus((err as { status?: number }).status)) {
         setIsNotFound(true)
       } else {
         const message = err instanceof Error ? err.message : t('customers.companies.detail.error.load', 'Failed to load company.')

package/src/modules/customers/backend/customers/people/[id]/page.tsx

@@ -40,7 +40,7 @@ import {
   InlineDictionaryEditor,
 } from '../../../../components/detail/InlineEditors'
 import { DetailFieldsSection, type DetailFieldConfig } from '@open-mercato/ui/backend/detail'
-import { isValidSocialUrl } from '@open-mercato/core/modules/customers/lib/detailHelpers'
+import { isValidSocialUrl, isDetailNotFoundStatus } from '@open-mercato/core/modules/customers/lib/detailHelpers'
 import type { ActivitySummary, DealSummary, TagSummary, TodoLinkSummary } from '../../../../components/detail/types'
 import { CustomDataSection } from '../../../../components/detail/CustomDataSection'
 import { createTranslatorWithFallback } from '@open-mercato/shared/lib/i18n/translate'
@@ -299,7 +299,7 @@ export default function CustomerPersonDetailPage({ params }: { params?: { id?: s
       )
       setData(payload as PersonOverview)
     } catch (err) {
-      if ((err as { status?: number }).status === 404) {
+      if (isDetailNotFoundStatus((err as { status?: number }).status)) {
         setIsNotFound(true)
       } else {
         const message = err instanceof Error ? err.message : t('customers.people.detail.error.load')

package/src/modules/customers/backend/customers/people-v2/[id]/page.tsx

@@ -53,6 +53,7 @@ import {
   type PersonOverview,
 } from '../../../../components/formConfig'
 import { coerceDisplayName, coerceDisplayNameOrNull } from '../../../../lib/displayName'
+import { isDetailNotFoundStatus } from '@open-mercato/core/modules/customers/lib/detailHelpers'
 import { createLogger } from '@open-mercato/shared/lib/logger'
 
 const logger = createLogger('customers')
@@ -168,7 +169,7 @@ export default function PersonDetailV2Page({ params }: { params?: { id?: string
         : payload
       setData(next as PersonOverview)
     } catch (err) {
-      if ((err as { status?: number }).status === 404) {
+      if (isDetailNotFoundStatus((err as { status?: number }).status)) {
         setIsNotFound(true)
       } else {
         const message = err instanceof Error ? err.message : t('customers.people.detail.error.load', 'Failed to load person.')

package/src/modules/customers/lib/detailHelpers.ts

@@ -34,4 +34,8 @@ export function isValidSocialUrl(
   return normalizedPath.length > 0
 }
 
+export function isDetailNotFoundStatus(status: number | null | undefined): boolean {
+  return status === 404 || status === 400
+}
+
 export { slugifyTagLabel }

package/src/modules/customers/lib/todoCompatibility.ts

@@ -1,6 +1,7 @@
 import type { EntityManager } from '@mikro-orm/postgresql'
 import type { QueryEngine } from '@open-mercato/shared/lib/query/types'
 import type { EntityId } from '@open-mercato/shared/modules/entities'
+import { isValidEntityIdShape } from '@open-mercato/shared/lib/query/engine'
 import { parseBooleanFromUnknown } from '@open-mercato/shared/lib/boolean'
 import {
   CustomerInteraction,
@@ -230,6 +231,15 @@ export async function resolveLegacyTodoDetails(
   for (const [source, idSet] of idsBySource.entries()) {
     const ids = Array.from(idSet)
     if (!ids.length) continue
+    if (!isValidEntityIdShape(source)) {
+      // A legacy/malformed `todoSource` (e.g. a bare module name written before
+      // the value was required to be a `module:entity` id) does not resolve to
+      // any real table. Querying it anyway surfaces a raw DB error ("relation
+      // ... does not exist") as a dashboard-wide schema-mismatch banner instead
+      // of just leaving that row's details unresolved.
+      logger.warn('Skipping malformed legacy todo source', { component: 'todoCompatibility', source })
+      continue
+    }
     try {
       const result = await queryEngine.query<Record<string, unknown>>(source as EntityId, {
         tenantId,

package/src/modules/design_system/backend/design-system/page.meta.ts

@@ -3,9 +3,10 @@ export const metadata = {
   requireFeatures: ['design_system.view'],
   pageTitle: 'Design system',
   pageTitleKey: 'design_system.nav.title',
-  pageGroup: 'Developer',
-  pageGroupKey: 'design_system.nav.group',
+  pageGroup: 'Developers',
+  pageGroupKey: 'backend.nav.developers',
   pageOrder: 900,
+  pageContext: 'settings' as const,
   icon: 'shapes',
   breadcrumb: [{ label: 'Design system', labelKey: 'design_system.nav.title' }],
 }

package/src/modules/design_system/gallery/assets/README.md

@@ -0,0 +1,30 @@
+These local image fixtures were downloaded from the Open Mercato Figma design system (`qCq9z6q1if0mpoRstV5OEA`) for its component gallery on 2026-09-12.
+
+| Fixture | Figma node | Content |
+| --- | --- | --- |
+| `avatar-photo.png` | `246:11135` | James Brown, photo |
+| `avatar-memoji.png` | `246:11139` | James Brown, Memoji |
+| `avatar-illustration.png` | `246:11141` | James Brown, illustration |
+
+The gallery uses the production Avatar image API and its object-cover crop. These fixtures demonstrate content support; they do not claim exact parity with every Figma crop, persona, or size.
+
+The `social-*-filled.svg` and `social-*-stroke.svg` fixtures are unmodified exports of the logo instances in Social Buttons set `180:4264`. The 14 exact logo-instance IDs are recorded in `docs/design-system/figma-audit/button-compositions.json`. The gallery uses masks for the monochrome Apple, GitHub, and X stroke logos so they follow the semantic foreground in both themes; other logos retain their original colors. These are local component examples, with no authentication requests.
+
+Menu follow-up source assets (read-only SVG export, same Figma file):
+
+- `menu-mastercard.svg`: `214:1327`, Select Provider, 32×24.
+- `menu-apex.svg`: `254:5084`, Company Apex.
+- `menu-spotify.svg`: `214:394`, Brand Spotify.
+- `menu-united-states.svg`: `253:6415`, Country United States.
+
+Menu demos also reuse the existing Poland/Google PNGs and Avatar illustration. No remote image requests are made by the previews.
+
+- `input-european-union.svg`: exact read-only Figma SVG export of `253:6853`, used by the Amount Input source composition (`320:1532`).
+
+## Finance widget artwork
+
+The `finance-*` PNG/SVG files are original read-only Figma exports for the 32 finance widget compositions from component set `3963:7181`. Exact node IDs and export methods are recorded in `docs/design-system/figma-audit/finance-widgets-followup.json`. The exports retain source artwork and are bundled locally through `finance-widgets-artwork.ts`; no expiring asset URL is used at runtime.
+
+## Cryptocurrency artwork
+
+The 30 `crypto-*` PNG/SVG files are original read-only exports from the Cryptocurrency page (`6696:81120`). They include twelve coin marks, three wallet-provider logos, the source brand, Wei Chen profile photo and empty-search emoji, eight monochrome interface glyphs, and four 12px transaction status graphics. `cryptocurrency-artwork.ts` normalizes Vite and Next asset imports. Monochrome SVGs are used as masks with semantic foreground tokens; colored graphics retain their original bytes. Export node IDs are recorded in `docs/design-system/figma-audit/cryptocurrency-followup.json`.

package/src/modules/design_system/gallery/assets/crypto-clock.svg

@@ -0,0 +1,3 @@
+<svg width="18" height="18" viewBox="0 0 18 18" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M9 15.75C5.27198 15.75 2.25 12.728 2.25 9C2.25 5.27198 5.27198 2.25 9 2.25C12.728 2.25 15.75 5.27198 15.75 9C15.75 12.728 12.728 15.75 9 15.75ZM9 14.4C10.4322 14.4 11.8057 13.8311 12.8184 12.8184C13.8311 11.8057 14.4 10.4322 14.4 9C14.4 7.56783 13.8311 6.19432 12.8184 5.18162C11.8057 4.16893 10.4322 3.6 9 3.6C7.56783 3.6 6.19432 4.16893 5.18162 5.18162C4.16893 6.19432 3.6 7.56783 3.6 9C3.6 10.4322 4.16893 11.8057 5.18162 12.8184C6.19432 13.8311 7.56783 14.4 9 14.4ZM9.675 9H12.375V10.35H8.325V5.625H9.675V9Z" fill="#A4A4A4"/>
+</svg>

package/src/modules/design_system/gallery/assets/crypto-crown.svg

@@ -0,0 +1,3 @@
+<svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M2.47988 3.92L4.99988 5.6L7.51148 2.084C7.56698 2.00622 7.64026 1.94282 7.72521 1.89908C7.81016 1.85534 7.90433 1.83252 7.99988 1.83252C8.09543 1.83252 8.1896 1.85534 8.27455 1.89908C8.3595 1.94282 8.43278 2.00622 8.48828 2.084L10.9999 5.6L13.5199 3.92C13.6153 3.85655 13.7268 3.82172 13.8413 3.81964C13.9559 3.81756 14.0686 3.84831 14.1662 3.90825C14.2638 3.9682 14.3422 4.05483 14.3922 4.15792C14.4421 4.26101 14.4615 4.37624 14.4481 4.49L13.4623 12.8702C13.4451 13.0162 13.3749 13.1507 13.2651 13.2484C13.1553 13.346 13.0134 13.4 12.8665 13.4H3.13328C2.98632 13.4 2.84448 13.346 2.73466 13.2484C2.62484 13.1507 2.55468 13.0162 2.53748 12.8702L1.55168 4.4894C1.53836 4.37569 1.55785 4.26054 1.60785 4.15755C1.65786 4.05456 1.73628 3.96802 1.83387 3.90816C1.93146 3.84829 2.04414 3.8176 2.15861 3.81969C2.27307 3.82179 2.38455 3.8566 2.47988 3.92ZM7.99988 9.8C8.31814 9.8 8.62337 9.67357 8.84841 9.44853C9.07345 9.22348 9.19988 8.91826 9.19988 8.6C9.19988 8.28174 9.07345 7.97652 8.84841 7.75147C8.62337 7.52643 8.31814 7.4 7.99988 7.4C7.68162 7.4 7.3764 7.52643 7.15135 7.75147C6.92631 7.97652 6.79988 8.28174 6.79988 8.6C6.79988 8.91826 6.92631 9.22348 7.15135 9.44853C7.3764 9.67357 7.68162 9.8 7.99988 9.8Z" fill="#16A34A"/>
+</svg>

package/src/modules/design_system/gallery/assets/crypto-history.svg

@@ -0,0 +1,3 @@
+<svg width="18" height="18" viewBox="0 0 18 18" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M9 2.25C12.728 2.25 15.75 5.27198 15.75 9C15.75 12.728 12.728 15.75 9 15.75C5.27198 15.75 2.25 12.728 2.25 9H3.6C3.6 11.9822 6.01785 14.4 9 14.4C11.9822 14.4 14.4 11.9822 14.4 9C14.4 6.01785 11.9822 3.6 9 3.6C7.14375 3.6 5.5062 4.53623 4.53488 5.9625H6.3V7.3125H2.25V3.2625H3.6V4.95C4.8312 3.30975 6.79208 2.25 9 2.25ZM9.675 5.625V8.71988L11.864 10.9089L10.9089 11.864L8.325 9.27878V5.625H9.675Z" fill="#A4A4A4"/>
+</svg>

package/src/modules/design_system/gallery/assets/crypto-link.svg

@@ -0,0 +1,3 @@
+<svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M10.795 7.08243L11.8563 8.14368C12.3438 8.63119 12.7306 9.20997 12.9944 9.84697C13.2583 10.484 13.3941 11.1667 13.3941 11.8562C13.3941 12.5457 13.2583 13.2284 12.9944 13.8654C12.7306 14.5024 12.3438 15.0812 11.8563 15.5687L11.5908 15.8334C10.6061 16.818 9.27071 17.3712 7.87825 17.3712C6.48579 17.3712 5.15037 16.818 4.16575 15.8334C3.18113 14.8488 2.62798 13.5134 2.62798 12.1209C2.62798 10.7285 3.18113 9.39305 4.16575 8.40843L5.227 9.46968C4.87628 9.81734 4.59768 10.2309 4.4072 10.6865C4.21672 11.1421 4.1181 11.6309 4.11702 12.1247C4.11594 12.6185 4.21241 13.1077 4.4009 13.5642C4.58938 14.0206 4.86617 14.4354 5.21536 14.7846C5.56456 15.1338 5.97929 15.4106 6.43574 15.599C6.8922 15.7875 7.38139 15.884 7.87522 15.8829C8.36906 15.8818 8.85782 15.7832 9.31345 15.5927C9.76907 15.4023 10.1826 15.1237 10.5303 14.7729L10.7958 14.5074C11.4988 13.8042 11.8937 12.8505 11.8937 11.8562C11.8937 10.8618 11.4988 9.90816 10.7958 9.20493L9.7345 8.14368L10.7958 7.08318L10.795 7.08243ZM15.8335 11.5907L14.773 10.5302C15.1237 10.1825 15.4023 9.769 15.5928 9.31338C15.7833 8.85775 15.8819 8.36899 15.883 7.87515C15.8841 7.38132 15.7876 6.89213 15.5991 6.43567C15.4106 5.97922 15.1338 5.56449 14.7846 5.21529C14.4354 4.8661 14.0207 4.58931 13.5643 4.40082C13.1078 4.21234 12.6186 4.11587 12.1248 4.11695C11.6309 4.11803 11.1422 4.21664 10.6866 4.40713C10.2309 4.59761 9.81741 4.87621 9.46975 5.22693L9.20425 5.49243C8.50123 6.19566 8.1063 7.14931 8.1063 8.14368C8.1063 9.13805 8.50123 10.0917 9.20425 10.7949L10.2655 11.8562L9.20425 12.9167L8.14375 11.8562C7.65619 11.3687 7.26943 10.7899 7.00556 10.1529C6.74168 9.5159 6.60587 8.83316 6.60587 8.14368C6.60587 7.4542 6.74168 6.77146 7.00556 6.13447C7.26943 5.49747 7.65619 4.91869 8.14375 4.43118L8.40925 4.16643C9.39387 3.18181 10.7293 2.62866 12.1218 2.62866C13.5142 2.62866 14.8496 3.18181 15.8342 4.16643C16.8189 5.15105 17.372 6.48647 17.372 7.87893C17.372 9.27139 16.8189 10.6068 15.8342 11.5914L15.8335 11.5907Z" fill="#A4A4A4"/>
+</svg>

package/src/modules/design_system/gallery/assets/crypto-menu.svg

@@ -0,0 +1,3 @@
+<svg width="18" height="18" viewBox="0 0 18 18" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M2.92505 3.6001H15.075V4.9501H2.92505V3.6001ZM6.97505 8.3251H15.075V9.6751H6.97505V8.3251ZM2.92505 13.0501H15.075V14.4001H2.92505V13.0501Z" fill="#A4A4A4"/>
+</svg>

package/src/modules/design_system/gallery/assets/crypto-more.svg

@@ -0,0 +1,3 @@
+<svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M10 3.25C9.38125 3.25 8.875 3.75625 8.875 4.375C8.875 4.99375 9.38125 5.5 10 5.5C10.6187 5.5 11.125 4.99375 11.125 4.375C11.125 3.75625 10.6187 3.25 10 3.25ZM10 14.5C9.38125 14.5 8.875 15.0063 8.875 15.625C8.875 16.2437 9.38125 16.75 10 16.75C10.6187 16.75 11.125 16.2437 11.125 15.625C11.125 15.0063 10.6187 14.5 10 14.5ZM10 8.875C9.38125 8.875 8.875 9.38125 8.875 10C8.875 10.6188 9.38125 11.125 10 11.125C10.6187 11.125 11.125 10.6188 11.125 10C11.125 9.38125 10.6187 8.875 10 8.875Z" fill="#A4A4A4"/>
+</svg>

package/src/modules/design_system/gallery/assets/crypto-rewards.svg

@@ -0,0 +1,3 @@
+<svg width="18" height="18" viewBox="0 0 18 18" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M10.875 3.375H14.625V14.625H3.375V10.875H5.875V8.375H8.375V5.875H10.875V3.375ZM12.125 4.625V7.125H9.625V9.625H7.125V12.125H4.625V13.375H13.375V4.625H12.125Z" fill="#A4A4A4"/>
+</svg>

package/src/modules/design_system/gallery/assets/crypto-star.svg

@@ -0,0 +1,3 @@
+<svg width="18" height="18" viewBox="0 0 18 18" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M9.00011 1.5L11.2043 5.96619L16.1331 6.68237L12.5666 10.1588L13.4085 15.0677L9.00011 12.75L4.59172 15.0677L5.43365 10.1588L1.86719 6.68237L6.79592 5.96619L9.00011 1.5Z" stroke="#A4A4A4" stroke-width="1.2" stroke-linecap="round"/>
+</svg>

package/src/modules/design_system/gallery/assets/crypto-status-cancelled.svg

@@ -0,0 +1,3 @@
+<svg width="12" height="12" viewBox="0 0 12 12" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M6 12C2.6862 12 0 9.3138 0 6C0 2.6862 2.6862 0 6 0C9.3138 0 12 2.6862 12 6C12 9.3138 9.3138 12 6 12ZM6 5.1516L4.3032 3.4542L3.4542 4.3032L5.1516 6L3.4542 7.6968L4.3032 8.5458L6 6.8484L7.6968 8.5458L8.5458 7.6968L6.8484 6L8.5458 4.3032L7.6968 3.4542L6 5.1516Z" fill="#A4A4A4"/>
+</svg>

package/src/modules/design_system/gallery/assets/crypto-status-pending.svg

@@ -0,0 +1,3 @@
+<svg width="12" height="12" viewBox="0 0 12 12" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M6 12C2.6862 12 0 9.3138 0 6C0 2.6862 2.6862 0 6 0C9.3138 0 12 2.6862 12 6C12 9.3138 9.3138 12 6 12ZM6.6 6V3H5.4V7.2H9V6H6.6Z" fill="#F6B51E"/>
+</svg>

package/src/modules/design_system/gallery/assets/crypto-status-success.svg

@@ -0,0 +1,3 @@
+<svg width="12" height="12" viewBox="0 0 12 12" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M6 12C2.6862 12 0 9.3138 0 6C0 2.6862 2.6862 0 6 0C9.3138 0 12 2.6862 12 6C12 9.3138 9.3138 12 6 12ZM5.4018 8.4L9.6438 4.1574L8.7954 3.309L5.4018 6.7032L3.7044 5.0058L2.856 5.8542L5.4018 8.4Z" fill="#16A34A"/>
+</svg>

package/src/modules/design_system/gallery/assets/crypto-status-warning.svg

@@ -0,0 +1,3 @@
+<svg width="12" height="12" viewBox="0 0 12 12" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M6 12C2.6862 12 0 9.3138 0 6C0 2.6862 2.6862 0 6 0C9.3138 0 12 2.6862 12 6C12 9.3138 9.3138 12 6 12ZM5.4 7.8V9H6.6V7.8H5.4ZM5.4 3V6.6H6.6V3H5.4Z" fill="#D97706"/>
+</svg>

package/src/modules/design_system/gallery/assets/cryptocurrency-artwork.ts

@@ -0,0 +1,63 @@
+import statusSuccess from './crypto-status-success.svg'
+import statusPending from './crypto-status-pending.svg'
+import statusWarning from './crypto-status-warning.svg'
+import statusCancelled from './crypto-status-cancelled.svg'
+import brand from './crypto-brand.png'
+import phantom from './crypto-phantom.png'
+import metamask from './crypto-metamask.png'
+import walletconnect from './crypto-walletconnect.png'
+import btc from './crypto-btc.png'
+import eth from './crypto-eth.png'
+import xrp from './crypto-xrp.png'
+import usdt from './crypto-usdt.png'
+import bnb from './crypto-bnb.png'
+import sol from './crypto-sol.png'
+import usdc from './crypto-usdc.png'
+import trx from './crypto-trx.png'
+import ada from './crypto-ada.png'
+import avax from './crypto-avax.png'
+import hbar from './crypto-hbar.png'
+import dot from './crypto-dot.png'
+import crown from './crypto-crown.svg'
+import star from './crypto-star.svg'
+import menu from './crypto-menu.svg'
+import history from './crypto-history.svg'
+import clock from './crypto-clock.svg'
+import rewards from './crypto-rewards.svg'
+import link from './crypto-link.svg'
+import more from './crypto-more.svg'
+import wei from './crypto-wei.png'
+import sadFace from './crypto-sad-face.png'
+const source = (image: string | { src: string }) => (typeof image === 'string' ? image : image.src)
+export const cryptoArtwork = {
+  statusSuccess: source(statusSuccess),
+  statusPending: source(statusPending),
+  statusWarning: source(statusWarning),
+  statusCancelled: source(statusCancelled),
+  brand: source(brand),
+  phantom: source(phantom),
+  metamask: source(metamask),
+  walletconnect: source(walletconnect),
+  btc: source(btc),
+  eth: source(eth),
+  xrp: source(xrp),
+  usdt: source(usdt),
+  bnb: source(bnb),
+  sol: source(sol),
+  usdc: source(usdc),
+  trx: source(trx),
+  ada: source(ada),
+  avax: source(avax),
+  hbar: source(hbar),
+  dot: source(dot),
+  crown: source(crown),
+  star: source(star),
+  menu: source(menu),
+  history: source(history),
+  clock: source(clock),
+  rewards: source(rewards),
+  link: source(link),
+  more: source(more),
+  wei: source(wei),
+  sadFace: source(sadFace),
+}

package/src/modules/design_system/gallery/assets/images.d.ts

@@ -0,0 +1,9 @@
+declare module '*.png' {
+  const image: string | { readonly src: string; readonly width: number; readonly height: number }
+  export default image
+}
+
+declare module '*.svg' {
+  const image: string | { readonly src: string; readonly width: number; readonly height: number }
+  export default image
+}

package/src/modules/design_system/gallery/assets/input-european-union.svg

@@ -0,0 +1,18 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_253_6853)">
+<path d="M12 24C18.6274 24 24 18.6274 24 12C24 5.37258 18.6274 0 12 0C5.37258 0 0 5.37258 0 12C0 18.6274 5.37258 24 12 24Z" fill="#0052B4"/>
+<path d="M12 4.69556L12.3886 5.89129H13.6458L12.6286 6.63028L13.0172 7.82601L12 7.08698L10.9828 7.82601L11.3714 6.63028L10.3542 5.89129H11.6115L12 4.69556Z" fill="#FFDA44"/>
+<path d="M6.83499 6.83503L7.9553 7.40578L8.84428 6.51685L8.64755 7.75856L9.76781 8.32936L8.52605 8.52605L8.32936 9.76786L7.75856 8.6476L6.51685 8.84433L7.40583 7.95535L6.83499 6.83503Z" fill="#FFDA44"/>
+<path d="M4.69568 11.9998L5.89141 11.6112V10.354L6.63035 11.3712L7.82613 10.9826L7.08705 11.9998L7.82613 13.0169L6.63035 12.6284L5.89141 13.6456V12.3883L4.69568 11.9998Z" fill="#FFDA44"/>
+<path d="M6.83499 17.165L7.40578 16.0446L6.51685 15.1557L7.75861 15.3524L8.32931 14.2322L8.52605 15.4739L9.76777 15.6706L8.64764 16.2414L8.84428 17.4831L7.9553 16.5942L6.83499 17.165Z" fill="#FFDA44"/>
+<path d="M12 19.3042L11.6114 18.1085H10.3542L11.3714 17.3695L10.9828 16.1738L12 16.9128L13.0172 16.1738L12.6286 17.3695L13.6458 18.1085H12.3885L12 19.3042Z" fill="#FFDA44"/>
+<path d="M17.165 17.165L16.0447 16.5942L15.1557 17.4832L15.3524 16.2414L14.2322 15.6706L15.474 15.4739L15.6706 14.2322L16.2414 15.3524L17.4831 15.1557L16.5941 16.0447L17.165 17.165Z" fill="#FFDA44"/>
+<path d="M19.3043 11.9998L18.1086 12.3883V13.6456L17.3696 12.6284L16.174 13.0169L16.9129 11.9998L16.174 10.9826L17.3696 11.3712L18.1086 10.354V11.6113L19.3043 11.9998Z" fill="#FFDA44"/>
+<path d="M17.165 6.83499L16.5942 7.9553L17.4832 8.84428L16.2413 8.6475L15.6706 9.76777L15.474 8.526L14.2322 8.32927L15.3524 7.75852L15.1557 6.51685L16.0448 7.40578L17.165 6.83499Z" fill="#FFDA44"/>
+</g>
+<defs>
+<clipPath id="clip0_253_6853">
+<rect width="24" height="24" fill="white"/>
+</clipPath>
+</defs>
+</svg>