c323adc343
Defines the "Bulk Import All Sources" feature for the on-demand bestiary system: one-click loading of all ~104 bestiary sources with concurrent fetching, progress feedback, toast notifications, and completion reporting. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1.8 KiB
1.8 KiB
Data Model: Bulk Import All Sources
Entities
BulkImportState
Tracks the progress and outcome of a bulk import operation.
| Field | Type | Description |
|---|---|---|
| status | "idle" / "loading" / "complete" / "partial-failure" | Current phase of the import operation |
| total | number | Total number of sources to fetch (excludes already-cached) |
| completed | number | Number of sources successfully fetched and cached |
| failed | number | Number of sources that failed to fetch |
State Transitions:
idle→loading: User clicks "Load All"loading→complete: All sources fetched successfully (failed === 0)loading→partial-failure: Some sources failed (failed > 0)complete/partial-failure→idle: User dismisses or starts a new import
ToastNotification
Lightweight notification data for the toast component.
| Field | Type | Description |
|---|---|---|
| message | string | Primary text to display (e.g., "Loading sources... 34/102") |
| progress | number (0-1) or undefined | Optional progress bar value |
| dismissible | boolean | Whether the toast shows a dismiss button |
| autoDismissMs | number or undefined | Auto-dismiss delay in ms; undefined means persistent |
Relationships
- BulkImportState drives the content of both the side panel progress UI and the toast notification.
- ToastNotification is derived from BulkImportState when the side panel is closed during an active import.
- Both consume state from the
useBulkImporthook.
Existing Entities (unchanged)
- CachedSourceRecord (bestiary-cache.ts): Stores normalized creature data per source in IndexedDB. No schema changes.
- BestiaryIndex (domain): Read-only index with source codes and compact creature entries. No changes.