@vicacha-devs/strapi-plugin-calendar 0.0.0-stage → 1.0.0

package/dist/shared/localization.d.ts

@@ -0,0 +1,14 @@
+import { CalendarDirection, CalendarDirectionSetting, FullCalendarLocaleDefinition } from './types';
+export declare const SUPPORTED_CALENDAR_LOCALES: FullCalendarLocaleDefinition[];
+export declare function normalizeLocaleCode(locale?: string): string;
+export declare function isRtlLocale(locale?: string): boolean;
+export declare function getLocalizedCalendarBundle(locale?: string): FullCalendarLocaleDefinition;
+export declare function resolveFullCalendarLocale(uiLocale?: string, defaultLocaleSetting?: string, runtimeOverrideLocale?: string): string;
+export declare function resolveCalendarDirection(locale: string, directionSetting?: CalendarDirectionSetting): CalendarDirection;
+export declare function resolveLocaleFirstDay(locale: string, configuredFirstDay?: number | null): number;
+export declare function buildFullCalendarTimeFormat(timeFormat24h?: boolean): {
+    hour: "2-digit" | "numeric";
+    minute: "2-digit";
+    meridiem: false | "short";
+    hour12: boolean;
+};

package/dist/shared/pluginId.d.ts

@@ -0,0 +1,2 @@
+export declare const PLUGIN_ID = "calendar";
+export declare const RRULE_CUSTOM_FIELD_UID: "plugin::calendar.rrule";

package/dist/shared/rruleEngine.d.ts

@@ -0,0 +1,22 @@
+import { OccurrenceOverride, ParsedRRule, RRuleFieldValue } from './types';
+export declare function parseRRule(rawRule?: string | null): ParsedRRule;
+export declare function buildRRule(parsed: ParsedRRule): string;
+export declare function describeRRule(rawRule?: string | null): string;
+export declare function parseRRuleFieldValue(raw: unknown, defaultTimezone?: string): RRuleFieldValue;
+export interface ExpandedSlot {
+    occurrenceDate: string;
+    startDate: string;
+    endDate: string;
+    isRecurring: boolean;
+    isOverridden: boolean;
+    rscale?: string;
+    override?: OccurrenceOverride;
+}
+export declare function expandRuleSlots(params: {
+    baseStartDate: string;
+    baseEndDate?: string | null;
+    recurrence?: RRuleFieldValue | null;
+    windowStart: string;
+    windowEnd: string;
+    maxOccurrences?: number;
+}): ExpandedSlot[];

package/dist/shared/themePalettes.d.ts

@@ -0,0 +1,27 @@
+import { CalendarColorPaletteId, CalendarColorScheme } from './types';
+export interface CalendarColorPaletteDefinition {
+    id: CalendarColorPaletteId;
+    label: string;
+    lightPrimary: string;
+    darkPrimary: string;
+    lightHeaderBg: string;
+    lightHeaderText: string;
+    lightTodayBg: string;
+    lightBadgeBg: string;
+    lightBadgeText: string;
+    lightBadgeBorder: string;
+    darkHeaderBg: string;
+    darkHeaderText: string;
+    darkTodayBg: string;
+    darkBadgeBg: string;
+    darkBadgeText: string;
+    darkBadgeBorder: string;
+}
+export declare const CALENDAR_COLOR_PALETTES: Record<CalendarColorPaletteId, CalendarColorPaletteDefinition>;
+/**
+ * Detects the active 'light' | 'dark' color scheme from:
+ * 1. Explicit 'light' or 'dark' preference
+ * 2. Strapi Design System theme's `colors.neutral0` hex luminance (e.g. #212134 in dark mode vs #ffffff in light mode)
+ * 3. Strapi Admin localStorage `STRAPI_THEME` and browser `prefers-color-scheme: dark` media query
+ */
+export declare function detectEffectiveColorScheme(colorScheme?: CalendarColorScheme, strapiNeutral0?: string): "light" | "dark";

