@mogura/moguchart-core 0.12.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;
@@ -59,6 +61,9 @@ export declare class GanttChartElement extends LitElement {
     private _lastZoomPxPerDay;
     private _lastZoomPxPerMonth;
     private _scrollContainer;
+    private _collapsedRowIds;
+    private _prevExternalCollapsed;
+    private _draggingRowId;
     private get displayRows();
     /**
      * 現在有効な pxPerDay（ズームオーバーライドがあればそちらを優先）
@@ -72,6 +77,7 @@ export declare class GanttChartElement extends LitElement {
     protected firstUpdated(): void;
     connectedCallback(): void;
     disconnectedCallback(): void;
+    private _handleGlobalDragEnd;
     private handleSystemThemeChange;
     protected willUpdate(changedProperties: PropertyValues): void;
     protected updated(changedProperties: PropertyValues): void;
@@ -107,6 +113,8 @@ export declare class GanttChartElement extends LitElement {
     private handleBarMouseLeave;
     private reorderRows;
     private handleContainerDragOver;
+    private handleRowDragStart;
+    private handleRowDragEnd;
     private handleContainerDragLeave;
     private handleContainerDrop;
     private handleExternalTaskDrop;
@@ -137,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 + マウスホイールによるズーム処理
      */
@@ -217,6 +239,35 @@ export declare class GanttChartElement extends LitElement {
      * @returns タスクが見つかり選択できた場合はtrue、見つからなかった場合はfalse
      */
     selectTask(taskId: string): boolean;
+    private handleRowToggleCollapse;
+    /**
+     * 指定した行の折りたたみ状態を切り替えます。
+     *
+     * @param rowId 対象の行ID
+     * @param collapsed 設定する折りたたみ状態（省略時は現在の状態を反転）
+     * @returns 切り替えに成功した場合はtrue、行が見つからない場合はfalse
+     */
+    toggleRowCollapse(rowId: string, collapsed?: boolean): boolean;
+    /**
+     * 子行を持つすべての親行を折りたたみます。
+     */
+    collapseAll(): void;
+    /**
+     * すべての行を展開（折りたたみ解除）します。
+     */
+    expandAll(): void;
+    /**
+     * スクロール位置を左上（0, 0）にリセットします。
+     */
+    resetScroll(): void;
+    /**
+     * 指定したスクロール位置に移動します。
+     */
+    scrollToPosition(options: {
+        left?: number;
+        top?: number;
+        behavior?: ScrollBehavior;
+    }): void;
     /**
      * 指定タスクが表示範囲外の場合にスクロールして表示する
      */

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

@@ -5,6 +5,9 @@ import './gantt-row-background';
 export declare class GanttRowElement extends LitElement {
     row: GanttRow;
     option: GanttChartOption;
+    level: number;
+    hasChildren: boolean;
+    wbsCode: string;
     isDragTarget: boolean;
     draggingTask: {
         id: string;
@@ -59,6 +62,7 @@ export declare class GanttRowElement extends LitElement {
     private calculateMarkerLanes;
     static styles: import("lit").CSSResult;
     private handleDragStart;
+    private handleDragEnd;
     private handleHeaderClick;
     private handleHeaderContextMenu;
     private handleHeaderDblClick;
@@ -66,6 +70,10 @@ 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;
     render(): import("lit").TemplateResult<1>;
 }

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';
 /**
  * ガントチャートのバーに適用できるパターンの種類
  */
@@ -83,6 +84,8 @@ export interface GanttTask {
     progressStyle?: string;
     /** 進捗バーのドラッグ編集可否 (指定がない場合はoption.progress.editableに準ずる) */
     progressResizable?: boolean;
+    /** タスクの種別 ('task': 通常, 'summary': 親サマリー集計バー, 'milestone': マイルストーン) */
+    type?: 'task' | 'summary' | 'milestone';
 }
 /**
  * ガントチャートの行を表すインターフェース
@@ -100,6 +103,16 @@ export interface GanttRow {
     selectedMarkerId?: string;
     /** 行を表示するかどうか (デフォルト: true) */
     visible?: boolean;
+    /** 親行のID (ルート階層の場合は null または undefined) */
+    parentId?: string | null;
+    /** 折りたたみ状態 (trueの場合、配下の子孫行を非表示にする) */
+    collapsed?: boolean;
+    /** サマリー行（グループ行）かどうか */
+    isSummary?: boolean;
+    /** サマリータスクバーのカスタム色 (CSSカラー文字列)。指定がない場合はoption.tree.summaryColorまたは既定色 */
+    summaryColor?: string;
+    /** WBSコード (例: "1.2.1") */
+    wbsCode?: string;
 }
 /**
  * 内部計算用: レーン情報が付与されたタスク
@@ -369,6 +382,8 @@ export interface GanttChartOption {
     snapDuration?: number;
     /** 非表示に設定された行を表示するかどうか (デフォルト: false) */
     showHiddenRows?: boolean;
+    /** チャート全体のフォントサイズ倍率 (デフォルト: 1) */
+    fontScale?: number;
     /** カスタムレンダリング設定 */
     customRendering?: GanttChartOptionCustomRendering;
     /** ロケール設定 (デフォルト: 日本語) */
@@ -399,6 +414,27 @@ export interface GanttChartOption {
     progress?: GanttChartOptionProgress;
     /** タスク選択に関する設定 */
     selection?: GanttChartOptionSelection;
+    /** WBS・階層ツリーに関する設定 */
+    tree?: GanttChartOptionTree;
+    /** 拡張プラグインの配列 */
+    plugins?: GanttPlugin[];
+}
+/**
+ * WBS・階層ツリーに関するオプション
+ */
+export interface GanttChartOptionTree {
+    /** ツリー表示を有効にするかどうか (デフォルト: true) */
+    enabled?: boolean;
+    /** 階層レベルあたりのインデント幅 (px、デフォルト: 16) */
+    indentWidth?: number;
+    /** 折りたたみトグルアイコン（▶/▼）を表示するかどうか (デフォルト: true) */
+    showToggleIcon?: boolean;
+    /** WBSコード（1, 1.1など）を行ヘッダーに自動表示するかどうか (デフォルト: false) */
+    showWbsCode?: boolean;
+    /** 子タスクの変更時に親サマリータスクを自動計算するかどうか (デフォルト: true) */
+    autoSummary?: boolean;
+    /** サマリータスクバーの既定色 (CSSカラー文字列、デフォルト: '#334155') */
+    summaryColor?: string;
 }
 /**
  * タスク選択・矩形範囲選択に関するオプション
@@ -423,6 +459,8 @@ export interface GanttChartOptionProgress {
     color?: string;
     /** 進捗ラベル (例: '50%') を表示するかどうか (デフォルト: false) */
     showLabel?: boolean;
+    /** サマリータスクにも進捗ラベルを表示するかどうか (デフォルト: false) */
+    showSummaryLabel?: boolean;
     /** 進捗ラベルの表示位置 ('inside' | 'right' | 'left' | 'center') (デフォルト: 'inside') */
     labelPosition?: 'inside' | 'right' | 'left' | 'center';
     /** 進捗ラベルのカスタムフォーマット関数 */
@@ -648,6 +686,17 @@ export interface RowHeaderContextMenuEventDetail {
     /** 右クリックされたヘッダー要素 */
     target: HTMLElement;
 }
+/**
+ * 行の折りたたみ/展開切り替えイベントの詳細
+ */
+export interface RowToggleCollapseEventDetail {
+    /** 対象の行ID */
+    rowId: string;
+    /** 新しい折りたたみ状態 (true: 折りたたみ, false: 展開) */
+    collapsed: boolean;
+    /** 対象の行データ */
+    row: GanttRow;
+}
 /**
  * テーマカラーパレット定義
  */
@@ -827,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/core/wbs.d.ts

@@ -0,0 +1,58 @@
+import type { GanttRow, GanttTask } from './types';
+/**
+ * 各行の階層レベル（深さ: ルートは0, その子は1, 孫は2...）を計算します。
+ * 循環参照や存在しない親IDがある場合でも安全にフォールバックします。
+ *
+ * @param rows ガント行の配列
+ * @returns 行ID -> 階層レベルのMap
+ */
+export declare function computeRowLevels(rows: GanttRow[]): Map<string, number>;
+/**
+ * 各行のWBSコード（例: "1", "1.1", "1.2", "2", "2.1"...）を行の順序に基づいて自動採番します。
+ *
+ * @param rows ガント行の配列
+ * @returns 行ID -> WBSコードのMap
+ */
+export declare function computeRowWbsCodes(rows: GanttRow[]): Map<string, string>;
+/**
+ * 指定された親行の直下、または再帰的なすべての子孫行IDを取得します。
+ *
+ * @param rows ガント行の配列
+ * @param parentId 親行のID
+ * @param recursive 再帰的に孫以降も取得するかどうか (デフォルト: true)
+ * @returns 子行IDの配列
+ */
+export declare function computeChildRowIds(rows: GanttRow[], parentId: string, recursive?: boolean): string[];
+/**
+ * 折りたたまれた親行を持つ子孫行を除外した、実際に画面に表示されるべき可視行リストを返します。
+ *
+ * @param rows ガント行の配列
+ * @param includeHidden `row.visible === false` の行も含めるか (showHiddenRows 用、デフォルト: false)
+ * @returns 表示対象の行配列
+ */
+export declare function computeVisibleTreeRows(rows: GanttRow[], includeHidden?: boolean): GanttRow[];
+/**
+ * 子タスクの配列から、親サマリータスク（最小開始日〜最大終了日、加重平均進捗率）を計算します。
+ *
+ * @param childTasks 子タスクの配列
+ * @param template サマリータスクの基本プロパティ（id, name 等）
+ * @returns 計算されたサマリータスク。子タスクがない場合は null
+ */
+export declare function computeSummaryTask(childTasks: GanttTask[], template?: Partial<GanttTask>): GanttTask | null;
+/**
+ * 行ドラッグ＆ドロップ時に、移動先が安全かつWBSの階層構造（親子関係）を維持できるかを判定します。
+ *
+ * - 循環参照ガード: 移動対象自身または自身の子孫へのドロップ、および自身の親を自身（または自身の子孫）にするドロップは禁止
+ * - 展開中親行の直下ガード: 展開中の親行の bottom は最初の子行の前への割り込みになるため禁止（親自身の子行の先頭移動を除く）
+ * - ドロップ先に応じた階層（parentId）の変化:
+ *   - ルート行へのドロップ: ルート行（parentId = null）に移動
+ *   - 子行へのドロップ: その子行の兄弟行（同じ parentId）に移動
+ *   - 親行へのドロップ: bottom なら先頭子行に移動、top なら親行の前（親行の兄弟）に移動
+ *
+ * @param rows ガント行の配列
+ * @param movingRowIds 移動しようとしている行ID（単一または複数）
+ * @param targetRowId ドロップ先の行ID
+ * @param position ドロップ位置 ('top' または 'bottom'、省略時は行へのドロップ可否全般)
+ * @returns ドロップ可能なら true, 不正な移動なら false
+ */
+export declare function canDropRow(rows: GanttRow[], movingRowIds: string | string[], targetRowId: string, position?: 'top' | 'bottom'): boolean;

package/dist/index.d.ts

@@ -6,5 +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';