@open-mercato/core 0.6.7-develop.6863.1.61001cf9a8 → 0.6.7

package/src/modules/data_sync/i18n/ko.json

@@ -1,125 +0,0 @@
-{
-  "data_sync.dashboard.actions.view": "보기",
-  "data_sync.dashboard.columns.created": "생성됨",
-  "data_sync.dashboard.columns.createdAt": "시작됨",
-  "data_sync.dashboard.columns.direction": "방향",
-  "data_sync.dashboard.columns.entityType": "엔터티 유형",
-  "data_sync.dashboard.columns.failed": "실패",
-  "data_sync.dashboard.columns.integration": "통합",
-  "data_sync.dashboard.columns.status": "상태",
-  "data_sync.dashboard.columns.updated": "수정됨",
-  "data_sync.dashboard.direction.export": "내보내기",
-  "data_sync.dashboard.direction.import": "가져오기",
-  "data_sync.dashboard.filters.allDirections": "모든 방향",
-  "data_sync.dashboard.filters.allStatuses": "모든 상태",
-  "data_sync.dashboard.filters.status": "상태",
-  "data_sync.dashboard.loadError": "동기화 실행을 불러오지 못했습니다",
-  "data_sync.dashboard.noRuns": "아직 동기화 실행 기록이 없습니다",
-  "data_sync.dashboard.schedule.cron": "Cron",
-  "data_sync.dashboard.schedule.cronHelp": "예: `0 * * * *`는 매시 정각에 실행됩니다.",
-  "data_sync.dashboard.schedule.cronValue": "Cron 표현식",
-  "data_sync.dashboard.schedule.delete": "일정 제거",
-  "data_sync.dashboard.schedule.deleteError": "반복 일정 제거에 실패했습니다",
-  "data_sync.dashboard.schedule.deleteSuccess": "반복 일정이 제거되었습니다",
-  "data_sync.dashboard.schedule.deleting": "제거 중...",
-  "data_sync.dashboard.schedule.description": "이 대시보드를 벗어나지 않고 선택한 통합, 엔터티, 방향에 대한 반복 일정을 저장하세요.",
-  "data_sync.dashboard.schedule.enabled": "일정 활성화됨",
-  "data_sync.dashboard.schedule.enabledHelp": "일정 정의를 삭제하지 않고 반복 작업을 일시 중지합니다.",
-  "data_sync.dashboard.schedule.error": "반복 일정 저장에 실패했습니다",
-  "data_sync.dashboard.schedule.fullSync": "예약된 작업을 전체 동기화로 실행",
-  "data_sync.dashboard.schedule.fullSyncHelp": "활성화하면 모든 반복 실행이 저장된 커서 대신 처음부터 시작됩니다.",
-  "data_sync.dashboard.schedule.interval": "간격",
-  "data_sync.dashboard.schedule.intervalHelp": "예: 반복 간격으로 `1h`, `6h`, `24h`를 사용하세요.",
-  "data_sync.dashboard.schedule.intervalValue": "간격",
-  "data_sync.dashboard.schedule.invalidValue": "저장하기 전에 일정 값을 입력하세요.",
-  "data_sync.dashboard.schedule.lastRun": "마지막 예약 실행: {value}",
-  "data_sync.dashboard.schedule.neverRun": "저장되었지만 아직 완료된 예약 실행이 없습니다.",
-  "data_sync.dashboard.schedule.none": "이 대상에 대해 저장된 반복 일정이 아직 없습니다.",
-  "data_sync.dashboard.schedule.save": "반복 일정 저장",
-  "data_sync.dashboard.schedule.saving": "저장 중...",
-  "data_sync.dashboard.schedule.status.disabled": "반복 일정 일시 중지됨",
-  "data_sync.dashboard.schedule.status.enabled": "반복 일정 활성",
-  "data_sync.dashboard.schedule.status.none": "반복 일정 없음",
-  "data_sync.dashboard.schedule.status.shortDisabled": "일시 중지됨",
-  "data_sync.dashboard.schedule.status.shortEnabled": "예약됨",
-  "data_sync.dashboard.schedule.status.shortNone": "1회성",
-  "data_sync.dashboard.schedule.success": "반복 일정이 저장되었습니다",
-  "data_sync.dashboard.schedule.timezone": "표준 시간대",
-  "data_sync.dashboard.schedule.title": "반복 일정",
-  "data_sync.dashboard.schedule.type": "일정 유형",
-  "data_sync.dashboard.searchPlaceholder": "통합, 엔터티 유형, 상태 또는 실행 ID로 검색",
-  "data_sync.dashboard.start.batchSize": "배치 크기",
-  "data_sync.dashboard.start.description": "이 페이지에서 동기화 대상을 선택하고, 임시 실행을 시작하거나, 동일한 엔터티와 방향에 대한 반복 일정을 저장하세요.",
-  "data_sync.dashboard.start.error": "동기화 실행을 시작하지 못했습니다",
-  "data_sync.dashboard.start.eyebrow": "한 번만 실행하거나 반복 실행 유지",
-  "data_sync.dashboard.start.fullSync": "전체 동기화로 실행",
-  "data_sync.dashboard.start.fullSyncHelp": "저장된 커서를 무시하고 이 실행에 대해 전체 소스를 다시 처리합니다.",
-  "data_sync.dashboard.start.invalidBatchSize": "배치 크기는 1에서 1000 사이여야 합니다.",
-  "data_sync.dashboard.start.providerManaged": "이 통합은 자체 설정 흐름에서 동기화 실행을 시작합니다. 계속하려면 통합 설정 페이지를 여세요.",
-  "data_sync.dashboard.start.runNowDescription": "다음 즉시 동기화에 사용하세요. 배치 크기와 전체 동기화 모드는 이 수동 실행에만 적용됩니다.",
-  "data_sync.dashboard.start.runNowFootnote": "수동 실행은 즉시 진행 상황을 표시하며 시작 후 실행 상세 페이지로 이동합니다.",
-  "data_sync.dashboard.start.runNowTitle": "지금 한 번 실행",
-  "data_sync.dashboard.start.status.credentialsMissing": "자격 증명 누락",
-  "data_sync.dashboard.start.status.credentialsReady": "자격 증명 준비됨",
-  "data_sync.dashboard.start.status.disabled": "통합 비활성화됨",
-  "data_sync.dashboard.start.status.enabled": "통합 활성화됨",
-  "data_sync.dashboard.start.submit": "동기화 시작",
-  "data_sync.dashboard.start.success": "동기화 실행이 시작되었습니다",
-  "data_sync.dashboard.start.title": "동기화 시작 또는 예약",
-  "data_sync.dashboard.status.cancelled": "취소됨",
-  "data_sync.dashboard.status.completed": "완료됨",
-  "data_sync.dashboard.status.failed": "실패",
-  "data_sync.dashboard.status.paused": "일시 중지됨",
-  "data_sync.dashboard.status.pending": "대기 중",
-  "data_sync.dashboard.status.running": "실행 중",
-  "data_sync.dashboard.title": "동기화 실행",
-  "data_sync.integrationTab.columns.actions": "작업",
-  "data_sync.integrationTab.columns.lastRun": "마지막 실행",
-  "data_sync.integrationTab.columns.value": "값",
-  "data_sync.integrationTab.credentialsMissing": "동기화를 시작하기 전에 자격 증명을 구성하세요.",
-  "data_sync.integrationTab.credentialsMissingNotice": "자격 증명이 아직 없습니다. 원한다면 먼저 일정을 저장할 수 있지만, 자격 증명이 구성될 때까지 수동 및 예약 실행은 실패합니다.",
-  "data_sync.integrationTab.description": "통합 상세 페이지에서 직접 일회성 동기화를 실행하거나 지원되는 모든 엔터티에 대한 반복 일정을 저장하세요.",
-  "data_sync.integrationTab.empty": "이 제공업체는 아직 예약 가능한 동기화 엔터티를 제공하지 않습니다.",
-  "data_sync.integrationTab.fullSyncShort": "전체",
-  "data_sync.integrationTab.integrationDisabled": "동기화를 시작하기 전에 통합을 활성화하세요.",
-  "data_sync.integrationTab.integrationDisabledNotice": "통합이 비활성화되어 있습니다. 지금 일정을 저장할 수 있지만 통합이 활성화될 때까지 실행이 차단됩니다.",
-  "data_sync.integrationTab.loadError": "동기화 일정을 불러오지 못했습니다.",
-  "data_sync.integrationTab.notAvailable": "이 통합은 데이터 동기화 제공업체로 등록되어 있지 않습니다.",
-  "data_sync.integrationTab.providerManaged": "이 통합은 제공업체별 설정 흐름에서 시작하세요.",
-  "data_sync.integrationTab.providerManagedNotice": "이 제공업체는 실행을 시작하기 전에 자체 설정 흐름이 필요합니다. 일반 일정 대신 이 페이지의 제공업체 탭을 사용하세요.",
-  "data_sync.integrationTab.refresh": "새로고침",
-  "data_sync.integrationTab.runError": "동기화 시작에 실패했습니다.",
-  "data_sync.integrationTab.runNowHelp": "지금 실행은 같은 행의 전체 동기화 체크박스를 사용하며 Data Sync에서 즉시 진행 상황 추적을 시작합니다.",
-  "data_sync.integrationTab.runNowTitle": "수동 실행",
-  "data_sync.integrationTab.runStarted": "동기화 실행이 시작되었습니다.",
-  "data_sync.integrationTab.start": "지금 실행",
-  "data_sync.integrationTab.starting": "시작하는 중...",
-  "data_sync.integrationTab.title": "동기화 일정",
-  "data_sync.nav.title": "데이터 동기화",
-  "data_sync.runs.detail.back": "동기화 실행으로 돌아가기",
-  "data_sync.runs.detail.cancel": "취소",
-  "data_sync.runs.detail.cancelError": "동기화 실행 취소에 실패했습니다",
-  "data_sync.runs.detail.cancelSuccess": "동기화 실행이 취소되었습니다",
-  "data_sync.runs.detail.counters.created": "생성됨",
-  "data_sync.runs.detail.counters.failed": "실패",
-  "data_sync.runs.detail.counters.skipped": "건너뜀",
-  "data_sync.runs.detail.counters.updated": "업데이트됨",
-  "data_sync.runs.detail.error": "오류",
-  "data_sync.runs.detail.loadError": "동기화 실행을 불러오지 못했습니다",
-  "data_sync.runs.detail.logs": "작업 로그",
-  "data_sync.runs.detail.logs.level": "레벨",
-  "data_sync.runs.detail.logs.message": "메시지",
-  "data_sync.runs.detail.logs.time": "시간",
-  "data_sync.runs.detail.noLogs": "로그 항목 없음",
-  "data_sync.runs.detail.notFound": "동기화 실행을 찾을 수 없습니다.",
-  "data_sync.runs.detail.progress": "진행 상황",
-  "data_sync.runs.detail.progress.batches": "{count}개 배치",
-  "data_sync.runs.detail.progress.eta": "{eta} 남음",
-  "data_sync.runs.detail.progress.itemsProcessed": "{count}개 항목 처리됨",
-  "data_sync.runs.detail.progress.itemsProcessedTotal": "{total}개 중 {processed}개 항목 처리됨",
-  "data_sync.runs.detail.progress.percent": "{percent}% 완료",
-  "data_sync.runs.detail.retry": "재시도",
-  "data_sync.runs.detail.retryError": "동기화 실행 재시도에 실패했습니다",
-  "data_sync.runs.detail.retrySuccess": "동기화 실행이 재시도되었습니다",
-  "data_sync.runs.detail.title": "동기화 실행"
-}

