timeline-canvas 1.5.0 → 1.6.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Sky
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -17,6 +17,9 @@ A powerful, high-performance timeline component built with HTML5 Canvas and Type
 - 📏 **Smart Guides**: Alignment guides and snapping for precise event placement.
 - ⏱️ **Time Indicator**: Draggable time head with snapping support.
 - 🔌 **Plugin System**: Extensible architecture with built-in plugins for themes, context menus, and more.
+- 🧭 **Resource scheduling (new in 1.6)**: optional `businessId` on events/tracks, strict atomic import/export (`loadScheduleData`/`exportScheduleData`), incremental upsert/patch/delete by business identity, a viewport snapshot subscription, and a unified `renderEventContent` hook covering normal, drag and resize phases.
+- 📨 **Optional async editing protocol** (`scheduleEditing`): candidate preview, typed validation, single-commit settlement with server correction, unknown-result reconciliation and per-event edit state.
+
 - 📝 **TypeScript**: Written in TypeScript with full type definitions.
 
 ## Installation

package/README_CN.md

@@ -17,6 +17,9 @@
 - 📏 **智能辅助线**: 对齐辅助线和吸附功能，实现精确的事件放置。
 - ⏱️ **时间指示器**: 可拖动的时间头，支持吸附。
 - 🔌 **插件系统**: 可扩展架构，内置主题、右键菜单等插件。
+- 🧭 **资源排程（1.6 新增）**: 事件/轨道可选 `businessId`，严格原子导入导出（`loadScheduleData`/`exportScheduleData`），按业务身份的增量 upsert/patch/删除，视口快照订阅，以及覆盖普通/拖动/拉伸阶段的统一 `renderEventContent` 内容入口。
+- 📨 **可选异步编辑协议**（`scheduleEditing`）：候选预览、typed 校验、单次提交结算与服务器修正、未知结果权威核对、单事件编辑状态查询。
+
 - 📝 **TypeScript**: 使用 TypeScript 编写，提供完整的类型定义。
 
 ## 安装

package/dist/{ContextMenuPlugin-C84Iiz8U.d.mts → ContextMenuPlugin-BRv4YT-G.d.mts}

