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:
@@ -0,0 +1,354 @@
|
||||
# Pending endpoints — frontend wishlist
|
||||
|
||||
Эти 5 endpoint'ов нужны admin-UI для завершения UI-фич, заплейсхолженных в
|
||||
sprint UI polish (MR !74→!93, mai-2026). Каждый блокирует конкретный
|
||||
component на frontend — сегодня там показывается placeholder ("backend
|
||||
changelog pending" notice / disabled button / `0` count).
|
||||
|
||||
Frontend готов подключить через Orval — нужны только OpenAPI спеки.
|
||||
Приоритет в порядке user-impact: 1 (highest) → 5 (nice-to-have).
|
||||
|
||||
---
|
||||
|
||||
## 1. Schema versions timeline — `GET /api/v1/dictionaries/{name}/changelog`
|
||||
|
||||
**Purpose:** History tab в editor (`/dictionaries/$name?tab=history`) и
|
||||
Time-travel modal — список всех schema versions с change summaries.
|
||||
|
||||
**Frontend usage:**
|
||||
|
||||
- `HistoryTabContent` (`routes/dictionaries.$name.tsx:HistoryTabContent`)
|
||||
показывает HEAD row + N исторических versions с `v{N} +X ~Y −Z`
|
||||
change summary, who/when, diff link.
|
||||
- `TimeTravelModal` использует timestamps versions для slider marks.
|
||||
|
||||
**Route:** `GET /api/v1/dictionaries/{name}/changelog`
|
||||
|
||||
**Query params:**
|
||||
|
||||
| param | type | default | description |
|
||||
|---|---|---|---|
|
||||
| `limit` | int | 50 | max entries (cap 200) |
|
||||
| `cursor` | string | — | opaque pagination token (next-page link) |
|
||||
| `from` | ISO datetime | — | filter versions с `publishedAt >= from` |
|
||||
| `to` | ISO datetime | — | filter versions с `publishedAt <= to` |
|
||||
|
||||
**Response 200:**
|
||||
|
||||
```json
|
||||
{
|
||||
"dictionary": "satellites",
|
||||
"currentVersion": "1.4.0",
|
||||
"entries": [
|
||||
{
|
||||
"version": "1.4.0",
|
||||
"publishedAt": "2026-04-12T10:23:00Z",
|
||||
"publishedBy": { "sub": "u-42", "name": "zimin.an" },
|
||||
"headers": "x-references массив + поле altitude",
|
||||
"diff": {
|
||||
"added": ["properties.altitude"],
|
||||
"removed": [],
|
||||
"changed": ["properties.operator (enum +1 value)"]
|
||||
},
|
||||
"recordsAffected": 0,
|
||||
"isCurrent": true
|
||||
},
|
||||
{
|
||||
"version": "1.3.2",
|
||||
"publishedAt": "2026-03-30T08:11:00Z",
|
||||
"publishedBy": { "sub": "u-17", "name": "petrov.iv" },
|
||||
"headers": "fix description перевод EN",
|
||||
"diff": { "added": [], "removed": [], "changed": ["description.en"] },
|
||||
"recordsAffected": 0,
|
||||
"isCurrent": false
|
||||
}
|
||||
],
|
||||
"nextCursor": "eyJ2IjoiMS4zLjEiLCJ0IjoiMjAyNi0wMy0xNVQwMDowMDowMFoifQ=="
|
||||
}
|
||||
```
|
||||
|
||||
**Errors:** 404 dict not found, 401 unauth.
|
||||
|
||||
**Notes:**
|
||||
- `diff` — best-effort summary, не полный JSON-patch. Если backend
|
||||
считает дорого — допустим только counts: `{ "added": 3, "removed": 0, "changed": 2 }`.
|
||||
- `headers` ≈ commit message от автора schema edit. Optional; покажем
|
||||
"—" если empty.
|
||||
|
||||
**Complexity:** medium. Нужна таблица `dictionary_schema_history` (если
|
||||
ещё нет — версия + JSON snapshot + author + timestamp).
|
||||
|
||||
---
|
||||
|
||||
## 2. Records snapshots — `GET /api/v1/dictionaries/{name}/snapshots`
|
||||
|
||||
**Purpose:** Time-travel modal slider marks — точки во времени где
|
||||
дествительно произошёл change в records (не каждая секунда). UX:
|
||||
slider snaps к "интересным" моментам.
|
||||
|
||||
**Frontend usage:**
|
||||
|
||||
- `TimeTravelModal` (`components/timetravel/TimeTravelModal.tsx`) рендерит
|
||||
marks на slider — каждая mark = snapshot point. Сейчас используем
|
||||
`recordTimestamps` derived из `validFrom` — но это не учитывает closes.
|
||||
|
||||
**Route:** `GET /api/v1/dictionaries/{name}/snapshots`
|
||||
|
||||
**Query params:**
|
||||
|
||||
| param | type | default | description |
|
||||
|---|---|---|---|
|
||||
| `from` | ISO datetime | now − 30d | start of window |
|
||||
| `to` | ISO datetime | now | end of window |
|
||||
| `granularity` | string | `day` | `hour` / `day` / `week` — bucket size |
|
||||
|
||||
**Response 200:**
|
||||
|
||||
```json
|
||||
{
|
||||
"dictionary": "satellites",
|
||||
"from": "2026-04-01T00:00:00Z",
|
||||
"to": "2026-05-11T00:00:00Z",
|
||||
"snapshots": [
|
||||
{
|
||||
"at": "2026-04-01T00:00:00Z",
|
||||
"totalRecords": 124,
|
||||
"changedSinceLast": 0,
|
||||
"label": "1 апр"
|
||||
},
|
||||
{
|
||||
"at": "2026-04-15T14:00:00Z",
|
||||
"totalRecords": 127,
|
||||
"changedSinceLast": 3,
|
||||
"label": "15 апр"
|
||||
},
|
||||
{
|
||||
"at": "2026-05-11T00:00:00Z",
|
||||
"totalRecords": 130,
|
||||
"changedSinceLast": 5,
|
||||
"label": "сейчас",
|
||||
"isCurrent": true
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
**Notes:**
|
||||
- Backend free выбрать какие точки маркировать — main критерий ≥1 change
|
||||
с прошлой snapshot. Пустые часы/дни skip.
|
||||
- `label` — backend-formatted RU label для UI (избегаем locale logic
|
||||
на front).
|
||||
|
||||
**Complexity:** medium. Можно делать `SELECT DISTINCT date_trunc('day', valid_from)`
|
||||
+ count(*) over window. Кеш ~5min на горячих dict'ах.
|
||||
|
||||
---
|
||||
|
||||
## 3. Workflow state machine — workflow API
|
||||
|
||||
**Purpose:** Workflow buttons в editor toolbar (`Request review`,
|
||||
`Approve`, `Publish`, `Create draft`). Сейчас показываются placeholder /
|
||||
hidden когда `approvalRequired=true` потому что нет actions.
|
||||
|
||||
**Frontend usage:**
|
||||
|
||||
- `WorkflowBanner` (`components/editor/WorkflowBanner.tsx`) показывает
|
||||
"live" / "pending review" / "draft" badge.
|
||||
- Action buttons прячутся пока нет API. После shipping — wire'им
|
||||
кнопки в banner / editor toolbar.
|
||||
|
||||
**Routes (4 endpoints, RESTful):**
|
||||
|
||||
### 3.1 `POST /api/v1/dictionaries/{name}/drafts`
|
||||
|
||||
Create draft от текущего HEAD. Returns draft id.
|
||||
|
||||
```json
|
||||
{ "fromVersion": "1.4.0", "reason": "обновить altitude диапазон" }
|
||||
```
|
||||
|
||||
Response:
|
||||
```json
|
||||
{ "draftId": "d-42a7", "branchedFrom": "1.4.0", "status": "draft" }
|
||||
```
|
||||
|
||||
### 3.2 `POST /api/v1/dictionaries/{name}/drafts/{draftId}/review`
|
||||
|
||||
Submit draft for review.
|
||||
|
||||
```json
|
||||
{ "reviewers": ["u-17", "u-92"], "note": "проверьте altitude rounding" }
|
||||
```
|
||||
|
||||
Response: 202 Accepted, `{ "status": "review_pending" }`.
|
||||
|
||||
### 3.3 `POST /api/v1/dictionaries/{name}/drafts/{draftId}/decision`
|
||||
|
||||
Reviewer's decision.
|
||||
|
||||
```json
|
||||
{ "decision": "approve", "comment": "OK" }
|
||||
```
|
||||
|
||||
`decision`: `approve` | `request_changes` | `reject`. Response 200 с new status.
|
||||
|
||||
### 3.4 `POST /api/v1/dictionaries/{name}/drafts/{draftId}/publish`
|
||||
|
||||
Publish approved draft → becomes new HEAD. Optimistic-lock на текущую version.
|
||||
|
||||
```json
|
||||
{ "expectedHeadVersion": "1.4.0", "publishNote": "v1.5.0 — altitude диапазон" }
|
||||
```
|
||||
|
||||
Response 200:
|
||||
```json
|
||||
{ "newVersion": "1.5.0", "publishedAt": "2026-05-11T22:00:00Z" }
|
||||
```
|
||||
|
||||
409 если кто-то другой опубликовал свой draft первым (concurrent publish race).
|
||||
|
||||
**Notes:**
|
||||
- State machine: `draft` → `review_pending` → (`approved` | `changes_requested` | `rejected`) → (publish | discard).
|
||||
- Все 4 endpoint'а должны вернуть updated draft state — frontend invalidate'ит
|
||||
query keys по dictionary name.
|
||||
- RBAC: только approvers могут вызвать 3.3 с decision=approve.
|
||||
|
||||
**Complexity:** high. Нужны таблицы `drafts`, `draft_reviews`, state transition
|
||||
guards. Webhook event hooks (frontend ожидает `dict.draft.*` events).
|
||||
|
||||
---
|
||||
|
||||
## 4. PATCH schema fields — `PATCH /api/v1/dictionaries/{name}/schema`
|
||||
|
||||
**Purpose:** Inline edit single field в Fields tab без открытия full
|
||||
DictionaryEditorDialog. UX: clickable field row → inline form → save →
|
||||
HEAD bumps minor version.
|
||||
|
||||
**Frontend usage:**
|
||||
|
||||
- `FieldsTabContent` (`routes/dictionaries.$name.tsx:FieldsTabContent`)
|
||||
сейчас read-only. После endpoint — кнопка edit на каждой row.
|
||||
|
||||
**Route:** `PATCH /api/v1/dictionaries/{name}/schema`
|
||||
|
||||
**Body (RFC 6902 JSON-patch subset или structured ops — backend выбирает):**
|
||||
|
||||
Option A — JSON Patch:
|
||||
```json
|
||||
{
|
||||
"expectedHeadVersion": "1.4.0",
|
||||
"ops": [
|
||||
{
|
||||
"op": "replace",
|
||||
"path": "/properties/altitude/description",
|
||||
"value": { "ru": "Высота орбиты в км", "en": "Orbit altitude in km" }
|
||||
},
|
||||
{ "op": "add", "path": "/properties/altitude/minimum", "value": 0 }
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
Option B — structured (более ergonomic для UI):
|
||||
```json
|
||||
{
|
||||
"expectedHeadVersion": "1.4.0",
|
||||
"field": "altitude",
|
||||
"changes": {
|
||||
"description": { "ru": "...", "en": "..." },
|
||||
"minimum": 0
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**Constraints:** допустимые ops — non-breaking changes только (description,
|
||||
title, minimum/maximum bounds expansion, enum value добавление). Breaking
|
||||
ops (rename, type change, remove) → 422 с `code: "breaking_change_requires_draft"`.
|
||||
|
||||
**Response 200:**
|
||||
|
||||
```json
|
||||
{
|
||||
"newVersion": "1.4.1",
|
||||
"schemaJson": { /* full updated schema */ }
|
||||
}
|
||||
```
|
||||
|
||||
**Errors:**
|
||||
|
||||
| code | status | meaning |
|
||||
|---|---|---|
|
||||
| `breaking_change_requires_draft` | 422 | op требует workflow draft, не inline patch |
|
||||
| `version_mismatch` | 409 | someone else patched schema first (refetch) |
|
||||
| `validation_failed` | 422 | op breaks existing record validation |
|
||||
|
||||
**Complexity:** medium-high. Нужен validator который проверяет что patch
|
||||
не breaks существующие записи (semver-minor только).
|
||||
|
||||
---
|
||||
|
||||
## 5. Batch outgoing FK counts — `GET /api/v1/dictionaries/graph/outgoing`
|
||||
|
||||
**Purpose:** Catalog list (`/dictionaries`) — колонка `→` показывает
|
||||
сколько FK rel'ов идёт ОТ каждого dict'а. Сейчас на front считаем
|
||||
loop'ом per-row через `extractOutgoingFkCount(schemaJson)` — работает,
|
||||
но требует все schemaJson на клиенте.
|
||||
|
||||
**Frontend usage:**
|
||||
|
||||
- `routes/dictionaries.index.tsx` catalog table — `→` column показывает
|
||||
outgoing FK count. Если backend вернёт батчом — frontend сделает 1
|
||||
request вместо включения schemaJson в каждую row useDictionaries.
|
||||
|
||||
**Route:** `GET /api/v1/dictionaries/graph/outgoing?dicts=satellites,operators,...`
|
||||
|
||||
**Query params:**
|
||||
|
||||
| param | type | default | description |
|
||||
|---|---|---|---|
|
||||
| `dicts` | comma-separated string | all visible | optional filter |
|
||||
| `scope` | comma-separated string | all | `PUBLIC,INTERNAL` etc |
|
||||
|
||||
**Response 200:**
|
||||
|
||||
```json
|
||||
{
|
||||
"outgoing": {
|
||||
"satellites": { "fkCount": 3, "targets": ["operators", "launch_sites", "missions"] },
|
||||
"operators": { "fkCount": 0, "targets": [] },
|
||||
"missions": { "fkCount": 2, "targets": ["operators", "rockets"] }
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**Notes:**
|
||||
- `targets` опционально — если дорого, можно вернуть только `fkCount`.
|
||||
- Скорость: вся таблица обычно ≤200 dict'ов — простой SELECT с
|
||||
`jsonb_array_length(schema_json->'x-references')` или `LATERAL`
|
||||
enumeration. Кеш 60s.
|
||||
|
||||
**Complexity:** low. Это derived data из существующих schemaJson —
|
||||
просто batch SELECT + aggregate.
|
||||
|
||||
---
|
||||
|
||||
## Frontend integration timeline
|
||||
|
||||
| Endpoint | Component | Estimate after backend ship |
|
||||
|---|---|---|
|
||||
| 1. Changelog | `HistoryTabContent`, `TimeTravelModal` | ~2h (Orval hook + render entries) |
|
||||
| 2. Snapshots | `TimeTravelModal` slider marks | ~1h (replace mock derivation) |
|
||||
| 3. Workflow API | `WorkflowBanner` + new buttons in toolbar | ~6h (4 mutations + state UI) |
|
||||
| 4. PATCH schema | `FieldsTabContent` inline edit | ~4h (form + diff preview) |
|
||||
| 5. Batch graph | `dictionaries.index` `→` column | ~30min (single query swap) |
|
||||
|
||||
Total frontend work post-backend: **~14h** (1.5 sprint days). Per
|
||||
endpoint frontend готов в течение часа после OpenAPI freeze.
|
||||
|
||||
## Conventions reminder
|
||||
|
||||
- Все endpoints должны быть Authenticated (Keycloak JWT, см. [auth.md](auth.md)).
|
||||
- Errors следуют [errors.md](errors.md) — `{ code, message, details? }`.
|
||||
- Optimistic-lock 409 везде где есть concurrent edits.
|
||||
- Webhook events для async state changes — см. [webhooks.md](webhooks.md).
|
||||
- Idempotency-Key header на mutating endpoints (Time-travel race
|
||||
safety per existing API guidelines).
|
||||
@@ -29,6 +29,8 @@ items:
|
||||
href: integration/api/best-practices.md
|
||||
- name: Bundle справочников cuod
|
||||
href: integration/api/bundle-cuod.md
|
||||
- name: Pending endpoints (admin-UI wishlist)
|
||||
href: integration/api/pending-endpoints.md
|
||||
|
||||
- name: Прикладные сценарии
|
||||
items:
|
||||
|
||||
@@ -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",
|
||||
|
||||
Generated
+80
@@ -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,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')}>
|
||||
|
||||
@@ -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>
|
||||
)
|
||||
}
|
||||
|
||||
@@ -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 {
|
||||
|
||||
Reference in New Issue
Block a user