@asteby/metacore-runtime-react 52.0.0 → 53.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (101) hide show
  1. package/CHANGELOG.md +26 -0
  2. package/dist/addon-loader.d.ts +22 -1
  3. package/dist/addon-loader.d.ts.map +1 -1
  4. package/dist/addon-loader.js +23 -5
  5. package/dist/addon-page-host.d.ts +80 -0
  6. package/dist/addon-page-host.d.ts.map +1 -0
  7. package/dist/addon-page-host.js +216 -0
  8. package/dist/addon-page-loader.d.ts +40 -0
  9. package/dist/addon-page-loader.d.ts.map +1 -0
  10. package/dist/addon-page-loader.js +87 -0
  11. package/dist/dynamic-view.d.ts +20 -1
  12. package/dist/dynamic-view.d.ts.map +1 -1
  13. package/dist/dynamic-view.js +26 -3
  14. package/dist/federated-error-boundary.d.ts +46 -0
  15. package/dist/federated-error-boundary.d.ts.map +1 -0
  16. package/dist/federated-error-boundary.js +55 -0
  17. package/dist/host-api.d.ts +22 -0
  18. package/dist/host-api.d.ts.map +1 -0
  19. package/dist/host-api.js +113 -0
  20. package/dist/index.d.ts +8 -2
  21. package/dist/index.d.ts.map +1 -1
  22. package/dist/index.js +12 -2
  23. package/dist/testing.d.ts +42 -0
  24. package/dist/testing.d.ts.map +1 -0
  25. package/dist/testing.js +53 -0
  26. package/dist/types.d.ts +13 -0
  27. package/dist/types.d.ts.map +1 -1
  28. package/dist/views/calendar-view.d.ts +23 -0
  29. package/dist/views/calendar-view.d.ts.map +1 -0
  30. package/dist/views/calendar-view.js +138 -0
  31. package/dist/views/chart-view.d.ts +14 -0
  32. package/dist/views/chart-view.d.ts.map +1 -0
  33. package/dist/views/chart-view.js +77 -0
  34. package/dist/views/data-source.d.ts +30 -0
  35. package/dist/views/data-source.d.ts.map +1 -0
  36. package/dist/views/data-source.js +103 -0
  37. package/dist/views/index.d.ts +4 -0
  38. package/dist/views/index.d.ts.map +1 -0
  39. package/dist/views/index.js +2 -0
  40. package/dist/views/map-view.d.ts +39 -0
  41. package/dist/views/map-view.d.ts.map +1 -0
  42. package/dist/views/map-view.js +143 -0
  43. package/dist/views/panels.d.ts +13 -0
  44. package/dist/views/panels.d.ts.map +1 -0
  45. package/dist/views/panels.js +119 -0
  46. package/dist/views/registry.d.ts +46 -0
  47. package/dist/views/registry.d.ts.map +1 -0
  48. package/dist/views/registry.js +139 -0
  49. package/dist/views/skeleton.d.ts +5 -0
  50. package/dist/views/skeleton.d.ts.map +1 -0
  51. package/dist/views/skeleton.js +6 -0
  52. package/dist/views/split-view.d.ts +6 -0
  53. package/dist/views/split-view.d.ts.map +1 -0
  54. package/dist/views/split-view.js +52 -0
  55. package/dist/views/timeline-view.d.ts +25 -0
  56. package/dist/views/timeline-view.d.ts.map +1 -0
  57. package/dist/views/timeline-view.js +130 -0
  58. package/dist/views/types.d.ts +87 -0
  59. package/dist/views/types.d.ts.map +1 -0
  60. package/dist/views/types.js +1 -0
  61. package/dist/widgets/charts.d.ts +9 -0
  62. package/dist/widgets/charts.d.ts.map +1 -0
  63. package/dist/widgets/charts.js +55 -0
  64. package/dist/widgets/lazy-charts.d.ts +10 -0
  65. package/dist/widgets/lazy-charts.d.ts.map +1 -0
  66. package/dist/widgets/lazy-charts.js +30 -0
  67. package/dist/widgets/renderers.d.ts +5 -5
  68. package/dist/widgets/renderers.d.ts.map +1 -1
  69. package/dist/widgets/renderers.js +3 -53
  70. package/dist/widgets/widget-renderer.d.ts.map +1 -1
  71. package/dist/widgets/widget-renderer.js +2 -1
  72. package/package.json +21 -5
  73. package/src/__tests__/addon-page-host.test.tsx +122 -0
  74. package/src/__tests__/addon-page-loader.test.tsx +201 -0
  75. package/src/__tests__/declarative-views.test.tsx +351 -0
  76. package/src/__tests__/host-api.test.ts +87 -0
  77. package/src/__tests__/index-static-graph.test.ts +83 -0
  78. package/src/addon-loader.tsx +51 -8
  79. package/src/addon-page-host.tsx +319 -0
  80. package/src/addon-page-loader.tsx +203 -0
  81. package/src/dynamic-view.tsx +61 -3
  82. package/src/federated-error-boundary.tsx +121 -0
  83. package/src/host-api.ts +143 -0
  84. package/src/index.ts +47 -4
  85. package/src/testing.tsx +108 -0
  86. package/src/types.ts +13 -0
  87. package/src/views/calendar-view.tsx +234 -0
  88. package/src/views/chart-view.tsx +122 -0
  89. package/src/views/data-source.ts +127 -0
  90. package/src/views/index.ts +37 -0
  91. package/src/views/map-view.tsx +217 -0
  92. package/src/views/panels.tsx +177 -0
  93. package/src/views/registry.tsx +202 -0
  94. package/src/views/skeleton.tsx +13 -0
  95. package/src/views/split-view.tsx +115 -0
  96. package/src/views/timeline-view.tsx +229 -0
  97. package/src/views/types.ts +105 -0
  98. package/src/widgets/charts.tsx +225 -0
  99. package/src/widgets/lazy-charts.tsx +51 -0
  100. package/src/widgets/renderers.tsx +5 -210
  101. package/src/widgets/widget-renderer.tsx +6 -4
