headless-vpl 0.1.0

package/dist/core/AutoLayout.d.ts

@@ -0,0 +1,51 @@
+import Container from './Container';
+import Workspace from './Workspace';
+import Position from './Position';
+import type { IWorkspaceElement } from './types';
+type AutoLayoutDirection = 'horizontal' | 'vertical';
+type AutoLayoutAlignment = 'start' | 'center' | 'end';
+type AutoLayoutProps = {
+    workspace?: Workspace;
+    position: Position;
+    width?: number;
+    height?: number;
+    direction?: AutoLayoutDirection;
+    gap?: number;
+    alignment?: AutoLayoutAlignment;
+    containers: Container[];
+};
+/**
+ * 子 Container を配置するレイアウトマネージャ。
+ * direction で水平/垂直、gap で間隔、alignment で交差軸の揃えを制御する。
+ * IWorkspaceElement を実装し、MovableObject と同じインターフェースを持つ。
+ */
+declare class AutoLayout implements IWorkspaceElement {
+    readonly id: string;
+    Children: Container[];
+    position: Position;
+    parentContainer: Container | null;
+    width: number;
+    height: number;
+    direction: AutoLayoutDirection;
+    gap: number;
+    alignment: AutoLayoutAlignment;
+    workspace: Workspace;
+    name: string;
+    type: string;
+    frame: number;
+    constructor({ workspace, position, width, height, direction, gap, alignment, containers }: AutoLayoutProps);
+    get absolutePosition(): {
+        x: number;
+        y: number;
+    };
+    setParent(container: Container): void;
+    addElement(element: Container): void;
+    update(): void;
+    private layoutHorizontal;
+    private layoutVertical;
+    private alignCrossAxis;
+    private computeContentSize;
+    move(x: number, y: number): void;
+    toJSON(): Record<string, unknown>;
+}
+export default AutoLayout;

package/dist/core/Connector.d.ts

@@ -0,0 +1,14 @@
+import Position from './Position';
+import Workspace from './Workspace';
+import { MovableObject } from './MovableObject';
+type ConnectorProps = {
+    workspace?: Workspace;
+    position: Position;
+    name: string;
+    type: 'input' | 'output';
+};
+declare class Connector extends MovableObject {
+    constructor({ workspace, position, name, type }: ConnectorProps);
+    toJSON(): Record<string, unknown>;
+}
+export default Connector;

package/dist/core/Container.d.ts

@@ -0,0 +1,54 @@
+import AutoLayout from './AutoLayout';
+import { MovableObject } from './MovableObject';
+import Position from './Position';
+import Workspace from './Workspace';
+import type { SizingMode, Padding } from './types';
+type ContainerProps<T extends {
+    [key: string]: MovableObject | AutoLayout;
+} = {}> = {
+    workspace?: Workspace;
+    position?: Position;
+    name: string;
+    color?: string;
+    width?: number;
+    height?: number;
+    widthMode?: SizingMode;
+    heightMode?: SizingMode;
+    padding?: Partial<Padding>;
+    minWidth?: number;
+    maxWidth?: number;
+    minHeight?: number;
+    maxHeight?: number;
+    resizable?: boolean;
+    children?: T;
+};
+declare class Container<T extends {
+    [key: string]: MovableObject | AutoLayout;
+} = {}> extends MovableObject {
+    color: string;
+    width: number;
+    height: number;
+    widthMode: SizingMode;
+    heightMode: SizingMode;
+    padding: Padding;
+    minWidth: number;
+    maxWidth: number;
+    minHeight: number;
+    maxHeight: number;
+    resizable: boolean;
+    children: T;
+    constructor({ workspace, position, name, color, width, height, widthMode, heightMode, padding, minWidth, maxWidth, minHeight, maxHeight, resizable, children, }: ContainerProps<T>);
+    private propagateWorkspace;
+    private bindChildWorkspace;
+    setColor(color: string): void;
+    applyContentSize(contentWidth: number, contentHeight: number): void;
+    updateChildren(): void;
+    private updateChildPosition;
+    private updateChildLayout;
+    move(x: number, y: number): void;
+    private updateChildrenPosition;
+    private isMovableObject;
+    private isAutoLayout;
+    toJSON(): Record<string, unknown>;
+}
+export default Container;

package/dist/core/Edge.d.ts