package/dist/shared/themePresets.d.ts

@@ -0,0 +1,32 @@
+import { CalendarColorPaletteId, CalendarColorScheme, CalendarThemePreset } from './types';
+export interface CalendarThemeDefinition {
+    id: CalendarThemePreset;
+    label: string;
+    description: string;
+    category?: "modern" | "design-system" | "heritage";
+    fontFamily?: string;
+    containerRadius?: string;
+    containerShadow?: string;
+    eventRadius?: string;
+    eventStyle?: "solid" | "tinted" | "accent-bar";
+    dayNumberAlign?: "start" | "center" | "end";
+    todayHeaderAccent?: "pill" | "top-bar" | "tint";
+    primaryColor: string;
+    headerBg: string;
+    headerText: string;
+    cellBg: string;
+    cellAltBg: string;
+    cellHoverBg: string;
+    cellText: string;
+    cellMutedText: string;
+    borderColor: string;
+    todayBg: string;
+    todayBorder: string;
+    todayNumberBg: string;
+    todayNumberText: string;
+    badgeBg: string;
+    badgeText: string;
+    badgeBorder: string;
+}
+export declare const CALENDAR_THEME_PRESETS: Record<CalendarThemePreset, CalendarThemeDefinition>;
+export declare function resolveCalendarTheme(themeKey?: CalendarThemePreset, colorScheme?: CalendarColorScheme, paletteKey?: CalendarColorPaletteId, strapiNeutral0?: string): CalendarThemeDefinition;

package/dist/shared/types.d.ts