package/src/modules/data_sync/lib/queue-policy.ts

@@ -1,30 +0,0 @@
-/**
- * Queue names whose jobs resume an existing SyncRun instead of starting a fresh
- * one. The workers import these to declare their `metadata.queue`, so a rename
- * cannot silently drop the retry policy.
- */
-export const DATA_SYNC_IMPORT_QUEUE = 'data-sync-import'
-export const DATA_SYNC_EXPORT_QUEUE = 'data-sync-export'
-
-export const DATA_SYNC_RESUMABLE_QUEUES: readonly string[] = [DATA_SYNC_IMPORT_QUEUE, DATA_SYNC_EXPORT_QUEUE]
-
-export const DATA_SYNC_QUEUE_ATTEMPTS = 3
-
-/**
- * A backfill batch can hold the processor well past BullMQ's 30s default lock,
- * so these jobs stall on slow upstreams even when the worker is perfectly
- * healthy. `DATA_SYNC_LOCK_DURATION_MS` is the primary defence — it stops most
- * of those false stalls at the source rather than reacting to them.
- *
- * `DATA_SYNC_MAX_STALLED_COUNT` covers what is left. BullMQ fails a job once it
- * stalls more than this many times, and at the default of 1 a single stall
- * during a long backfill discards the run permanently. 10 buys enough
- * redeliveries to survive a rolling restart. Raising it is only safe because a
- * duplicate delivery can no longer corrupt the run: the ownership
- * compare-and-swap in `commitBatchProgress` lets exactly one worker advance a
- * run, and every other delivery aborts on its first commit. A job that poisons its
- * worker still dies — after 10 stalls, with the run left `running` and its
- * cursor unmoved, which is the state the admin runs list surfaces.
- */
-export const DATA_SYNC_LOCK_DURATION_MS = 120_000
-export const DATA_SYNC_MAX_STALLED_COUNT = 10

