# youzan/vant-weapp architecture

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

- Interactive diagram: https://gitdiagram.com/youzan/vant-weapp
- Repository: https://github.com/youzan/vant-weapp

## Overview

Vant Weapp is a lightweight UI component library for WeChat Mini Programs. The main user workflow is that an application registers a component, renders it in WXML, and receives component events or values. Its component families cover input, selection, navigation, display, and feedback; a shared runtime layer adapts component definitions and supplies utilities. The README documents component registration and use. Source excerpts show selected component-to-runtime dependencies; many other component relationships are not verified here and are represented as product capabilities, not invented call chains.

Main entry points: [`packages/tabs/index.ts`](https://github.com/youzan/vant-weapp/blob/dev/packages/tabs/index.ts) (Tabs), [`packages/common/component.ts`](https://github.com/youzan/vant-weapp/blob/dev/packages/common/component.ts) (Component Adapter), [`packages/datetime-picker/index.ts`](https://github.com/youzan/vant-weapp/blob/dev/packages/datetime-picker/index.ts) (Date-time Picker), [`packages/calendar/index.ts`](https://github.com/youzan/vant-weapp/blob/dev/packages/calendar/index.ts) (Calendar)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Input and Selection"]
  node_button["Button<br/>[index.ts]"]
  node_field["Field<br/>[index.ts]"]
  node_picker["Picker<br/>[index.ts]"]
  node_datepick["Date-time Picker<br/>[index.ts]"]
  node_calendar["Calendar<br/>[index.ts]"]
  node_area["Area Selector<br/>[index.ts]"]
  node_cascader["Cascader<br/>[index.ts]"]
  node_uploader["Uploader<br/>[index.ts]"]
end

subgraph group_navigation["Navigation and Layout"]
  node_tabs["Tabs<br/>[index.ts]"]
  node_indexbar["Index Bar<br/>[index.js]"]
  node_grid["Grid<br/>[index.ts]"]
  node_collapse["Collapse<br/>[index.ts]"]
end

subgraph group_display["Display Components"]
  node_image["Image<br/>[index.ts]"]
  node_card["Card<br/>[index.ts]"]
  node_progress["Progress<br/>[index.ts]"]
end

subgraph group_feedback["Feedback Components"]
  node_dialog["Dialog<br/>[index.ts]"]
  node_toast["Toast<br/>[toast.ts]"]
end

subgraph group_runtime["Shared Runtime"]
  node_component["Component Adapter<br/>[component.ts]"]
  node_componentjs["Component Adapter JS<br/>[component.js]"]
  node_utils["Runtime Utilities<br/>[utils.ts]"]
  node_utilsjs["Runtime Utilities JS<br/>[utils.js]"]
  node_validator["Value Validators<br/>[validator.ts]"]
  node_validatorjs["Value Validators JS<br/>[validator.js]"]
  node_relations["Component Relations<br/>[relation.ts]"]
  node_relationsjs["Component Relations JS<br/>[relation.js]"]
  node_touch["Touch Behavior<br/>[touch.ts]"]
  node_touchjs["Touch Behavior JS<br/>[touch.js]"]
  node_pickerdata["Picker Shared Logic<br/>[shared.ts]"]
  node_pickerdatajs["Picker Shared Logic JS<br/>[shared.js]"]
  node_calendarutil["Calendar Date Logic<br/>[utils.ts]"]
  node_toastjs["Toast Runtime<br/>[toast.js]"]
end

node_app(("Mini Program App"))

node_app -->|"registers and renders"| node_button
node_field -->|"uses adapter"| node_component
node_area -->|"uses adapter"| node_component
node_area -->|"uses shared logic"| node_pickerdata
node_datepick -->|"uses adapter"| node_component
node_datepick -->|"uses validators"| node_validator
node_datepick -->|"uses shared logic"| node_pickerdata
node_calendar -->|"uses adapter"| node_component
node_calendar -->|"uses date logic"| node_calendarutil
node_tabs -->|"uses adapter"| node_component
node_tabs -->|"uses behavior"| node_touch
node_tabs -->|"uses utilities"| node_utils
node_tabs -->|"uses validators"| node_validator
node_tabs -->|"uses relations"| node_relations
node_indexbar -->|"uses relations"| node_relationsjs
node_indexbar -->|"uses utilities"| node_utilsjs
node_toast -.->|"uses adapter"| node_component
node_calendar -->|"uses feedback"| node_toast

click node_button "https://github.com/youzan/vant-weapp/blob/dev/packages/button/index.ts"
click node_field "https://github.com/youzan/vant-weapp/blob/dev/packages/field/index.ts"
click node_picker "https://github.com/youzan/vant-weapp/blob/dev/packages/picker/index.ts"
click node_datepick "https://github.com/youzan/vant-weapp/blob/dev/packages/datetime-picker/index.ts"
click node_calendar "https://github.com/youzan/vant-weapp/blob/dev/packages/calendar/index.ts"
click node_area "https://github.com/youzan/vant-weapp/blob/dev/packages/area/index.ts"
click node_cascader "https://github.com/youzan/vant-weapp/blob/dev/packages/cascader/index.ts"
click node_uploader "https://github.com/youzan/vant-weapp/blob/dev/packages/uploader/index.ts"
click node_tabs "https://github.com/youzan/vant-weapp/blob/dev/packages/tabs/index.ts"
click node_indexbar "https://github.com/youzan/vant-weapp/blob/dev/lib/index-bar/index.js"
click node_grid "https://github.com/youzan/vant-weapp/blob/dev/packages/grid/index.ts"
click node_collapse "https://github.com/youzan/vant-weapp/blob/dev/packages/collapse/index.ts"
click node_image "https://github.com/youzan/vant-weapp/blob/dev/packages/image/index.ts"
click node_card "https://github.com/youzan/vant-weapp/blob/dev/packages/card/index.ts"
click node_progress "https://github.com/youzan/vant-weapp/blob/dev/packages/progress/index.ts"
click node_dialog "https://github.com/youzan/vant-weapp/blob/dev/packages/dialog/index.ts"
click node_toast "https://github.com/youzan/vant-weapp/blob/dev/packages/toast/toast.ts"
click node_component "https://github.com/youzan/vant-weapp/blob/dev/packages/common/component.ts"
click node_componentjs "https://github.com/youzan/vant-weapp/blob/dev/lib/common/component.js"
click node_utils "https://github.com/youzan/vant-weapp/blob/dev/packages/common/utils.ts"
click node_utilsjs "https://github.com/youzan/vant-weapp/blob/dev/lib/common/utils.js"
click node_validator "https://github.com/youzan/vant-weapp/blob/dev/packages/common/validator.ts"
click node_validatorjs "https://github.com/youzan/vant-weapp/blob/dev/lib/common/validator.js"
click node_relations "https://github.com/youzan/vant-weapp/blob/dev/packages/common/relation.ts"
click node_relationsjs "https://github.com/youzan/vant-weapp/blob/dev/lib/common/relation.js"
click node_touch "https://github.com/youzan/vant-weapp/blob/dev/packages/mixins/touch.ts"
click node_touchjs "https://github.com/youzan/vant-weapp/blob/dev/lib/mixins/touch.js"
click node_pickerdata "https://github.com/youzan/vant-weapp/blob/dev/packages/picker/shared.ts"
click node_pickerdatajs "https://github.com/youzan/vant-weapp/blob/dev/lib/picker/shared.js"
click node_calendarutil "https://github.com/youzan/vant-weapp/blob/dev/packages/calendar/utils.ts"
click node_toastjs "https://github.com/youzan/vant-weapp/blob/dev/lib/toast/toast.js"

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_button,node_field,node_picker,node_datepick,node_calendar,node_area,node_cascader,node_uploader toneBlue
class node_tabs,node_indexbar,node_grid,node_collapse toneAmber
class node_image,node_card,node_progress toneMint
class node_dialog,node_toast toneRose
class node_component,node_componentjs,node_utils,node_utilsjs,node_validator,node_validatorjs,node_relations,node_relationsjs,node_touch,node_touchjs,node_pickerdata,node_pickerdatajs,node_calendarutil,node_toastjs,node_app toneIndigo
```

## Components

### Input and Selection

- [Button](https://github.com/youzan/vant-weapp/blob/dev/packages/button/index.ts): `packages/button/index.ts`
- [Field](https://github.com/youzan/vant-weapp/blob/dev/packages/field/index.ts): `packages/field/index.ts`
- [Picker](https://github.com/youzan/vant-weapp/blob/dev/packages/picker/index.ts): `packages/picker/index.ts`
- [Date-time Picker](https://github.com/youzan/vant-weapp/blob/dev/packages/datetime-picker/index.ts): `packages/datetime-picker/index.ts`
- [Calendar](https://github.com/youzan/vant-weapp/blob/dev/packages/calendar/index.ts): `packages/calendar/index.ts`
- [Area Selector](https://github.com/youzan/vant-weapp/blob/dev/packages/area/index.ts): `packages/area/index.ts`
- [Cascader](https://github.com/youzan/vant-weapp/blob/dev/packages/cascader/index.ts): `packages/cascader/index.ts`
- [Uploader](https://github.com/youzan/vant-weapp/blob/dev/packages/uploader/index.ts): `packages/uploader/index.ts`

### Navigation and Layout

- [Tabs](https://github.com/youzan/vant-weapp/blob/dev/packages/tabs/index.ts): `packages/tabs/index.ts`
- [Index Bar](https://github.com/youzan/vant-weapp/blob/dev/lib/index-bar/index.js): `lib/index-bar/index.js`
- [Grid](https://github.com/youzan/vant-weapp/blob/dev/packages/grid/index.ts): `packages/grid/index.ts`
- [Collapse](https://github.com/youzan/vant-weapp/blob/dev/packages/collapse/index.ts): `packages/collapse/index.ts`

### Display Components

- [Image](https://github.com/youzan/vant-weapp/blob/dev/packages/image/index.ts): `packages/image/index.ts`
- [Card](https://github.com/youzan/vant-weapp/blob/dev/packages/card/index.ts): `packages/card/index.ts`
- [Progress](https://github.com/youzan/vant-weapp/blob/dev/packages/progress/index.ts): `packages/progress/index.ts`

### Feedback Components

- [Dialog](https://github.com/youzan/vant-weapp/blob/dev/packages/dialog/index.ts): `packages/dialog/index.ts`
- [Toast](https://github.com/youzan/vant-weapp/blob/dev/packages/toast/toast.ts): `packages/toast/toast.ts`

### Shared Runtime

- [Component Adapter](https://github.com/youzan/vant-weapp/blob/dev/packages/common/component.ts): `packages/common/component.ts`
- [Component Adapter JS](https://github.com/youzan/vant-weapp/blob/dev/lib/common/component.js): `lib/common/component.js`
- [Runtime Utilities](https://github.com/youzan/vant-weapp/blob/dev/packages/common/utils.ts): `packages/common/utils.ts`
- [Runtime Utilities JS](https://github.com/youzan/vant-weapp/blob/dev/lib/common/utils.js): `lib/common/utils.js`
- [Value Validators](https://github.com/youzan/vant-weapp/blob/dev/packages/common/validator.ts): `packages/common/validator.ts`
- [Value Validators JS](https://github.com/youzan/vant-weapp/blob/dev/lib/common/validator.js): `lib/common/validator.js`
- [Component Relations](https://github.com/youzan/vant-weapp/blob/dev/packages/common/relation.ts): `packages/common/relation.ts`
- [Component Relations JS](https://github.com/youzan/vant-weapp/blob/dev/lib/common/relation.js): `lib/common/relation.js`
- [Touch Behavior](https://github.com/youzan/vant-weapp/blob/dev/packages/mixins/touch.ts): `packages/mixins/touch.ts`
- [Touch Behavior JS](https://github.com/youzan/vant-weapp/blob/dev/lib/mixins/touch.js): `lib/mixins/touch.js`
- [Picker Shared Logic](https://github.com/youzan/vant-weapp/blob/dev/packages/picker/shared.ts): `packages/picker/shared.ts`
- [Picker Shared Logic JS](https://github.com/youzan/vant-weapp/blob/dev/lib/picker/shared.js): `lib/picker/shared.js`
- [Calendar Date Logic](https://github.com/youzan/vant-weapp/blob/dev/packages/calendar/utils.ts): `packages/calendar/utils.ts`
- [Toast Runtime](https://github.com/youzan/vant-weapp/blob/dev/lib/toast/toast.js): `lib/toast/toast.js`

### Other components

- **Mini Program App**

## Connections

- Mini Program App → Button: registers and renders (evidence: `README.md`)
- Field → Component Adapter: uses adapter (evidence: `packages/field/index.ts`)
- Area Selector → Component Adapter: uses adapter (evidence: `packages/area/index.ts`)
- Area Selector → Picker Shared Logic: uses shared logic (evidence: `packages/area/index.ts`)
- Date-time Picker → Component Adapter: uses adapter (evidence: `packages/datetime-picker/index.ts`)
- Date-time Picker → Value Validators: uses validators (evidence: `packages/datetime-picker/index.ts`)
- Date-time Picker → Picker Shared Logic: uses shared logic (evidence: `packages/datetime-picker/index.ts`)
- Calendar → Component Adapter: uses adapter (evidence: `packages/calendar/index.ts`)
- Calendar → Calendar Date Logic: uses date logic (evidence: `packages/calendar/index.ts`)
- Tabs → Component Adapter: uses adapter (evidence: `packages/tabs/index.ts`)
- Tabs → Touch Behavior: uses behavior (evidence: `packages/tabs/index.ts`)
- Tabs → Runtime Utilities: uses utilities (evidence: `packages/tabs/index.ts`)
- Tabs → Value Validators: uses validators (evidence: `packages/tabs/index.ts`)
- Tabs → Component Relations: uses relations (evidence: `packages/tabs/index.ts`)
- Index Bar → Component Relations JS: uses relations (evidence: `lib/index-bar/index.js`)
- Index Bar → Runtime Utilities JS: uses utilities (evidence: `lib/index-bar/index.js`)
- Toast → Component Adapter: uses adapter
- Calendar → Toast: uses feedback (evidence: `packages/calendar/index.ts`)