@@ -0,0 +1,42 @@
+import type Connector from './Connector';
+import Workspace from './Workspace';
+import type { IEdge, EdgeType, EdgeMarker } from './types';
+import type { IPosition } from './Position';
+import type { EdgePathResult } from '../util/edgePath';
+type EdgeProps = {
+    workspace?: Workspace;
+    start: Connector;
+    end: Connector;
+    edgeType?: EdgeType;
+    label?: string;
+    markerStart?: EdgeMarker;
+    markerEnd?: EdgeMarker;
+};
+/**
+ * 2 つの Connector を結ぶ接続線。
+ * Position ではなく Connector への参照を保持し、
+ * Connector の移動に自動追従する（Renderer 側で処理）。
+ */
+declare class Edge implements IEdge {
+    readonly id: string;
+    workspace: Workspace;
+    startConnector: Connector;
+    endConnector: Connector;
+    edgeType: EdgeType;
+    label?: string;
+    markerStart?: EdgeMarker;
+    markerEnd?: EdgeMarker;
+    constructor({ workspace, start, end, edgeType, label, markerStart, markerEnd }: EdgeProps);
+    get startPosition(): import("./Position").default;
+    get endPosition(): import("./Position").default;
+    /**
+     * edgeType に応じたパス文字列とラベル位置を計算する。
+     */
+    computePath(): EdgePathResult;
+    /**
+     * ラベルの表示位置を返す。
+     */
+    getLabelPosition(): IPosition;
+    toJSON(): Record<string, unknown>;
+}
+export default Edge;

package/dist/core/EventBus.d.ts

@@ -0,0 +1,10 @@
+import type { VplEventType, VplEvent } from './types';
+/**
+ * 最小限のイベントシステム。
+ * move / connect / disconnect / add / remove / update の 6 種のイベントを扱う。
+ */
+export declare class EventBus {
+    private handlers;
+    on(type: VplEventType, handler: (event: VplEvent) => void): () => void;
+    emit(type: VplEventType, target: unknown, data?: Record<string, unknown>): void;
+}

package/dist/core/History.d.ts

@@ -0,0 +1,28 @@
+/**
+ * コマンドインターフェース。Undo/Redo のための do/undo ペア。
+ */
+export interface Command {
+    execute(): void;
+    undo(): void;
+}
+/**
+ * Command パターンベースの Undo/Redo 履歴。
+ * execute() でコマンドを実行しスタックに積む。
+ * undo()/redo() でスタックを戻す/進む。
+ */
+export declare class History {
+    private _undoStack;
+    private _redoStack;
+    private _maxDepth;
+    constructor(maxDepth?: number);
+    /**
+     * コマンドを実行し、Undo スタックに追加する。
+     * 新しいコマンド実行時に Redo スタックはクリアされる。
+     */
+    execute(command: Command): void;
+    undo(): void;
+    redo(): void;
+    get canUndo(): boolean;
+    get canRedo(): boolean;
+    clear(): void;
+}

package/dist/core/MovableObject.d.ts

@@ -0,0 +1,29 @@
+import Position from './Position';
+import Workspace from './Workspace';
+import type { IWorkspaceElement } from './types';
+/**
+ * 動くオブジェクトに共通するプロパティ・処理をまとめた基底クラス。
+ * DOM 依存はゼロ — 描画は外部の Renderer が EventBus 経由で行う。
+ */
+export declare abstract class MovableObject implements IWorkspaceElement {
+    readonly id: string;
+    /** スナップ接続による親 (型安全) */
+    Parent: MovableObject | null;
+    /** スナップ接続による子 (型安全) */
+    Children: MovableObject | null;
+    workspace: Workspace;
+    position: Position;
+    name: string;
+    type: string;
+    selected: boolean;
+    constructor(workspace: Workspace | undefined, position: Position, name: string, type: string);
+    /**
+     * プロパティ変更を通知する。Renderer が 'update' イベントで再描画する。
+     */
+    update(): void;
+    /**
+     * 位置を変更し 'move' イベントを発火する。
+     */
+    move(x: number, y: number): void;
+    toJSON(): Record<string, unknown>;
+}

package/dist/core/Position.d.ts

@@ -0,0 +1,12 @@
+export interface IPosition {
+    x: number;
+    y: number;
+}
+declare class Position {
+    x: number;
+    y: number;
+    constructor(x: number, y: number);
+    setPosition(x: number, y: number): void;
+    getPosition(): IPosition;
+}
+export default Position;

package/dist/core/SelectionManager.d.ts

@@ -0,0 +1,19 @@
+import type { EventBus } from './EventBus';
+import type { MovableObject } from './MovableObject';
+/**
+ * 選択状態を管理するクラス。
+ * Workspace のプロパティとして保持し、EventBus 経由で select/deselect イベントを発火する。
+ */
+export declare class SelectionManager {
+    private _selected;
+    private eventBus;
+    constructor(eventBus: EventBus);
+    select(element: MovableObject): void;
+    deselect(element: MovableObject): void;
+    toggleSelect(element: MovableObject): void;
+    selectAll(elements: readonly MovableObject[]): void;
+    deselectAll(): void;
+    getSelection(): readonly MovableObject[];
+    isSelected(element: MovableObject): boolean;
+    get size(): number;
+}

package/dist/core/Workspace.d.ts