@@ -0,0 +1,311 @@
+export type RRuleFrequency = "NONE" | "DAILY" | "WEEKLY" | "MONTHLY" | "YEARLY";
+export type RRuleWeekday = "MO" | "TU" | "WE" | "TH" | "FR" | "SA" | "SU";
+export type CalendarItemStatus = "scheduled" | "cancelled" | "postponed" | "rescheduled";
+export type CalendarViewMode = "dayGridMonth" | "timeGridWeek" | "timeGridDay" | "listMonth" | "multiMonthYear" | "multiMonthYearStacked" | "dayGridYear";
+export interface OccurrenceOverride {
+    /** Original occurrence ISO date (YYYY-MM-DD) */
+    originalDate: string;
+    /** Whether this specific occurrence is cancelled */
+    cancelled?: boolean;
+    /** Optional overridden start ISO datetime */
+    startDate?: string;
+    /** Optional overridden end ISO datetime */
+    endDate?: string;
+    /** Optional overridden title for this occurrence */
+    title?: string;
+    /** Optional overridden location for this occurrence */
+    location?: string;
+    /** Optional note for this occurrence */
+    note?: string;
+}
+export interface RRuleFieldValue {
+    /**
+     * RFC 5545 / RFC 7529 RRULE string
+     * e.g. "FREQ=WEEKLY;INTERVAL=1;BYDAY=FR"
+     * or "RSCALE=ISLAMIC-UMALQURA;FREQ=YEARLY;BYMONTH=9;BYMONTHDAY=1"
+     */
+    rrule: string;
+    /** IANA timezone identifier (e.g. "UTC", "America/New_York", "America/Bogota") */
+    timezone: string;
+    /** Optional RFC 7529 non-Gregorian recurrence scale (e.g. "islamic-umalqura", "hebrew", "persian") */
+    rscale?: string;
+    /** Whether the entry spans full days */
+    allDay?: boolean;
+    /** Excluded occurrence dates in YYYY-MM-DD format */
+    exdates?: string[];
+    /** Per-occurrence overrides keyed by YYYY-MM-DD */
+    overrides?: Record<string, OccurrenceOverride>;
+}
+export interface ParsedRRule {
+    freq: RRuleFrequency;
+    interval: number;
+    byDay: RRuleWeekday[];
+    byMonth?: number;
+    byMonthDay?: number;
+    rscale?: string;
+    count?: number;
+    until?: string;
+}
+export interface TimeSlotWindow {
+    /** Start time in HH:mm:ss format (e.g. "09:00:00") */
+    start: string;
+    /** End time in HH:mm:ss format (e.g. "11:00:00") */
+    end: string;
+}
+export interface BusinessHoursWindow {
+    /** Days of week (0 = Sunday .. 6 = Saturday) */
+    daysOfWeek: number[];
+    /** Start time in HH:mm format (e.g. "08:00") */
+    startTime: string;
+    /** End time in HH:mm format (e.g. "18:00") */
+    endTime: string;
+}
+export interface CalendarSystemConfig {
+    /** Unique identifier for this calendar system (e.g. "hijri", "hebrew", "persian", "fiscal") */
+    id: string;
+    /** Human-readable display label (e.g. "Hijri (Umm al-Qura)", "Hebrew", "Persian") */
+    label: string;
+    /** Unicode BCP 47 / @internationalized/date calendar identifier or custom formatter ID */
+    intlCalendar: string;
+    /** Optional BCP 47 locale tag for formatting (defaults to current request/UI locale) */
+    locale?: string;
+    /** Optional day offset (-2 to +2) for lunar sighting or regional adjustments */
+    dayOffset?: number;
+    /** Optional document field name that overrides the auto-computed date when non-empty (e.g. "hijriDate") */
+    overrideField?: string;
+    /** Whether this calendar system is active in the Admin Calendar & Occurrence APIs */
+    enabled: boolean;
+}
+export type CalendarSystemFormatterFn = (date: Date, context: {
+    locale: string;
+    system: CalendarSystemConfig;
+    compact: boolean;
+}) => string;
+export interface AlternateDateValue {
+    calendarId: string;
+    label: string;
+    formatted: string;
+    compact?: string;
+    intlCalendar?: string;
+    year?: number;
+    month?: number;
+    day?: number;
+    isOverridden?: boolean;
+}
+export interface CalendarSourceMapping {
+    /** Unique identifier for this source mapping (e.g. "events", "bookings", "articles") */
+    id: string;
+    /** Human-readable label shown in Calendar filter pills */
+    label: string;
+    /** Strapi Content-Type UID (e.g. "api::event.event", "api::booking.booking") */
+    uid: string;
+    /** Hex color used on the calendar grid (e.g. "#0D9488") */
+    color: string;
+    /** Whether this source is enabled on the calendar & occurrence APIs */
+    enabled: boolean;
+    /** Whether this source is included in public Content-API feeds (defaults to true, false for private bookings) */
+    publicFeed?: boolean;
+    /** Field mapping on the target collection type */
+    fields: {
+        title: string;
+        startDate: string;
+        endDate?: string;
+        rrule?: string;
+        location?: string;
+        category?: string;
+        status?: string;
+        summary?: string;
+        slug?: string;
+        color?: string;
+        timeSlot?: string;
+        /** Optional mapping of calendar system IDs to document override fields (e.g. { hijri: "hijriDate" }) */
+        alternateDateFields?: Record<string, string>;
+        /** Optional list of custom document attributes to pass through onto each ExpandedCalendarOccurrence */
+        customFields?: string[];
+    };
+    /** Optional custom mapping from timeSlot enum values to start/end times */
+    timeSlotMap?: Record<string, TimeSlotWindow>;
+    /** Optional category-to-color overrides */
+    categoryColors?: Record<string, string>;
+    /** Default allDay flag when endDate is omitted and startDate is date-only */
+    defaultAllDay?: boolean;
+}
+export interface RecurrencePreset {
+    /** Unique identifier for the preset */
+    id: string;
+    /** Human-readable preset label */
+    label: string;
+    /** RFC 5545 / RFC 7529 RRULE string */
+    rrule: string;
+}
+export interface DiscoveredContentTypeField {
+    name: string;
+    type: string;
+}
+export interface DiscoveredContentType {
+    uid: string;
+    displayName: string;
+    kind: string;
+    fields: DiscoveredContentTypeField[];
+}
+export type CalendarDirection = "ltr" | "rtl";
+export type CalendarDirectionSetting = "auto" | "ltr" | "rtl";
+export type WeekNumberCalculationMode = "local" | "ISO";
+export type CalendarThemePreset = "breeze" | "monarch" | "forma" | "pulse" | "classic" | "shadcn" | "mui" | "emerald" | "sand" | "midnight";
+export type CalendarColorScheme = "auto" | "light" | "dark";
+export type CalendarColorPaletteId = "default" | "purple" | "blue" | "indigo" | "emerald" | "rose" | "amber";
+export type SecondaryCalendarLanguageMode = "local" | "ar" | "off";
+export * from './themePalettes';
+export * from './themePresets';
+export interface FullCalendarLocaleDefinition {
+    /** BCP 47 locale code (e.g. "en", "es", "fr", "ar") */
+    code: string;
+    /** English display name */
+    label: string;
+    /** Native display name */
+    nativeName: string;
+    /** Default text direction for this locale */
+    direction: CalendarDirection;
+    /** Default week parameters (dow: 0=Sun..6=Sat, doy: min days in first week) */
+    week: {
+        dow: number;
+        doy: number;
+    };
+    /** Localized button labels for FullCalendar */
+    buttonText: {
+        prev: string;
+        next: string;
+        today: string;
+        year: string;
+        month: string;
+        week: string;
+        day: string;
+        list: string;
+    };
+    /** Week number column prefix (e.g. "Wk", "Sm", "KW", "أسبوع") */
+    weekText: string;
+    /** Label for all-day slot in TimeGrid */
+    allDayText: string;
+    /** Label for "+N more" popover link */
+    moreLinkText: string;
+    /** Empty state message in List / Agenda view */
+    noEventsText: string;
+}
+export interface CalendarPluginSettings {
+    /** Visual calendar theme preset ("breeze" by default) */
+    theme?: CalendarThemePreset;
+    /** Light or dark color scheme ("light" by default) */
+    colorScheme?: CalendarColorScheme;
+    /** Optional accent color palette override ("default" | "purple" | "blue" | "indigo" | "emerald" | "rose" | "amber") */
+    themePalette?: CalendarColorPaletteId;
+    /** Secondary calendar display language mode ("local" | "ar" | "off") */
+    secondaryCalendarLanguage?: SecondaryCalendarLanguageMode;
+    /** Default IANA timezone (e.g. "UTC") */
+    defaultTimezone: string;
+    /** Default FullCalendar locale ("auto" uses Strapi Admin locale, or explicit code e.g. "es", "ar") */
+    defaultLocale?: string;
+    /** Layout direction ("auto" derives from active locale, or explicit "ltr" | "rtl") */
+    direction?: CalendarDirectionSetting;
+    /** Default FullCalendar view mode */
+    defaultView: CalendarViewMode;
+    /** First day of week (0 = Sunday, 1 = Monday, 6 = Saturday) */
+    firstDayOfWeek: number;
+    /** Show week numbers on Month/Week grids */
+    weekNumbers?: boolean;
+    /** Week number calculation rule ("ISO" or "local") */
+    weekNumberCalculation?: WeekNumberCalculationMode;
+    /** Use 24-hour time formatting (true = 14:30, false = 2:30 PM) */
+    timeFormat24h?: boolean;
+    /** TimeGrid start time (e.g. "07:00:00") */
+    startHour: string;
+    /** TimeGrid end time (e.g. "21:00:00") */
+    endHour: string;
+    /** TimeGrid slot duration in HH:mm:ss (e.g. "00:30:00") */
+    slotDuration: string;
+    /** Primary accent color for the calendar */
+    primaryColor: string;
+    /** Show weekends on Month/Week grids */
+    showWeekends: boolean;
+    /** Show Today button in toolbar */
+    showTodayButton: boolean;
+    /** Show Quick-Create button in toolbar & allow slot selection */
+    showCreateButton: boolean;
+    /** Enable Month view tab */
+    monthView: boolean;
+    /** Enable Week TimeGrid view tab */
+    weekView: boolean;
+    /** Enable Day TimeGrid view tab */
+    dayView: boolean;
+    /** Enable Agenda List view tab */
+    agendaView: boolean;
+    /** Enable Multi-Month Year view tab */
+    yearView: boolean;
+    /** Business / Operating hours shaded on Week & Day TimeGrids */
+    businessHours: BusinessHoursWindow[];
+    /** Public iCal feed calendar name */
+    feedTitle: string;
+    /** Configured collection sources */
+    sources: CalendarSourceMapping[];
+    /** Optional secondary/alternative calendar systems (Hijri, Hebrew, Persian, Buddhist, or custom) */
+    secondaryCalendars?: CalendarSystemConfig[];
+    /** Configurable RRULE / RSCALE recurrence presets */
+    recurrencePresets?: RecurrencePreset[];
+}
+export interface CalendarLinkSet {
+    google: string;
+    outlook: string;
+    yahoo: string;
+    icsPath: string;
+}
+export interface ExpandedCalendarOccurrence {
+    /** Deterministic ID: `${sourceId}:${documentId}:${occurrenceDate}` */
+    occurrenceId: string;
+    /** Source mapping ID */
+    sourceId: string;
+    /** Source display label */
+    sourceLabel: string;
+    /** Strapi Content-Type UID */
+    uid: string;
+    /** Strapi v5 documentId */
+    documentId: string;
+    /** Document locale code when localized via Strapi i18n (e.g. "es", "en") */
+    locale?: string;
+    /** Occurrence date key (YYYY-MM-DD) */
+    occurrenceDate: string;
+    /** Effective start ISO timestamp */
+    startDate: string;
+    /** Effective end ISO timestamp */
+    endDate: string;
+    /** All-day flag */
+    allDay: boolean;
+    /** IANA timezone */
+    timezone: string;
+    /** Entry title */
+    title: string;
+    /** Optional slug */
+    slug?: string;
+    /** Optional summary */
+    summary?: string;
+    /** Physical location or venue */
+    location?: string;
+    /** Category string */
+    category?: string;
+    /** Lifecycle status */
+    status: CalendarItemStatus;
+    /** Hex badge color */
+    color: string;
+    /** Whether generated from an RRULE/RSCALE recurrence */
+    isRecurring: boolean;
+    /** Raw RRULE string if recurring */
+    rrule?: string;
+    /** Optional non-Gregorian RSCALE identifier */
+    rscale?: string;
+    /** Whether this specific occurrence has an override applied */
+    isOverridden?: boolean;
+    /** Add-to-calendar links */
+    calendarLinks: CalendarLinkSet;
+    /** Alternate calendar representations (e.g., Hijri, Hebrew, Persian, or custom date systems) */
+    alternateDates?: Record<string, AlternateDateValue>;
+    /** Custom fields extracted from the source document via `source.fields.customFields` */
+    customFields?: Record<string, unknown>;
+}