package/src/modules/design_system/AGENTS.md

@@ -1,34 +0,0 @@
-# Design System Module — Agent Guidelines
-
-Live component gallery at `/backend/design-system`, gated by `design_system.view`. Entries are plain data (`gallery/entries/<family>.tsx`) listed in the family manifest (`gallery/registry.ts`) and lazy-loaded per family. The gallery is a DS consumer: it must showcase the DS without ever violating it.
-
-## Registry Contract
-
-- `gallery/types.ts` defines `GalleryVariant` / `GalleryEntry` / `GalleryFamily` — do not extend them casually; the shapes are the spec contract (`.ai/specs/2026-07-05-ds-live-component-gallery.md`).
-- A family = one manifest row in `galleryFamilies` + one `entries/<id>.tsx` exporting `entries: GalleryEntry[]`.
-- Every variant keeps `render` and `code` side by side in one object literal; review them together — colocation is the drift defense.
-
-## Always
-
-1. **MUST keep every variant `code` snippet containing the entry's `importPath`** — enforced by `gallery/__tests__/registry-integrity.test.ts`.
-2. **MUST update the coverage allowlist honestly** — when adding a primitive entry, delete its row from `PENDING_FAMILIES` in `gallery/__tests__/gallery-coverage.test.ts`; when a new primitive lands without an entry, add it there with a one-line reason. `PENDING_FAMILIES` must only shrink as families land.
-3. **MUST use semantic tokens only** in gallery chrome (`border-border`, `bg-background`, `bg-muted`, `text-muted-foreground`) and lucide icons only.
-4. **MUST route all gallery chrome strings through `i18n/` in all four locales** (en, pl, es, de) via `useT()`. Component titles and variant names (`Button`, `destructive-soft`) are proper nouns and stay untranslated.
-5. **MUST render entries with inline mock props only** — the gallery never calls tenant APIs and never renders tenant data.
-6. **MUST keep `figmaNodeId` in `<page>:<node>` format** pointing into `DS_FIGMA_FILE`; omit it when unknown — never guess node ids.
-
-## Never
-
-- Never add gallery-specific props or code to `packages/ui` — the gallery consumes primitives exactly as any other module does.
-- Never hardcode colors, arbitrary sizes, or full-pill chips in gallery chrome.
-- Never add API routes, entities, DI registrations, or tenant-scoped anything to this module.
-- Never remove a file from the primitives coverage enumeration by loosening the test — only entries or allowlist rows with reasons.
-
-## Validation Commands
-
-```bash
-yarn generate
-yarn workspace @open-mercato/core test --testPathPattern design_system
-yarn workspace @open-mercato/core typecheck
-yarn i18n:check-hardcoded
-```

