Merge branch 'fix/loop-globeloader-error-boundary' into 'main'

fix(ui): infinite-loop + GlobeLoader + AppErrorBoundary + a11y modals

See merge request 2-6/2-6-4/terravault/ordinis!94
This commit is contained in:
Александр Зимин
2026-05-11 19:48:59 +00:00
17 changed files with 907 additions and 23 deletions
+7 -1
View File
@@ -31,6 +31,7 @@
"class-variance-authority": "^0.7.1",
"clsx": "^2.1.1",
"d3-force": "^3.0.0",
"d3-geo": "^3.1.1",
"i18next": "^26.0.3",
"i18next-browser-languagedetector": "^8.0.2",
"leaflet": "^1.9.4",
@@ -44,7 +45,9 @@
"react-oidc-context": "^3.3.1",
"sonner": "^2.0.7",
"tailwind-merge": "^3.6.0",
"tw-animate-css": "^1.4.0"
"topojson-client": "^3.1.0",
"tw-animate-css": "^1.4.0",
"world-atlas": "^2.0.2"
},
"devDependencies": {
"@semantic-release/changelog": "^6.0.3",
@@ -59,9 +62,12 @@
"@testing-library/react": "^16.3.2",
"@testing-library/user-event": "^14.6.1",
"@types/d3-force": "^3.0.10",
"@types/d3-geo": "^3.1.0",
"@types/geojson": "^7946.0.16",
"@types/leaflet": "^1.9.21",
"@types/react": "^19.0.0",
"@types/react-dom": "^19.0.0",
"@types/topojson-client": "^3.1.5",
"@vitejs/plugin-react": "^4.3.4",
"conventional-changelog-conventionalcommits": "^9.3.1",
"jsdom": "^29.1.1",
+80
View File
@@ -68,6 +68,9 @@ importers:
d3-force:
specifier: ^3.0.0
version: 3.0.0
d3-geo:
specifier: ^3.1.1
version: 3.1.1
i18next:
specifier: ^26.0.3
version: 26.0.8(typescript@5.9.3)
@@ -107,9 +110,15 @@ importers:
tailwind-merge:
specifier: ^3.6.0
version: 3.6.0
topojson-client:
specifier: ^3.1.0
version: 3.1.0
tw-animate-css:
specifier: ^1.4.0
version: 1.4.0
world-atlas:
specifier: ^2.0.2
version: 2.0.2
devDependencies:
'@semantic-release/changelog':
specifier: ^6.0.3
@@ -147,6 +156,12 @@ importers:
'@types/d3-force':
specifier: ^3.0.10
version: 3.0.10
'@types/d3-geo':
specifier: ^3.1.0
version: 3.1.0
'@types/geojson':
specifier: ^7946.0.16
version: 7946.0.16
'@types/leaflet':
specifier: ^1.9.21
version: 1.9.21
@@ -156,6 +171,9 @@ importers:
'@types/react-dom':
specifier: ^19.0.0
version: 19.2.3(@types/react@19.2.14)
'@types/topojson-client':
specifier: ^3.1.5
version: 3.1.5
'@vitejs/plugin-react':
specifier: ^4.3.4
version: 4.7.0(vite@6.4.2(jiti@2.6.1)(lightningcss@1.32.0))
@@ -1619,6 +1637,9 @@ packages:
'@types/d3-force@3.0.10':
resolution: {integrity: sha512-ZYeSaCF3p73RdOKcjj+swRlZfnYpK1EbaDiYICEEp5Q6sUiqFaFQ9qgoshp5CzIyyb/yD09kD9o2zEltCexlgw==}
'@types/d3-geo@3.1.0':
resolution: {integrity: sha512-856sckF0oP/diXtS4jNsiQw/UuK5fQG8l/a9VVLeSouf1/PPbBE1i1W852zVwKwYCBkFJJB7nCFTbk6UMEXBOQ==}
'@types/estree@1.0.8':
resolution: {integrity: sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==}
@@ -1642,6 +1663,12 @@ packages:
'@types/react@19.2.14':
resolution: {integrity: sha512-ilcTH/UniCkMdtexkoCN0bI7pMcJDvmQFPvuPvmEaYA/NSfFTAgdUSLAoVjaRJm7+6PvcM+q1zYOwS4wTYMF9w==}
'@types/topojson-client@3.1.5':
resolution: {integrity: sha512-C79rySTyPxnQNNguTZNI1Ct4D7IXgvyAs3p9HPecnl6mNrJ5+UhvGNYcZfpROYV2lMHI48kJPxwR+F9C6c7nmw==}
'@types/topojson-specification@1.0.5':
resolution: {integrity: sha512-C7KvcQh+C2nr6Y2Ub4YfgvWvWCgP2nOQMtfhlnwsRL4pYmmwzBS7HclGiS87eQfDOU/DLQpX6GEscviaz4yLIQ==}
'@vitejs/plugin-react@4.7.0':
resolution: {integrity: sha512-gUu9hwfWvvEDBBmgtAowQCojwZmJ5mcLn3aufeCsitijs3+f2NsrPtlAWIR6OPiqljl96GVCUbLe0HyqIpVaoA==}
engines: {node: ^14.18.0 || >=16.0.0}
@@ -1898,6 +1925,9 @@ packages:
resolution: {integrity: sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==}
engines: {node: '>= 0.8'}
commander@2.20.3:
resolution: {integrity: sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ==}
compare-func@2.0.0:
resolution: {integrity: sha512-zHig5N+tPWARooBnb0Zx1MFcdfpyJrfTJ3Y5L+IFvUm8rM74hHz66z0gw0x4tijh5CorKkKUCnW82R2vmpeCRA==}
@@ -1966,6 +1996,10 @@ packages:
csstype@3.2.3:
resolution: {integrity: sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==}
d3-array@3.2.4:
resolution: {integrity: sha512-tdQAmyA18i4J7wprpYq8ClcxZy3SC31QMeByyCFyRt7BVHdREQZ5lpzoe5mFEYZUWe+oq8HBvk9JjpibyEV4Jg==}
engines: {node: '>=12'}
d3-dispatch@3.0.1:
resolution: {integrity: sha512-rzUyPU/S7rwUflMyLc1ETDeBj0NRuHKKAcvukozwhshr6g6c5d8zh4c2gQjY2bZ0dXeGLWc1PF174P2tVvKhfg==}
engines: {node: '>=12'}
@@ -1974,6 +2008,10 @@ packages:
resolution: {integrity: sha512-zxV/SsA+U4yte8051P4ECydjD/S+qeYtnaIyAs9tgHCqfguma/aAQDjo85A9Z6EKhBirHRJHXIgJUlffT4wdLg==}
engines: {node: '>=12'}
d3-geo@3.1.1:
resolution: {integrity: sha512-637ln3gXKXOwhalDzinUgY83KzNWZRKbYubaG+fGVuc/dxO64RRljtCTnf5ecMyE1RIdtqpkVcq0IbtU2S8j2Q==}
engines: {node: '>=12'}
d3-quadtree@3.0.1:
resolution: {integrity: sha512-04xDrxQTDTCFwP5H6hRhsRcb9xxv2RzkcsygFzmkSIOJy3PeRJP7sNk3VRIbKXcog561P9oU0/rVH6vDROAgUw==}
engines: {node: '>=12'}
@@ -2407,6 +2445,10 @@ packages:
ini@1.3.8:
resolution: {integrity: sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew==}
internmap@2.0.3:
resolution: {integrity: sha512-5Hh7Y1wQbvY5ooGgPbDaL5iYLAPzMTUrjMulskHLH6wnv/A+1q5rgEaiuqEjB+oxGXIVZs1FF+R/KPN3ZSQYYg==}
engines: {node: '>=12'}
is-arrayish@0.2.1:
resolution: {integrity: sha512-zz06S8t0ozoDXMG+ube26zeCTNXcKIPJZJi8hBrF4idCLms4CG9QtK7qBl1boi5ODzFpjswb5JPmHCbMpjaYzg==}
@@ -3422,6 +3464,10 @@ packages:
resolution: {integrity: sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==}
engines: {node: '>=8.0'}
topojson-client@3.1.0:
resolution: {integrity: sha512-605uxS6bcYxGXw9qi62XyrV6Q3xwbndjachmNxu8HWTtVPxZfEJN9fd/SZS1Q54Sn2y0TMyMxFj/cJINqGHrKw==}
hasBin: true
tough-cookie@6.0.1:
resolution: {integrity: sha512-LktZQb3IeoUWB9lqR5EWTHgW/VTITCXg4D21M+lvybRVdylLrRMnqaIONLVb5mav8vM19m44HIcGq4qASeu2Qw==}
engines: {node: '>=16'}
@@ -3677,6 +3723,9 @@ packages:
wordwrap@1.0.0:
resolution: {integrity: sha512-gvVzJFlPycKc5dZN4yPkP8w7Dc37BtP1yczEneOb4uq34pXZcvrtRTmWV8W+Ume+XCxKgbjM+nevkyFPMybd4Q==}
world-atlas@2.0.2:
resolution: {integrity: sha512-IXfV0qwlKXpckz1FhwXVwKRjiIhOnWttOskm5CtxMsjgE/MXAYRHWJqgXOpM8IkcPBoXnyTU5lFHcYa5ChG0LQ==}
wrap-ansi@7.0.0:
resolution: {integrity: sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==}
engines: {node: '>=10'}
@@ -5017,6 +5066,10 @@ snapshots:
'@types/d3-force@3.0.10': {}
'@types/d3-geo@3.1.0':
dependencies:
'@types/geojson': 7946.0.16
'@types/estree@1.0.8': {}
'@types/geojson@7946.0.16': {}
@@ -5037,6 +5090,15 @@ snapshots:
dependencies:
csstype: 3.2.3
'@types/topojson-client@3.1.5':
dependencies:
'@types/geojson': 7946.0.16
'@types/topojson-specification': 1.0.5
'@types/topojson-specification@1.0.5':
dependencies:
'@types/geojson': 7946.0.16
'@vitejs/plugin-react@4.7.0(vite@6.4.2(jiti@2.6.1)(lightningcss@1.32.0))':
dependencies:
'@babel/core': 7.29.0
@@ -5317,6 +5379,8 @@ snapshots:
dependencies:
delayed-stream: 1.0.0
commander@2.20.3: {}
compare-func@2.0.0:
dependencies:
array-ify: 1.0.0
@@ -5386,6 +5450,10 @@ snapshots:
csstype@3.2.3: {}
d3-array@3.2.4:
dependencies:
internmap: 2.0.3
d3-dispatch@3.0.1: {}
d3-force@3.0.0:
@@ -5394,6 +5462,10 @@ snapshots:
d3-quadtree: 3.0.1
d3-timer: 3.0.1
d3-geo@3.1.1:
dependencies:
d3-array: 3.2.4
d3-quadtree@3.0.1: {}
d3-timer@3.0.1: {}
@@ -5856,6 +5928,8 @@ snapshots:
ini@1.3.8: {}
internmap@2.0.3: {}
is-arrayish@0.2.1: {}
is-binary-path@2.1.0:
@@ -6697,6 +6771,10 @@ snapshots:
dependencies:
is-number: 7.0.0
topojson-client@3.1.0:
dependencies:
commander: 2.20.3
tough-cookie@6.0.1:
dependencies:
tldts: 7.0.30
@@ -6888,6 +6966,8 @@ snapshots:
wordwrap@1.0.0: {}
world-atlas@2.0.2: {}
wrap-ansi@7.0.0:
dependencies:
ansi-styles: 4.3.0
@@ -1,6 +1,6 @@
import { useMemo, useState } from 'react'
import { useTranslation } from 'react-i18next'
import { Dialog, DialogContent } from '@/ui'
import { Dialog, DialogContent, DialogTitle, DialogDescription } from '@/ui'
import type { DictionaryDetail, FlattenedRecord } from '@/api/client'
import { cn } from '@/lib/utils'
@@ -175,6 +175,16 @@ export function ExportModal({
return (
<Dialog open={open} onOpenChange={(v) => !v && onClose()}>
<DialogContent size="xl" className="!p-0 gap-0">
{/* Radix a11y: visually-hidden Title + Description. Visible heading
* рендерится ниже как кастомный layout. */}
<DialogTitle className="sr-only">
{t('export.title', { defaultValue: 'Экспорт' })} {detail.name}
</DialogTitle>
<DialogDescription className="sr-only">
{t('export.description', {
defaultValue: 'Выбор формата, объёма и колонок для выгрузки.',
})}
</DialogDescription>
{/* Header */}
<div className="px-6 py-4 border-b border-line">
<div className="text-cap text-mute tracking-[0.18em] uppercase">
@@ -1,4 +1,4 @@
import { useEffect, useMemo, useState } from 'react'
import { useEffect, useMemo, useRef, useState } from 'react'
import { useForm, Controller, type Path, type SubmitHandler } from 'react-hook-form'
import { useTranslation } from 'react-i18next'
import Ajv, { type ErrorObject } from 'ajv'
@@ -70,6 +70,10 @@ type Props = {
}
const ajv = new Ajv({ allErrors: true, strict: false })
// Stable empty-object literal — используется как default для dataValues
// чтобы не создавать новый `{}` на каждый render (deps memo invalidation).
const EMPTY_DATA: Record<string, unknown> = Object.freeze({})
addFormats(ajv)
const isLocalized = (s: JsonSchema): boolean => Boolean(s['x-localized'])
@@ -149,7 +153,12 @@ export const SchemaDrivenForm = ({
// search: substring match (case-insensitive) против key OR labelOf(key)
// onlyFilled: hide fields где data[key] empty (null/undefined/''/false/[]/0)
// Применяется только в sections layout (drawer use case).
const dataValues = (mode === 'edit' ? defaultValues?.data : undefined) ?? {}
// useMemo чтобы default {} не создавал new object literal каждый render —
// иначе isFieldVisible useMemo ниже invalidate'ится → каскад re-renders.
const dataValues = useMemo(
() => (mode === 'edit' ? defaultValues?.data : undefined) ?? EMPTY_DATA,
[mode, defaultValues?.data],
)
const isFieldVisible = useMemo(() => {
const search = (searchFilter ?? '').trim().toLowerCase()
return (key: string): boolean => {
@@ -183,9 +192,18 @@ export const SchemaDrivenForm = ({
const totalFieldCount = buckets.identity.length + buckets.description.length + buckets.extra.length
const visibleFieldCount =
filteredBuckets.identity.length + filteredBuckets.description.length + filteredBuckets.extra.length
// Ref-pattern для callback: parent часто передаёт inline arrow
// (() => setState(...)) — identity меняется каждый render. Если включить
// callback в effect deps → effect fires → setState → re-render → loop
// ("Maximum update depth exceeded"). Держим latest callback в ref и
// вызываем по value-deps только. (review #infinite-loop-2026-05-11)
const onCounterChangeRef = useRef(onCounterChange)
useEffect(() => {
onCounterChange?.(visibleFieldCount, totalFieldCount)
}, [visibleFieldCount, totalFieldCount, onCounterChange])
onCounterChangeRef.current = onCounterChange
})
useEffect(() => {
onCounterChangeRef.current?.(visibleFieldCount, totalFieldCount)
}, [visibleFieldCount, totalFieldCount])
const submit: SubmitHandler<FormValues> = (values) => {
if (values.validFrom && values.validTo) {
@@ -243,9 +261,15 @@ export const SchemaDrivenForm = ({
: 0
return top + dataDirty
}, [formState.dirtyFields])
// Same ref-pattern as onCounterChange: parent's inline callback identity
// changes every render → loop. Subscribe to value (dirtyCount) only.
const onDirtyChangeRef = useRef(onDirtyChange)
useEffect(() => {
onDirtyChange?.(dirtyCount)
}, [dirtyCount, onDirtyChange])
onDirtyChangeRef.current = onDirtyChange
})
useEffect(() => {
onDirtyChangeRef.current?.(dirtyCount)
}, [dirtyCount])
// Section visibility — в 'sections' layout все buckets рендерятся подряд,
// в 'tabs' — только active. Sections layout per handoff Screen 3 prototype.
@@ -0,0 +1,87 @@
import { useTranslation } from 'react-i18next'
import { useRouter } from '@tanstack/react-router'
import { useState } from 'react'
import { Button } from '@/ui'
import { GlobeLoader } from '@/ui/components/globe-loader'
/**
* AppErrorBoundary — friendly UI который рендерится через TanStack Router
* `errorComponent` когда route выкидывает unhandled exception (включая
* "Maximum update depth exceeded" infinite loops).
*
* Юзер видит:
* - illustrated GlobeLoader (статичный paused)
* - "Что-то пошло не так. Попробуйте обновить страницу"
* - кнопки [Обновить] / [На главную]
* - dev-only collapsible с raw error (только в dev mode, не в prod)
*
* НЕ показывает raw stack trace в prod — это утечка деталей реализации
* и тревожит юзера.
*/
export type AppErrorBoundaryProps = {
error: Error
reset?: () => void
}
export function AppErrorBoundary({ error, reset }: AppErrorBoundaryProps) {
const { t } = useTranslation()
const router = useRouter()
const [showDetails, setShowDetails] = useState(false)
// Vite dev mode → import.meta.env.DEV — показываем raw error для разработки.
const isDev = import.meta.env.DEV
const handleRetry = () => {
if (reset) reset()
else router.invalidate()
}
const handleHome = () => {
router.navigate({ to: '/dictionaries' })
}
return (
<div
role="alert"
className="min-h-[60vh] flex flex-col items-center justify-center px-6 py-12 text-center"
>
<div className="opacity-40 mb-6">
<GlobeLoader size={120} />
</div>
<h1 className="text-title-xl text-ink font-semibold mb-2">
{t('error.boundary.title', { defaultValue: 'Что-то пошло не так' })}
</h1>
<p className="text-body text-mute max-w-md mb-6">
{t('error.boundary.description', {
defaultValue:
'Произошла непредвиденная ошибка при отображении страницы. Попробуйте обновить — обычно это помогает. Если повторится, сообщите нам.',
})}
</p>
<div className="flex items-center gap-2">
<Button variant="primary" size="sm" onClick={handleRetry}>
{t('error.boundary.retry', { defaultValue: 'Обновить' })}
</Button>
<Button variant="ghost" size="sm" onClick={handleHome}>
{t('error.boundary.home', { defaultValue: 'На главную' })}
</Button>
</div>
{isDev && (
<div className="mt-8 w-full max-w-2xl text-left">
<button
type="button"
onClick={() => setShowDetails((v) => !v)}
className="text-cell text-mute hover:text-ink-2 underline underline-offset-2"
>
{showDetails ? 'Скрыть детали (dev)' : 'Показать детали (dev)'}
</button>
{showDetails && (
<pre className="mt-2 rounded-md border border-line bg-surface-2 p-3 text-mono text-cell text-ink-2 overflow-auto max-h-64 whitespace-pre-wrap">
{error.message}
{error.stack ? `\n\n${error.stack}` : ''}
</pre>
)}
</div>
)}
</div>
)
}
@@ -1,7 +1,7 @@
import { useMemo } from 'react'
import { useTranslation } from 'react-i18next'
import { ArrowsClockwiseIcon, WarningIcon } from '@phosphor-icons/react'
import { Dialog, DialogContent } from '@/ui'
import { Dialog, DialogContent, DialogTitle, DialogDescription } from '@/ui'
import { useRecordRaw } from '@/api/queries'
import type { CreateRecordRequest } from '@/api/client'
import { cn } from '@/lib/utils'
@@ -75,6 +75,17 @@ export function ConflictDiffModal({
return (
<Dialog open={open} onOpenChange={(v) => !v && onClose()}>
<DialogContent size="lg" className="!p-0 gap-0 max-h-[85vh]">
{/* Radix a11y: visually-hidden Title + Description satisfy
* DialogContent requirements. Visible header — custom layout ниже. */}
<DialogTitle className="sr-only">
{t('conflict.title', { defaultValue: 'Запись изменена другим пользователем' })}
</DialogTitle>
<DialogDescription className="sr-only">
{t('conflict.description', {
defaultValue:
'Сравнение локальных правок с актуальным состоянием на сервере.',
})}
</DialogDescription>
{/* Header */}
<div className="flex items-start gap-3 px-6 py-4 border-b border-line">
<div className="size-8 rounded-md bg-warn-bg inline-flex items-center justify-center shrink-0">
@@ -156,6 +156,12 @@ export function RecordDrawer({
<DialogPrimitive.Title id={titleId} className="text-cap text-mute truncate">
{caption}
</DialogPrimitive.Title>
{/* sr-only Description чтобы Radix не ругался на missing
* `aria-describedby` (a11y warning). Visible description нам не
* нужен — caption + recordId уже описывают drawer. */}
<DialogPrimitive.Description className="sr-only">
{caption}{recordId ? ` (${recordId})` : ''}
</DialogPrimitive.Description>
{recordId && (
<div className="text-mono text-ink-2 truncate mt-0.5">{recordId}</div>
)}
@@ -1,7 +1,7 @@
import { useMemo, useState } from 'react'
import { useTranslation } from 'react-i18next'
import { ClockCounterClockwiseIcon, CaretLeftIcon, CaretRightIcon, XIcon } from '@phosphor-icons/react'
import { Dialog, DialogContent } from '@/ui'
import { Dialog, DialogContent, DialogTitle, DialogDescription } from '@/ui'
import type { DictionaryDetail } from '@/api/client'
import { cn } from '@/lib/utils'
@@ -127,6 +127,16 @@ export function TimeTravelModal({
return (
<Dialog open={open} onOpenChange={(v) => !v && onClose()}>
<DialogContent size="full" className="!p-0 gap-0 max-h-[95vh]" hideClose>
{/* Radix a11y: sr-only Title + Description. Visible header — custom layout ниже. */}
<DialogTitle className="sr-only">
{t('timeTravel.title', { defaultValue: 'Состояние справочника на момент времени' })}
</DialogTitle>
<DialogDescription className="sr-only">
{t('timeTravel.description', {
defaultValue:
'Сравнение текущего состояния справочника с выбранной точкой во времени.',
})}
</DialogDescription>
{/* Header */}
<div className="flex items-start gap-3 px-6 py-4 border-b border-line">
<div className="size-8 rounded-md bg-surface-2 inline-flex items-center justify-center shrink-0">
+4
View File
@@ -4,6 +4,7 @@ import { useState } from 'react'
import { Sidebar, MobileSidebar } from '@/components/layout/Sidebar'
import { TopBar } from '@/components/layout/TopBar'
import { UpdateBanner } from '@/components/version/UpdateBanner'
import { AppErrorBoundary } from '@/components/layout/AppErrorBoundary'
/**
* Root layout (Stage 3.1 + 3.x mobile responsive):
@@ -24,6 +25,9 @@ import { UpdateBanner } from '@/components/version/UpdateBanner'
*/
export const Route = createRootRouteWithContext<{ queryClient: QueryClient }>()({
component: RootLayout,
// Catch unhandled errors inside any route — show friendly UI instead of
// TanStack default "Something went wrong! Hide Error" + raw stack trace.
errorComponent: AppErrorBoundary,
})
function RootLayout() {
@@ -598,6 +598,25 @@ function DictionaryDetail() {
return false
}, [detailQuery.data?.schemaJson])
// Full-page loader пока ОБА query (detail + records) не готовы. Иначе
// юзер видит partial render — узкая колонка без extra columns, info panel
// ещё не появилась, бар нагружается частями. Per user: "вот такого не
// должно быть, лучше лоадер".
if (detailQuery.isLoading || (!detailQuery.data && !detailQuery.error)) {
return (
<div className="min-h-[60vh] flex items-center justify-center">
<LoadingBlock size="lg" label={t('loading')} />
</div>
)
}
if (detailQuery.error) {
return (
<Alert variant="error" title={t('error.failed')}>
{String(detailQuery.error)}
</Alert>
)
}
return (
<div className="space-y-6">
{scope && (
@@ -185,7 +185,13 @@ function DictionariesPage() {
</button>
) : null
if (isLoading) return <LoadingBlock size="md" label={t('loading')} />
if (isLoading) {
return (
<div className="min-h-[60vh] flex items-center justify-center">
<LoadingBlock size="lg" label={t('loading')} />
</div>
)
}
if (error) {
return (
<Alert variant="error" title={t('error.failed')}>
+38
View File
@@ -374,6 +374,44 @@ body {
color: var(--color-mute);
}
/* === GlobeLoader keyframes orbital spinner (src/ui/components/globe-loader.tsx).
* Класс .globe-loader на wrapper'е активирует вложенные .globe-* animations
* через стандартные CSS animation rules. Transform-only GPU-композитятся. */
@keyframes ord-globe-spin {
to { transform: rotate(360deg); }
}
@keyframes ord-globe-pulse {
0%, 100% { opacity: 0.18; }
50% { opacity: 0.42; }
}
/* transform-box default = view-box для SVG elements transform-origin
* считается в SVG user coordinates (viewBox 0 0 200 200). 100px 100px =
* центр глобуса. Прошлая версия с transform-box: fill-box ломала орбиты
* (origin становился offset bounding-box'а каждой группы арки летали
* вокруг неправильной точки). Прототип HTML использует default copy. */
.globe-loader .globe-whirl {
transform-origin: 100px 100px;
animation: ord-globe-spin 3.6s linear infinite;
}
.globe-loader .globe-whirl-rev {
transform-origin: 100px 100px;
animation: ord-globe-spin 5.4s linear infinite reverse;
}
.globe-loader .globe-pulse {
transform-origin: 100px 100px;
animation: ord-globe-pulse 2.4s ease-in-out infinite;
}
/* Sphere/land внутри globe-loader rotates через d3 projection (rAF
* пересчитывает path d-attr), не через CSS transform иначе land
* distort'илась бы при rotation (no projection math). */
@media (prefers-reduced-motion: reduce) {
.globe-loader .globe-whirl,
.globe-loader .globe-whirl-rev,
.globe-loader .globe-pulse {
animation: none;
}
}
/* === Legacy fallback: старые компоненты используют nstart token names
* (--color-carbon, --color-ultramarain etc). Маппим их на новые pending
* полная миграция. === */
@@ -0,0 +1,225 @@
import { useEffect, useId as useReactId, useRef, useState } from 'react'
import { geoOrthographic, geoPath, geoGraticule10 } from 'd3-geo'
import type { Feature, FeatureCollection, Geometry } from 'geojson'
import { cn } from '@/lib/utils'
/**
* GlobeLoader orbital globe spinner per /Users/zimin/Downloads/Globe loader
* prototype. Real Natural Earth land outline через d3-geo orthographic
* projection, rotating longitude continuously. Outer whirl arcs + pulsing
* ring CSS-only.
*
* <p>Lazy-loads world-atlas (~55kb) пока геометрия не доехала, видны
* только sphere + graticule + orbital arcs (still looks like a loader).
*
* <p>Использование:
* <GlobeLoader /> // 64px default
* <GlobeLoader size={120} /> // larger
* <GlobeLoader className="text-mute" /> // tint via currentColor
*/
export type GlobeLoaderProps = {
/** Pixel size of the spinner square (default 64). */
size?: number
/** Optional label rendered below. */
label?: React.ReactNode
/** Extra wrapper class. */
className?: string
}
// Cache загруженной land geometry между mount'ами loader'а (типично загрузка
// списка → переход в editor → ещё loader). Без cache каждый GlobeLoader
// триггерил бы import заново — Vite кеширует chunk, но parse cost есть.
let LAND_CACHE: Feature<Geometry> | null = null
let LAND_PROMISE: Promise<Feature<Geometry>> | null = null
async function loadLand(): Promise<Feature<Geometry>> {
if (LAND_CACHE) return LAND_CACHE
if (LAND_PROMISE) return LAND_PROMISE
LAND_PROMISE = (async () => {
const [{ feature }, world] = await Promise.all([
import('topojson-client'),
import('world-atlas/land-110m.json'),
])
const data = (world as { default: unknown }).default ?? world
// topojson-client expects Topology с objects.land mesh.
const f = feature(
data as Parameters<typeof feature>[0],
(data as { objects: { land: Parameters<typeof feature>[1] } }).objects.land,
) as Feature<Geometry> | FeatureCollection<Geometry>
const result = 'features' in f ? (f.features[0] as Feature<Geometry>) : f
LAND_CACHE = result
return result
})()
return LAND_PROMISE
}
export function GlobeLoader({ size = 64, label, className }: GlobeLoaderProps) {
const id = useReactId().replace(/:/g, '')
const tailA = `globe-tail-a-${id}`
const tailB = `globe-tail-b-${id}`
const sphereRef = useRef<SVGPathElement>(null)
const gratRef = useRef<SVGPathElement>(null)
const landRef = useRef<SVGPathElement>(null)
const [landReady, setLandReady] = useState(false)
useEffect(() => {
// Setup projection: orthographic, R=70 (как в прототипе), tilt -15° (легкий
// northern lean). viewBox 200x200 — fixed; scale projection относительно него.
const projection = geoOrthographic()
.scale(70)
.translate([100, 100])
.clipAngle(90)
.rotate([0, -15, 0])
const path = geoPath(projection)
const graticule = geoGraticule10()
// Initial render (без land — оно lazy).
if (sphereRef.current) sphereRef.current.setAttribute('d', path({ type: 'Sphere' }) ?? '')
if (gratRef.current) gratRef.current.setAttribute('d', path(graticule) ?? '')
let landFeature: Feature<Geometry> | null = LAND_CACHE
let cancelled = false
if (!landFeature) {
void loadLand().then((f) => {
if (cancelled) return
landFeature = f
if (landRef.current) landRef.current.setAttribute('d', path(f) ?? '')
setLandReady(true)
})
} else {
if (landRef.current) landRef.current.setAttribute('d', path(landFeature) ?? '')
setLandReady(true)
}
// Animate rotation — 8s per revolution per prototype.
const start = performance.now()
const period = 8000
let raf = 0
const frame = (now: number) => {
if (cancelled) return
const t = ((now - start) % period) / period
const lambda = t * 360
projection.rotate([lambda, -15, 0])
if (gratRef.current) gratRef.current.setAttribute('d', path(graticule) ?? '')
if (landFeature && landRef.current) {
landRef.current.setAttribute('d', path(landFeature) ?? '')
}
raf = requestAnimationFrame(frame)
}
raf = requestAnimationFrame(frame)
return () => {
cancelled = true
cancelAnimationFrame(raf)
}
}, [])
return (
<div
role="status"
aria-busy="true"
aria-label="loading"
className={cn('inline-flex flex-col items-center justify-center gap-2 text-ink', className)}
>
<div className="globe-loader relative" style={{ width: size, height: size }}>
{/* Outer overlay svg: whirl arcs + pulse ring (CSS-animated). */}
<svg viewBox="0 0 200 200" className="absolute inset-0 size-full overflow-visible">
<defs>
<linearGradient id={tailA} gradientUnits="userSpaceOnUse" x1="0" y1="0" x2="200" y2="0">
<stop offset="0%" stopColor="currentColor" stopOpacity="0" />
<stop offset="60%" stopColor="currentColor" stopOpacity="0.18" />
<stop offset="100%" stopColor="currentColor" stopOpacity="0.95" />
</linearGradient>
<linearGradient id={tailB} gradientUnits="userSpaceOnUse" x1="0" y1="0" x2="200" y2="0">
<stop offset="0%" stopColor="currentColor" stopOpacity="0" />
<stop offset="70%" stopColor="currentColor" stopOpacity="0.12" />
<stop offset="100%" stopColor="currentColor" stopOpacity="0.55" />
</linearGradient>
</defs>
{/* Pulsing outermost dashed ring */}
<g className="globe-pulse">
<circle
cx="100"
cy="100"
r="96"
fill="none"
stroke="currentColor"
strokeWidth="0.6"
strokeDasharray="1 4"
/>
</g>
{/* Outer whirl: 270° tail arc + leading dot + ghost arc */}
<g className="globe-whirl">
<path
d="M 100 4 A 96 96 0 1 1 4 100"
fill="none"
stroke={`url(#${tailA})`}
strokeWidth="2"
strokeLinecap="round"
/>
<circle cx="100" cy="4" r="2.4" fill="currentColor" />
<path
d="M 100 12 A 88 88 0 0 1 188 100"
fill="none"
stroke={`url(#${tailB})`}
strokeWidth="1.2"
strokeLinecap="round"
opacity="0.7"
/>
</g>
{/* Inner whirl, counter-rotating */}
<g className="globe-whirl-rev">
<path
d="M 100 18 A 82 82 0 1 1 18 100"
fill="none"
stroke={`url(#${tailA})`}
strokeWidth="1.1"
strokeLinecap="round"
opacity="0.55"
/>
<circle cx="100" cy="18" r="1.6" fill="currentColor" opacity="0.85" />
</g>
</svg>
{/* Globe svg: real orthographic projection с rotating land. */}
<svg viewBox="0 0 200 200" className="absolute inset-0 size-full overflow-visible">
{/* Sphere disk silhouette (fill = bg чтобы land не светилось через
* прозрачное место). */}
<path
ref={sphereRef}
fill="var(--color-bg, #f4f1ec)"
stroke="currentColor"
strokeWidth="1.25"
/>
{/* Graticule — subtle lat/lon grid. */}
<path
ref={gratRef}
fill="none"
stroke="currentColor"
strokeWidth="0.4"
strokeOpacity="0.18"
/>
{/* Land Natural Earth outline, rotated continuously. fill-opacity
* 0.88 чтобы slightly soften. */}
<path
ref={landRef}
fill="currentColor"
fillOpacity={landReady ? 0.88 : 0}
stroke="var(--color-bg, #f4f1ec)"
strokeWidth="0.35"
strokeLinejoin="round"
style={{ transition: 'fill-opacity 0.3s ease' }}
/>
</svg>
</div>
{label && <span className="text-body text-mute">{label}</span>}
</div>
)
}
@@ -1,14 +1,15 @@
import { Loader2 } from 'lucide-react'
import { cn } from '@/lib/utils'
import { GlobeLoader } from './globe-loader'
/**
* LoadingBlock central spinner с подписью. Заменяет {@code @nstart/ui}
* LoadingBlock. Для inline placeholder используйте Skeleton.
* LoadingBlock central spinner с подписью. Используется везде где
* загружаются данные / окна. С 11.05.2026 заменили Loader2 spinner на
* GlobeLoader (orbital globe loader per /Users/zimin/Downloads/Globe loader).
*
* Size variants:
* - sm: small inline spinner (py-4)
* - md: default centered (py-12)
* - lg: prominent (py-20)
* - sm: small inline (py-4, 32px globe)
* - md: default centered (py-12, 64px globe)
* - lg: prominent full-page (py-20, 96px globe)
*/
export type LoadingBlockProps = React.HTMLAttributes<HTMLDivElement> & {
label?: React.ReactNode
@@ -16,9 +17,9 @@ export type LoadingBlockProps = React.HTMLAttributes<HTMLDivElement> & {
}
const SIZES = {
sm: { wrapper: 'py-4', icon: 'size-3' },
md: { wrapper: 'py-12', icon: 'size-5' },
lg: { wrapper: 'py-20', icon: 'size-8' },
sm: { wrapper: 'py-4', globe: 32 },
md: { wrapper: 'py-12', globe: 64 },
lg: { wrapper: 'py-20', globe: 96 },
} as const
export function LoadingBlock({ className, label, size = 'md', ...props }: LoadingBlockProps) {
@@ -28,14 +29,14 @@ export function LoadingBlock({ className, label, size = 'md', ...props }: Loadin
role="status"
aria-busy="true"
className={cn(
'flex flex-col items-center justify-center gap-2 text-mute',
'flex flex-col items-center justify-center gap-3 text-ink',
s.wrapper,
className,
)}
{...props}
>
<Loader2 className={cn('animate-spin text-accent', s.icon)} />
{label && <span className="text-body">{label}</span>}
<GlobeLoader size={s.globe} />
{label && <span className="text-body text-mute">{label}</span>}
</div>
)
}
+1
View File
@@ -78,6 +78,7 @@ export { Panel, type PanelProps } from './components/panel'
export { PageHeader, type PageHeaderProps } from './components/page-header'
export { EmptyState, type EmptyStateProps } from './components/empty-state'
export { LoadingBlock, type LoadingBlockProps } from './components/loading-block'
export { GlobeLoader, type GlobeLoaderProps } from './components/globe-loader'
// === Tables ===
export {