Integration & API

import { CalendarEvent, ZonedDateTime } from '@ascentsparksoftware/angular-calendar';

const zone = 'America/New_York';
const z = (iso: string): ZonedDateTime => ({ epochMs: Date.parse(iso), zone });

// The only required fields are id and start. Everything else is optional.
const job: CalendarEvent = {
  id: 'job-1842',
  title: 'AC install — 14 Elm St',
  start: z('2026-06-15T13:00:00Z'),
  end: z('2026-06-15T15:30:00Z'),
  status: 'scheduled',            // -> keyed into statusColors / --cal-event-<key>
  resourceIds: ['alice'],         // which timeline lane(s) it sits on
  resizable: { beforeStart: true, afterEnd: true },
  draggable: true,
  meta: { workOrderId: 1842 },    // opaque passenger data, echoed back to you
};

import {
  buildMonthView,
  packColumns,
  expandRecurringEvents,
  filterByStatus,
  DateFnsDateAdapter,
} from '@ascentsparksoftware/angular-calendar';
import { provideDateFnsAdapter } from '@ascentsparksoftware/angular-calendar/date-fns';

// The same pure functions the components call. No DOM, no Angular — testable in isolation.
const adapter = new DateFnsDateAdapter();

// buildMonthView returns a plain view-model (weeks, days, lane-packed chips):
const vm = buildMonthView(adapter, {
  viewDate: { epochMs: Date.parse('2026-06-15T12:00:00Z'), zone: 'America/New_York' },
  events: filterByStatus(myEvents, ['scheduled', 'en-route']),
  weekStartsOn: 1,
  maxLanes: 3,
});

vm.weeks.forEach((w) => w.days.forEach((d) => console.log(d.date, d.chips.length)));

// Layout + recurrence helpers are exported too, for building your own surfaces:
const columns = packColumns(intervals);       // overlap -> side-by-side columns
const occurrences = expandRecurringEvents(seriesEvents, ctx); // RRULE -> instances

import { ApplicationConfig } from '@angular/core';
import { provideCalendar, withDateAdapter, withDefaults } from '@ascentsparksoftware/angular-calendar';
import { provideDateFnsAdapter } from '@ascentsparksoftware/angular-calendar/date-fns';

export const appConfig: ApplicationConfig = {
  providers: [
    provideCalendar(
      // Default adapter: date-fns + date-fns-tz. A Temporal adapter can drop in later.
      withDateAdapter(provideDateFnsAdapter()),
      // Optional app-wide defaults so every view inherits them.
      withDefaults({ timezone: 'America/New_York', weekStartsOn: 1, locale: 'en-US' }),
    ),
  ],
};