package/src/modules/design_system/acl.ts

@@ -1,5 +0,0 @@
-export const features = [
-  { id: 'design_system.view', title: 'View the design system gallery', module: 'design_system' },
-]
-
-export default features

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

@@ -1,11 +0,0 @@
-export const metadata = {
-  requireAuth: true,
-  requireFeatures: ['design_system.view'],
-  pageTitle: 'Design system',
-  pageTitleKey: 'design_system.nav.title',
-  pageGroup: 'Developer',
-  pageGroupKey: 'design_system.nav.group',
-  pageOrder: 900,
-  icon: 'shapes',
-  breadcrumb: [{ label: 'Design system', labelKey: 'design_system.nav.title' }],
-}

package/src/modules/design_system/backend/design-system/page.tsx

@@ -1,14 +0,0 @@
-"use client"
-
-import { Page, PageBody } from '@open-mercato/ui/backend/Page'
-import { GalleryShell } from '../../gallery/components/GalleryShell'
-
-export default function DesignSystemGalleryPage() {
-  return (
-    <Page>
-      <PageBody>
-        <GalleryShell />
-      </PageBody>
-    </Page>
-  )
-}

package/src/modules/design_system/gallery/components/CodeSnippet.tsx

@@ -1,55 +0,0 @@
-'use client'
-
-import * as React from 'react'
-import { Copy } from 'lucide-react'
-import { useT } from '@open-mercato/shared/lib/i18n/context'
-import { IconButton } from '@open-mercato/ui/primitives/icon-button'
-import { flash } from '@open-mercato/ui/backend/FlashMessages'
-
-export function CodeSnippet({ code }: { code: string }) {
-  const t = useT()
-  const copyLabel = t('design_system.gallery.copy', 'Copy code')
-
-  const onCopy = React.useCallback(async () => {
-    try {
-      if (navigator.clipboard) {
-        await navigator.clipboard.writeText(code)
-      } else {
-        // Non-secure contexts (plain-HTTP self-hosted installs) have no
-        // navigator.clipboard — fall back to the legacy selection API.
-        const holder = document.createElement('textarea')
-        holder.value = code
-        holder.setAttribute('readonly', '')
-        holder.style.position = 'fixed'
-        holder.style.opacity = '0'
-        document.body.appendChild(holder)
-        holder.select()
-        const copied = document.execCommand('copy')
-        holder.remove()
-        if (!copied) throw new Error('[internal] execCommand copy failed')
-      }
-      flash(t('design_system.gallery.copied', 'Snippet copied to clipboard'), 'success')
-    } catch {
-      flash(t('design_system.gallery.copyFailed', 'Could not copy the snippet'), 'error')
-    }
-  }, [code, t])
-
-  return (
-    <div className="relative rounded-md border border-border bg-muted/50">
-      <pre className="overflow-x-auto p-3 pr-12 text-xs leading-relaxed">
-        <code>{code}</code>
-      </pre>
-      <IconButton
-        type="button"
-        variant="ghost"
-        size="sm"
-        className="absolute right-1.5 top-1.5"
-        aria-label={copyLabel}
-        title={copyLabel}
-        onClick={onCopy}
-      >
-        <Copy />
-      </IconButton>
-    </div>
-  )
-}

