Some ignored filles was missing

wwwroot/js/managers/EventStackManager.d.ts

@@ -0,0 +1,91 @@
+/**
+ * EventStackManager - Manages visual stacking of overlapping calendar events
+ *
+ * This class handles the creation and maintenance of "stack chains" - doubly-linked
+ * lists of overlapping events stored directly in DOM elements via data attributes.
+ *
+ * Implements 3-phase algorithm for grid + nested stacking:
+ * Phase 1: Group events by start time proximity (configurable threshold)
+ * Phase 2: Decide container type (GRID vs STACKING)
+ * Phase 3: Handle late arrivals (nested stacking - NOT IMPLEMENTED)
+ *
+ * @see STACKING_CONCEPT.md for detailed documentation
+ * @see stacking-visualization.html for visual examples
+ */
+import { ICalendarEvent } from '../types/CalendarTypes';
+import { Configuration } from '../configurations/CalendarConfig';
+export interface IStackLink {
+    prev?: string;
+    next?: string;
+    stackLevel: number;
+}
+export interface IEventGroup {
+    events: ICalendarEvent[];
+    containerType: 'NONE' | 'GRID' | 'STACKING';
+    startTime: Date;
+}
+export declare class EventStackManager {
+    private static readonly STACK_OFFSET_PX;
+    private config;
+    constructor(config: Configuration);
+    /**
+     * Group events by time conflicts (both start-to-start and end-to-start within threshold)
+     *
+     * Events are grouped if:
+     * 1. They start within ±threshold minutes of each other (start-to-start)
+     * 2. One event starts within threshold minutes before another ends (end-to-start conflict)
+     */
+    groupEventsByStartTime(events: ICalendarEvent[]): IEventGroup[];
+    /**
+     * Decide container type for a group of events
+     *
+     * Rule: Events starting simultaneously (within threshold) should ALWAYS use GRID,
+     * even if they overlap each other. This provides better visual indication that
+     * events start at the same time.
+     */
+    decideContainerType(group: IEventGroup): 'NONE' | 'GRID' | 'STACKING';
+    /**
+     * Check if two events overlap in time
+     */
+    doEventsOverlap(event1: ICalendarEvent, event2: ICalendarEvent): boolean;
+    /**
+     * Create optimized stack links (events share levels when possible)
+     */
+    createOptimizedStackLinks(events: ICalendarEvent[]): Map<string, IStackLink>;
+    /**
+     * Calculate marginLeft based on stack level
+     */
+    calculateMarginLeft(stackLevel: number): number;
+    /**
+     * Calculate zIndex based on stack level
+     */
+    calculateZIndex(stackLevel: number): number;
+    /**
+     * Serialize stack link to JSON string
+     */
+    serializeStackLink(stackLink: IStackLink): string;
+    /**
+     * Deserialize JSON string to stack link
+     */
+    deserializeStackLink(json: string): IStackLink | null;
+    /**
+     * Apply stack link to DOM element
+     */
+    applyStackLinkToElement(element: HTMLElement, stackLink: IStackLink): void;
+    /**
+     * Get stack link from DOM element
+     */
+    getStackLinkFromElement(element: HTMLElement): IStackLink | null;
+    /**
+     * Apply visual styling to element based on stack level
+     */
+    applyVisualStyling(element: HTMLElement, stackLevel: number): void;
+    /**
+     * Clear stack link from element
+     */
+    clearStackLinkFromElement(element: HTMLElement): void;
+    /**
+     * Clear visual styling from element
+     */
+    clearVisualStyling(element: HTMLElement): void;
+}