@stoa-dev/kit 0.1.4 → 1.0.2
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.
- package/CHANGELOG.md +76 -0
- package/README.md +97 -2
- package/dist/autosave/controller.js +93 -0
- package/dist/autosave/controller.js.map +1 -0
- package/dist/autosave/index.js +7 -0
- package/dist/autosave/index.js.map +1 -0
- package/dist/autosave/provider.js +48 -0
- package/dist/autosave/provider.js.map +1 -0
- package/dist/display/BarChart/index.js +70 -0
- package/dist/display/BarChart/index.js.map +1 -0
- package/dist/display/Marginalia/index.js +16 -0
- package/dist/display/Marginalia/index.js.map +1 -0
- package/dist/display/MarginaliaFramed/index.js +19 -0
- package/dist/display/MarginaliaFramed/index.js.map +1 -0
- package/dist/display/MarginaliaPair/index.js +32 -0
- package/dist/display/MarginaliaPair/index.js.map +1 -0
- package/dist/display/ProgressBar/index.js +72 -0
- package/dist/display/ProgressBar/index.js.map +1 -0
- package/dist/display/TimeMeasured/index.js +38 -0
- package/dist/display/TimeMeasured/index.js.map +1 -0
- package/dist/display/index.js +16 -0
- package/dist/display/index.js.map +1 -0
- package/dist/i18n/locales/at.json.js +10 -4
- package/dist/i18n/locales/at.json.js.map +1 -1
- package/dist/i18n/locales/de.json.js +10 -4
- package/dist/i18n/locales/de.json.js.map +1 -1
- package/dist/i18n/locales/en.json.js +10 -4
- package/dist/i18n/locales/en.json.js.map +1 -1
- package/dist/i18n/locales/it.json.js +12 -6
- package/dist/i18n/locales/it.json.js.map +1 -1
- package/dist/kit.css +1 -1
- package/dist/shell/AnimatedSwap/index.js +61 -0
- package/dist/shell/AnimatedSwap/index.js.map +1 -0
- package/dist/shell/AppNavigation/index.js +97 -77
- package/dist/shell/AppNavigation/index.js.map +1 -1
- package/dist/shell/BackButton/index.js +24 -0
- package/dist/shell/BackButton/index.js.map +1 -0
- package/dist/shell/BrandLines/index.js +14 -12
- package/dist/shell/BrandLines/index.js.map +1 -1
- package/dist/shell/DatePicker/index.js +16 -15
- package/dist/shell/DatePicker/index.js.map +1 -1
- package/dist/shell/ExternalLink/index.js +30 -0
- package/dist/shell/ExternalLink/index.js.map +1 -0
- package/dist/shell/PageHeading/index.js +15 -8
- package/dist/shell/PageHeading/index.js.map +1 -1
- package/dist/shell/SaveStatus/index.js +61 -0
- package/dist/shell/SaveStatus/index.js.map +1 -0
- package/dist/shell/SectionNavigation/index.js +5 -112
- package/dist/shell/SectionNavigation/index.js.map +1 -1
- package/dist/shell/SetupWizard/index.js +158 -0
- package/dist/shell/SetupWizard/index.js.map +1 -0
- package/dist/shell/StartupAnimation/index.js +88 -0
- package/dist/shell/StartupAnimation/index.js.map +1 -0
- package/dist/shell/StartupProvider/index.js +37 -0
- package/dist/shell/StartupProvider/index.js.map +1 -0
- package/dist/shell/SubNavigation/index.js +127 -0
- package/dist/shell/SubNavigation/index.js.map +1 -0
- package/dist/shell/TagInput/index.js +93 -0
- package/dist/shell/TagInput/index.js.map +1 -0
- package/dist/shell/ValidatedInput/index.js +31 -0
- package/dist/shell/ValidatedInput/index.js.map +1 -0
- package/dist/shell/index.js +45 -24
- package/dist/shell/index.js.map +1 -1
- package/dist/types/autosave/controller.d.ts +44 -0
- package/dist/types/autosave/controller.d.ts.map +1 -0
- package/dist/types/autosave/index.d.ts +3 -0
- package/dist/types/autosave/index.d.ts.map +1 -0
- package/dist/types/autosave/provider.d.ts +20 -0
- package/dist/types/autosave/provider.d.ts.map +1 -0
- package/dist/types/display/BarChart/index.d.ts +25 -0
- package/dist/types/display/BarChart/index.d.ts.map +1 -0
- package/dist/types/display/Marginalia/index.d.ts +8 -0
- package/dist/types/display/Marginalia/index.d.ts.map +1 -0
- package/dist/types/display/MarginaliaFramed/index.d.ts +8 -0
- package/dist/types/display/MarginaliaFramed/index.d.ts.map +1 -0
- package/dist/types/display/MarginaliaPair/index.d.ts +9 -0
- package/dist/types/display/MarginaliaPair/index.d.ts.map +1 -0
- package/dist/types/display/ProgressBar/index.d.ts +19 -0
- package/dist/types/display/ProgressBar/index.d.ts.map +1 -0
- package/dist/types/display/TimeMeasured/index.d.ts +16 -0
- package/dist/types/display/TimeMeasured/index.d.ts.map +1 -0
- package/dist/types/display/index.d.ts +7 -0
- package/dist/types/display/index.d.ts.map +1 -0
- package/dist/types/i18n/index.d.ts +88 -0
- package/dist/types/i18n/index.d.ts.map +1 -1
- package/dist/types/shell/AnimatedSwap/index.d.ts +13 -0
- package/dist/types/shell/AnimatedSwap/index.d.ts.map +1 -0
- package/dist/types/shell/AppNavigation/index.d.ts +1 -1
- package/dist/types/shell/AppNavigation/index.d.ts.map +1 -1
- package/dist/types/shell/BackButton/index.d.ts +8 -0
- package/dist/types/shell/BackButton/index.d.ts.map +1 -0
- package/dist/types/shell/BrandLines/index.d.ts.map +1 -1
- package/dist/types/shell/DatePicker/index.d.ts.map +1 -1
- package/dist/types/shell/ErrorBoundary/index.d.ts +1 -1
- package/dist/types/shell/ExternalLink/index.d.ts +10 -0
- package/dist/types/shell/ExternalLink/index.d.ts.map +1 -0
- package/dist/types/shell/PageHeading/index.d.ts.map +1 -1
- package/dist/types/shell/SaveStatus/index.d.ts +15 -0
- package/dist/types/shell/SaveStatus/index.d.ts.map +1 -0
- package/dist/types/shell/SectionNavigation/index.d.ts +4 -11
- package/dist/types/shell/SectionNavigation/index.d.ts.map +1 -1
- package/dist/types/shell/SetupWizard/index.d.ts +23 -0
- package/dist/types/shell/SetupWizard/index.d.ts.map +1 -0
- package/dist/types/shell/StartupAnimation/index.d.ts +26 -0
- package/dist/types/shell/StartupAnimation/index.d.ts.map +1 -0
- package/dist/types/shell/StartupProvider/index.d.ts +22 -0
- package/dist/types/shell/StartupProvider/index.d.ts.map +1 -0
- package/dist/types/shell/SubNavigation/index.d.ts +16 -0
- package/dist/types/shell/SubNavigation/index.d.ts.map +1 -0
- package/dist/types/shell/TagInput/index.d.ts +20 -0
- package/dist/types/shell/TagInput/index.d.ts.map +1 -0
- package/dist/types/shell/ValidatedInput/index.d.ts +17 -0
- package/dist/types/shell/ValidatedInput/index.d.ts.map +1 -0
- package/dist/types/shell/index.d.ts +10 -1
- package/dist/types/shell/index.d.ts.map +1 -1
- package/dist/types/ui/field/index.d.ts +1 -1
- package/dist/types/ui/index.d.ts +2 -0
- package/dist/types/ui/index.d.ts.map +1 -1
- package/dist/types/ui/theme-switch/index.d.ts +12 -0
- package/dist/types/ui/theme-switch/index.d.ts.map +1 -0
- package/dist/types/ui/theme-toggle/index.d.ts +12 -0
- package/dist/types/ui/theme-toggle/index.d.ts.map +1 -0
- package/dist/types/utils/index.d.ts +1 -0
- package/dist/types/utils/index.d.ts.map +1 -1
- package/dist/types/utils/saveFeedback.d.ts +35 -0
- package/dist/types/utils/saveFeedback.d.ts.map +1 -0
- package/dist/ui/index.js +41 -37
- package/dist/ui/index.js.map +1 -1
- package/dist/ui/theme-switch/ThemeSwitch.module.scss.js +14 -0
- package/dist/ui/theme-switch/ThemeSwitch.module.scss.js.map +1 -0
- package/dist/ui/theme-switch/index.js +38 -0
- package/dist/ui/theme-switch/index.js.map +1 -0
- package/dist/ui/theme-toggle/index.js +36 -0
- package/dist/ui/theme-toggle/index.js.map +1 -0
- package/dist/ui/tooltip/index.js +11 -11
- package/dist/ui/tooltip/index.js.map +1 -1
- package/dist/utils/index.js +5 -3
- package/dist/utils/index.js.map +1 -1
- package/dist/utils/saveFeedback.js +54 -0
- package/dist/utils/saveFeedback.js.map +1 -0
- package/package.json +13 -3
- package/styles/instrument.css +703 -0
- package/styles/theme.css +1 -0
- package/dist/shell/BackHomeButton/index.js +0 -23
- package/dist/shell/BackHomeButton/index.js.map +0 -1
- package/dist/types/shell/BackHomeButton/index.d.ts +0 -7
- package/dist/types/shell/BackHomeButton/index.d.ts.map +0 -1
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
# Changelog — @stoa-dev/kit
|
|
2
|
+
|
|
3
|
+
## Unreleased
|
|
4
|
+
|
|
5
|
+
- Neuer Export `@stoa-dev/kit/autosave`: `createAutosave<T>()` mit typisiertem
|
|
6
|
+
Provider und Hook, dazu ein unabhängig von React nutzbarer `AutosaveController`.
|
|
7
|
+
- Autosave und manuelles Speichern teilen sich eine serielle Warteschlange:
|
|
8
|
+
Debounce, maximale Wartezeit, neuester Entwurf während laufender Schreibvorgänge,
|
|
9
|
+
Schreibsperre, explizites Wiederholen und Fehlerzustand ohne Datenverlust im Speicher.
|
|
10
|
+
- `SaveStatus` unterstützt nun auch `pending` (ungespeicherte Änderungen), mit
|
|
11
|
+
Übersetzungen in allen vier Sprachen.
|
|
12
|
+
- Storybook-Beispiele für Autosave, manuelles Speichern und Fehler/Wiederholung;
|
|
13
|
+
Unit-Tests für die Speichersteuerung (`npm test`).
|
|
14
|
+
|
|
15
|
+
## 1.0.0
|
|
16
|
+
|
|
17
|
+
Erste stabile Version: neues Design, neue Anzeige-Bausteine und die gemeinsamen
|
|
18
|
+
Teile der Apps im Kit.
|
|
19
|
+
|
|
20
|
+
### Neu
|
|
21
|
+
|
|
22
|
+
- **Skin „Instrument“** (`@stoa-dev/kit/instrument.css`, Klasse `stoa-instrument` auf
|
|
23
|
+
`<html>`, hell und dunkel): ruhige, papiergraue Flächen mit großen Rundungen,
|
|
24
|
+
kräftige Linien, Mono-Versalien für Beschriftungen und Buttons, Schwarz für aktive
|
|
25
|
+
Zustände, die App-Akzentfarbe nur als kleiner Indikator. Schriften: Mona Sans und
|
|
26
|
+
Mona Sans Mono.
|
|
27
|
+
- **`@stoa-dev/kit/display`**: `MarginaliaPair`, `Marginalia`, `MarginaliaFramed`,
|
|
28
|
+
`TimeMeasured`, `ProgressBar`, `BarChart`/`BarChartItem` (vertikal und horizontal).
|
|
29
|
+
- **Aus den Apps übernommen** (`@stoa-dev/kit/shell`): `StartupProvider`/`useStartup`,
|
|
30
|
+
`StartupAnimation`, `SaveStatus`, `TagInput`, `ValidatedInput` (+ `fieldFeedback`),
|
|
31
|
+
`ExternalLink`, `AnimatedSwap`; in `@stoa-dev/kit/utils`: `SaveFeedback`.
|
|
32
|
+
- Kit-Texte für Laden der Einstellungen, Autosave, Schlagwörter und „Erneut versuchen“
|
|
33
|
+
(de, de-AT, en, it).
|
|
34
|
+
- Stabile `data-slot`-Attribute an AppNavigation, PageHeading, BrandLines und
|
|
35
|
+
SectionNavigation.
|
|
36
|
+
|
|
37
|
+
### Geändert
|
|
38
|
+
|
|
39
|
+
- `DatePickerInput`: Der Kalender zeigt immer sechs Wochenzeilen; Höhe und
|
|
40
|
+
Monatspfeile bleiben beim Blättern stabil.
|
|
41
|
+
- Theme: `font-mono` ist Mona Sans Mono (Fallback: System-Monospace).
|
|
42
|
+
|
|
43
|
+
### Umstieg von 0.1.x
|
|
44
|
+
|
|
45
|
+
Keine entfernten oder umbenannten Exporte; bestehende Apps bauen unverändert.
|
|
46
|
+
Empfohlen beim Integrieren:
|
|
47
|
+
|
|
48
|
+
1. App-eigene Kopien von StartupAnimation/StartupProvider, SaveStatus, TagInput,
|
|
49
|
+
ValidatedInput, ExternalLink und AnimatedActionRow durch die Kit-Versionen ersetzen.
|
|
50
|
+
2. Für den Skin `@stoa-dev/kit/instrument.css` nach `theme.css` importieren und
|
|
51
|
+
`stoa-instrument` auf `<html>` setzen.
|
|
52
|
+
3. Mona Sans Mono einbinden (github.com/github/mona-sans, SIL OFL), sonst greift die
|
|
53
|
+
System-Monospace.
|
|
54
|
+
|
|
55
|
+
## 0.1.4
|
|
56
|
+
|
|
57
|
+
- `DatePickerInput`: Auswahllisten für Monat und Jahr (100 Jahre zurück, 10 voraus,
|
|
58
|
+
per `startMonth`/`endMonth` änderbar).
|
|
59
|
+
- `InputGroupAddon`: Klicks aus Portalen (z. B. dem Kalender-Popover) setzen den Fokus
|
|
60
|
+
nicht mehr ins Feld.
|
|
61
|
+
|
|
62
|
+
## 0.1.3
|
|
63
|
+
|
|
64
|
+
- Dropdown-Menüs passen sich dem Inhalt an: mindestens 12rem, höchstens 20rem.
|
|
65
|
+
|
|
66
|
+
## 0.1.2
|
|
67
|
+
|
|
68
|
+
- App-spezifische Link-Hover-Farbe aus dem gemeinsamen Theme entfernt.
|
|
69
|
+
|
|
70
|
+
## 0.1.1
|
|
71
|
+
|
|
72
|
+
- Repository-Metadaten, stabile CSS-Modul-Klassennamen.
|
|
73
|
+
|
|
74
|
+
## 0.1.0
|
|
75
|
+
|
|
76
|
+
- Erste Veröffentlichung.
|
package/README.md
CHANGED
|
@@ -5,12 +5,15 @@ Gemeinsame React-Komponenten, Hooks, Hilfsfunktionen, Lizenz-UI und Theme der ST
|
|
|
5
5
|
| Import | Inhalt |
|
|
6
6
|
|---|---|
|
|
7
7
|
| `@stoa-dev/kit/ui` | shadcn-Primitives (Button, Dialog, Select, Calendar, …) |
|
|
8
|
-
| `@stoa-dev/kit/shell` | AppNavigation,
|
|
8
|
+
| `@stoa-dev/kit/shell` | AppNavigation, SubNavigation, SetupWizard, PageHeading, BrandLines, Spinner, BackButton, ErrorBoundary, ConfirmDialog, DatePickerInput, NativeSelect, UploadButton, StartupProvider/`useStartup`, StartupAnimation, SaveStatus, TagInput, ValidatedInput, ExternalLink, AnimatedSwap |
|
|
9
|
+
| `@stoa-dev/kit/display` | MarginaliaPair, Marginalia, MarginaliaFramed, TimeMeasured, ProgressBar, BarChart/BarChartItem |
|
|
9
10
|
| `@stoa-dev/kit/licensing` | LicenseProvider/`useLicense`, LicenseGate, LicenseCard, LicenseActivation, LicenseStatusBanner, Tauri-API |
|
|
11
|
+
| `@stoa-dev/kit/autosave` | `createAutosave<T>()`, typisierte Provider/Hooks, `AutosaveController` |
|
|
10
12
|
| `@stoa-dev/kit/hooks` | `useOnlineStatus`, `useRouting<Route>()` |
|
|
11
|
-
| `@stoa-dev/kit/utils` | `cn`, `formatDate`, `formatTimestamp`, `parseHexColor`, … |
|
|
13
|
+
| `@stoa-dev/kit/utils` | `cn`, `formatDate`, `formatTimestamp`, `parseHexColor`, `SaveFeedback`, … |
|
|
12
14
|
| `@stoa-dev/kit/i18n` | `registerStoaLocales`, `supportedLanguages`, Namespace `stoa` (de, de-AT, en, it) |
|
|
13
15
|
| `@stoa-dev/kit/theme.css` | Tailwind-4-Tokens (shadcn-Variablen + STOA-Extras), Quelle für die App-Tailwind |
|
|
16
|
+
| `@stoa-dev/kit/instrument.css` | Skin „Instrument“ (siehe unten) |
|
|
14
17
|
| `@stoa-dev/kit/styles.css` | Kompilierte SCSS-Module der Komponenten |
|
|
15
18
|
| `@stoa-dev/kit/scss` | SCSS-Werkzeuge (`reduced-motion`, `dark`, `accent-mix`, …) für App-Module |
|
|
16
19
|
|
|
@@ -79,3 +82,95 @@ cd ../practicr && npm link ../stoa-dev/packages/kit
|
|
|
79
82
|
|
|
80
83
|
Vite: Bei verlinkten Paketen `resolve.dedupe: ['react', 'react-dom', 'react-router', 'i18next', 'react-i18next']`
|
|
81
84
|
setzen, damit Kontext-Provider (Router, i18n) nicht doppelt geladen werden.
|
|
85
|
+
|
|
86
|
+
## Skin „Instrument“
|
|
87
|
+
|
|
88
|
+
Ruhiges, monochromes Instrumenten-Design: papiergraue, stark gerundete Flächen mit viel Luft,
|
|
89
|
+
kräftige Linien, Mono-Versalien für Beschriftungen und Buttons, Pillen-Buttons und Schwarz
|
|
90
|
+
für aktive Zustände (auch die hervorgehobene Zeile im Kontextmenü).
|
|
91
|
+
Die App-Akzentfarbe bleibt nur als kleiner Indikator erhalten.
|
|
92
|
+
|
|
93
|
+
```css
|
|
94
|
+
@import "@stoa-dev/kit/theme.css";
|
|
95
|
+
@import "@stoa-dev/kit/instrument.css";
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
Aktiv wird er mit der Klasse `stoa-instrument` auf `<html>` (zusammen mit `dark` für die dunkle
|
|
99
|
+
Variante). Der Skin greift nur über `data-slot`-Attribute und braucht für die Beschriftungen
|
|
100
|
+
die Schriften „Mona Sans“ und „Mona Sans Mono“ (github.com/github/mona-sans, SIL OFL; sonst
|
|
101
|
+
Fallback auf Geist bzw. die System-Monospace). Im Storybook über die
|
|
102
|
+
Toolbar „Design“ umschaltbar.
|
|
103
|
+
|
|
104
|
+
|
|
105
|
+
## Autosave und manuelles Speichern
|
|
106
|
+
|
|
107
|
+
`createAutosave<T>()` erzeugt ein zusammengehöriges Paar aus `AutosaveProvider`
|
|
108
|
+
und `useAutosave`. Die Factory einmal auf Modulebene aufrufen. Jeder gemountete
|
|
109
|
+
Provider hält einen unabhängigen Datensatz und dessen Schreibwarteschlange.
|
|
110
|
+
|
|
111
|
+
```tsx
|
|
112
|
+
import { createAutosave } from '@stoa-dev/kit/autosave'
|
|
113
|
+
|
|
114
|
+
type Preferences = { language: string; theme: 'light' | 'dark' }
|
|
115
|
+
export const { AutosaveProvider, useAutosave } = createAutosave<Preferences>()
|
|
116
|
+
|
|
117
|
+
// Erst nach erfolgreichem Laden mounten; initialValue gilt als bereits gespeichert.
|
|
118
|
+
// savePreferences muss erst auflösen, wenn die Speicherung abgeschlossen ist.
|
|
119
|
+
<AutosaveProvider
|
|
120
|
+
initialValue={loadedPreferences}
|
|
121
|
+
save={savePreferences}
|
|
122
|
+
enabled={canWrite}
|
|
123
|
+
debounceMs={600}
|
|
124
|
+
maxWaitMs={5000}
|
|
125
|
+
>
|
|
126
|
+
<PreferencesEditor />
|
|
127
|
+
</AutosaveProvider>
|
|
128
|
+
|
|
129
|
+
function PreferencesEditor() {
|
|
130
|
+
const { value, setValue, dirty, status, error, flush, retry } = useAutosave()
|
|
131
|
+
// Beispiel für ein Formularfeld:
|
|
132
|
+
// setValue(previous => ({ ...previous, language: 'it' }))
|
|
133
|
+
// Manueller Button: await flush(); Fehler anzeigen oder über status behandeln.
|
|
134
|
+
// Wiederholen nach Fehler: await retry().
|
|
135
|
+
return <button disabled={!dirty || status === 'saving'}
|
|
136
|
+
onClick={() => { void flush().catch(console.error) }}>Speichern</button>
|
|
137
|
+
}
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
- `value` immer unveränderlich aktualisieren; vorhandene Objekte nicht mutieren.
|
|
141
|
+
Nur gültige Daten an `setValue` übergeben. Unvollständige Formulartexte separat
|
|
142
|
+
halten. Ein abgelehnter `save`-Aufruf bewahrt den neuesten Entwurf.
|
|
143
|
+
- Standard: Speicherung nach 600 ms Eingabepause, spätestens nach 5 s fortlaufender
|
|
144
|
+
Änderungen, sofern kein Schreibvorgang läuft. Während einer Speicherung werden
|
|
145
|
+
neue Änderungen gesammelt und anschließend als neuester Stand geschrieben.
|
|
146
|
+
- `autoSave={false}` bietet ausschließlich manuelles Speichern über `flush`/`retry`.
|
|
147
|
+
`enabled={false}` sperrt auch manuelle Schreibversuche; Änderungen bleiben im
|
|
148
|
+
Speicher. Die App muss Berechtigungen zusätzlich im Backend prüfen.
|
|
149
|
+
- `flush()` wartet auch auf Änderungen während eines laufenden Schreibvorgangs.
|
|
150
|
+
Gleichzeitige Aufrufe teilen sich eine Promise. Fehler werden weitergereicht;
|
|
151
|
+
automatische Fehler erzeugen keine unbegrenzte Wiederholungsschleife.
|
|
152
|
+
`retry()` oder eine neue Änderung können einen weiteren Versuch auslösen.
|
|
153
|
+
- `status`: `idle`, `pending`, `saving`, `saved`, `error`; zusätzlich `dirty`,
|
|
154
|
+
`error`, `editRevision` und `successfulSaves`. `SaveStatus` aus `/shell` versteht
|
|
155
|
+
`pending`, `saving`, `saved`, `error` und `null`. `idle` als `null` abbilden.
|
|
156
|
+
- Den Provider oberhalb wechselnder Routen halten. Beim Unmount werden Timer
|
|
157
|
+
gestoppt, ausstehende Änderungen werden **nicht automatisch gespeichert**.
|
|
158
|
+
Vor dem bewussten Dokumentwechsel `await flush()` ausführen, dann für das neue
|
|
159
|
+
Dokument mit einem neuen React-`key` mounten. Änderungen an `initialValue`
|
|
160
|
+
setzen einen bestehenden Provider absichtlich nicht zurück.
|
|
161
|
+
- React StrictMode wird unterstützt. `AutosaveController<T>` stellt dieselbe
|
|
162
|
+
Steuerung ohne React bereit (`start`, `stop`, `setValue`, `flush`, `subscribe`,
|
|
163
|
+
`getSnapshot`, `configure`).
|
|
164
|
+
|
|
165
|
+
Der Provider koordiniert eine schreibende Instanz. Atomare Dateiablage,
|
|
166
|
+
Datenbankschemata, Migrationen, Konflikte zwischen Fenstern/Prozessen und
|
|
167
|
+
Backups liegen beim Speicheradapter. Es gibt keine Garantie für noch nicht
|
|
168
|
+
persistierte Änderungen bei Prozessabsturz, erzwungenem Beenden oder Stromausfall.
|
|
169
|
+
|
|
170
|
+
Das Desktop-Boilerplate enthält ein Beispiel mit den vorhandenen Tauri-Commands
|
|
171
|
+
und `localStorage` für die Browser-Vorschau. Sein nativer Exit-Guard fängt
|
|
172
|
+
Fensterschließen und reguläres App-Beenden ab, wartet auf `flush()` und lässt die
|
|
173
|
+
App bei Speicherfehlern geöffnet. Die Browser-Vorschau warnt bei ungespeicherten
|
|
174
|
+
Änderungen vor dem Verlassen; Browser erlauben keine verlässliche asynchrone
|
|
175
|
+
Speicherung während des Schließens. Diese Integration ist app-spezifisch und
|
|
176
|
+
wird vom Kit nicht automatisch registriert.
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
class h {
|
|
2
|
+
options;
|
|
3
|
+
snapshot;
|
|
4
|
+
savedRevision = 0;
|
|
5
|
+
listeners = /* @__PURE__ */ new Set();
|
|
6
|
+
timer;
|
|
7
|
+
firstEditAt;
|
|
8
|
+
operation;
|
|
9
|
+
active = !1;
|
|
10
|
+
constructor(s) {
|
|
11
|
+
this.options = s, this.snapshot = {
|
|
12
|
+
value: s.initialValue,
|
|
13
|
+
status: "idle",
|
|
14
|
+
dirty: !1,
|
|
15
|
+
error: null,
|
|
16
|
+
editRevision: 0,
|
|
17
|
+
successfulSaves: 0
|
|
18
|
+
};
|
|
19
|
+
}
|
|
20
|
+
getSnapshot = () => this.snapshot;
|
|
21
|
+
subscribe = (s) => (this.listeners.add(s), () => {
|
|
22
|
+
this.listeners.delete(s);
|
|
23
|
+
});
|
|
24
|
+
publish(s) {
|
|
25
|
+
this.snapshot = { ...this.snapshot, ...s };
|
|
26
|
+
for (const t of this.listeners) t();
|
|
27
|
+
}
|
|
28
|
+
configure(s) {
|
|
29
|
+
this.options = { ...this.options, ...s }, this.schedule();
|
|
30
|
+
}
|
|
31
|
+
/** Safe to stop/start again during React StrictMode's effect replay. */
|
|
32
|
+
start = () => {
|
|
33
|
+
this.active = !0, this.schedule();
|
|
34
|
+
};
|
|
35
|
+
stop = () => {
|
|
36
|
+
this.active = !1, clearTimeout(this.timer);
|
|
37
|
+
};
|
|
38
|
+
setValue = (s) => {
|
|
39
|
+
const t = typeof s == "function" ? s(this.snapshot.value) : s;
|
|
40
|
+
Object.is(t, this.snapshot.value) || (this.firstEditAt ??= Date.now(), this.publish({
|
|
41
|
+
value: t,
|
|
42
|
+
editRevision: this.snapshot.editRevision + 1,
|
|
43
|
+
dirty: !0,
|
|
44
|
+
status: this.operation ? "saving" : "pending",
|
|
45
|
+
error: null
|
|
46
|
+
}), this.schedule());
|
|
47
|
+
};
|
|
48
|
+
schedule() {
|
|
49
|
+
if (clearTimeout(this.timer), !this.active || this.options.enabled === !1 || this.options.autoSave === !1 || !this.snapshot.dirty || this.operation || this.snapshot.status === "error")
|
|
50
|
+
return;
|
|
51
|
+
const s = Math.max(0, this.options.debounceMs ?? 600), t = Math.max(
|
|
52
|
+
0,
|
|
53
|
+
(this.options.maxWaitMs ?? 5e3) - (Date.now() - (this.firstEditAt ?? Date.now()))
|
|
54
|
+
);
|
|
55
|
+
this.timer = setTimeout(
|
|
56
|
+
() => {
|
|
57
|
+
this.flush().catch(() => {
|
|
58
|
+
});
|
|
59
|
+
},
|
|
60
|
+
Math.min(s, t)
|
|
61
|
+
);
|
|
62
|
+
}
|
|
63
|
+
/** Drains edits made during a write too. Concurrent callers share one promise. */
|
|
64
|
+
flush = () => {
|
|
65
|
+
if (clearTimeout(this.timer), this.operation) return this.operation;
|
|
66
|
+
if (!this.snapshot.dirty) return Promise.resolve();
|
|
67
|
+
const s = Promise.resolve().then(async () => {
|
|
68
|
+
for (; this.snapshot.dirty; ) {
|
|
69
|
+
if (this.options.enabled === !1)
|
|
70
|
+
throw new Error("Autosave writes are disabled");
|
|
71
|
+
const { value: t, editRevision: e } = this.snapshot;
|
|
72
|
+
this.publish({ status: "saving", error: null }), await this.options.save(t), this.savedRevision = e;
|
|
73
|
+
const i = this.snapshot.editRevision !== this.savedRevision;
|
|
74
|
+
this.publish({
|
|
75
|
+
dirty: i,
|
|
76
|
+
successfulSaves: this.snapshot.successfulSaves + 1,
|
|
77
|
+
status: i ? "saving" : "saved"
|
|
78
|
+
});
|
|
79
|
+
}
|
|
80
|
+
this.firstEditAt = void 0;
|
|
81
|
+
}).catch((t) => {
|
|
82
|
+
throw this.publish({ status: "error", error: t }), t;
|
|
83
|
+
}).finally(() => {
|
|
84
|
+
this.operation = void 0, this.schedule();
|
|
85
|
+
});
|
|
86
|
+
return this.operation = s, s;
|
|
87
|
+
};
|
|
88
|
+
retry = () => this.flush();
|
|
89
|
+
}
|
|
90
|
+
export {
|
|
91
|
+
h as AutosaveController
|
|
92
|
+
};
|
|
93
|
+
//# sourceMappingURL=controller.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"controller.js","sources":["../../src/autosave/controller.ts"],"sourcesContent":["export type AutosaveStatus = 'idle' | 'pending' | 'saving' | 'saved' | 'error'\n\nexport interface AutosaveOptions<T> {\n\tinitialValue: T\n\tsave: (value: T) => Promise<void>\n\t/** Disables all writes, including flush/retry. Pending edits are retained. */\n\tenabled?: boolean\n\t/** Disable automatic writes while keeping manual flush available. */\n\tautoSave?: boolean\n\tdebounceMs?: number\n\tmaxWaitMs?: number\n}\n\nexport interface AutosaveSnapshot<T> {\n\tvalue: T\n\tstatus: AutosaveStatus\n\tdirty: boolean\n\terror: unknown\n\teditRevision: number\n\tsuccessfulSaves: number\n}\n\n/** One immutable document, one writer. No I/O is performed by the constructor. */\nexport class AutosaveController<T> {\n\tprivate options: AutosaveOptions<T>\n\tprivate snapshot: AutosaveSnapshot<T>\n\tprivate savedRevision = 0\n\tprivate listeners = new Set<() => void>()\n\tprivate timer?: ReturnType<typeof setTimeout>\n\tprivate firstEditAt?: number\n\tprivate operation?: Promise<void>\n\tprivate active = false\n\n\tconstructor(options: AutosaveOptions<T>) {\n\t\tthis.options = options\n\t\tthis.snapshot = {\n\t\t\tvalue: options.initialValue,\n\t\t\tstatus: 'idle',\n\t\t\tdirty: false,\n\t\t\terror: null,\n\t\t\teditRevision: 0,\n\t\t\tsuccessfulSaves: 0,\n\t\t}\n\t}\n\n\tgetSnapshot = () => this.snapshot\n\tsubscribe = (listener: () => void) => {\n\t\tthis.listeners.add(listener)\n\t\treturn () => {\n\t\t\tthis.listeners.delete(listener)\n\t\t}\n\t}\n\tprivate publish(patch: Partial<AutosaveSnapshot<T>>) {\n\t\tthis.snapshot = { ...this.snapshot, ...patch }\n\t\tfor (const listener of this.listeners) listener()\n\t}\n\tconfigure(options: Omit<AutosaveOptions<T>, 'initialValue'>) {\n\t\tthis.options = { ...this.options, ...options }\n\t\tthis.schedule()\n\t}\n\t/** Safe to stop/start again during React StrictMode's effect replay. */\n\tstart = () => {\n\t\tthis.active = true\n\t\tthis.schedule()\n\t}\n\tstop = () => {\n\t\tthis.active = false\n\t\tclearTimeout(this.timer)\n\t}\n\n\tsetValue = (update: T | ((previous: T) => T)) => {\n\t\tconst value =\n\t\t\ttypeof update === 'function'\n\t\t\t\t? (update as (previous: T) => T)(this.snapshot.value)\n\t\t\t\t: update\n\t\tif (Object.is(value, this.snapshot.value)) return\n\t\tthis.firstEditAt ??= Date.now()\n\t\tthis.publish({\n\t\t\tvalue,\n\t\t\teditRevision: this.snapshot.editRevision + 1,\n\t\t\tdirty: true,\n\t\t\tstatus: this.operation ? 'saving' : 'pending',\n\t\t\terror: null,\n\t\t})\n\t\tthis.schedule()\n\t}\n\n\tprivate schedule() {\n\t\tclearTimeout(this.timer)\n\t\tif (\n\t\t\t!this.active ||\n\t\t\tthis.options.enabled === false ||\n\t\t\tthis.options.autoSave === false ||\n\t\t\t!this.snapshot.dirty ||\n\t\t\tthis.operation ||\n\t\t\tthis.snapshot.status === 'error'\n\t\t)\n\t\t\treturn\n\t\tconst debounce = Math.max(0, this.options.debounceMs ?? 600)\n\t\tconst remaining = Math.max(\n\t\t\t0,\n\t\t\t(this.options.maxWaitMs ?? 5000) -\n\t\t\t\t(Date.now() - (this.firstEditAt ?? Date.now())),\n\t\t)\n\t\tthis.timer = setTimeout(\n\t\t\t() => {\n\t\t\t\tvoid this.flush().catch(() => {})\n\t\t\t},\n\t\t\tMath.min(debounce, remaining),\n\t\t)\n\t}\n\n\t/** Drains edits made during a write too. Concurrent callers share one promise. */\n\tflush = (): Promise<void> => {\n\t\tclearTimeout(this.timer)\n\t\tif (this.operation) return this.operation\n\t\tif (!this.snapshot.dirty) return Promise.resolve()\n\t\t// Start on a microtask so synchronous save errors cannot leave a stuck operation.\n\t\tconst operation = Promise.resolve()\n\t\t\t.then(async () => {\n\t\t\t\twhile (this.snapshot.dirty) {\n\t\t\t\t\tif (this.options.enabled === false)\n\t\t\t\t\t\tthrow new Error('Autosave writes are disabled')\n\t\t\t\t\tconst { value, editRevision } = this.snapshot\n\t\t\t\t\tthis.publish({ status: 'saving', error: null })\n\t\t\t\t\tawait this.options.save(value)\n\t\t\t\t\tthis.savedRevision = editRevision\n\t\t\t\t\tconst dirty = this.snapshot.editRevision !== this.savedRevision\n\t\t\t\t\tthis.publish({\n\t\t\t\t\t\tdirty,\n\t\t\t\t\t\tsuccessfulSaves: this.snapshot.successfulSaves + 1,\n\t\t\t\t\t\tstatus: dirty ? 'saving' : 'saved',\n\t\t\t\t\t})\n\t\t\t\t}\n\t\t\t\tthis.firstEditAt = undefined\n\t\t\t})\n\t\t\t.catch((error: unknown) => {\n\t\t\t\tthis.publish({ status: 'error', error })\n\t\t\t\tthrow error\n\t\t\t})\n\t\t\t.finally(() => {\n\t\t\t\tthis.operation = undefined\n\t\t\t\tthis.schedule()\n\t\t\t})\n\t\tthis.operation = operation\n\t\treturn operation\n\t}\n\tretry = () => this.flush()\n}\n"],"names":["AutosaveController","options","listener","patch","update","value","debounce","remaining","operation","editRevision","dirty","error"],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
import { jsx as h } from "react/jsx-runtime";
|
|
2
|
+
import { createContext as a, useContext as m, useSyncExternalStore as v, useState as A, useEffect as f } from "react";
|
|
3
|
+
import { AutosaveController as g } from "./controller.js";
|
|
4
|
+
function y() {
|
|
5
|
+
const c = a(null);
|
|
6
|
+
function l({
|
|
7
|
+
children: t,
|
|
8
|
+
initialValue: i,
|
|
9
|
+
save: e,
|
|
10
|
+
enabled: o = !0,
|
|
11
|
+
autoSave: n = !0,
|
|
12
|
+
debounceMs: s = 600,
|
|
13
|
+
maxWaitMs: u = 5e3
|
|
14
|
+
}) {
|
|
15
|
+
const [r] = A(
|
|
16
|
+
() => new g({
|
|
17
|
+
initialValue: i,
|
|
18
|
+
save: e,
|
|
19
|
+
enabled: o,
|
|
20
|
+
autoSave: n,
|
|
21
|
+
debounceMs: s,
|
|
22
|
+
maxWaitMs: u
|
|
23
|
+
})
|
|
24
|
+
);
|
|
25
|
+
return f(() => {
|
|
26
|
+
r.configure({ save: e, enabled: o, autoSave: n, debounceMs: s, maxWaitMs: u });
|
|
27
|
+
}, [r, e, o, n, s, u]), f(() => (r.start(), r.stop), [r]), /* @__PURE__ */ h(c.Provider, { value: r, children: t });
|
|
28
|
+
}
|
|
29
|
+
function p() {
|
|
30
|
+
const t = m(c);
|
|
31
|
+
if (!t) throw new Error("AutosaveProvider is missing");
|
|
32
|
+
return {
|
|
33
|
+
...v(
|
|
34
|
+
t.subscribe,
|
|
35
|
+
t.getSnapshot,
|
|
36
|
+
t.getSnapshot
|
|
37
|
+
),
|
|
38
|
+
setValue: t.setValue,
|
|
39
|
+
flush: t.flush,
|
|
40
|
+
retry: t.retry
|
|
41
|
+
};
|
|
42
|
+
}
|
|
43
|
+
return { AutosaveProvider: l, useAutosave: p };
|
|
44
|
+
}
|
|
45
|
+
export {
|
|
46
|
+
y as createAutosave
|
|
47
|
+
};
|
|
48
|
+
//# sourceMappingURL=provider.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"provider.js","sources":["../../src/autosave/provider.tsx"],"sourcesContent":["import {\n\tcreateContext,\n\ttype ReactNode,\n\tuseContext,\n\tuseEffect,\n\tuseState,\n\tuseSyncExternalStore,\n} from 'react'\nimport { AutosaveController, type AutosaveOptions } from './controller'\n\n/** Create once at module scope to keep each document's context fully typed. */\nexport function createAutosave<T>() {\n\tconst Context = createContext<AutosaveController<T> | null>(null)\n\tfunction AutosaveProvider({\n\t\tchildren,\n\t\tinitialValue,\n\t\tsave,\n\t\tenabled = true,\n\t\tautoSave = true,\n\t\tdebounceMs = 600,\n\t\tmaxWaitMs = 5000,\n\t}: AutosaveOptions<T> & { children: ReactNode }) {\n\t\tconst [controller] = useState(\n\t\t\t() =>\n\t\t\t\tnew AutosaveController({\n\t\t\t\t\tinitialValue,\n\t\t\t\t\tsave,\n\t\t\t\t\tenabled,\n\t\t\t\t\tautoSave,\n\t\t\t\t\tdebounceMs,\n\t\t\t\t\tmaxWaitMs,\n\t\t\t\t}),\n\t\t)\n\t\tuseEffect(() => {\n\t\t\tcontroller.configure({ save, enabled, autoSave, debounceMs, maxWaitMs })\n\t\t}, [controller, save, enabled, autoSave, debounceMs, maxWaitMs])\n\t\tuseEffect(() => {\n\t\t\tcontroller.start()\n\t\t\treturn controller.stop\n\t\t}, [controller])\n\t\treturn <Context.Provider value={controller}>{children}</Context.Provider>\n\t}\n\tfunction useAutosave() {\n\t\tconst controller = useContext(Context)\n\t\tif (!controller) throw new Error('AutosaveProvider is missing')\n\t\tconst snapshot = useSyncExternalStore(\n\t\t\tcontroller.subscribe,\n\t\t\tcontroller.getSnapshot,\n\t\t\tcontroller.getSnapshot,\n\t\t)\n\t\treturn {\n\t\t\t...snapshot,\n\t\t\tsetValue: controller.setValue,\n\t\t\tflush: controller.flush,\n\t\t\tretry: controller.retry,\n\t\t}\n\t}\n\treturn { AutosaveProvider, useAutosave }\n}\n"],"names":["createAutosave","Context","createContext","AutosaveProvider","children","initialValue","save","enabled","autoSave","debounceMs","maxWaitMs","controller","useState","AutosaveController","useEffect","useAutosave","useContext","useSyncExternalStore"],"mappings":";;;AAWO,SAASA,IAAoB;AACnC,QAAMC,IAAUC,EAA4C,IAAI;AAChE,WAASC,EAAiB;AAAA,IACzB,UAAAC;AAAA,IACA,cAAAC;AAAA,IACA,MAAAC;AAAA,IACA,SAAAC,IAAU;AAAA,IACV,UAAAC,IAAW;AAAA,IACX,YAAAC,IAAa;AAAA,IACb,WAAAC,IAAY;AAAA,EAAA,GACoC;AAChD,UAAM,CAACC,CAAU,IAAIC;AAAA,MACpB,MACC,IAAIC,EAAmB;AAAA,QACtB,cAAAR;AAAA,QACA,MAAAC;AAAA,QACA,SAAAC;AAAA,QACA,UAAAC;AAAA,QACA,YAAAC;AAAA,QACA,WAAAC;AAAA,MAAA,CACA;AAAA,IAAA;AAEH,WAAAI,EAAU,MAAM;AACf,MAAAH,EAAW,UAAU,EAAE,MAAAL,GAAM,SAAAC,GAAS,UAAAC,GAAU,YAAAC,GAAY,WAAAC,GAAW;AAAA,IACxE,GAAG,CAACC,GAAYL,GAAMC,GAASC,GAAUC,GAAYC,CAAS,CAAC,GAC/DI,EAAU,OACTH,EAAW,MAAA,GACJA,EAAW,OAChB,CAACA,CAAU,CAAC,qBACPV,EAAQ,UAAR,EAAiB,OAAOU,GAAa,UAAAP,GAAS;AAAA,EACvD;AACA,WAASW,IAAc;AACtB,UAAMJ,IAAaK,EAAWf,CAAO;AACrC,QAAI,CAACU,EAAY,OAAM,IAAI,MAAM,6BAA6B;AAM9D,WAAO;AAAA,MACN,GANgBM;AAAA,QAChBN,EAAW;AAAA,QACXA,EAAW;AAAA,QACXA,EAAW;AAAA,MAAA;AAAA,MAIX,UAAUA,EAAW;AAAA,MACrB,OAAOA,EAAW;AAAA,MAClB,OAAOA,EAAW;AAAA,IAAA;AAAA,EAEpB;AACA,SAAO,EAAE,kBAAAR,GAAkB,aAAAY,EAAA;AAC5B;"}
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
import { jsx as a, jsxs as i } from "react/jsx-runtime";
|
|
2
|
+
import { Children as c, useContext as d, isValidElement as u, createContext as h } from "react";
|
|
3
|
+
import { cn as f } from "../../utils/cn.js";
|
|
4
|
+
const m = h({
|
|
5
|
+
max: 1,
|
|
6
|
+
variant: "vertical"
|
|
7
|
+
});
|
|
8
|
+
function g(t) {
|
|
9
|
+
return u(t) && Number(t.props.value) || 0;
|
|
10
|
+
}
|
|
11
|
+
function N({
|
|
12
|
+
children: t,
|
|
13
|
+
variant: e = "vertical",
|
|
14
|
+
max: n,
|
|
15
|
+
label: s,
|
|
16
|
+
className: l
|
|
17
|
+
}) {
|
|
18
|
+
const r = n ?? Math.max(1, ...c.map(t, g) ?? []);
|
|
19
|
+
return /* @__PURE__ */ a(m.Provider, { value: { max: r, variant: e }, children: /* @__PURE__ */ a(
|
|
20
|
+
"ul",
|
|
21
|
+
{
|
|
22
|
+
"data-slot": "bar-chart",
|
|
23
|
+
"data-variant": e,
|
|
24
|
+
"aria-label": s,
|
|
25
|
+
className: f(
|
|
26
|
+
e === "vertical" ? "grid auto-cols-fr grid-flow-col items-end gap-4" : "grid gap-3",
|
|
27
|
+
l
|
|
28
|
+
),
|
|
29
|
+
children: t
|
|
30
|
+
}
|
|
31
|
+
) });
|
|
32
|
+
}
|
|
33
|
+
function C({ label: t, value: e, display: n }) {
|
|
34
|
+
const { max: s, variant: l } = d(m), r = Math.min(1, Math.max(0, e / s)), o = n ?? e;
|
|
35
|
+
return l === "horizontal" ? /* @__PURE__ */ i(
|
|
36
|
+
"li",
|
|
37
|
+
{
|
|
38
|
+
"data-slot": "bar-chart-item",
|
|
39
|
+
className: "grid grid-cols-[minmax(4rem,auto)_1fr_auto] items-center gap-4",
|
|
40
|
+
children: [
|
|
41
|
+
/* @__PURE__ */ a("span", { className: "font-mono text-[0.6875rem] font-semibold uppercase tracking-[0.12em] text-muted-foreground", children: t }),
|
|
42
|
+
/* @__PURE__ */ a("span", { className: "h-1.5 rounded-full bg-border/60", children: /* @__PURE__ */ a(
|
|
43
|
+
"span",
|
|
44
|
+
{
|
|
45
|
+
"data-slot": "bar-chart-bar",
|
|
46
|
+
className: "block h-full rounded-full bg-foreground",
|
|
47
|
+
style: { width: `${r * 100}%` }
|
|
48
|
+
}
|
|
49
|
+
) }),
|
|
50
|
+
/* @__PURE__ */ a("span", { className: "text-lg font-light tabular-nums", children: o })
|
|
51
|
+
]
|
|
52
|
+
}
|
|
53
|
+
) : /* @__PURE__ */ i("li", { "data-slot": "bar-chart-item", className: "grid justify-items-center gap-2", children: [
|
|
54
|
+
/* @__PURE__ */ a("span", { className: "flex h-28 items-end", "aria-hidden": "true", children: /* @__PURE__ */ a(
|
|
55
|
+
"span",
|
|
56
|
+
{
|
|
57
|
+
"data-slot": "bar-chart-bar",
|
|
58
|
+
className: "block w-1.5 rounded-full bg-foreground",
|
|
59
|
+
style: { height: `${r * 100}%` }
|
|
60
|
+
}
|
|
61
|
+
) }),
|
|
62
|
+
/* @__PURE__ */ a("span", { className: "text-xl font-light tabular-nums", children: o }),
|
|
63
|
+
/* @__PURE__ */ a("span", { className: "font-mono text-[0.6875rem] font-semibold uppercase tracking-[0.12em] text-muted-foreground", children: t })
|
|
64
|
+
] });
|
|
65
|
+
}
|
|
66
|
+
export {
|
|
67
|
+
N as BarChart,
|
|
68
|
+
C as BarChartItem
|
|
69
|
+
};
|
|
70
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sources":["../../../src/display/BarChart/index.tsx"],"sourcesContent":["import {\n\tChildren,\n\tcreateContext,\n\tisValidElement,\n\ttype ReactElement,\n\ttype ReactNode,\n\tuseContext,\n} from 'react'\nimport { cn } from '../../utils/cn'\n\ntype Variant = 'vertical' | 'horizontal'\n\nconst ChartContext = createContext<{ max: number; variant: Variant }>({\n\tmax: 1,\n\tvariant: 'vertical',\n})\n\nexport interface BarChartItemProps {\n\tlabel: ReactNode\n\tvalue: number\n\t/** Text for the figure; defaults to the value. */\n\tdisplay?: ReactNode\n}\n\nexport interface BarChartProps {\n\tchildren: ReactNode\n\tvariant?: Variant\n\t/** Scale maximum; defaults to the largest item value. */\n\tmax?: number\n\t/** Accessible name of the chart. */\n\tlabel?: string\n\tclassName?: string\n}\n\nfunction itemValue(child: ReactNode) {\n\treturn isValidElement(child)\n\t\t? Number((child as ReactElement<BarChartItemProps>).props.value) || 0\n\t\t: 0\n}\n\n/**\n * Bars as firm rounded strokes. `vertical`: columns with figure and label\n * below; `horizontal`: rows with label, bar and figure.\n */\nexport function BarChart({\n\tchildren,\n\tvariant = 'vertical',\n\tmax,\n\tlabel,\n\tclassName,\n}: BarChartProps) {\n\tconst scale = max ?? Math.max(1, ...(Children.map(children, itemValue) ?? []))\n\n\treturn (\n\t\t<ChartContext.Provider value={{ max: scale, variant }}>\n\t\t\t<ul\n\t\t\t\tdata-slot='bar-chart'\n\t\t\t\tdata-variant={variant}\n\t\t\t\taria-label={label}\n\t\t\t\tclassName={cn(\n\t\t\t\t\tvariant === 'vertical'\n\t\t\t\t\t\t? 'grid auto-cols-fr grid-flow-col items-end gap-4'\n\t\t\t\t\t\t: 'grid gap-3',\n\t\t\t\t\tclassName,\n\t\t\t\t)}\n\t\t\t>\n\t\t\t\t{children}\n\t\t\t</ul>\n\t\t</ChartContext.Provider>\n\t)\n}\n\nexport function BarChartItem({ label, value, display }: BarChartItemProps) {\n\tconst { max, variant } = useContext(ChartContext)\n\tconst share = Math.min(1, Math.max(0, value / max))\n\tconst figure = display ?? value\n\n\tif (variant === 'horizontal')\n\t\treturn (\n\t\t\t<li\n\t\t\t\tdata-slot='bar-chart-item'\n\t\t\t\tclassName='grid grid-cols-[minmax(4rem,auto)_1fr_auto] items-center gap-4'\n\t\t\t>\n\t\t\t\t<span className='font-mono text-[0.6875rem] font-semibold uppercase tracking-[0.12em] text-muted-foreground'>\n\t\t\t\t\t{label}\n\t\t\t\t</span>\n\t\t\t\t<span className='h-1.5 rounded-full bg-border/60'>\n\t\t\t\t\t<span\n\t\t\t\t\t\tdata-slot='bar-chart-bar'\n\t\t\t\t\t\tclassName='block h-full rounded-full bg-foreground'\n\t\t\t\t\t\tstyle={{ width: `${share * 100}%` }}\n\t\t\t\t\t/>\n\t\t\t\t</span>\n\t\t\t\t<span className='text-lg font-light tabular-nums'>{figure}</span>\n\t\t\t</li>\n\t\t)\n\n\treturn (\n\t\t<li data-slot='bar-chart-item' className='grid justify-items-center gap-2'>\n\t\t\t<span className='flex h-28 items-end' aria-hidden='true'>\n\t\t\t\t<span\n\t\t\t\t\tdata-slot='bar-chart-bar'\n\t\t\t\t\tclassName='block w-1.5 rounded-full bg-foreground'\n\t\t\t\t\tstyle={{ height: `${share * 100}%` }}\n\t\t\t\t/>\n\t\t\t</span>\n\t\t\t<span className='text-xl font-light tabular-nums'>{figure}</span>\n\t\t\t<span className='font-mono text-[0.6875rem] font-semibold uppercase tracking-[0.12em] text-muted-foreground'>\n\t\t\t\t{label}\n\t\t\t</span>\n\t\t</li>\n\t)\n}\n"],"names":["ChartContext","createContext","itemValue","child","isValidElement","BarChart","children","variant","max","label","className","scale","Children","jsx","cn","BarChartItem","value","display","useContext","share","figure","jsxs"],"mappings":";;;AAYA,MAAMA,IAAeC,EAAiD;AAAA,EACrE,KAAK;AAAA,EACL,SAAS;AACV,CAAC;AAmBD,SAASC,EAAUC,GAAkB;AACpC,SAAOC,EAAeD,CAAK,KACxB,OAAQA,EAA0C,MAAM,KAAK,KAAK;AAEtE;AAMO,SAASE,EAAS;AAAA,EACxB,UAAAC;AAAA,EACA,SAAAC,IAAU;AAAA,EACV,KAAAC;AAAA,EACA,OAAAC;AAAA,EACA,WAAAC;AACD,GAAkB;AACjB,QAAMC,IAAQH,KAAO,KAAK,IAAI,GAAG,GAAII,EAAS,IAAIN,GAAUJ,CAAS,KAAK,CAAA,CAAG;AAE7E,SACC,gBAAAW,EAACb,EAAa,UAAb,EAAsB,OAAO,EAAE,KAAKW,GAAO,SAAAJ,KAC3C,UAAA,gBAAAM;AAAA,IAAC;AAAA,IAAA;AAAA,MACA,aAAU;AAAA,MACV,gBAAcN;AAAA,MACd,cAAYE;AAAA,MACZ,WAAWK;AAAA,QACVP,MAAY,aACT,oDACA;AAAA,QACHG;AAAA,MAAA;AAAA,MAGA,UAAAJ;AAAA,IAAA;AAAA,EAAA,GAEH;AAEF;AAEO,SAASS,EAAa,EAAE,OAAAN,GAAO,OAAAO,GAAO,SAAAC,KAA8B;AAC1E,QAAM,EAAE,KAAAT,GAAK,SAAAD,MAAYW,EAAWlB,CAAY,GAC1CmB,IAAQ,KAAK,IAAI,GAAG,KAAK,IAAI,GAAGH,IAAQR,CAAG,CAAC,GAC5CY,IAASH,KAAWD;AAE1B,SAAIT,MAAY,eAEd,gBAAAc;AAAA,IAAC;AAAA,IAAA;AAAA,MACA,aAAU;AAAA,MACV,WAAU;AAAA,MAEV,UAAA;AAAA,QAAA,gBAAAR,EAAC,QAAA,EAAK,WAAU,8FACd,UAAAJ,GACF;AAAA,QACA,gBAAAI,EAAC,QAAA,EAAK,WAAU,mCACf,UAAA,gBAAAA;AAAA,UAAC;AAAA,UAAA;AAAA,YACA,aAAU;AAAA,YACV,WAAU;AAAA,YACV,OAAO,EAAE,OAAO,GAAGM,IAAQ,GAAG,IAAA;AAAA,UAAI;AAAA,QAAA,GAEpC;AAAA,QACA,gBAAAN,EAAC,QAAA,EAAK,WAAU,mCAAmC,UAAAO,EAAA,CAAO;AAAA,MAAA;AAAA,IAAA;AAAA,EAAA,IAK5D,gBAAAC,EAAC,MAAA,EAAG,aAAU,kBAAiB,WAAU,mCACxC,UAAA;AAAA,IAAA,gBAAAR,EAAC,QAAA,EAAK,WAAU,uBAAsB,eAAY,QACjD,UAAA,gBAAAA;AAAA,MAAC;AAAA,MAAA;AAAA,QACA,aAAU;AAAA,QACV,WAAU;AAAA,QACV,OAAO,EAAE,QAAQ,GAAGM,IAAQ,GAAG,IAAA;AAAA,MAAI;AAAA,IAAA,GAErC;AAAA,IACA,gBAAAN,EAAC,QAAA,EAAK,WAAU,mCAAmC,UAAAO,GAAO;AAAA,IAC1D,gBAAAP,EAAC,QAAA,EAAK,WAAU,8FACd,UAAAJ,EAAA,CACF;AAAA,EAAA,GACD;AAEF;"}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import { jsx as t } from "react/jsx-runtime";
|
|
2
|
+
import { cn as m } from "../../utils/cn.js";
|
|
3
|
+
function o({ value: a, className: r }) {
|
|
4
|
+
return /* @__PURE__ */ t(
|
|
5
|
+
"p",
|
|
6
|
+
{
|
|
7
|
+
"data-slot": "marginalia",
|
|
8
|
+
className: m("text-sm font-medium tabular-nums", r),
|
|
9
|
+
children: a
|
|
10
|
+
}
|
|
11
|
+
);
|
|
12
|
+
}
|
|
13
|
+
export {
|
|
14
|
+
o as Marginalia
|
|
15
|
+
};
|
|
16
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sources":["../../../src/display/Marginalia/index.tsx"],"sourcesContent":["import type { ReactNode } from 'react'\nimport { cn } from '../../utils/cn'\n\nexport interface MarginaliaProps {\n\tvalue: ReactNode\n\tclassName?: string\n}\n\n/** A single margin note in the same type as MarginaliaPair, e.g. the year. */\nexport function Marginalia({ value, className }: MarginaliaProps) {\n\treturn (\n\t\t<p\n\t\t\tdata-slot='marginalia'\n\t\t\tclassName={cn('text-sm font-medium tabular-nums', className)}\n\t\t>\n\t\t\t{value}\n\t\t</p>\n\t)\n}\n"],"names":["Marginalia","value","className","jsx","cn"],"mappings":";;AASO,SAASA,EAAW,EAAE,OAAAC,GAAO,WAAAC,KAA8B;AACjE,SACC,gBAAAC;AAAA,IAAC;AAAA,IAAA;AAAA,MACA,aAAU;AAAA,MACV,WAAWC,EAAG,oCAAoCF,CAAS;AAAA,MAE1D,UAAAD;AAAA,IAAA;AAAA,EAAA;AAGJ;"}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import { jsx as e } from "react/jsx-runtime";
|
|
2
|
+
import { cn as a } from "../../utils/cn.js";
|
|
3
|
+
function i({ value: r, className: n }) {
|
|
4
|
+
return /* @__PURE__ */ e(
|
|
5
|
+
"span",
|
|
6
|
+
{
|
|
7
|
+
"data-slot": "marginalia-framed",
|
|
8
|
+
className: a(
|
|
9
|
+
"inline-flex items-center border-[1.5px] border-current px-2 py-1 font-mono text-xs leading-none tabular-nums",
|
|
10
|
+
n
|
|
11
|
+
),
|
|
12
|
+
children: r
|
|
13
|
+
}
|
|
14
|
+
);
|
|
15
|
+
}
|
|
16
|
+
export {
|
|
17
|
+
i as MarginaliaFramed
|
|
18
|
+
};
|
|
19
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sources":["../../../src/display/MarginaliaFramed/index.tsx"],"sourcesContent":["import type { ReactNode } from 'react'\nimport { cn } from '../../utils/cn'\n\nexport interface MarginaliaFramedProps {\n\tvalue: ReactNode\n\tclassName?: string\n}\n\n/** A short code or index in a thin frame, e.g. a page number like \"013\". */\nexport function MarginaliaFramed({ value, className }: MarginaliaFramedProps) {\n\treturn (\n\t\t<span\n\t\t\tdata-slot='marginalia-framed'\n\t\t\tclassName={cn(\n\t\t\t\t'inline-flex items-center border-[1.5px] border-current px-2 py-1 font-mono text-xs leading-none tabular-nums',\n\t\t\t\tclassName,\n\t\t\t)}\n\t\t>\n\t\t\t{value}\n\t\t</span>\n\t)\n}\n"],"names":["MarginaliaFramed","value","className","jsx","cn"],"mappings":";;AASO,SAASA,EAAiB,EAAE,OAAAC,GAAO,WAAAC,KAAoC;AAC7E,SACC,gBAAAC;AAAA,IAAC;AAAA,IAAA;AAAA,MACA,aAAU;AAAA,MACV,WAAWC;AAAA,QACV;AAAA,QACAF;AAAA,MAAA;AAAA,MAGA,UAAAD;AAAA,IAAA;AAAA,EAAA;AAGJ;"}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import { jsxs as e, jsx as a } from "react/jsx-runtime";
|
|
2
|
+
import { cn as l } from "../../utils/cn.js";
|
|
3
|
+
function m({
|
|
4
|
+
left: r,
|
|
5
|
+
right: i,
|
|
6
|
+
className: n
|
|
7
|
+
}) {
|
|
8
|
+
return /* @__PURE__ */ e(
|
|
9
|
+
"p",
|
|
10
|
+
{
|
|
11
|
+
"data-slot": "marginalia-pair",
|
|
12
|
+
className: l("flex items-center gap-4 text-sm font-medium", n),
|
|
13
|
+
children: [
|
|
14
|
+
r,
|
|
15
|
+
/* @__PURE__ */ a("span", { className: "sr-only", children: ", " }),
|
|
16
|
+
/* @__PURE__ */ a(
|
|
17
|
+
"span",
|
|
18
|
+
{
|
|
19
|
+
"aria-hidden": "true",
|
|
20
|
+
"data-slot": "marginalia-pair-rule",
|
|
21
|
+
className: "inline-block h-[1.5px] w-10 shrink-0 rounded-full bg-current"
|
|
22
|
+
}
|
|
23
|
+
),
|
|
24
|
+
i
|
|
25
|
+
]
|
|
26
|
+
}
|
|
27
|
+
);
|
|
28
|
+
}
|
|
29
|
+
export {
|
|
30
|
+
m as MarginaliaPair
|
|
31
|
+
};
|
|
32
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sources":["../../../src/display/MarginaliaPair/index.tsx"],"sourcesContent":["import type { ReactNode } from 'react'\nimport { cn } from '../../utils/cn'\n\nexport interface MarginaliaPairProps {\n\tleft: ReactNode\n\tright: ReactNode\n\tclassName?: string\n}\n\n/** Margin note of two values joined by a long rule, e.g. weekday —— date. */\nexport function MarginaliaPair({\n\tleft,\n\tright,\n\tclassName,\n}: MarginaliaPairProps) {\n\treturn (\n\t\t<p\n\t\t\tdata-slot='marginalia-pair'\n\t\t\tclassName={cn('flex items-center gap-4 text-sm font-medium', className)}\n\t\t>\n\t\t\t{left}\n\t\t\t<span className='sr-only'>, </span>\n\t\t\t<span\n\t\t\t\taria-hidden='true'\n\t\t\t\tdata-slot='marginalia-pair-rule'\n\t\t\t\tclassName='inline-block h-[1.5px] w-10 shrink-0 rounded-full bg-current'\n\t\t\t/>\n\t\t\t{right}\n\t\t</p>\n\t)\n}\n"],"names":["MarginaliaPair","left","right","className","jsxs","cn","jsx"],"mappings":";;AAUO,SAASA,EAAe;AAAA,EAC9B,MAAAC;AAAA,EACA,OAAAC;AAAA,EACA,WAAAC;AACD,GAAwB;AACvB,SACC,gBAAAC;AAAA,IAAC;AAAA,IAAA;AAAA,MACA,aAAU;AAAA,MACV,WAAWC,EAAG,+CAA+CF,CAAS;AAAA,MAErE,UAAA;AAAA,QAAAF;AAAA,QACD,gBAAAK,EAAC,QAAA,EAAK,WAAU,WAAU,UAAA,MAAE;AAAA,QAC5B,gBAAAA;AAAA,UAAC;AAAA,UAAA;AAAA,YACA,eAAY;AAAA,YACZ,aAAU;AAAA,YACV,WAAU;AAAA,UAAA;AAAA,QAAA;AAAA,QAEVJ;AAAA,MAAA;AAAA,IAAA;AAAA,EAAA;AAGJ;"}
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
import { jsxs as n, jsx as r } from "react/jsx-runtime";
|
|
2
|
+
import { cn as d } from "../../utils/cn.js";
|
|
3
|
+
import { getRuntimeLocale as u } from "../../utils/dates.js";
|
|
4
|
+
function c(e) {
|
|
5
|
+
return Number.isFinite(e) ? Math.min(1, Math.max(0, e)) : 0;
|
|
6
|
+
}
|
|
7
|
+
function b({
|
|
8
|
+
label: e,
|
|
9
|
+
value: a,
|
|
10
|
+
total: s,
|
|
11
|
+
progress: i,
|
|
12
|
+
completed: l = !1,
|
|
13
|
+
className: m
|
|
14
|
+
}) {
|
|
15
|
+
const t = c(
|
|
16
|
+
l ? 1 : a !== void 0 && s ? a / s : i ?? 0
|
|
17
|
+
), o = new Intl.NumberFormat(u(), {
|
|
18
|
+
style: "percent",
|
|
19
|
+
maximumFractionDigits: 0
|
|
20
|
+
}).format(t);
|
|
21
|
+
return /* @__PURE__ */ n("div", { "data-slot": "progress-bar", className: d("grid gap-2", m), children: [
|
|
22
|
+
/* @__PURE__ */ n("div", { className: "flex items-baseline justify-between gap-4", children: [
|
|
23
|
+
/* @__PURE__ */ r(
|
|
24
|
+
"span",
|
|
25
|
+
{
|
|
26
|
+
"data-slot": "progress-bar-label",
|
|
27
|
+
className: "font-mono text-[0.6875rem] font-semibold uppercase tracking-[0.12em] text-muted-foreground",
|
|
28
|
+
children: e
|
|
29
|
+
}
|
|
30
|
+
),
|
|
31
|
+
a !== void 0 ? /* @__PURE__ */ r(
|
|
32
|
+
"span",
|
|
33
|
+
{
|
|
34
|
+
"data-slot": "progress-bar-value",
|
|
35
|
+
className: "text-2xl font-light tabular-nums",
|
|
36
|
+
children: a
|
|
37
|
+
}
|
|
38
|
+
) : /* @__PURE__ */ r(
|
|
39
|
+
"span",
|
|
40
|
+
{
|
|
41
|
+
"data-slot": "progress-bar-value",
|
|
42
|
+
className: "font-mono text-[0.6875rem] font-semibold tracking-[0.12em] text-muted-foreground tabular-nums",
|
|
43
|
+
children: o
|
|
44
|
+
}
|
|
45
|
+
)
|
|
46
|
+
] }),
|
|
47
|
+
/* @__PURE__ */ r(
|
|
48
|
+
"div",
|
|
49
|
+
{
|
|
50
|
+
role: "progressbar",
|
|
51
|
+
"aria-valuemin": 0,
|
|
52
|
+
"aria-valuemax": 100,
|
|
53
|
+
"aria-valuenow": Math.round(t * 100),
|
|
54
|
+
"aria-valuetext": o,
|
|
55
|
+
"data-slot": "progress-bar-track",
|
|
56
|
+
className: "h-[1.5px] rounded-full bg-border",
|
|
57
|
+
children: /* @__PURE__ */ r(
|
|
58
|
+
"div",
|
|
59
|
+
{
|
|
60
|
+
"data-slot": "progress-bar-fill",
|
|
61
|
+
className: "h-full rounded-full bg-foreground transition-[width] duration-300 motion-reduce:transition-none",
|
|
62
|
+
style: { width: `${t * 100}%` }
|
|
63
|
+
}
|
|
64
|
+
)
|
|
65
|
+
}
|
|
66
|
+
)
|
|
67
|
+
] });
|
|
68
|
+
}
|
|
69
|
+
export {
|
|
70
|
+
b as ProgressBar
|
|
71
|
+
};
|
|
72
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sources":["../../../src/display/ProgressBar/index.tsx"],"sourcesContent":["import type { ReactNode } from 'react'\nimport { cn } from '../../utils/cn'\nimport { getRuntimeLocale } from '../../utils/dates'\n\nexport interface ProgressBarProps {\n\tlabel: ReactNode\n\t/** Count shown on the right, e.g. the number of items in this state. */\n\tvalue?: number\n\t/** With `value`: progress becomes `value / total`. */\n\ttotal?: number\n\t/** Share from 0 to 1. Shown as a percentage when no `value` is given. */\n\tprogress?: number\n\t/** Full bar. Combines with `value`, e.g. the number of finished items. */\n\tcompleted?: boolean\n\tclassName?: string\n}\n\nfunction clamp(value: number) {\n\treturn Number.isFinite(value) ? Math.min(1, Math.max(0, value)) : 0\n}\n\n/**\n * A captioned progress line: label left, figure right, thin bar below.\n * The share comes from `completed`, `value / total` or `progress`, in this order.\n */\nexport function ProgressBar({\n\tlabel,\n\tvalue,\n\ttotal,\n\tprogress,\n\tcompleted = false,\n\tclassName,\n}: ProgressBarProps) {\n\tconst share = clamp(\n\t\tcompleted\n\t\t\t? 1\n\t\t\t: value !== undefined && total\n\t\t\t\t? value / total\n\t\t\t\t: (progress ?? 0),\n\t)\n\tconst percent = new Intl.NumberFormat(getRuntimeLocale(), {\n\t\tstyle: 'percent',\n\t\tmaximumFractionDigits: 0,\n\t}).format(share)\n\n\treturn (\n\t\t<div data-slot='progress-bar' className={cn('grid gap-2', className)}>\n\t\t\t<div className='flex items-baseline justify-between gap-4'>\n\t\t\t\t<span\n\t\t\t\t\tdata-slot='progress-bar-label'\n\t\t\t\t\tclassName='font-mono text-[0.6875rem] font-semibold uppercase tracking-[0.12em] text-muted-foreground'\n\t\t\t\t>\n\t\t\t\t\t{label}\n\t\t\t\t</span>\n\t\t\t\t{value !== undefined ? (\n\t\t\t\t\t<span\n\t\t\t\t\t\tdata-slot='progress-bar-value'\n\t\t\t\t\t\tclassName='text-2xl font-light tabular-nums'\n\t\t\t\t\t>\n\t\t\t\t\t\t{value}\n\t\t\t\t\t</span>\n\t\t\t\t) : (\n\t\t\t\t\t<span\n\t\t\t\t\t\tdata-slot='progress-bar-value'\n\t\t\t\t\t\tclassName='font-mono text-[0.6875rem] font-semibold tracking-[0.12em] text-muted-foreground tabular-nums'\n\t\t\t\t\t>\n\t\t\t\t\t\t{percent}\n\t\t\t\t\t</span>\n\t\t\t\t)}\n\t\t\t</div>\n\t\t\t<div\n\t\t\t\trole='progressbar'\n\t\t\t\taria-valuemin={0}\n\t\t\t\taria-valuemax={100}\n\t\t\t\taria-valuenow={Math.round(share * 100)}\n\t\t\t\taria-valuetext={percent}\n\t\t\t\tdata-slot='progress-bar-track'\n\t\t\t\tclassName='h-[1.5px] rounded-full bg-border'\n\t\t\t>\n\t\t\t\t<div\n\t\t\t\t\tdata-slot='progress-bar-fill'\n\t\t\t\t\tclassName='h-full rounded-full bg-foreground transition-[width] duration-300 motion-reduce:transition-none'\n\t\t\t\t\tstyle={{ width: `${share * 100}%` }}\n\t\t\t\t/>\n\t\t\t</div>\n\t\t</div>\n\t)\n}\n"],"names":["clamp","value","ProgressBar","label","total","progress","completed","className","share","percent","getRuntimeLocale","jsxs","cn","jsx"],"mappings":";;;AAiBA,SAASA,EAAMC,GAAe;AAC7B,SAAO,OAAO,SAASA,CAAK,IAAI,KAAK,IAAI,GAAG,KAAK,IAAI,GAAGA,CAAK,CAAC,IAAI;AACnE;AAMO,SAASC,EAAY;AAAA,EAC3B,OAAAC;AAAA,EACA,OAAAF;AAAA,EACA,OAAAG;AAAA,EACA,UAAAC;AAAA,EACA,WAAAC,IAAY;AAAA,EACZ,WAAAC;AACD,GAAqB;AACpB,QAAMC,IAAQR;AAAA,IACbM,IACG,IACAL,MAAU,UAAaG,IACtBH,IAAQG,IACPC,KAAY;AAAA,EAAA,GAEZI,IAAU,IAAI,KAAK,aAAaC,KAAoB;AAAA,IACzD,OAAO;AAAA,IACP,uBAAuB;AAAA,EAAA,CACvB,EAAE,OAAOF,CAAK;AAEf,SACC,gBAAAG,EAAC,SAAI,aAAU,gBAAe,WAAWC,EAAG,cAAcL,CAAS,GAClE,UAAA;AAAA,IAAA,gBAAAI,EAAC,OAAA,EAAI,WAAU,6CACd,UAAA;AAAA,MAAA,gBAAAE;AAAA,QAAC;AAAA,QAAA;AAAA,UACA,aAAU;AAAA,UACV,WAAU;AAAA,UAET,UAAAV;AAAA,QAAA;AAAA,MAAA;AAAA,MAEDF,MAAU,SACV,gBAAAY;AAAA,QAAC;AAAA,QAAA;AAAA,UACA,aAAU;AAAA,UACV,WAAU;AAAA,UAET,UAAAZ;AAAA,QAAA;AAAA,MAAA,IAGF,gBAAAY;AAAA,QAAC;AAAA,QAAA;AAAA,UACA,aAAU;AAAA,UACV,WAAU;AAAA,UAET,UAAAJ;AAAA,QAAA;AAAA,MAAA;AAAA,IACF,GAEF;AAAA,IACA,gBAAAI;AAAA,MAAC;AAAA,MAAA;AAAA,QACA,MAAK;AAAA,QACL,iBAAe;AAAA,QACf,iBAAe;AAAA,QACf,iBAAe,KAAK,MAAML,IAAQ,GAAG;AAAA,QACrC,kBAAgBC;AAAA,QAChB,aAAU;AAAA,QACV,WAAU;AAAA,QAEV,UAAA,gBAAAI;AAAA,UAAC;AAAA,UAAA;AAAA,YACA,aAAU;AAAA,YACV,WAAU;AAAA,YACV,OAAO,EAAE,OAAO,GAAGL,IAAQ,GAAG,IAAA;AAAA,UAAI;AAAA,QAAA;AAAA,MACnC;AAAA,IAAA;AAAA,EACD,GACD;AAEF;"}
|