---
applyTo: "**"
---
# Mobiscroll for Vue — AI Rules

## Documentation Source

- **Primary (complete docs):** {{DOCS_BASE_URL}}/llms-vue-full.txt
- **TOC (links to .md pages):** {{DOCS_BASE_URL}}/llms-vue.txt
- **Individual pages:** `{{DOCS_BASE_URL}}/docs/vue/{section}/{page}.md`
- **Icons (supplementary):** {{DOCS_BASE_URL}}/llms-icons.txt

## Scope

USE this file when:
- Project has `@mobiscroll/vue` in package.json
- Files use `.vue` extension
- Imports contain `from '@mobiscroll/vue'`
- User explicitly mentions Vue + Mobiscroll

DO NOT use this file for React, Angular, JavaScript, or jQuery projects.

## Component Mapping

All scheduling views are ONE component: **Eventcalendar**, configured via the `view` option.

| Intent | Component | Doc Path |
|:---|:---|:---|
| Event calendar / scheduling | Eventcalendar | `vue/eventcalendar/overview` |
| Monthly/weekly/daily grid | Eventcalendar (calendar view) | `vue/eventcalendar/calendar` |
| Event list / agenda | Eventcalendar (agenda view) | `vue/eventcalendar/agenda` |
| Resource scheduler | Eventcalendar (scheduler view) | `vue/eventcalendar/scheduler` |
| Horizontal timeline | Eventcalendar (timeline view) | `vue/eventcalendar/timeline` |
| Drag & drop | Eventcalendar | `vue/eventcalendar/drag-and-drop` |
| CRUD operations | Eventcalendar | `vue/eventcalendar/crud` |
| Recurring events | Eventcalendar | `vue/core-concepts/recurrence` |
| Date / time picker | Datepicker | `vue/datepicker/overview` |
| Dropdown select | Select | `vue/select/overview` |
| Modal / overlay | Popup | `vue/popup/overview` |
| Input, textarea, button | Forms | `vue/forms/input` |
| Toast, snackbar, alert | Notifications | `vue/notifications/toast` |
| Theming | Theming | `vue/theming/sass-themes` |
| Full API reference | Eventcalendar API | `vue/eventcalendar/api` |

## Rules

- Fetch `llms-vue-full.txt` for complete context
- Prefer `.md` pages over HTML — `.md` files are optimized for AI
- Use official docs examples only — docs are the source of truth
- Package: `@mobiscroll/vue` — no other Mobiscroll package
- CSS: `import '@mobiscroll/vue/dist/css/mobiscroll.min.css'`
- Use Vue 3 Composition API with `<script setup>` as shown in docs
- Components use `MbscEventcalendar`, `MbscDatepicker`, etc. in templates
- Version: 6 (latest). Do not use deprecated v5 APIs.
- Types are prefixed `Mbsc` (e.g., `MbscEventcalendarView`, `MbscCalendarEvent`)

## Constraints

- NEVER import from `@mobiscroll/react`, `@mobiscroll/angular`, `@mobiscroll/javascript`, or `@mobiscroll/jquery`
- NEVER use React hooks, Angular decorators, or jQuery patterns in Vue code
- NEVER invent API options, events, methods, or types — if not found in docs, say so
- NEVER treat Scheduler/Timeline/Agenda as separate components — they are views of Eventcalendar
- NEVER use Mobiscroll Connect docs for frontend UI (Connect = server-side REST API)
- If the framework is unclear, ASK — do not default
- NEVER silently translate v5 patterns to v6 — detect and ask first

## Version Mismatch

If the user mentions "v5", "version 5", or uses a v5-only pattern, respond:

> "⚠️ This looks like Mobiscroll v5 syntax or API usage. This file is configured for Mobiscroll **v6 (latest)**. Would you like: 1) the v6 equivalent of what you're asking about, or 2) guidance using the v5 documentation instead?"

Do not proceed with a v6 answer until the user confirms. Do not assume backward compatibility.