package/package.json

@@ -1,6 +1,123 @@
 {
   "name": "@vicacha-devs/strapi-plugin-calendar",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.0",
+  "description": "Universal Multi-Source Calendar, FullCalendar v6 Scheduler, RFC 5545/7529 Recurrence (RRULE & RSCALE), Multi-Calendar Systems (Hijri, Hebrew, Persian, etc.), and iCal (.ics) plugin for Strapi v5.",
+  "keywords": [
+    "calendar",
+    "fullcalendar",
+    "hebrew",
+    "hijri",
+    "ical",
+    "ics",
+    "internationalized-date",
+    "persian",
+    "rrule",
+    "rscale",
+    "scheduler",
+    "strapi",
+    "strapi-plugin",
+    "strapi-v5"
+  ],
+  "homepage": "https://github.com/Vicacha-Devs/strapi-v5-extensions/tree/main/packages/strapi-plugin-calendar#readme",
+  "bugs": {
+    "url": "https://github.com/Vicacha-Devs/strapi-v5-extensions/issues"
+  },
+  "license": "MIT",
+  "author": "Vicacha Devs",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Vicacha-Devs/strapi-v5-extensions.git",
+    "directory": "packages/strapi-plugin-calendar"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    "./package.json": "./package.json",
+    "./strapi-admin": {
+      "types": "./dist/admin/src/index.d.ts",
+      "source": "./admin/src/index.ts",
+      "import": "./dist/admin/index.js",
+      "require": "./dist/admin/index.cjs",
+      "default": "./dist/admin/index.js"
+    },
+    "./strapi-server": {
+      "types": "./dist/server/src/index.d.ts",
+      "source": "./server/src/index.ts",
+      "import": "./dist/server/index.js",
+      "require": "./dist/server/index.cjs",
+      "default": "./dist/server/index.js"
+    },
+    "./shared": {
+      "types": "./dist/shared/index.d.ts",
+      "source": "./shared/index.ts",
+      "import": "./dist/shared/index.js",
+      "require": "./dist/shared/index.cjs",
+      "default": "./dist/shared/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@fullcalendar/core": "^6.1.15",
+    "@fullcalendar/daygrid": "^6.1.15",
+    "@fullcalendar/interaction": "^6.1.15",
+    "@fullcalendar/list": "^6.1.15",
+    "@fullcalendar/multimonth": "^6.1.15",
+    "@fullcalendar/react": "^6.1.15",
+    "@fullcalendar/timegrid": "^6.1.15",
+    "@internationalized/date": "^3.10.0",
+    "@strapi/design-system": "^2.0.0",
+    "@strapi/icons": "^2.0.0",
+    "react-intl": "^6.6.8"
+  },
+  "devDependencies": {
+    "@strapi/sdk-plugin": "6.1.1",
+    "@strapi/strapi": "^5.0.0",
+    "@strapi/typescript-utils": "^5.0.0",
+    "@types/node": "^20.11.0",
+    "@types/react": "^18.3.3",
+    "@types/react-dom": "^18.3.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-router-dom": "^6.26.0",
+    "styled-components": "^6.1.12",
+    "typescript": "^5.5.4",
+    "vitest": "^2.1.0",
+    "@vicacha-devs/plugin-shared": "1.0.0",
+    "@vicacha-devs/typescript-config": "1.0.0"
+  },
+  "peerDependencies": {
+    "@strapi/design-system": "^2.0.0",
+    "@strapi/icons": "^2.0.0",
+    "@strapi/strapi": "^5.0.0",
+    "react": "^17.0.0 || ^18.0.0",
+    "react-dom": "^17.0.0 || ^18.0.0",
+    "react-router-dom": "^6.0.0",
+    "styled-components": "^6.0.0"
+  },
+  "engines": {
+    "node": ">=20.16.0",
+    "pnpm": ">=10.0.0"
+  },
+  "strapi": {
+    "name": "calendar",
+    "displayName": "Calendar & Scheduler",
+    "description": "Visualize, schedule, and syndicate any Strapi v5 collection types across Month, Week, Day, Agenda, and Year views with multi-calendar & RRULE support.",
+    "kind": "plugin"
+  },
+  "scripts": {
+    "build": "strapi-plugin build && node ../../scripts/ensure-esm-dist.ts",
+    "clean": "rm -rf dist .strapi",
+    "test": "node --import ./tests/register-ts-resolver.ts --test tests/*.test.ts",
+    "test:ts": "npm run test:ts:front && npm run test:ts:back",
+    "test:ts:back": "tsc -p server/tsconfig.json --noEmit",
+    "test:ts:front": "tsc -p admin/tsconfig.json --noEmit",
+    "verify": "strapi-plugin verify",
+    "watch": "strapi-plugin watch",
+    "watch:link": "strapi-plugin watch:link"
+  }
 }