package/src/modules/design_system/gallery/components/EntryCard.tsx

@@ -1,95 +0,0 @@
-'use client'
-
-import * as React from 'react'
-import { Check, ExternalLink, X } from 'lucide-react'
-import { useT } from '@open-mercato/shared/lib/i18n/context'
-import { LinkButton } from '@open-mercato/ui/primitives/link-button'
-import type { GalleryEntry } from '../types'
-import { DS_DOCS_URL, figmaNodeUrl } from '../registry'
-import { VariantPreview } from './VariantPreview'
-import { CodeSnippet } from './CodeSnippet'
-
-export function EntryCard({ entry }: { entry: GalleryEntry }) {
-  const t = useT()
-
-  return (
-    <section
-      id={`gallery-entry-${entry.id}`}
-      aria-labelledby={`gallery-entry-${entry.id}-title`}
-      className="scroll-mt-4 space-y-4 rounded-lg border border-border bg-card p-4"
-    >
-      <div className="flex flex-col gap-2 sm:flex-row sm:items-start sm:justify-between">
-        <div className="min-w-0 space-y-1">
-          <h3 id={`gallery-entry-${entry.id}-title`} className="text-base font-semibold leading-tight">
-            {entry.title}
-          </h3>
-          {entry.descriptionKey ? (
-            <p className="text-sm text-muted-foreground">{t(entry.descriptionKey, entry.title)}</p>
-          ) : null}
-          <code className="block truncate text-xs text-muted-foreground">{entry.importPath}</code>
-        </div>
-        <div className="flex shrink-0 items-center gap-3">
-          {entry.figmaNodeId ? (
-            <LinkButton asChild size="sm">
-              <a href={figmaNodeUrl(entry.figmaNodeId)} target="_blank" rel="noreferrer">
-                {t('design_system.gallery.openInFigma', 'Open in Figma')}
-                <ExternalLink />
-              </a>
-            </LinkButton>
-          ) : null}
-          {entry.docsAnchor ? (
-            <LinkButton asChild size="sm" variant="gray">
-              <a href={`${DS_DOCS_URL}${entry.docsAnchor}`} target="_blank" rel="noreferrer">
-                {t('design_system.gallery.viewDocs', 'View docs')}
-                <ExternalLink />
-              </a>
-            </LinkButton>
-          ) : null}
-        </div>
-      </div>
-      {entry.usage && (entry.usage.do?.length || entry.usage.dont?.length) ? (
-        <div className="grid gap-4 rounded-md border border-border bg-muted/30 p-4 sm:grid-cols-2">
-          {entry.usage.do?.length ? (
-            <div className="space-y-1.5">
-              <div className="text-xs font-medium uppercase tracking-wider text-muted-foreground">
-                {t('design_system.gallery.usageDo', 'Do')}
-              </div>
-              <ul className="space-y-1.5">
-                {entry.usage.do.map((rule) => (
-                  <li key={rule} className="flex items-start gap-2 text-sm text-foreground">
-                    <Check aria-hidden className="mt-0.5 size-3.5 shrink-0 text-status-success-icon" />
-                    <span>{rule}</span>
-                  </li>
-                ))}
-              </ul>
-            </div>
-          ) : null}
-          {entry.usage.dont?.length ? (
-            <div className="space-y-1.5">
-              <div className="text-xs font-medium uppercase tracking-wider text-muted-foreground">
-                {t('design_system.gallery.usageDont', "Don't")}
-              </div>
-              <ul className="space-y-1.5">
-                {entry.usage.dont.map((rule) => (
-                  <li key={rule} className="flex items-start gap-2 text-sm text-foreground">
-                    <X aria-hidden className="mt-0.5 size-3.5 shrink-0 text-status-error-icon" />
-                    <span>{rule}</span>
-                  </li>
-                ))}
-              </ul>
-            </div>
-          ) : null}
-        </div>
-      ) : null}
-      <div className="space-y-4">
-        {entry.variants.map((variant) => (
-          <div key={variant.id} className="space-y-2">
-            <div className="text-sm font-medium text-foreground">{variant.title}</div>
-            <VariantPreview>{variant.render()}</VariantPreview>
-            <CodeSnippet code={variant.code} />
-          </div>
-        ))}
-      </div>
-    </section>
-  )
-}

