stacks-calendar
Use when working with calendar functionality in Stacks - exporting events to Google Calendar, Outlook, Yahoo, or ICS format, the CalendarLink interface for event definitions, timezone handling, all-day events, or calendar URL generation. Covers @stacksjs/calendar-api.
来源信息
- 仓库
- stacksjs/stacks
- 最近来源活动
- 2026年8月29日 17:05
- 检测到的 SKILL.md 语言
- 英语
- 星标
- 631
- 分支
- 20
安装方式
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
检查来源文件
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
正在显示 SKILL.md
SKILL.md
来源说明 · 只读预览- name
- stacks-calendar
- description
- Use when working with calendar functionality in Stacks - exporting events to Google Calendar, Outlook, Yahoo, or ICS format, the CalendarLink interface for event definitions, timezone handling, all-day events, or calendar URL generation. Covers @stacksjs/calendar-api.
- license
- MIT
- compatibility
- Bun >= 1.3.0, TypeScript
- allowed-tools
- Read Edit Write Bash Grep Glob
# Stacks Calendar
Calendar event export to 4 calendar providers.
## Key Paths
- Core package: `storage/framework/core/calendar-api/src/`
- Package: `@stacksjs/calendar-api`
## Export Functions
```typescript
import { exportCalendarGoogle, exportCalendarIcs, exportCalendarOutlook, exportCalendarYahoo } from '@stacksjs/calendar-api'
const event: CalendarLink = {
title: 'Team Meeting',
description: 'Weekly standup',
from: new Date('2024-06-15T10:00:00'),
to: new Date('2024-06-15T11:00:00'),
address: '123 Main St, City',
timezone: 'America/New_York',
allDay: false
}
// Generate URLs
const googleUrl = exportCalendarGoogle(event)
// → https://calendar.google.com/calendar/render?action=TEMPLATE&text=...
const icsContent = exportCalendarIcs(event)
// → BEGIN:VCALENDAR\nBEGIN:VEVENT\n...
const outlookUrl = exportCalendarOutlook(event)
// → https://outlook.live.com/calendar/0/deeplink/compose?...
const yahooUrl = exportCalendarYahoo(event)
// → https://calendar.yahoo.com/?v=60&title=...
```
## CalendarLink Interface
```typescript
interface CalendarLink {
title: string
description?: string
from: Date // start time
to: Date // end time
allDay?: boolean // all-day event (ignores time)
address?: string // location
timezone?: string // IANA timezone (e.g., 'America/New_York')
}
```
## Calendar Store Types
```typescript
interface CalendarStore {
day: number
month: number
year: number
currentMonthYear: string
datesOfMonth: number[]
currentWeekView: WeekDates[]
}
interface Events {
date: string
title: string
description?: string
month: number
day: number
year: number
time?: Time
}
interface Time { from: string, to: string }
interface WeekDates { month: number, date: number }
```
## All-Day Events
```typescript
const allDayEvent: CalendarLink = {
title: 'Company Holiday',
from: new Date('2024-12-25'),
to: new Date('2024-12-25'),
allDay: true // only date matters, no time component
}
```
## Format Differences
| Feature | Google | ICS | Outlook | Yahoo |
|---------|--------|-----|---------|-------|
| URL-based | Yes | No (file) | Yes | Yes |
| Timezone | URL param | VTIMEZONE | URL param | URL param |
| All-day | Date only | DATE value | isAllDay=true | st= format |
| Description | details= | DESCRIPTION | body= | desc= |
## Gotchas
- Note package name is `@stacksjs/calendar-api` (not `@stacksjs/calendar`)
- ICS export returns file content (not a URL) — serve as `.ics` download
- All-day events use date-only format, ignoring time components
- Timezone handling varies by provider — ICS includes VTIMEZONE block
- Google Calendar uses UTC format in URLs
- For task scheduling (cron), use `@stacksjs/scheduler` instead
- ICS generates a unique UID per event for calendar deduplication
在 GitHub 查看