@unofficialbox/box-open-elements 0.24.0 → 0.25.0

package/dist/patterns/process-modeler/model.d.ts

@@ -6,6 +6,8 @@ export interface ProcessBox<N = unknown> {
     title: string;
     description?: string;
     path?: NodePath;
+    /** Host identity at this path, used to reject stale saved positions. */
+    fingerprint?: string;
     /** A frame draws behind its children and connects as one box. */
     frame?: boolean;
     parentId?: string;
@@ -15,18 +17,51 @@ export interface ProcessLine {
     from: string;
     to: string;
     label?: string;
+    weight?: number;
+    fromSide?: ProcessSide;
+    toSide?: ProcessSide;
     dashed?: boolean;
     points?: {
         x: number;
         y: number;
     }[];
 }
+export type ProcessSide = "north" | "east" | "south" | "west";
+export interface ProcessConnection {
+    name: string;
+    kind: string;
+    id?: string;
+}
+export interface ProcessVariable {
+    name: string;
+    value?: unknown;
+    description?: string;
+}
+export interface ProcessPositionSnapshot {
+    path?: NodePath;
+    fingerprint?: string;
+    id: string;
+    position: BoxPosition;
+}
+export interface ProcessLoadOptions {
+    /** Keys are JSON.stringify(path); snapshots are also accepted. Fingerprints must match. */
+    positions?: Readonly<Record<string, {
+        fingerprint?: string;
+        position: BoxPosition;
+    }>> | readonly ProcessPositionSnapshot[];
+    version?: string | number;
+    selectedPath?: NodePath | null;
+}
 export interface ProcessProjection<N = unknown> {
     boxes: readonly ProcessBox<N>[];
     lines: readonly ProcessLine[];
 }
 export interface ProcessModel<D = unknown, N = unknown> {
     project(document: D): ProcessProjection<N>;
+    /** Optional host arrangement, used by Tidy up and for missing positions. */
+    arrange?(projection: ProcessProjection<N>): ProcessLayout;
+    /** Host-specific semantics supplement the generic free-graph checks. */
+    validate?(document: D, projection: ProcessProjection<N>): readonly ProcessCheck[];
 }
 export interface BoxPosition {
     x: number;
@@ -61,17 +96,22 @@ export interface ProcessCheck {
     path?: NodePath;
 }
 export interface ProcessEdit {
-    type: "add" | "delete" | "connect" | "disconnect" | "insert";
+    type: "add" | "delete" | "connect" | "disconnect" | "insert" | "reparent";
     boxId?: string;
     from?: string;
     to?: string;
     lineId?: string;
     kind?: FlowKind;
     position?: BoxPosition;
+    parentId?: string;
+    fromSide?: ProcessSide;
+    toSide?: ProcessSide;
 }
 export interface ReversibleProcessEdit {
     undo(): void;
     redo(): void;
+    /** The already-applied edit's layout, recorded atomically with the document. */
+    layout?: ProcessLayout;
 }
 /** Host applies the edit, then calls accept with its inverse and replay. */
 export interface ProcessEditRequest extends ProcessEdit {

package/dist/patterns/process-modeler/process-modeler.d.ts

@@ -1,5 +1,6 @@
 import { BaseElement } from "../../core/index.js";
 import type { FlowKind, NodePath } from "../flow-builder/model.js";
+import type { ProcessConnection, ProcessVariable, ProcessLoadOptions } from "./model.js";
 import { ProcessHistory, type ProcessBox, type ProcessCheck, type ProcessEdit, type ProcessLayout, type ProcessModel, type ProcessProjection } from "./model.js";
 /** Projects host documents without owning workflow schemas or persistence. */
 export declare class ProcessModeler<D = ProcessProjection, N = unknown> extends BaseElement {
@@ -23,6 +24,40 @@ export declare class ProcessModeler<D = ProcessProjection, N = unknown> extends
     private drag?;
     private pinchDistance;
     private gestureZoom;
+    private insertion?;
+    private selectedIds;
+    private versionValue;
+    private lastProjection;
+    private lastDocument?;
+    private connectionsValue;
+    private variablesValue;
+    private activePane;
+    private portDrag?;
+    private marquee?;
+    private segmentDrag?;
+    private dropLine?;
+    private narrowValue;
+    private suppressClick;
+    private resizeObserver?;
+    private routedLines;
+    private computedChecks;
+    get selectedBoxes(): readonly ProcessBox<N>[];
+    get selectedPath(): NodePath | null;
+    set selectedPath(path: NodePath | null);
+    get connections(): readonly ProcessConnection[];
+    set connections(value: readonly ProcessConnection[]);
+    get variables(): readonly ProcessVariable[];
+    set variables(value: readonly ProcessVariable[]);
+    get version(): string | number;
+    get narrow(): boolean;
+    get positions(): readonly import("./model.js").ProcessPositionSnapshot[];
+    load(document: D, options?: ProcessLoadOptions): void;
+    selectMany(ids: readonly string[]): void;
+    get headingLevel(): number;
+    set headingLevel(value: number);
+    get disableConnections(): boolean;
+    set disableConnections(value: boolean);
+    private arrangedLayout;
     get document(): D | undefined;
     get history(): ProcessHistory;
     set history(value: ProcessHistory);
@@ -41,6 +76,7 @@ export declare class ProcessModeler<D = ProcessProjection, N = unknown> extends
     get renderInspector(): ((node: N, container: HTMLElement) => void | (() => void)) | undefined;
     set renderInspector(value: ((node: N, container: HTMLElement) => void | (() => void)) | undefined);
     disconnectedCallback(): void;
+    connectedCallback(): void;
     refresh(): void;
     select(id: string | null): void;
     setValidation(checks: readonly ProcessCheck[]): void;
@@ -50,6 +86,7 @@ export declare class ProcessModeler<D = ProcessProjection, N = unknown> extends
     redo(): void;
     private commitLayout;
     move(id: string, x: number, y: number): void;
+    private emitPositions;
     private translatedLayout;
     tidy(): void;
     resize(id: string, width: number, height: number): void;
@@ -63,13 +100,24 @@ export declare class ProcessModeler<D = ProcessProjection, N = unknown> extends
     fit(): void;
     private bounds;
     protected renderTemplate(): void;
+    private setupPanes;
+    private renderPane;
+    private selectionCommand;
     protected setupListeners(): void;
     private onKey;
     private pointerDown;
     private distance;
     private pointerMove;
     private pointerEnd;
+    private canvasPoint;
+    private boxAt;
+    private lineAt;
+    private markDropLine;
+    private alignedPoint;
+    private openChooser;
     protected update(): void;
+    private get allChecks();
+    private collectChecks;
     private renderWorld;
     private place;
     private renderPalette;