@@ -0,0 +1,40 @@
+import { EventBus } from './EventBus';
+import { History } from './History';
+import { SelectionManager } from './SelectionManager';
+import type { IWorkspaceElement, IEdge, VplEventType, VplEvent, Viewport } from './types';
+/**
+ * 要素の管理と EventBus を提供するワークスペース。
+ * DOM への依存はゼロ — 描画は外部の Renderer が担う。
+ */
+declare class Workspace {
+    readonly eventBus: EventBus;
+    readonly viewport: Viewport;
+    readonly selection: SelectionManager;
+    readonly history: History;
+    private _elements;
+    private _edges;
+    addElement(element: IWorkspaceElement): void;
+    addEdge(edge: IEdge): void;
+    removeElement(element: IWorkspaceElement): void;
+    removeEdge(edge: IEdge): void;
+    /**
+     * コンテナを削除する。関連 Edge の自動削除、Parent/Children 関係のクリア、
+     * 子要素の再帰削除を行う。
+     * instanceof を使わずダックタイピングで判定し、循環参照を回避する。
+     */
+    removeContainer(element: IWorkspaceElement): void;
+    get elements(): readonly IWorkspaceElement[];
+    get edges(): readonly IEdge[];
+    on(type: VplEventType, handler: (event: VplEvent) => void): () => void;
+    pan(x: number, y: number): void;
+    panBy(dx: number, dy: number): void;
+    zoomAt(screenX: number, screenY: number, newScale: number): void;
+    setScale(scale: number): void;
+    /**
+     * 全要素が収まるようにビューポートを自動調整する。
+     * scale は 1.0 を上限とし、過度なズームインを防止する。
+     * canvasWidth/canvasHeight は引数で渡す（DOM 依存回避）。
+     */
+    fitView(canvasWidth: number, canvasHeight: number, padding?: number): void;
+}
+export default Workspace;

package/dist/core/commands.d.ts

@@ -0,0 +1,55 @@
+import type { Command } from './History';
+import type { IWorkspaceElement } from './types';
+import type Workspace from './Workspace';
+/**
+ * 移動コマンド。要素を指定位置に移動する。
+ */
+export declare class MoveCommand implements Command {
+    private element;
+    private fromX;
+    private fromY;
+    private toX;
+    private toY;
+    constructor(element: IWorkspaceElement, fromX: number, fromY: number, toX: number, toY: number);
+    execute(): void;
+    undo(): void;
+}
+/**
+ * 要素追加コマンド。
+ */
+export declare class AddCommand implements Command {
+    private workspace;
+    private element;
+    constructor(workspace: Workspace, element: IWorkspaceElement);
+    execute(): void;
+    undo(): void;
+}
+/**
+ * 要素削除コマンド。Undo で再追加する。
+ */
+export declare class RemoveCommand implements Command {
+    private workspace;
+    private element;
+    private relatedEdges;
+    private savedParent;
+    private savedChildren;
+    constructor(workspace: Workspace, element: IWorkspaceElement);
+    private findRelatedEdges;
+    execute(): void;
+    undo(): void;
+}
+/**
+ * 接続コマンド。2 つの要素の Parent/Children 関係を設定する。
+ */
+export declare class ConnectCommand implements Command {
+    private workspace;
+    private parent;
+    private child;
+    constructor(workspace: Workspace, parent: IWorkspaceElement & {
+        Children: unknown;
+    }, child: IWorkspaceElement & {
+        Parent: unknown;
+    });
+    execute(): void;
+    undo(): void;
+}

package/dist/core/types.d.ts

@@ -0,0 +1,51 @@
+import type Position from './Position';
+import type { IPosition } from './Position';
+export type SizingMode = 'fixed' | 'hug' | 'fill';
+export type Padding = {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+};
+export declare function generateId(prefix?: string): string;
+/**
+ * Workspace 上に配置される要素の共通インターフェース。
+ * MovableObject と AutoLayout が共有するプロパティを統一する。
+ */
+export interface IWorkspaceElement {
+    readonly id: string;
+    position: Position;
+    name: string;
+    type: string;
+    move(x: number, y: number): void;
+    update(): void;
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Edge のインターフェース（Position を 2 つ持つため IWorkspaceElement とは別）
+ */
+export interface IEdge {
+    readonly id: string;
+    readonly startPosition: IPosition;
+    readonly endPosition: IPosition;
+    toJSON(): Record<string, unknown>;
+}
+export type VplEventType = 'move' | 'connect' | 'disconnect' | 'add' | 'remove' | 'update' | 'pan' | 'zoom' | 'select' | 'deselect';
+export type EdgeType = 'straight' | 'bezier' | 'step' | 'smoothstep';
+export type MarkerType = 'arrow' | 'arrowClosed' | 'none';
+export type EdgeMarker = {
+    type: MarkerType;
+    color?: string;
+    size?: number;
+};
+export type ResizeHandleDirection = 'n' | 's' | 'e' | 'w' | 'ne' | 'nw' | 'se' | 'sw';
+export interface Viewport {
+    x: number;
+    y: number;
+    scale: number;
+}
+export interface VplEvent {
+    type: VplEventType;
+    target: unknown;
+    data?: Record<string, unknown>;
+}