@mogura/moguchart-core 1.0.0 → 1.1.0

package/dist/components/gantt-chart.d.ts

@@ -3,7 +3,8 @@ import { LitElement, type PropertyValues } from 'lit';
 import './gantt-calendar';
 import './gantt-row';
 import './gantt-minimap';
-import { type ExportImageOptions } from './gantt-chart-export';
+import { PluginManager, type GanttPlugin } from '../core/plugin';
+import type { ExportImageOptions } from '../core/types';
 export declare class GanttChartElement extends LitElement {
     rows: GanttRow[];
     option: GanttChartOption;
@@ -39,6 +40,7 @@ export declare class GanttChartElement extends LitElement {
     private cursorLineX;
     private connectorDrag;
     private _systemThemeMediaQuery;
+    private _pluginManager;
     private isExporting;
     private focusedTaskId;
     private focusedRowId;
@@ -143,12 +145,26 @@ export declare class GanttChartElement extends LitElement {
         bottom: number;
     }[];
     /**
-     * html2canvas を使用してガントチャートを画像としてエクスポートする。
-     * (Shadow DOMネイティブ対応版 html2canvas-pro を使用)
+     * プラグインを登録してインストールする。
+     * @param plugin 登録するプラグイン
+     * @param config プラグインの設定オプション（任意）
+     */
+    use<TConfig = any>(plugin: GanttPlugin<TConfig>, config?: TConfig): this;
+    /**
+     * 内部のプラグインマネージャーを取得する。
+     */
+    get pluginManager(): PluginManager;
+    /**
+     * ガントチャートを画像またはPDFとしてエクスポートする。
+     * ※ エクスポート機能を使用するには、`@mogura/moguchart-plugin-export` プラグインの登録が必要です。
+     * 例:
+     *   import { exportPlugin } from '@mogura/moguchart-plugin-export'
+     *   chart.use(exportPlugin())
      *
-     * @param options エクスポートオプション。
+     * @param format 'png' または 'pdf'
+     * @param options エクスポートオプション
      */
-    exportImage(format?: 'png' | 'pdf', options?: ExportImageOptions): Promise<string | Blob>;
+    exportImage(_format?: 'png' | 'pdf', _options?: ExportImageOptions): Promise<string | Blob>;
     /**
      * Ctrl/Cmd + マウスホイールによるズーム処理
      */

package/dist/components/gantt-row.d.ts

@@ -70,6 +70,8 @@ export declare class GanttRowElement extends LitElement {
     private _rowHeaderTooltipTimer;
     private handleHeaderMouseEnter;
     private handleHeaderMouseLeave;
+    private handleToggleMouseEnter;
+    private handleToggleMouseLeave;
     private handleToggleCollapse;
     private handleToggleDblClick;
     protected updated(changedProperties: PropertyValues): void;

package/dist/core/plugin.d.ts

@@ -0,0 +1,60 @@
+import type { GanttChartElement } from '../components/gantt-chart';
+import type { TaskUpdateEventDetail } from './types';
+/**
+ * ガントチャート拡張プラグインの共通インターフェース
+ */
+export interface GanttPlugin<TConfig = any, TChart = any> {
+    /** プラグインの一意な識別名 (例: 'export', 'auto-schedule') */
+    name: string;
+    /** プラグインのバージョン (任意) */
+    version?: string;
+    /** チャートインスタンス初期化時またはuse()呼び出し時のインストール処理 */
+    install?: (chart: TChart, config?: TConfig) => void;
+    /** チャート破棄時（disconnectedCallback）のクリーンアップ処理 */
+    destroy?: (chart: TChart) => void;
+    /** ライフサイクルフック */
+    hooks?: {
+        /** タスク更新直前のフック（false を返すと更新処理をキャンセル） */
+        beforeTaskUpdate?: (detail: TaskUpdateEventDetail) => boolean | void | Promise<boolean | void>;
+        /** タスク更新直後のフック */
+        afterTaskUpdate?: (detail: TaskUpdateEventDetail) => void;
+        /** レンダリング後のフック */
+        afterRender?: (chart: TChart) => void;
+    };
+}
+/**
+ * プラグイン管理マネージャークラス
+ */
+export declare class PluginManager {
+    private plugins;
+    private chart;
+    constructor(chart: GanttChartElement);
+    /**
+     * プラグインを登録・インストールする
+     */
+    use<TConfig = any>(plugin: GanttPlugin<TConfig>, config?: TConfig): void;
+    /**
+     * 登録済みプラグインの一覧を取得する
+     */
+    getPlugin(name: string): GanttPlugin | undefined;
+    /**
+     * プラグインが登録されているかどうかを確認する
+     */
+    hasPlugin(name: string): boolean;
+    /**
+     * beforeTaskUpdate フックを一括実行する
+     */
+    executeBeforeTaskUpdate(detail: TaskUpdateEventDetail): Promise<boolean>;
+    /**
+     * afterTaskUpdate フックを一括実行する
+     */
+    executeAfterTaskUpdate(detail: TaskUpdateEventDetail): void;
+    /**
+     * afterRender フックを一括実行する
+     */
+    executeAfterRender(): void;
+    /**
+     * 全プラグインを破棄・クリーンアップする
+     */
+    destroy(): void;
+}

package/dist/core/types.d.ts

@@ -1,4 +1,5 @@
 import type { MoguchartLocale } from './i18n';
+import type { GanttPlugin } from './plugin';
 /**
  * ガントチャートのバーに適用できるパターンの種類
  */
@@ -415,6 +416,8 @@ export interface GanttChartOption {
     selection?: GanttChartOptionSelection;
     /** WBS・階層ツリーに関する設定 */
     tree?: GanttChartOptionTree;
+    /** 拡張プラグインの配列 */
+    plugins?: GanttPlugin[];
 }
 /**
  * WBS・階層ツリーに関するオプション
@@ -873,3 +876,16 @@ export interface TaskProgressChangeEventDetail {
     /** キャンセルされたかどうか */
     cancelled?: boolean;
 }
+/**
+ * 画像・PDFエクスポートのオプション
+ */
+export interface ExportImageOptions {
+    /** ダウンロード時のファイル名（拡張子なし）。省略時は 'gantt-chart' */
+    filename?: string;
+    /** true の場合、自動的にファイルダウンロードを開始する。デフォルト: false */
+    download?: boolean;
+    /** PNG 出力時のスケール倍率（高解像度化）。デフォルト: 2 */
+    scale?: number;
+    /** 画像を指定したピクセル数で縦に分割し、分割位置にカレンダー（ヘッダー）を挿入する。未指定時は分割しない */
+    splitHeight?: number;
+}

package/dist/index.d.ts

@@ -6,6 +6,7 @@ export * from './components/gantt-minimap';
 export * from './core/types';
 export * from './core/patterns';
 export * from './core/i18n';
-export { clampProgress, calculateRowProgress, calculateWeightedRowProgress, calculateProjectProgress, } from './core/utils';
+export * from './core/plugin';
+export { clampProgress, calculateRowProgress, calculateWeightedRowProgress, calculateProjectProgress, getThemeColors, } from './core/utils';
 export { computeCriticalPath } from './core/critical-path';
 export { computeRowLevels, computeRowWbsCodes, computeChildRowIds, computeVisibleTreeRows, computeSummaryTask, canDropRow, } from './core/wbs';