@unofficialbox/box-open-elements 0.34.0 → 0.36.0

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

@@ -14,6 +14,9 @@ export interface ProcessBox<N = unknown> {
     node: N;
     kind: string;
     title: string;
+    /** Graph notes keep box identity but are not workflow steps. */
+    role?: "flow" | "note";
+    /** For graph notes, the visible note text (title is the fallback). */
     description?: string;
     /** Description used in Technical view; absent values fall back to description. */
     technicalDescription?: string;
@@ -40,6 +43,8 @@ export interface ProcessBox<N = unknown> {
 }
 export interface ProcessLine {
     id: string;
+    /** Associations attach graph notes without participating in workflow flow. */
+    role?: "flow" | "association";
     from: string;
     to: string;
     label?: string;
@@ -54,6 +59,9 @@ export interface ProcessLine {
     /** Optional last-run traffic share, between 0 and 1. */
     share?: number;
 }
+/** Semantic eligibility is independent of host kind names. */
+export declare const isFlowBox: (box: ProcessBox) => boolean;
+export declare const isFlowLine: (line: ProcessLine) => boolean;
 export type ProcessSide = "north" | "east" | "south" | "west";
 export interface ProcessConnection {
     name: string;
@@ -148,19 +156,58 @@ export interface ProcessExpressionField {
 export interface ProcessField {
     key: string;
     label: string;
-    kind: "text" | "multiline" | "number" | "choice" | "boolean" | "expression" | "search" | "action";
+    kind: "text" | "multiline" | "number" | "choice" | "boolean" | "expression" | "search" | "action" | "time" | "datetime-local";
     value: string | number | boolean;
     description?: string;
     options?: readonly {
         value: string;
         label: string;
         group?: string;
+        description?: string;
+    }[];
+    /** Action category order and optional headings supplied by the host catalog. */
+    actionGroups?: readonly {
+        name: string;
+        heading?: string;
     }[];
+    /** Permit a dotted action key absent from the host catalog. The host validates it. */
+    allowCustomValue?: boolean;
     placeholder?: string;
     required?: boolean;
     disabled?: boolean;
     problem?: string;
     expression?: ProcessExpressionField;
+    /** Visible rows for multiline fields. Expression fields use expression.rows. */
+    rows?: number;
+    /** Monospace presentation for host-owned code or structured text. */
+    format?: 'code';
+    /** Native constraints for number fields; the host still validates edits. */
+    min?: number;
+    max?: number;
+    step?: number | 'any';
+    /** Adjacent fields with the same key share a titled section. */
+    section?: {
+        key: string;
+        title: string;
+        description?: string;
+        descriptionSegments?: ProcessTechnicalDetail['segments'];
+    };
+    /** Adjacent fields with the same key share a native disclosure. */
+    disclosure?: {
+        key: string;
+        summary: string;
+        open?: boolean;
+    };
+    /** Adjacent fields with the same key share a row; default columns are equal. */
+    row?: {
+        key: string;
+        leadingWidth?: number;
+        gap?: number;
+    };
+    /** A visible optional marker, independent of native required validation. */
+    optional?: boolean;
+    /** Plain-text type/location hint after validation feedback. */
+    annotation?: string;
 }
 export interface ProcessPositionSnapshot {
     path?: NodePath;
@@ -182,6 +229,8 @@ export interface ProcessProjection<N = unknown> {
     lines: readonly ProcessLine[];
 }
 export interface ProcessKind extends FlowKind {
+    /** False for metadata-only kinds that must not appear in Add or insert choices. */
+    addable?: boolean;
     /** Alternative terms included in palette search. */
     aliases?: readonly string[];
     /** Host kind names never dictate the reusable visual anatomy. */
@@ -291,7 +340,7 @@ export type ProcessSelectionItem = {
     readonly id: string;
 };
 export interface ProcessEdit {
-    type: "add" | "delete" | "duplicate" | "connect" | "disconnect" | "reattach" | "insert" | "reparent" | "reset-line" | "tidy" | "make-section" | "delete-selection";
+    type: "add" | "delete" | "duplicate" | "connect" | "disconnect" | "reattach" | "insert" | "reparent" | "reset-line" | "tidy" | "make-section" | "delete-selection" | "edit-line";
     /** One atomic mixed deletion; the host owns protected roots, descendants,
      * incident edges and notes. Unsupported hosts must leave it unapplied. */
     selection?: readonly ProcessSelectionItem[];
@@ -308,6 +357,9 @@ export interface ProcessEdit {
     from?: string;
     to?: string;
     lineId?: string;
+    /** Host-owned branch presentation; edit-line preserves endpoints and routing. */
+    label?: string;
+    weight?: number;
     kind?: FlowKind;
     position?: BoxPosition;
     /** Optional for existing hosts; all built-in insertion producers supply intent. */

package/dist/patterns/process-modeler/model.js

@@ -1,3 +1,6 @@
+/** Semantic eligibility is independent of host kind names. */
+export const isFlowBox = (box) => box.role !== "note";
+export const isFlowLine = (line) => line.role !== "association";
 export function validateProjection(projection) {
     const ids = new Set();
     for (const box of projection.boxes) {
@@ -35,7 +38,7 @@ export function completeLayout(projection, layout) {
             .filter((child) => child.parentId === box.id)
             .map(measure);
         const size = {
-            width: Math.max(box.frame || box.shape === "frame" ? 320 : box.shape === "gateway" || box.shape === "event" ? 56 : 224, ...children.map((child) => child.width + 40)),
+            width: Math.max(box.frame || box.shape === "frame" ? 320 : box.shape === "gateway" || box.shape === "event" ? 56 : box.role === "note" ? 208 : 224, ...children.map((child) => child.width + 40)),
             height: box.frame
                 ? Math.max(180, 64 + children.reduce((sum, child) => sum + child.height + 24, 0))
                 : box.shape === "gateway" || box.shape === "event" ? 56 : 64,
@@ -49,13 +52,30 @@ export function completeLayout(projection, layout) {
         let y = top;
         for (const box of siblings) {
             const size = sizes.get(box.id);
-            boxes[box.id] ??= { x, y, ...size };
+            if (!boxes[box.id]) {
+                if (box.role === "note") {
+                    // Flow ranks are already placed; unplaced graph notes need free space
+                    // regardless of their order in the projection.
+                    const ancestors = new Set();
+                    for (let parent = box.parentId; parent; parent = projection.boxes.find(b => b.id === parent)?.parentId)
+                        ancestors.add(parent);
+                    let overlaps;
+                    do {
+                        overlaps = Object.entries(boxes).filter(([id]) => !ancestors.has(id)).map(([, p]) => p).filter(p => x < p.x + (p.width ?? 224) && x + size.width > p.x && y < p.y + (p.height ?? 64) && y + size.height > p.y);
+                        if (overlaps.length)
+                            y = Math.max(...overlaps.map(p => p.y + (p.height ?? 64))) + 60;
+                    } while (overlaps.length);
+                    boxes[box.id] = { x, y, width: size.width };
+                }
+                else
+                    boxes[box.id] = { x, y, ...size };
+            }
             const position = boxes[box.id];
             place(projection.boxes.filter((child) => child.parentId === box.id), position.x + 20, position.y + 64);
             y += (position.height ?? size.height) + 60;
         }
     };
-    place(roots, 40, 40);
+    place([...roots.filter(box => box.role !== "note"), ...roots.filter(box => box.role === "note")], 40, 40);
     return { ...layout, boxes };
 }
 /** Bounded history shared by layout edits and host-accepted document commands. */

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

@@ -60,6 +60,10 @@ export declare class ProcessModeler<D = ProcessProjection, N = unknown> extends
     private checks;
     private renderer?;
     private cleanupInspector?;
+    private inspectorFieldCleanups;
+    private pendingActionChoice?;
+    private quietActionFocus;
+    private cleanupInspectorFields;
     private inspected?;
     private inspectedId?;
     private inspectedControls;
@@ -95,6 +99,7 @@ export declare class ProcessModeler<D = ProcessProjection, N = unknown> extends
     private readableValue;
     private lastDocument?;
     private connectionsValue;
+    private connectionsHelpValue;
     private variablesValue;
     private variablesEditableValue;
     private outlineValue;
@@ -117,6 +122,8 @@ export declare class ProcessModeler<D = ProcessProjection, N = unknown> extends
     private narrowValue;
     private suppressClick;
     private resizeObserver?;
+    private autoNoteHeights;
+    private unplacedNotes;
     private routedLines;
     private computedChecks;
     get selectedBoxes(): readonly ProcessBox<N>[];
@@ -125,6 +132,9 @@ export declare class ProcessModeler<D = ProcessProjection, N = unknown> extends
     set selectedPath(path: NodePath | null);
     get connections(): readonly ProcessConnection[];
     set connections(value: readonly ProcessConnection[]);
+    /** Plain-text help describing where this host owns connection setup. */
+    get connectionsHelp(): string;
+    set connectionsHelp(value: string);
     get variables(): readonly ProcessVariable[];
     set variables(value: readonly ProcessVariable[]);
     private pendingVariableRename?;
@@ -254,6 +264,7 @@ export declare class ProcessModeler<D = ProcessProjection, N = unknown> extends
     private navigateSelection;
     private revealBox;
     private pointerDown;
+    private selectMarquee;
     private distance;
     private pointerMove;
     private pointerEnd;
@@ -276,6 +287,7 @@ export declare class ProcessModeler<D = ProcessProjection, N = unknown> extends
     private addLayoutKind;
     private showConnectTooltip;
     protected update(): void;
+    private measureGraphNotes;
     private get allChecks();
     private collectChecks;
     private renderWorld;
@@ -290,7 +302,9 @@ export declare class ProcessModeler<D = ProcessProjection, N = unknown> extends
     private finishPalettePointer;
     private renderPalette;
     private renderChecks;
+    private renderFields;
     private renderField;
+    private renderLeadsTo;
     private renderSelection;
     private renderLocalVariables;
     private requestLocalVariableEdit;