timeline-scheduler 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,63 @@
+export interface Resource {
+    id: string;
+    name: string;
+    /** Optional avatar image URL. Falls back to coloured initials. */
+    avatar?: string;
+}
+export interface TimelineItem {
+    id: string;
+    resourceId: string;
+    name: string;
+    /** Any valid CSS color string, e.g. "#3b82f6" or "rgb(59, 130, 246)" */
+    color: string;
+    start: Date;
+    end: Date;
+    /** Optional tooltip text shown on hover */
+    description?: string;
+}
+export interface ChangeDetail {
+    items: TimelineItem[];
+}
+export interface ItemClickDetail {
+    item: TimelineItem;
+}
+export interface ItemHoverDetail {
+    item: TimelineItem;
+    type: 'enter' | 'leave';
+}
+export interface ItemContextMenuDetail {
+    item: TimelineItem;
+    /** clientX of the pointer event */
+    x: number;
+    /** clientY of the pointer event */
+    y: number;
+}
+export interface ItemCreateDetail {
+    resourceId: string;
+    start: Date;
+    end: Date;
+}
+export interface DateChangeDetail {
+    date: Date;
+}
+export interface ItemDblClickDetail {
+    item: TimelineItem;
+}
+export interface ItemDragStartDetail {
+    item: TimelineItem;
+}
+export interface ItemDragEndDetail {
+    item: TimelineItem;
+    /** Resource the item was dropped on */
+    resourceId: string;
+    start: Date;
+    end: Date;
+}
+export interface ItemResizeStartDetail {
+    item: TimelineItem;
+}
+export interface ItemResizeEndDetail {
+    item: TimelineItem;
+    start: Date;
+    end: Date;
+}

package/dist/utils/layout.d.ts

@@ -0,0 +1,7 @@
+import type { TimelineItem } from '../types';
+/**
+ * Assigns a sub-row index to each item using a greedy interval scheduling algorithm.
+ * Items are sorted by start time. Each item goes into the first sub-row where
+ * the last item's end time <= this item's start time.
+ */
+export declare function assignSubRows(items: TimelineItem[]): Map<string, number>;

package/dist/utils/layout.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/utils/time.d.ts

@@ -0,0 +1,16 @@
+export declare function clamp(value: number, min: number, max: number): number;
+/**
+ * Converts a Date to a percentage position [0, 100] on the timeline.
+ * Clamps dates outside the startHour–endHour range.
+ * Note: sub-minute precision (seconds, milliseconds) is ignored intentionally —
+ * the timeline operates at minute granularity.
+ */
+export declare function timeToPercent(date: Date, startHour: number, endHour: number): number;
+/**
+ * Converts a percentage [0, 100] back to a Date, using baseDate for the date part.
+ */
+export declare function percentToTime(percent: number, startHour: number, endHour: number, baseDate: Date): Date;
+/**
+ * Snaps a Date to the nearest multiple of `minutes`.
+ */
+export declare function snapToInterval(date: Date, minutes: number): Date;

package/dist/utils/time.test.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "timeline-scheduler",
+  "version": "0.1.0",
+  "description": "Framework-agnostic Web Component timeline scheduler with drag & drop",
+  "type": "module",
+  "main": "./dist/timeline-scheduler.cjs.js",
+  "module": "./dist/timeline-scheduler.es.js",
+  "types": "./dist/timeline-scheduler.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/timeline-scheduler.es.js",
+      "require": "./dist/timeline-scheduler.cjs.js"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "vite build && tsc",
+    "dev": "vite serve playground --open",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": ["timeline", "scheduler", "web-component", "drag-drop"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Sindreglo/timeline-scheduler"
+  },
+  "homepage": "https://github.com/Sindreglo/timeline-scheduler#readme",
+  "bugs": {
+    "url": "https://github.com/Sindreglo/timeline-scheduler/issues"
+  },
+  "dependencies": {
+    "lit": "^3.3.2"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^4.1.4",
+    "jsdom": "^29.0.2",
+    "typescript": "^6.0.2",
+    "vite": "^8.0.8",
+    "vitest": "^4.1.4"
+  }
+}