package/src/modules/design_system/gallery/components/GalleryShell.tsx

@@ -1,206 +0,0 @@
-'use client'
-
-import * as React from 'react'
-import { useSearchParams } from 'next/navigation'
-import { useT } from '@open-mercato/shared/lib/i18n/context'
-import { SectionPage } from '@open-mercato/ui/backend/section-page'
-import type { SectionNavGroup } from '@open-mercato/ui/backend/section-page'
-import { SearchInput } from '@open-mercato/ui/primitives/search-input'
-import { Skeleton } from '@open-mercato/ui/primitives/skeleton'
-import { EmptyState } from '@open-mercato/ui/primitives/empty-state'
-import { Button } from '@open-mercato/ui/primitives/button'
-import { ErrorMessage } from '@open-mercato/ui/backend/detail'
-import type { GalleryEntry, GalleryFamily } from '../types'
-import { GALLERY_BASE_PATH, galleryFamilies } from '../registry'
-import { EntryCard } from './EntryCard'
-
-/** 'buttons' → 'Buttons' — untranslated fallback when a family labelKey has no message. */
-function familyLabelFallback(id: string): string {
-  return id.charAt(0).toUpperCase() + id.slice(1).replace(/[-_]/g, ' ')
-}
-
-function matchesQuery(entry: GalleryEntry, query: string): boolean {
-  const needle = query.trim().toLowerCase()
-  if (!needle) return true
-  if (entry.id.toLowerCase().includes(needle) || entry.title.toLowerCase().includes(needle)) return true
-  if (entry.keywords?.some((keyword) => keyword.toLowerCase().includes(needle))) return true
-  // 'radiobutton' should still find 'radio' — match when the query CONTAINS the id/title too.
-  return needle.includes(entry.id.toLowerCase()) || needle.includes(entry.title.toLowerCase())
-}
-
-type LoadedEntries = Record<string, GalleryEntry[]>
-
-export function GalleryShell() {
-  const t = useT()
-  const searchParams = useSearchParams()
-  const [loaded, setLoaded] = React.useState<LoadedEntries>({})
-  const [failed, setFailed] = React.useState<Record<string, boolean>>({})
-  const [search, setSearch] = React.useState('')
-  const pendingRef = React.useRef(new Set<string>())
-
-  const familyParam = searchParams?.get('family') ?? null
-  const entryParam = searchParams?.get('entry') ?? null
-
-  // Clicking a family in the section nav exits search mode — otherwise the
-  // query keeps precedence and family navigation appears dead.
-  React.useEffect(() => {
-    setSearch('')
-  }, [familyParam])
-  const activeFamily: GalleryFamily | undefined =
-    galleryFamilies.find((family) => family.id === familyParam) ?? galleryFamilies[0]
-  const activeFamilyId = activeFamily?.id ?? null
-
-  const loadFamily = React.useCallback((family: GalleryFamily) => {
-    if (pendingRef.current.has(family.id)) return
-    pendingRef.current.add(family.id)
-    setFailed((prev) => (prev[family.id] ? { ...prev, [family.id]: false } : prev))
-    family
-      .load()
-      .then((mod) => {
-        setLoaded((prev) => (prev[family.id] ? prev : { ...prev, [family.id]: mod.entries }))
-      })
-      .catch(() => {
-        pendingRef.current.delete(family.id)
-        setFailed((prev) => ({ ...prev, [family.id]: true }))
-      })
-  }, [])
-
-  // Lazy-load the active family; when searching, load every family so results
-  // span the whole gallery.
-  const searching = search.trim().length > 0
-  React.useEffect(() => {
-    if (searching) {
-      for (const family of galleryFamilies) loadFamily(family)
-    } else if (activeFamily) {
-      loadFamily(activeFamily)
-    }
-  }, [searching, activeFamily, loadFamily])
-
-  // Deep link: ?entry=<id> scrolls the entry into view once its family loaded.
-  const activeEntries = activeFamilyId ? loaded[activeFamilyId] : undefined
-  React.useEffect(() => {
-    if (!entryParam || searching || !activeEntries) return
-    const node = document.getElementById(`gallery-entry-${entryParam}`)
-    node?.scrollIntoView({ block: 'start' })
-  }, [entryParam, searching, activeEntries])
-
-  const sections: SectionNavGroup[] = React.useMemo(
-    () => [
-      {
-        id: 'families',
-        label: 'Families',
-        labelKey: 'design_system.gallery.familiesGroup',
-        items: galleryFamilies.map((family) => ({
-          id: family.id,
-          label: familyLabelFallback(family.id),
-          labelKey: family.labelKey,
-          icon: family.icon,
-          href: `${GALLERY_BASE_PATH}?family=${family.id}`,
-        })),
-      },
-    ],
-    [],
-  )
-
-  const renderFamilySkeleton = () => (
-    <div className="space-y-4" data-testid="gallery-family-skeleton">
-      <Skeleton className="h-40 w-full" />
-      <Skeleton className="h-40 w-full" />
-    </div>
-  )
-
-  const renderSearchResults = () => {
-    const groups = galleryFamilies
-      .map((family) => ({
-        family,
-        entries: (loaded[family.id] ?? []).filter((entry) => matchesQuery(entry, search)),
-      }))
-      .filter((group) => group.entries.length > 0)
-    const stillLoading = galleryFamilies.some((family) => !loaded[family.id] && !failed[family.id])
-    if (groups.length === 0 && stillLoading) return renderFamilySkeleton()
-    if (groups.length === 0) {
-      return (
-        <EmptyState
-          title={t('design_system.gallery.noResults', 'No components match your search')}
-        />
-      )
-    }
-    return (
-      <div className="space-y-8">
-        {groups.map(({ family, entries }) => (
-          <div key={family.id} className="space-y-4">
-            <h2 className="text-sm font-medium uppercase tracking-wider text-muted-foreground">
-              {t(family.labelKey, familyLabelFallback(family.id))}
-            </h2>
-            {entries.map((entry) => (
-              <EntryCard key={entry.id} entry={entry} />
-            ))}
-          </div>
-        ))}
-      </div>
-    )
-  }
-
-  const renderActiveFamily = () => {
-    if (!activeFamily) return null
-    const entries = loaded[activeFamily.id]
-    if (!entries && failed[activeFamily.id]) {
-      return (
-        <ErrorMessage
-          label={t('design_system.gallery.loadFailed', 'Could not load this family')}
-          action={
-            <Button type="button" variant="outline" size="sm" onClick={() => loadFamily(activeFamily)}>
-              {t('design_system.gallery.retry', 'Retry')}
-            </Button>
-          }
-        />
-      )
-    }
-    if (!entries) return renderFamilySkeleton()
-    return (
-      <div className="space-y-4">
-        <h2 className="text-lg font-semibold">
-          {t(activeFamily.labelKey, familyLabelFallback(activeFamily.id))}
-        </h2>
-        {entries.length > 1 ? (
-          <nav
-            aria-label={t('design_system.gallery.familyContents', 'Components in this family')}
-            className="flex flex-wrap items-center gap-1.5 rounded-md border border-border bg-muted/30 p-2"
-          >
-            {entries.map((entry) => (
-              <a
-                key={entry.id}
-                href={`#gallery-entry-${entry.id}`}
-                className="rounded-md border border-border bg-background px-2 py-1 text-xs text-foreground transition-colors hover:bg-muted focus-visible:outline-none focus-visible:shadow-focus"
-              >
-                {entry.title}
-              </a>
-            ))}
-          </nav>
-        ) : null}
-        {entries.map((entry) => (
-          <EntryCard key={entry.id} entry={entry} />
-        ))}
-      </div>
-    )
-  }
-
-  return (
-    <SectionPage
-      title="Design system"
-      titleKey="design_system.nav.title"
-      sections={sections}
-      activePath={activeFamilyId ? `${GALLERY_BASE_PATH}?family=${activeFamilyId}` : GALLERY_BASE_PATH}
-    >
-      <div className="mx-auto w-full max-w-5xl space-y-6">
-        <SearchInput
-          value={search}
-          onChange={setSearch}
-          placeholder={t('design_system.gallery.searchPlaceholder', 'Search components…')}
-          aria-label={t('design_system.gallery.searchPlaceholder', 'Search components…')}
-        />
-        {searching ? renderSearchResults() : renderActiveFamily()}
-      </div>
-    </SectionPage>
-  )
-}

package/src/modules/design_system/gallery/components/VariantPreview.tsx

@@ -1,15 +0,0 @@
-'use client'
-
-import * as React from 'react'
-
-/**
- * Bordered stage a variant renders inside. Chrome uses semantic tokens only —
- * the stage must never impose colors of its own on the previewed component.
- */
-export function VariantPreview({ children }: { children: React.ReactNode }) {
-  return (
-    <div className="flex flex-wrap items-center gap-3 rounded-md border border-border bg-background p-4">
-      {children}
-    </div>
-  )
-}