@@ -0,0 +1,217 @@
1
+ // `view_type: map` and `kind: map` detail panels — CONTRACT + ACCESSIBLE
2
+ // FALLBACK. The interactive renderer (MapLibre, clustering, layers, dark
3
+ // style) belongs to `@asteby/metacore-maps`, which registers itself with
4
+ // `registerViewRenderer('map', …)` / `registerPanelRenderer('map', …)`. Until a
5
+ // host does, this chunk renders what every map must offer anyway: the
6
+ // equivalent keyboard-navigable list of features, each with an "open in map"
7
+ // link. The pure helpers below (features, route) are the shared contract the
8
+ // maps package builds on, so both renderers read the manifest identically.
9
+ import * as React from 'react'
10
+ import { useTranslation } from 'react-i18next'
11
+ import { MapPin } from 'lucide-react'
12
+ import type { MapPoint, MapView } from '@asteby/metacore-sdk'
13
+ import { buildRelationFilterParams } from '../dynamic-relation-helpers'
14
+ import type { PanelRendererProps, ViewRendererProps } from './types'
15
+ import { displayValue } from './data-source'
16
+ import { ViewSkeleton } from './skeleton'
17
+
18
+ const MAX_FEATURES = 500
19
+
20
+ export interface MapFeature {
21
+ key: string
22
+ lat: number
23
+ lng: number
24
+ /** `color_by` value (option key); the renderer maps it to a token. */
25
+ color?: string
26
+ /** Popup fields in `popup[]` order. */
27
+ popup: Array<{ field: string; value: string }>
28
+ row: Record<string, unknown>
29
+ }
30
+
31
+ function num(v: unknown): number | null {
32
+ const n = typeof v === 'number' ? v : typeof v === 'string' && v.trim() !== '' ? Number(v) : NaN
33
+ return Number.isFinite(n) ? n : null
34
+ }
35
+
36
+ /** Coordinates of a row: `point {lat,lng}` columns or a GeoJSON Point column. */
37
+ export function rowCoordinates(
38
+ row: Record<string, unknown>,
39
+ point: MapPoint | undefined,
40
+ geometry: string | undefined,
41
+ ): { lat: number; lng: number } | null {
42
+ if (point) {
43
+ const lat = num(row[point.lat])
44
+ const lng = num(row[point.lng])
45
+ if (lat === null || lng === null || Math.abs(lat) > 90 || Math.abs(lng) > 180) return null
46
+ return { lat, lng }
47
+ }
48
+ if (geometry) {
49
+ let g = row[geometry] as unknown
50
+ if (typeof g === 'string') {
51
+ try {
52
+ g = JSON.parse(g)
53
+ } catch {
54
+ return null
55
+ }
56
+ }
57
+ const geo = g as { type?: string; coordinates?: unknown[] } | null
58
+ if (geo?.type === 'Point' && Array.isArray(geo.coordinates)) {
59
+ const lng = num(geo.coordinates[0])
60
+ const lat = num(geo.coordinates[1])
61
+ if (lat !== null && lng !== null) return { lat, lng }
62
+ }
63
+ }
64
+ return null
65
+ }
66
+
67
+ /** Pure: rows → map features (rows without valid coordinates are skipped). */
68
+ export function toMapFeatures(rows: Record<string, unknown>[], view: MapView): MapFeature[] {
69
+ const out: MapFeature[] = []
70
+ rows.forEach((row, i) => {
71
+ const c = rowCoordinates(row, view.point, view.geometry)
72
+ if (!c) return
73
+ out.push({
74
+ key: String(row.id ?? i),
75
+ ...c,
76
+ color: view.color_by ? displayValue(row[view.color_by]) || undefined : undefined,
77
+ popup: (view.popup ?? []).map((field) => ({ field, value: displayValue(row[field]) })),
78
+ row,
79
+ })
80
+ })
81
+ return out
82
+ }
83
+
84
+ /** Pure: ordered route points of a record's children (`route.order_by` ascending). */
85
+ export function toRoutePoints(
86
+ children: Record<string, unknown>[],
87
+ route: NonNullable<MapView['route']>,
88
+ ): Array<{ lat: number; lng: number }> {
89
+ return [...children]
90
+ .sort((a, b) => String(a[route.order_by] ?? '').localeCompare(String(b[route.order_by] ?? '')))
91
+ .map((r) => rowCoordinates(r, route.point, undefined))
92
+ .filter((p): p is { lat: number; lng: number } => p !== null)
93
+ }
94
+
95
+ /** "Open in map" link (OpenStreetMap; no key, no tracking script). */
96
+ export function openInMapHref(lat: number, lng: number): string {
97
+ return `https://www.openstreetmap.org/?mlat=${lat}&mlon=${lng}#map=16/${lat}/${lng}`
98
+ }
99
+
100
+ export function MapFeatureList({
101
+ features,
102
+ onOpen,
103
+ }: {
104
+ features: MapFeature[]
105
+ onOpen?: (row: Record<string, unknown>) => void
106
+ }) {
107
+ const { t } = useTranslation()
108
+ if (features.length === 0) {
109
+ return (
110
+ <p className="py-8 text-center text-sm text-muted-foreground" data-testid="map-empty">
111
+ {t('metacore.views.map_empty', 'No hay ubicaciones para mostrar.')}
112
+ </p>
113
+ )
114
+ }
115
+ return (
116
+ <ul className="divide-y rounded-lg border" data-testid="map-feature-list">
117
+ {features.map((f) => {
118
+ const label = f.popup[0]?.value || f.key
119
+ return (
120
+ <li key={f.key} className="flex items-start gap-3 p-3">
121
+ <MapPin aria-hidden className="mt-0.5 h-4 w-4 shrink-0 text-primary" />
122
+ <div className="min-w-0 flex-1">
123
+ {onOpen ? (
124
+ <button
125
+ type="button"
126
+ className="truncate text-left text-sm font-medium text-foreground hover:underline focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
127
+ onClick={() => onOpen(f.row)}
128
+ >
129
+ {label}
130
+ </button>
131
+ ) : (
132
+ <span className="truncate text-sm font-medium text-foreground">{label}</span>
133
+ )}
134
+ {f.popup.length > 1 || f.color ? (
135
+ <p className="truncate text-xs text-muted-foreground">
136
+ {[f.color, ...f.popup.slice(1).map((p) => p.value)].filter(Boolean).join(' · ')}
137
+ </p>
138
+ ) : null}
139
+ </div>
140
+ <a
141
+ href={openInMapHref(f.lat, f.lng)}
142
+ target="_blank"
143
+ rel="noopener noreferrer"
144
+ className="shrink-0 text-xs text-primary underline-offset-2 hover:underline"
145
+ aria-label={t('metacore.views.open_in_map_of', 'Abrir en mapa: {{label}}', { label })}
146
+ >
147
+ {t('metacore.views.open_in_map', 'Abrir en mapa')}
148
+ </a>
149
+ </li>
150
+ )
151
+ })}
152
+ </ul>
153
+ )
154
+ }
155
+
156
+ /** `view_type: map` fallback renderer: the accessible list of features. */
157
+ export default function MapViewFallback(props: ViewRendererProps<'map'>) {
158
+ const { model, view, data, onOpenRecord, className } = props
159
+ const { t } = useTranslation()
160
+ const [rows, setRows] = React.useState<Record<string, unknown>[] | null>(null)
161
+ const [error, setError] = React.useState(false)
162
+ React.useEffect(() => {
163
+ let cancelled = false
164
+ data
165
+ .list(model, { per_page: MAX_FEATURES })
166
+ .then((res) => !cancelled && setRows(res.rows))
167
+ .catch(() => !cancelled && setError(true))
168
+ return () => {
169
+ cancelled = true
170
+ }
171
+ }, [data, model])
172
+ if (error) {
173
+ return (
174
+ <p role="alert" className="text-sm text-destructive">
175
+ {t('metacore.views.error', 'No se pudo cargar la información.')}
176
+ </p>
177
+ )
178
+ }
179
+ if (!rows) return <ViewSkeleton />
180
+ return (
181
+ <div className={className} data-testid="map-view-fallback">
182
+ <MapFeatureList features={toMapFeatures(rows, view)} onOpen={onOpenRecord} />
183
+ </div>
184
+ )
185
+ }
186
+
187
+ /** `kind: map` panel fallback: the record's point and its route stops. */
188
+ export function MapPanel({ panel, record, metadata, data }: PanelRendererProps) {
189
+ const view = panel.map
190
+ const route = view?.route
191
+ const rel = route ? metadata?.relations?.find((r) => r.name === route.relation) : undefined
192
+ const [stops, setStops] = React.useState<Array<{ lat: number; lng: number }>>([])
193
+ const recordId = record.id
194
+ React.useEffect(() => {
195
+ if (!route || !rel || recordId === undefined || recordId === null) return
196
+ let cancelled = false
197
+ data
198
+ .list(rel.through, {
199
+ ...buildRelationFilterParams(rel.foreign_key, String(recordId), rel.scope),
200
+ per_page: MAX_FEATURES,
201
+ sortBy: route.order_by,
202
+ order: 'asc',
203
+ })
204
+ .then((res) => !cancelled && setStops(toRoutePoints(res.rows, route)))
205
+ .catch(() => undefined)
206
+ return () => {
207
+ cancelled = true
208
+ }
209
+ }, [data, route, rel, recordId])
210
+ if (!view) return null
211
+ const own = toMapFeatures([record], { ...view, popup: view.popup ?? [] })
212
+ const features: MapFeature[] = [
213
+ ...stops.map((s, i) => ({ key: `stop-${i}`, ...s, popup: [{ field: '#', value: `#${i + 1}` }], row: {} })),
214
+ ...own,
215
+ ]
216
+ return <MapFeatureList features={features} />
217
+ }
@@ -0,0 +1,177 @@
1
+ // `kind: relation` and `kind: stats` detail panels. Lazy chunk. Both only
2
+ // display server values: a relation panel lists the record's children (first
3
+ // `limit` rows), a stats panel formats a few of the record's own fields.
4
+ import * as React from 'react'
5
+ import { useTranslation } from 'react-i18next'
6
+ import { buildRelationFilterParams } from '../dynamic-relation-helpers'
7
+ import type { PanelRendererProps } from './types'
8
+ import { displayValue, toDate } from './data-source'
9
+ import { ViewSkeleton } from './skeleton'
10
+
11
+ export type StatFormat =
12
+ | 'number'
13
+ | 'currency'
14
+ | 'percent'
15
+ | 'compact'
16
+ | 'date'
17
+ | 'datetime'
18
+ | 'relative_date'
19
+
20
+ /** Pure: format one stat value for display. `now` is injectable for tests. */
21
+ export function formatStat(
22
+ value: unknown,
23
+ format: string | undefined,
24
+ opts: { locale?: string; currency?: string; timeZone?: string; now?: Date } = {},
25
+ ): string {
26
+ if (value === null || value === undefined || value === '') return '—'
27
+ const { locale, currency, timeZone } = opts
28
+ const num = typeof value === 'number' ? value : typeof value === 'string' ? Number(value) : NaN
29
+ try {
30
+ switch (format as StatFormat | undefined) {
31
+ case 'currency':
32
+ if (Number.isNaN(num)) break
33
+ return new Intl.NumberFormat(locale, { style: 'currency', currency: currency || 'MXN' }).format(num)
34
+ case 'percent':
35
+ if (Number.isNaN(num)) break
36
+ return new Intl.NumberFormat(locale, { style: 'percent', maximumFractionDigits: 1 }).format(num)
37
+ case 'compact':
38
+ if (Number.isNaN(num)) break
39
+ return new Intl.NumberFormat(locale, { notation: 'compact' }).format(num)
40
+ case 'number':
41
+ if (Number.isNaN(num)) break
42
+ return new Intl.NumberFormat(locale).format(num)
43
+ case 'date':
44
+ case 'datetime': {
45
+ const d = toDate(value)
46
+ if (!d) break
47
+ return new Intl.DateTimeFormat(locale, {
48
+ dateStyle: 'medium',
49
+ ...(format === 'datetime' ? { timeStyle: 'short' } : {}),
50
+ timeZone,
51
+ }).format(d)
52
+ }
53
+ case 'relative_date': {
54
+ const d = toDate(value)
55
+ if (!d) break
56
+ const now = opts.now ?? new Date()
57
+ const diffMs = d.getTime() - now.getTime()
58
+ const abs = Math.abs(diffMs)
59
+ const rtf = new Intl.RelativeTimeFormat(locale, { numeric: 'auto' })
60
+ if (abs < 3_600_000) return rtf.format(Math.round(diffMs / 60_000), 'minute')
61
+ if (abs < 86_400_000) return rtf.format(Math.round(diffMs / 3_600_000), 'hour')
62
+ return rtf.format(Math.round(diffMs / 86_400_000), 'day')
63
+ }
64
+ }
65
+ } catch {
66
+ /* invalid locale/currency: fall through to the raw value */
67
+ }
68
+ return displayValue(value)
69
+ }
70
+
71
+ export function StatsPanelView({ panel, record, metadata, locale, currency, timeZone }: PanelRendererProps) {
72
+ const { t } = useTranslation()
73
+ const items = panel.stats?.items ?? []
74
+ const labelOf = (field: string, label?: string) =>
75
+ label ? t(label) : metadata?.columns?.find((c) => c.key === field)?.label ?? field
76
+ return (
77
+ <dl className="grid grid-cols-2 gap-3 sm:grid-cols-4" data-testid="stats-panel">
78
+ {items.map((it) => (
79
+ <div key={it.field} className="rounded-md bg-muted/40 p-3">
80
+ <dt className="text-xs text-muted-foreground">{labelOf(it.field, it.label)}</dt>
81
+ <dd className="mt-1 text-lg font-semibold tabular-nums text-foreground">
82
+ {formatStat(record[it.field], it.format, { locale, currency, timeZone })}
83
+ </dd>
84
+ </div>
85
+ ))}
86
+ </dl>
87
+ )
88
+ }
89
+
90
+ export function RelationPanelView({ panel, record, metadata, data, onOpenRecord }: PanelRendererProps) {
91
+ const { t } = useTranslation()
92
+ const cfg = panel.relation
93
+ const rel = metadata?.relations?.find((r) => r.name === cfg?.name)
94
+ const limit = Math.min(Math.max(cfg?.limit ?? 10, 1), 50)
95
+ const [rows, setRows] = React.useState<Record<string, unknown>[] | null>(null)
96
+ const [total, setTotal] = React.useState<number | undefined>()
97
+ const [error, setError] = React.useState(false)
98
+ const recordId = record.id
99
+
100
+ React.useEffect(() => {
101
+ if (!rel || rel.kind !== 'one_to_many' || recordId === undefined || recordId === null) return
102
+ let cancelled = false
103
+ setRows(null)
104
+ setError(false)
105
+ data
106
+ .list(rel.through, {
107
+ ...buildRelationFilterParams(rel.foreign_key, String(recordId), rel.scope),
108
+ per_page: limit,
109
+ })
110
+ .then(
111
+ (res) => {
112
+ if (cancelled) return
113
+ setRows(res.rows)
114
+ setTotal(res.total)
115
+ },
116
+ () => !cancelled && setError(true),
117
+ )
118
+ return () => {
119
+ cancelled = true
120
+ }
121
+ }, [data, rel, recordId, limit])
122
+
123
+ if (!cfg) return null
124
+ if (!rel || rel.kind !== 'one_to_many') {
125
+ return <p className="text-xs text-muted-foreground">{cfg.name}</p>
126
+ }
127
+ if (error) {
128
+ return (
129
+ <p role="alert" className="text-sm text-destructive">
130
+ {t('metacore.views.error', 'No se pudo cargar la información.')}
131
+ </p>
132
+ )
133
+ }
134
+ if (!rows) return <ViewSkeleton height={160} />
135
+ if (rows.length === 0) {
136
+ return <p className="py-4 text-sm text-muted-foreground">{t('metacore.views.empty', 'Sin datos todavía.')}</p>
137
+ }
138
+ const columns =
139
+ cfg.columns && cfg.columns.length > 0
140
+ ? cfg.columns
141
+ : Object.keys(rows[0]).filter((k) => k !== 'id' && k !== rel.foreign_key && k !== 'organization_id').slice(0, 4)
142
+ return (
143
+ <div className="overflow-x-auto" data-testid="relation-panel">
144
+ <table className="w-full text-sm">
145
+ <thead>
146
+ <tr className="border-b text-left text-xs text-muted-foreground">
147
+ {columns.map((c) => (
148
+ <th key={c} scope="col" className="px-2 py-1.5 font-medium">
149
+ {c}
150
+ </th>
151
+ ))}
152
+ </tr>
153
+ </thead>
154
+ <tbody>
155
+ {rows.map((row, i) => (
156
+ <tr
157
+ key={String(row.id ?? i)}
158
+ className={['border-b last:border-0', onOpenRecord ? 'cursor-pointer hover:bg-muted/40' : ''].join(' ')}
159
+ onClick={onOpenRecord ? () => onOpenRecord(rel.through, row) : undefined}
160
+ >
161
+ {columns.map((c) => (
162
+ <td key={c} className="px-2 py-1.5">
163
+ {displayValue(row[c])}
164
+ </td>
165
+ ))}
166
+ </tr>
167
+ ))}
168
+ </tbody>
169
+ </table>
170
+ {total !== undefined && total > rows.length ? (
171
+ <p className="mt-2 text-xs text-muted-foreground">
172
+ {t('metacore.views.showing_of', '{{shown}} de {{total}}', { shown: rows.length, total })}
173
+ </p>
174
+ ) : null}
175
+ </div>
176
+ )
177
+ }
@@ -0,0 +1,202 @@
1
+ // Declarative view & panel renderer registry.
2
+ //
3
+ // Every renderer is a separate lazy chunk keyed by type: an addon that only
4
+ // declares a `timeline` never downloads the chart, calendar or map code, and
5
+ // none of them is in the host's first paint (the package index reaches this
6
+ // module, never the renderers — see __tests__/index-static-graph.test.ts).
7
+ //
8
+ // Built-in: chart, timeline, calendar, split (views) and map/timeline/chart/
9
+ // relation/stats (panels). `map` ships an accessible list fallback until a
10
+ // maps package registers the real renderer:
11
+ //
12
+ // registerViewRenderer('map', () => import('@asteby/metacore-maps/view'))
13
+ // registerPanelRenderer('map', () => import('@asteby/metacore-maps/panel'))
14
+ //
15
+ // `custom` panels (level C, a federated component) have no built-in: the host
16
+ // registers one that mounts the addon's expose.
17
+ import * as React from 'react'
18
+ import type { DetailPanel, NavView } from '@asteby/metacore-sdk'
19
+ import type {
20
+ DeclarativeViewType,
21
+ PanelRendererComponent,
22
+ PanelRendererLoader,
23
+ PanelRendererProps,
24
+ ViewRendererComponent,
25
+ ViewRendererLoader,
26
+ ViewRendererProps,
27
+ } from './types'
28
+ import { FederatedErrorBoundary } from '../federated-error-boundary'
29
+ import { ViewSkeleton } from './skeleton'
30
+
31
+ export { ViewSkeleton }
32
+
33
+ export const DECLARATIVE_VIEW_TYPES: readonly DeclarativeViewType[] = [
34
+ 'map',
35
+ 'timeline',
36
+ 'calendar',
37
+ 'chart',
38
+ 'split',
39
+ ] as const
40
+
41
+ export function isDeclarativeViewType(t: string | undefined | null): t is DeclarativeViewType {
42
+ return !!t && (DECLARATIVE_VIEW_TYPES as readonly string[]).includes(t)
43
+ }
44
+
45
+ const viewLoaders = new Map<string, ViewRendererLoader>([
46
+ ['chart', () => import('./chart-view')],
47
+ ['timeline', () => import('./timeline-view')],
48
+ ['calendar', () => import('./calendar-view')],
49
+ ['split', () => import('./split-view')],
50
+ ['map', () => import('./map-view')],
51
+ ])
52
+
53
+ const panelLoaders = new Map<string, PanelRendererLoader>([
54
+ ['chart', () => import('./chart-view').then((m) => ({ default: m.ChartPanel }))],
55
+ ['timeline', () => import('./timeline-view').then((m) => ({ default: m.TimelinePanel }))],
56
+ ['map', () => import('./map-view').then((m) => ({ default: m.MapPanel }))],
57
+ ['relation', () => import('./panels').then((m) => ({ default: m.RelationPanelView }))],
58
+ ['stats', () => import('./panels').then((m) => ({ default: m.StatsPanelView }))],
59
+ ])
60
+
61
+ const lazyViews = new Map<string, React.LazyExoticComponent<ViewRendererComponent>>()
62
+ const lazyPanels = new Map<string, React.LazyExoticComponent<PanelRendererComponent>>()
63
+
64
+ /**
65
+ * Register (or replace) the renderer of a view type. Returns a function that
66
+ * restores the previous loader. Replacing drops the cached lazy component.
67
+ */
68
+ export function registerViewRenderer(type: string, loader: ViewRendererLoader): () => void {
69
+ const prev = viewLoaders.get(type)
70
+ viewLoaders.set(type, loader)
71
+ lazyViews.delete(type)
72
+ return () => {
73
+ if (prev) viewLoaders.set(type, prev)
74
+ else viewLoaders.delete(type)
75
+ lazyViews.delete(type)
76
+ }
77
+ }
78
+
79
+ /** Register (or replace) the renderer of a detail panel kind (incl. `custom`). */
80
+ export function registerPanelRenderer(kind: string, loader: PanelRendererLoader): () => void {
81
+ const prev = panelLoaders.get(kind)
82
+ panelLoaders.set(kind, loader)
83
+ lazyPanels.delete(kind)
84
+ return () => {
85
+ if (prev) panelLoaders.set(kind, prev)
86
+ else panelLoaders.delete(kind)
87
+ lazyPanels.delete(kind)
88
+ }
89
+ }
90
+
91
+ export function hasViewRenderer(type: string): boolean {
92
+ return viewLoaders.has(type)
93
+ }
94
+
95
+ export function hasPanelRenderer(kind: string): boolean {
96
+ return panelLoaders.has(kind)
97
+ }
98
+
99
+ /** Warm a renderer chunk (hover/focus on a nav entry). Resolves false when none. */
100
+ export function preloadViewRenderer(type: string): Promise<boolean> {
101
+ const loader = viewLoaders.get(type)
102
+ return loader ? loader().then(() => true, () => false) : Promise.resolve(false)
103
+ }
104
+
105
+ function lazyView(type: string): React.LazyExoticComponent<ViewRendererComponent> | null {
106
+ const loader = viewLoaders.get(type)
107
+ if (!loader) return null
108
+ let c = lazyViews.get(type)
109
+ if (!c) {
110
+ c = React.lazy(loader)
111
+ lazyViews.set(type, c)
112
+ }
113
+ return c
114
+ }
115
+
116
+ function lazyPanel(kind: string): React.LazyExoticComponent<PanelRendererComponent> | null {
117
+ const loader = panelLoaders.get(kind)
118
+ if (!loader) return null
119
+ let c = lazyPanels.get(kind)
120
+ if (!c) {
121
+ c = React.lazy(loader)
122
+ lazyPanels.set(kind, c)
123
+ }
124
+ return c
125
+ }
126
+
127
+ export interface DeclarativeViewProps extends Omit<ViewRendererProps, 'view'> {
128
+ viewType: DeclarativeViewType | string
129
+ /** The nav entry's `view` block (served in the table metadata). */
130
+ view: NavView | null | undefined
131
+ /** Rendered when the type has no renderer or its block is missing. */
132
+ fallback?: React.ReactNode
133
+ }
134
+
135
+ /**
136
+ * Render a declarative view by type: picks `view[viewType]`, lazy-loads that
137
+ * renderer, isolates it in an error boundary. Unknown types render `fallback`
138
+ * (hosts pass the table, the same rule DynamicView applies).
139
+ */
140
+ export function DeclarativeView({ viewType, view, fallback = null, ...rest }: DeclarativeViewProps) {
141
+ const block = (view as Record<string, unknown> | null | undefined)?.[viewType]
142
+ const Renderer = lazyView(viewType)
143
+ if (!Renderer || !block) return <>{fallback}</>
144
+ return (
145
+ <FederatedErrorBoundary addonKey={`view:${viewType}`} resetKeys={[rest.model, viewType]}>
146
+ <React.Suspense fallback={<ViewSkeleton />}>
147
+ <Renderer {...rest} view={block} />
148
+ </React.Suspense>
149
+ </FederatedErrorBoundary>
150
+ )
151
+ }
152
+
153
+ export interface DetailPanelsProps extends Omit<PanelRendererProps, 'panel'> {
154
+ panels: DetailPanel[] | null | undefined
155
+ /** Permission check for `panel.permission` (default: everything visible). */
156
+ can?: (permission: string) => boolean
157
+ /** i18n for panel titles (raw keys pass through by default). */
158
+ translate?: (key: string) => string
159
+ className?: string
160
+ }
161
+
162
+ /**
163
+ * Detail panels of a record in a 2-column grid (`span: half` takes one
164
+ * column, `full` both). Each panel is lazy and isolated: one failing panel
165
+ * never blanks the detail page.
166
+ */
167
+ export function DetailPanels({ panels, can, translate, className, ...rest }: DetailPanelsProps) {
168
+ const visible = (panels ?? []).filter((p) => !p.permission || !can || can(p.permission))
169
+ if (visible.length === 0) return null
170
+ const tr = translate ?? ((k: string) => k)
171
+ return (
172
+ <div className={['grid grid-cols-1 gap-4 lg:grid-cols-2', className].filter(Boolean).join(' ')}>
173
+ {visible.map((panel) => {
174
+ const Renderer = lazyPanel(panel.kind)
175
+ return (
176
+ <section
177
+ key={panel.key}
178
+ data-panel={panel.key}
179
+ aria-label={tr(panel.title)}
180
+ className={[
181
+ 'min-w-0 rounded-lg border bg-card p-4',
182
+ panel.span === 'half' ? '' : 'lg:col-span-2',
183
+ ].join(' ')}
184
+ >
185
+ <h3 className="mb-3 text-sm font-medium text-foreground">{tr(panel.title)}</h3>
186
+ {Renderer ? (
187
+ <FederatedErrorBoundary addonKey={`panel:${panel.key}`} resetKeys={[rest.record]}>
188
+ <React.Suspense fallback={<ViewSkeleton height={200} />}>
189
+ <Renderer {...rest} panel={panel} />
190
+ </React.Suspense>
191
+ </FederatedErrorBoundary>
192
+ ) : (
193
+ <p className="text-xs text-muted-foreground" data-testid="panel-unsupported">
194
+ {panel.kind}
195
+ </p>
196
+ )}
197
+ </section>
198
+ )
199
+ })}
200
+ </div>
201
+ )
202
+ }
@@ -0,0 +1,13 @@
1
+ // Fixed-height placeholder shared by the registry and the lazy renderers.
2
+
3
+ /** Fixed-height skeleton (no layout shift while a renderer chunk loads). */
4
+ export function ViewSkeleton({ height = 360 }: { height?: number }) {
5
+ return (
6
+ <div
7
+ aria-busy="true"
8
+ data-testid="view-skeleton"
9
+ className="w-full animate-pulse rounded-lg bg-muted"
10
+ style={{ height }}
11
+ />
12
+ )
13
+ }