# svar-widgets/calendar architecture

> Architecture diagram of the GitHub repository svar-widgets/calendar, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/svar-widgets/calendar
- Repository: https://github.com/svar-widgets/calendar

## Overview

SVAR Svelte Calendar is a Svelte event calendar and scheduler. Users supply events and a date, choose a Day, Week, or Month view, then interact with rendered events to inspect, create, move, resize, or edit them. The store owns calendar state and action dispatch; view models turn events into positioned sections for the widget to render. The README also documents REST-provider and iCal capabilities, represented as optional integration branches. Some widget and integration modules were not sampled, so their internal wiring is not asserted.

Main entry points: [`packages/store/src/calendar_store.ts`](https://github.com/svar-widgets/calendar/blob/main/packages/store/src/calendar_store.ts) (Calendar store), [`apps/widget/src/components/Render/SectionContent.svelte`](https://github.com/svar-widgets/calendar/blob/main/apps/widget/src/components/Render/SectionContent.svelte) (Section content), [`apps/widget/src/components/Calendar.svelte`](https://github.com/svar-widgets/calendar/blob/main/apps/widget/src/components/Calendar.svelte) (Calendar widget), [`apps/widget/src/directives/drag.ts`](https://github.com/svar-widgets/calendar/blob/main/apps/widget/src/directives/drag.ts) (Drag interactions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_widget["Calendar widget"]
  node_calendar["Calendar widget<br/>[Calendar.svelte]"]
  node_toolbar["Navigation and toolbar<br/>[Navigation.svelte]"]
  node_editor["Event editor<br/>[Editor.svelte]"]
  node_contextmenu["Context menu<br/>[ContextMenu.svelte]"]
  node_drag["Drag interactions<br/>[drag.ts]"]
  node_resize["Resize interaction<br/>[dragresize.ts]"]
end

subgraph group_state["Calendar state"]
  node_store[("Calendar store<br/>[calendar_store.ts]")]
  node_eventstore[("Event collection<br/>[events_store.ts]")]
  node_actions["Calendar actions<br/>[index.ts]"]
  node_addaction["Add event<br/>[add-event.ts]"]
end

subgraph group_views["Views and rendering"]
  node_sections["Section renderer<br/>[Sections.svelte]"]
  node_sectioncontent["Section content"]
  node_boxsection["Box view section<br/>[BoxSection.svelte]"]
  node_gridsection["Grid view section<br/>[GridSection.svelte]"]
  node_listsection["List view section<br/>[ListSection.svelte]"]
  node_yearsection["Year view section<br/>[YearSection.svelte]"]
  node_models["View models<br/>[model.ts]"]
  node_monthview["Month view<br/>[month_view.ts]"]
  node_scales["Scale helpers<br/>[scales.ts]"]
end

subgraph group_integrations["Data integrations"]
  node_provider["REST provider"]
  node_icalparse["iCal import<br/>[parse.ts]"]
  node_icalserialize["iCal export<br/>[serialize.ts]"]
end

node_user(("Calendar user"))

node_user -->|"uses"| node_calendar
node_calendar -.-> node_toolbar
node_calendar -.-> node_editor
node_calendar -.-> node_contextmenu
node_sections -->|"renders"| node_sectioncontent
node_sectioncontent -->|"renders"| node_boxsection
node_sectioncontent -->|"renders"| node_gridsection
node_sectioncontent -->|"renders"| node_listsection
node_sectioncontent -->|"renders"| node_yearsection
node_sections -->|"registers"| node_drag
node_drag -->|"starts resize"| node_resize
node_drag -->|"dispatches add"| node_addaction
node_drag -->|"dispatches move"| node_actions
node_store -->|"routes events"| node_eventstore
node_store -->|"initializes"| node_actions
node_store -->|"configures views"| node_models
node_actions -->|"registers"| node_addaction
node_addaction -->|"adds event"| node_eventstore
node_models -->|"creates scales"| node_scales
node_monthview -->|"extends"| node_models
node_provider -.->|"backend data"| node_store
node_icalparse -.->|"imports events"| node_store
node_store -.->|"exports events"| node_icalserialize

click node_calendar "https://github.com/svar-widgets/calendar/blob/main/apps/widget/src/components/Calendar.svelte"
click node_toolbar "https://github.com/svar-widgets/calendar/blob/main/apps/widget/src/components/Navigation.svelte"
click node_editor "https://github.com/svar-widgets/calendar/blob/main/apps/widget/src/components/Editor.svelte"
click node_contextmenu "https://github.com/svar-widgets/calendar/blob/main/apps/widget/src/components/ContextMenu.svelte"
click node_sections "https://github.com/svar-widgets/calendar/blob/main/apps/widget/src/components/Render/Sections.svelte"
click node_sectioncontent "https://github.com/svar-widgets/calendar/blob/main/apps/widget/src/components/Render/SectionContent.svelte"
click node_boxsection "https://github.com/svar-widgets/calendar/blob/main/apps/widget/src/components/Render/BoxSection.svelte"
click node_gridsection "https://github.com/svar-widgets/calendar/blob/main/apps/widget/src/components/Render/GridSection.svelte"
click node_listsection "https://github.com/svar-widgets/calendar/blob/main/apps/widget/src/components/Render/ListSection.svelte"
click node_yearsection "https://github.com/svar-widgets/calendar/blob/main/apps/widget/src/components/Render/YearSection.svelte"
click node_drag "https://github.com/svar-widgets/calendar/blob/main/apps/widget/src/directives/drag.ts"
click node_resize "https://github.com/svar-widgets/calendar/blob/main/apps/widget/src/directives/dragresize.ts"
click node_store "https://github.com/svar-widgets/calendar/blob/main/packages/store/src/calendar_store.ts"
click node_eventstore "https://github.com/svar-widgets/calendar/blob/main/packages/store/src/events_store.ts"
click node_actions "https://github.com/svar-widgets/calendar/blob/main/packages/store/src/actions/index.ts"
click node_addaction "https://github.com/svar-widgets/calendar/blob/main/packages/store/src/actions/add-event.ts"
click node_models "https://github.com/svar-widgets/calendar/blob/main/packages/store/src/models/model.ts"
click node_monthview "https://github.com/svar-widgets/calendar/blob/main/packages/store/src/models/month_view.ts"
click node_scales "https://github.com/svar-widgets/calendar/blob/main/packages/store/src/models/helpers/scales.ts"
click node_provider "https://github.com/svar-widgets/calendar/blob/main/packages/provider/src/RestDataProvider.ts"
click node_icalparse "https://github.com/svar-widgets/calendar/blob/main/packages/ical/src/parse.ts"
click node_icalserialize "https://github.com/svar-widgets/calendar/blob/main/packages/ical/src/serialize.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_calendar,node_toolbar,node_editor,node_contextmenu,node_drag,node_resize,node_user toneBlue
class node_store,node_eventstore,node_actions,node_addaction toneAmber
class node_sections,node_sectioncontent,node_boxsection,node_gridsection,node_listsection,node_yearsection,node_models,node_monthview,node_scales toneMint
class node_provider,node_icalparse,node_icalserialize toneRose
```

## Components

### Calendar widget

- [Calendar widget](https://github.com/svar-widgets/calendar/blob/main/apps/widget/src/components/Calendar.svelte): `apps/widget/src/components/Calendar.svelte`
- [Navigation and toolbar](https://github.com/svar-widgets/calendar/blob/main/apps/widget/src/components/Navigation.svelte): `apps/widget/src/components/Navigation.svelte`
- [Event editor](https://github.com/svar-widgets/calendar/blob/main/apps/widget/src/components/Editor.svelte): `apps/widget/src/components/Editor.svelte`
- [Context menu](https://github.com/svar-widgets/calendar/blob/main/apps/widget/src/components/ContextMenu.svelte): `apps/widget/src/components/ContextMenu.svelte`
- [Drag interactions](https://github.com/svar-widgets/calendar/blob/main/apps/widget/src/directives/drag.ts): `apps/widget/src/directives/drag.ts`
- [Resize interaction](https://github.com/svar-widgets/calendar/blob/main/apps/widget/src/directives/dragresize.ts): `apps/widget/src/directives/dragresize.ts`

### Calendar state

- [Calendar store](https://github.com/svar-widgets/calendar/blob/main/packages/store/src/calendar_store.ts): `packages/store/src/calendar_store.ts`
- [Event collection](https://github.com/svar-widgets/calendar/blob/main/packages/store/src/events_store.ts): `packages/store/src/events_store.ts`
- [Calendar actions](https://github.com/svar-widgets/calendar/blob/main/packages/store/src/actions/index.ts): `packages/store/src/actions/index.ts`
- [Add event](https://github.com/svar-widgets/calendar/blob/main/packages/store/src/actions/add-event.ts): `packages/store/src/actions/add-event.ts`

### Views and rendering

- [Section renderer](https://github.com/svar-widgets/calendar/blob/main/apps/widget/src/components/Render/Sections.svelte): `apps/widget/src/components/Render/Sections.svelte`
- [Section content](https://github.com/svar-widgets/calendar/blob/main/apps/widget/src/components/Render/SectionContent.svelte): `apps/widget/src/components/Render/SectionContent.svelte`
- [Box view section](https://github.com/svar-widgets/calendar/blob/main/apps/widget/src/components/Render/BoxSection.svelte): `apps/widget/src/components/Render/BoxSection.svelte`
- [Grid view section](https://github.com/svar-widgets/calendar/blob/main/apps/widget/src/components/Render/GridSection.svelte): `apps/widget/src/components/Render/GridSection.svelte`
- [List view section](https://github.com/svar-widgets/calendar/blob/main/apps/widget/src/components/Render/ListSection.svelte): `apps/widget/src/components/Render/ListSection.svelte`
- [Year view section](https://github.com/svar-widgets/calendar/blob/main/apps/widget/src/components/Render/YearSection.svelte): `apps/widget/src/components/Render/YearSection.svelte`
- [View models](https://github.com/svar-widgets/calendar/blob/main/packages/store/src/models/model.ts): `packages/store/src/models/model.ts`
- [Month view](https://github.com/svar-widgets/calendar/blob/main/packages/store/src/models/month_view.ts): `packages/store/src/models/month_view.ts`
- [Scale helpers](https://github.com/svar-widgets/calendar/blob/main/packages/store/src/models/helpers/scales.ts): `packages/store/src/models/helpers/scales.ts`

### Data integrations

- [REST provider](https://github.com/svar-widgets/calendar/blob/main/packages/provider/src/RestDataProvider.ts): `packages/provider/src/RestDataProvider.ts`
- [iCal import](https://github.com/svar-widgets/calendar/blob/main/packages/ical/src/parse.ts): `packages/ical/src/parse.ts`
- [iCal export](https://github.com/svar-widgets/calendar/blob/main/packages/ical/src/serialize.ts): `packages/ical/src/serialize.ts`

### Other components

- **Calendar user**

## Connections

- Calendar user → Calendar widget: uses
- Calendar widget → Navigation and toolbar
- Calendar widget → Event editor
- Calendar widget → Context menu
- Section renderer → Section content: renders (evidence: `apps/widget/src/components/Render/Sections.svelte`)
- Section content → Box view section: renders (evidence: `apps/widget/src/components/Render/SectionContent.svelte`)
- Section content → Grid view section: renders (evidence: `apps/widget/src/components/Render/SectionContent.svelte`)
- Section content → List view section: renders (evidence: `apps/widget/src/components/Render/SectionContent.svelte`)
- Section content → Year view section: renders (evidence: `apps/widget/src/components/Render/SectionContent.svelte`)
- Section renderer → Drag interactions: registers (evidence: `apps/widget/src/components/Render/Sections.svelte`)
- Drag interactions → Resize interaction: starts resize (evidence: `apps/widget/src/directives/drag.ts`)
- Drag interactions → Add event: dispatches add (evidence: `apps/widget/src/directives/drag.ts`)
- Drag interactions → Calendar actions: dispatches move (evidence: `apps/widget/src/directives/drag.ts`)
- Calendar store → Event collection: routes events (evidence: `packages/store/src/calendar_store.ts`)
- Calendar store → Calendar actions: initializes (evidence: `packages/store/src/calendar_store.ts`)
- Calendar store → View models: configures views (evidence: `packages/store/src/calendar_store.ts`)
- Calendar actions → Add event: registers (evidence: `packages/store/src/actions/index.ts`)
- Add event → Event collection: adds event (evidence: `packages/store/src/actions/add-event.ts`)
- View models → Scale helpers: creates scales (evidence: `packages/store/src/models/model.ts`)
- Month view → View models: extends (evidence: `packages/store/src/models/month_view.ts`)
- REST provider → Calendar store: backend data
- iCal import → Calendar store: imports events
- Calendar store → iCal export: exports events