@@ -1,4 +1,4 @@
-import { d as TimelinePlugin } from "./types-Ch6RMCi9.mjs";
+import { d as TimelinePlugin } from "./types-KQ5C-I-e.mjs";
 //#region src/plugins/builtin/ContextMenuPlugin.d.ts
 interface ContextMenuPluginOptions {
   /** 自定义 HTML 模板字符串。传入此参数将自动启用 HTML 渲染模式 */

package/dist/{DarkThemePlugin-YD-fFNVt.d.mts → DarkThemePlugin-DN2gKMxW.d.mts}

@@ -1,4 +1,4 @@
-import { d as TimelinePlugin } from "./types-Ch6RMCi9.mjs";
+import { d as TimelinePlugin } from "./types-KQ5C-I-e.mjs";
 //#region src/plugins/builtin/DarkThemePlugin.d.ts
 declare const DarkThemePlugin: TimelinePlugin;
 //#endregion

package/dist/{EventMediaPlugin-BiG8wzdz.d.mts → EventMediaPlugin-B1YKwQ8_.d.mts}

@@ -1,4 +1,4 @@
-import { d as TimelinePlugin } from "./types-Ch6RMCi9.mjs";
+import { d as TimelinePlugin } from "./types-KQ5C-I-e.mjs";
 //#region src/plugins/builtin/EventMediaPlugin.d.ts
 declare function EventMediaPlugin(): TimelinePlugin;
 //#endregion

package/dist/{EventTooltipPlugin-r1624PXo.d.mts → EventTooltipPlugin-CVvSszzY.d.mts}

@@ -1,4 +1,4 @@
-import { d as TimelinePlugin } from "./types-Ch6RMCi9.mjs";
+import { d as TimelinePlugin } from "./types-KQ5C-I-e.mjs";
 //#region src/plugins/builtin/EventTooltipPlugin.d.ts
 interface EventTooltipPluginOptions {
   /** 自定义 HTML 模板函数，接收事件标题，返回 HTML 字符串。传入此参数将自动启用 HTML 渲染模式 */

package/dist/{LightThemePlugin-CGDyxruq.d.mts → LightThemePlugin-DOaW67ZR.d.mts}

@@ -1,4 +1,4 @@
-import { d as TimelinePlugin } from "./types-Ch6RMCi9.mjs";
+import { d as TimelinePlugin } from "./types-KQ5C-I-e.mjs";
 //#region src/plugins/builtin/LightThemePlugin.d.ts
 declare const LightThemePlugin: TimelinePlugin;
 //#endregion

package/dist/{PerformanceOverlayPlugin-DDmW-ils.d.mts → PerformanceOverlayPlugin-BrIN19DR.d.mts}

@@ -1,4 +1,4 @@
-import { d as TimelinePlugin } from "./types-Ch6RMCi9.mjs";
+import { d as TimelinePlugin } from "./types-KQ5C-I-e.mjs";
 //#region src/plugins/builtin/PerformanceOverlayPlugin.d.ts
 declare const PerformanceOverlayPlugin: TimelinePlugin;
 //#endregion

package/dist/builtin-plugin/ContextMenuPlugin.d.mts

@@ -1,2 +1,2 @@
-import { t as ContextMenuPlugin } from "../ContextMenuPlugin-C84Iiz8U.mjs";
+import { t as ContextMenuPlugin } from "../ContextMenuPlugin-BRv4YT-G.mjs";
 export { ContextMenuPlugin };

package/dist/builtin-plugin/DarkThemePlugin.d.mts

@@ -1,2 +1,2 @@
-import { t as DarkThemePlugin } from "../DarkThemePlugin-YD-fFNVt.mjs";
+import { t as DarkThemePlugin } from "../DarkThemePlugin-DN2gKMxW.mjs";
 export { DarkThemePlugin as DarkTheme, DarkThemePlugin };

package/dist/builtin-plugin/EventMediaPlugin.d.mts

@@ -1,2 +1,2 @@
-import { t as EventMediaPlugin } from "../EventMediaPlugin-BiG8wzdz.mjs";
+import { t as EventMediaPlugin } from "../EventMediaPlugin-B1YKwQ8_.mjs";
 export { EventMediaPlugin };

package/dist/builtin-plugin/EventTooltipPlugin.d.mts

@@ -1,2 +1,2 @@
-import { t as EventTooltipPlugin } from "../EventTooltipPlugin-r1624PXo.mjs";
+import { t as EventTooltipPlugin } from "../EventTooltipPlugin-CVvSszzY.mjs";
 export { EventTooltipPlugin };

package/dist/builtin-plugin/LightThemePlugin.d.mts

@@ -1,2 +1,2 @@
-import { t as LightThemePlugin } from "../LightThemePlugin-CGDyxruq.mjs";
+import { t as LightThemePlugin } from "../LightThemePlugin-DOaW67ZR.mjs";
 export { LightThemePlugin as LightTheme, LightThemePlugin };

package/dist/builtin-plugin/MutexGuardPlugin.d.mts

@@ -1,4 +1,4 @@
-import { d as TimelinePlugin } from "../types-Ch6RMCi9.mjs";
+import { d as TimelinePlugin } from "../types-KQ5C-I-e.mjs";
 //#region src/plugins/builtin/MutexGuardPlugin.d.ts
 declare function MutexGuardPlugin(): TimelinePlugin;
 //#endregion

package/dist/builtin-plugin/PerformanceOverlayPlugin.d.mts

@@ -1,2 +1,2 @@
-import { t as PerformanceOverlayPlugin } from "../PerformanceOverlayPlugin-DDmW-ils.mjs";
+import { t as PerformanceOverlayPlugin } from "../PerformanceOverlayPlugin-BrIN19DR.mjs";
 export { PerformanceOverlayPlugin };

package/dist/index.d.mts

@@ -1,10 +1,10 @@
-import { A as LoadDataFormat, B as TimelineState, C as EventClickData, D as EventTextStyle, E as EventMoveData, F as TimelineEvent, H as ZoomData, I as TimelineI18nMessages, L as TimelineLocale, M as TimelineCallbacks, N as TimelineColors, O as EventUpdateData, P as TimelineConfig, R as TimelineMessageParams, S as EventAddData, T as EventEditData, V as Track, _ as translateTimelineConfig, a as PluginLocalizedText, b as ContextMenuItem, c as PluginType, d as TimelinePlugin, f as Timeline, g as normalizeTimelineLocale, h as createTimelineMessages, i as PluginContext, j as TimeIndicatorMoveData, k as InteractionTarget, l as RenderLayer, m as createDefaultContextMenuItems, n as CoreRenderTarget, o as PluginMetadata, p as ChangeType, r as PluginAPI, s as PluginPriority, t as CoreLayerHook, u as RenderLayerPosition, v as translateTimelineMessage, w as EventDeleteData, x as ContextMenuStyle, y as ContextMenuData, z as TimelineOptions } from "./types-Ch6RMCi9.mjs";
-import { t as ContextMenuPlugin } from "./ContextMenuPlugin-C84Iiz8U.mjs";
-import { t as DarkThemePlugin } from "./DarkThemePlugin-YD-fFNVt.mjs";
-import { t as EventMediaPlugin } from "./EventMediaPlugin-BiG8wzdz.mjs";
-import { t as EventTooltipPlugin } from "./EventTooltipPlugin-r1624PXo.mjs";
-import { t as LightThemePlugin } from "./LightThemePlugin-CGDyxruq.mjs";
-import { t as PerformanceOverlayPlugin } from "./PerformanceOverlayPlugin-DDmW-ils.mjs";
+import { $ as ScheduleValidationResult, A as EventMoveData, B as ScheduleEditDraft, C as EventAddData, D as EventContentRenderContext, E as EventContentRect, F as ScheduleChange, G as ScheduleErrorCode, H as ScheduleEditState, I as ScheduleCommitResult, J as ScheduleEventPatch, K as ScheduleEventInput, L as ScheduleCommitStateData, M as EventUpdateData, N as InteractionTarget, O as EventDeleteData, P as LoadDataFormat, Q as ScheduleTrackInput, R as ScheduleCommitStateKind, S as ContextMenuStyle, T as EventContentPhase, U as ScheduleEditingOptions, V as ScheduleEditSnapshot, W as ScheduleError, X as SchedulePlacement, Y as ScheduleEventUpsert, Z as ScheduleResult, _ as translateTimelineConfig, a as PluginLocalizedText, at as TimelineI18nMessages, b as ContextMenuData, c as PluginType, ct as TimelineOptions, d as TimelinePlugin, dt as Track, et as TimeIndicatorMoveData, f as Timeline, ft as TrackRect, g as normalizeTimelineLocale, h as createTimelineMessages, i as PluginContext, it as TimelineEvent, j as EventTextStyle, k as EventEditData, l as RenderLayer, lt as TimelineState, m as createDefaultContextMenuItems, mt as ZoomData, n as CoreRenderTarget, nt as TimelineColors, o as PluginMetadata, ot as TimelineLocale, p as ChangeType, pt as ViewportListener, q as ScheduleEventLocation, r as PluginAPI, rt as TimelineConfig, s as PluginPriority, st as TimelineMessageParams, t as CoreLayerHook, tt as TimelineCallbacks, u as RenderLayerPosition, ut as TimelineViewportSnapshot, v as translateTimelineMessage, w as EventClickData, x as ContextMenuItem, y as BusinessId, z as ScheduleDataFormat } from "./types-KQ5C-I-e.mjs";
+import { t as ContextMenuPlugin } from "./ContextMenuPlugin-BRv4YT-G.mjs";
+import { t as DarkThemePlugin } from "./DarkThemePlugin-DN2gKMxW.mjs";
+import { t as EventMediaPlugin } from "./EventMediaPlugin-B1YKwQ8_.mjs";
+import { t as EventTooltipPlugin } from "./EventTooltipPlugin-CVvSszzY.mjs";
+import { t as LightThemePlugin } from "./LightThemePlugin-DOaW67ZR.mjs";
+import { t as PerformanceOverlayPlugin } from "./PerformanceOverlayPlugin-BrIN19DR.mjs";
 //#region src/utils/time.d.ts
 declare function formatTime(seconds: number, showSeconds?: boolean): string;
 declare function getCurrentTime(): number;
@@ -14,4 +14,4 @@ declare function formatDuration(duration: number, label?: string): string;
 //#region src/plugins/metadata.d.ts
 declare function getPluginMetadataDescription(metadata: PluginMetadata, locale?: string): string;
 //#endregion
-export { type ChangeType, type ContextMenuData, type ContextMenuItem, ContextMenuPlugin, type ContextMenuStyle, type CoreLayerHook, type CoreRenderTarget, DarkThemePlugin, type EventAddData, type EventClickData, type EventDeleteData, type EventEditData, EventMediaPlugin, type EventMoveData, type EventTextStyle, EventTooltipPlugin, type EventUpdateData, type InteractionTarget, LightThemePlugin, type LoadDataFormat, PerformanceOverlayPlugin, type PluginAPI, type PluginContext, type PluginLocalizedText, type PluginMetadata, PluginPriority, PluginType, type RenderLayer, type RenderLayerPosition, type TimeIndicatorMoveData, Timeline, type TimelineCallbacks, type TimelineColors, type TimelineConfig, type TimelineEvent, type TimelineI18nMessages, type TimelineLocale, type TimelineMessageParams, type TimelineOptions, type TimelinePlugin, type TimelineState, type Track, type ZoomData, createDefaultContextMenuItems, createTimelineMessages, formatDuration, formatTime, formatTimeRange, getCurrentTime, getPluginMetadataDescription, normalizeTimelineLocale, translateTimelineConfig, translateTimelineMessage };
+export { type BusinessId, type ChangeType, type ContextMenuData, type ContextMenuItem, ContextMenuPlugin, type ContextMenuStyle, type CoreLayerHook, type CoreRenderTarget, DarkThemePlugin, type EventAddData, type EventClickData, type EventContentPhase, type EventContentRect, type EventContentRenderContext, type EventDeleteData, type EventEditData, EventMediaPlugin, type EventMoveData, type EventTextStyle, EventTooltipPlugin, type EventUpdateData, type InteractionTarget, LightThemePlugin, type LoadDataFormat, PerformanceOverlayPlugin, type PluginAPI, type PluginContext, type PluginLocalizedText, type PluginMetadata, PluginPriority, PluginType, type RenderLayer, type RenderLayerPosition, type ScheduleChange, type ScheduleCommitResult, type ScheduleCommitStateData, type ScheduleCommitStateKind, type ScheduleDataFormat, type ScheduleEditDraft, type ScheduleEditSnapshot, type ScheduleEditState, type ScheduleEditingOptions, type ScheduleError, type ScheduleErrorCode, type ScheduleEventInput, type ScheduleEventLocation, type ScheduleEventPatch, type ScheduleEventUpsert, type SchedulePlacement, type ScheduleResult, type ScheduleTrackInput, type ScheduleValidationResult, type TimeIndicatorMoveData, Timeline, type TimelineCallbacks, type TimelineColors, type TimelineConfig, type TimelineEvent, type TimelineI18nMessages, type TimelineLocale, type TimelineMessageParams, type TimelineOptions, type TimelinePlugin, type TimelineState, type TimelineViewportSnapshot, type Track, type TrackRect, type ViewportListener, type ZoomData, createDefaultContextMenuItems, createTimelineMessages, formatDuration, formatTime, formatTimeRange, getCurrentTime, getPluginMetadataDescription, normalizeTimelineLocale, translateTimelineConfig, translateTimelineMessage };