@squeed/flow-sdk 2.0.8 → 2.0.11

package/dist/index.d.cts

@@ -280,6 +280,7 @@ export declare interface FlowDiagramCallbacks {
     onNodeCreateRequest?: (request: FlowNodeCreationRequest) => boolean;
     onFormSchemaChange?: (schema: FormSchema | undefined) => void;
     onFormChange?: (event: FormChange) => FormEdit[] | void;
+    uploadFormFile?: (request: FormUploadRequest) => Promise<string> | string;
     resolveFormOptions?: (request: FormOptionsRequest) => Promise<FormOption[]> | FormOption[];
     onSpacingChange?: (spacing: NodeSpacing) => void;
     onEdgeRadiusChange?: (radius: number) => void;
@@ -619,7 +620,7 @@ export declare interface FlowEngine {
     /** Temporarily show only this branch and fit it, preserving graph data. */
     isolateBranch(id: string, padding?: number, animate?: boolean): void;
     /** End isolation and restore the viewport saved when isolation began. */
-    restoreView(animate?: boolean): void;
+    restoreView(animate?: boolean, state?: ViewportState): void;
     /** Hide/show edge paths, labels and hit targets without changing graph data. */
     setEdgesVisible(visible: boolean): void;
     clientToModel(clientX: number, clientY: number): Point;
@@ -697,6 +698,7 @@ bindings?: StateForms["bindings"];
 editable?: boolean;
 schema?: FormSchema;
 renderForm?: StateForms["renderForm"];
+onFieldCreate?: (change: FormChange, config: FormFieldConfig) => void;
 structured?: StructuredForms;
 references?: StateForms["references"];
 callbacks: FlowDiagramCallbacks;
@@ -714,7 +716,11 @@ export declare type FormEdit = {
 export declare interface FormFieldConfig {
     $label?: string;
     $section?: string;
-    $control?: "input" | "textarea" | "select" | "pills" | "checkbox";
+    $control?: "input" | "textarea" | "select" | "pills" | "checkbox" | "upload";
+    $upload?: {
+        accept?: string;
+        maxSizeBytes?: number;
+    };
     $visibleWhen?: FormCondition;
     $requiredWhen?: FormCondition;
     $options?: {
@@ -743,6 +749,11 @@ export declare type FormSchema = Record<string, Extract<ContractType, {
     kind: "object";
 }>>;
 
+export declare interface FormUploadRequest extends FormRequest {
+    file: File;
+    signal: AbortSignal;
+}
+
 export declare type FormValue = string | number | boolean | null;
 
 export declare function formValueError(type: ContractType, value: unknown, required: boolean): string | undefined;
@@ -800,6 +811,8 @@ export declare interface JsonStreamOptions<Document> {
 
 export declare type LayoutAlgorithm = "dagre" | "elk" | "tidytree" | "concentric" | "cose";
 
+export declare const LIGHT_BLACK = "#8c8c8d";
+
 export declare const NODE_TYPE_VIEWS: readonly ["", "icon-label", "object", "text"];
 
 export declare type NodeAlignment = "leading" | "center" | "trailing";
@@ -831,10 +844,12 @@ export declare function NodeFormPopover({ nodeAddress, active, label, open, onCl
     height?: number;
 }): JSX_2.Element;
 
-export declare function NodeIconPicker({ nodeId, edgeId, value, }: {
+export declare function NodeIconPicker({ nodeId, edgeId, value, open: requestedOpen, onOpenChange, }: {
     nodeId?: string;
     edgeId?: string;
     value?: string;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
 }): JSX_2.Element;
 
 /** Actions shown in the hover overlay above nodes */
@@ -871,7 +886,7 @@ export declare function NodeTools({ ids, onClose, }: {
 
 export declare type NodeTypeView = Exclude<(typeof NODE_TYPE_VIEWS)[number], "">;
 
-export declare const NodeView: MemoExoticComponent<({ data: nodeData, children, isInverted, isParent, }: NodeViewProps) => JSX_2.Element>;
+export declare const NodeView: MemoExoticComponent<({ data: nodeData, children, isInverted, isParent, onOpenView, editOnMount, }: NodeViewProps) => JSX_2.Element>;
 
 declare interface NodeViewChildArgs {
     id: string;
@@ -889,6 +904,8 @@ declare interface NodeViewProps {
     data: any;
     isInverted?: boolean;
     isParent?: boolean;
+    onOpenView?: () => void;
+    editOnMount?: boolean;
     children: (args: NodeViewChildArgs) => React.ReactNode;
 }
 
@@ -1153,7 +1170,7 @@ export declare function ToolbarScrollContainer({ children, background, border, }
     border: string;
 }): JSX_2.Element;
 
-export declare function ToolbarSelect({ children, value, onValueChange, disabled, style, title, icon, popupContent, labelCase, "aria-label": label, }: {
+export declare function ToolbarSelect({ children, value, onValueChange, disabled, style, title, icon, popupContent, labelCase, "aria-label": label, ...triggerProps }: {
     children: ReactNode;
     value: string;
     onValueChange: (value: string) => void;
@@ -1164,7 +1181,7 @@ export declare function ToolbarSelect({ children, value, onValueChange, disabled
     popupContent?: ReactNode;
     labelCase?: "title" | "preserve";
     "aria-label": string;
-}): JSX_2.Element;
+} & Pick<React.ComponentProps<"button">, "id" | "aria-required" | "aria-invalid" | "aria-describedby">): JSX_2.Element;
 
 export declare function ToolbarTooltip({ label, children, }: {
     label: string;

package/dist/index.d.ts

@@ -280,6 +280,7 @@ export declare interface FlowDiagramCallbacks {
     onNodeCreateRequest?: (request: FlowNodeCreationRequest) => boolean;
     onFormSchemaChange?: (schema: FormSchema | undefined) => void;
     onFormChange?: (event: FormChange) => FormEdit[] | void;
+    uploadFormFile?: (request: FormUploadRequest) => Promise<string> | string;
     resolveFormOptions?: (request: FormOptionsRequest) => Promise<FormOption[]> | FormOption[];
     onSpacingChange?: (spacing: NodeSpacing) => void;
     onEdgeRadiusChange?: (radius: number) => void;
@@ -619,7 +620,7 @@ export declare interface FlowEngine {
     /** Temporarily show only this branch and fit it, preserving graph data. */
     isolateBranch(id: string, padding?: number, animate?: boolean): void;
     /** End isolation and restore the viewport saved when isolation began. */
-    restoreView(animate?: boolean): void;
+    restoreView(animate?: boolean, state?: ViewportState): void;
     /** Hide/show edge paths, labels and hit targets without changing graph data. */
     setEdgesVisible(visible: boolean): void;
     clientToModel(clientX: number, clientY: number): Point;
@@ -697,6 +698,7 @@ bindings?: StateForms["bindings"];
 editable?: boolean;
 schema?: FormSchema;
 renderForm?: StateForms["renderForm"];
+onFieldCreate?: (change: FormChange, config: FormFieldConfig) => void;
 structured?: StructuredForms;
 references?: StateForms["references"];
 callbacks: FlowDiagramCallbacks;
@@ -714,7 +716,11 @@ export declare type FormEdit = {
 export declare interface FormFieldConfig {
     $label?: string;
     $section?: string;
-    $control?: "input" | "textarea" | "select" | "pills" | "checkbox";
+    $control?: "input" | "textarea" | "select" | "pills" | "checkbox" | "upload";
+    $upload?: {
+        accept?: string;
+        maxSizeBytes?: number;
+    };
     $visibleWhen?: FormCondition;
     $requiredWhen?: FormCondition;
     $options?: {
@@ -743,6 +749,11 @@ export declare type FormSchema = Record<string, Extract<ContractType, {
     kind: "object";
 }>>;
 
+export declare interface FormUploadRequest extends FormRequest {
+    file: File;
+    signal: AbortSignal;
+}
+
 export declare type FormValue = string | number | boolean | null;
 
 export declare function formValueError(type: ContractType, value: unknown, required: boolean): string | undefined;
@@ -800,6 +811,8 @@ export declare interface JsonStreamOptions<Document> {
 
 export declare type LayoutAlgorithm = "dagre" | "elk" | "tidytree" | "concentric" | "cose";
 
+export declare const LIGHT_BLACK = "#8c8c8d";
+
 export declare const NODE_TYPE_VIEWS: readonly ["", "icon-label", "object", "text"];
 
 export declare type NodeAlignment = "leading" | "center" | "trailing";
@@ -831,10 +844,12 @@ export declare function NodeFormPopover({ nodeAddress, active, label, open, onCl
     height?: number;
 }): JSX_2.Element;
 
-export declare function NodeIconPicker({ nodeId, edgeId, value, }: {
+export declare function NodeIconPicker({ nodeId, edgeId, value, open: requestedOpen, onOpenChange, }: {
     nodeId?: string;
     edgeId?: string;
     value?: string;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
 }): JSX_2.Element;
 
 /** Actions shown in the hover overlay above nodes */
@@ -871,7 +886,7 @@ export declare function NodeTools({ ids, onClose, }: {
 
 export declare type NodeTypeView = Exclude<(typeof NODE_TYPE_VIEWS)[number], "">;
 
-export declare const NodeView: MemoExoticComponent<({ data: nodeData, children, isInverted, isParent, }: NodeViewProps) => JSX_2.Element>;
+export declare const NodeView: MemoExoticComponent<({ data: nodeData, children, isInverted, isParent, onOpenView, editOnMount, }: NodeViewProps) => JSX_2.Element>;
 
 declare interface NodeViewChildArgs {
     id: string;
@@ -889,6 +904,8 @@ declare interface NodeViewProps {
     data: any;
     isInverted?: boolean;
     isParent?: boolean;
+    onOpenView?: () => void;
+    editOnMount?: boolean;
     children: (args: NodeViewChildArgs) => React.ReactNode;
 }
 
@@ -1153,7 +1170,7 @@ export declare function ToolbarScrollContainer({ children, background, border, }
     border: string;
 }): JSX_2.Element;
 
-export declare function ToolbarSelect({ children, value, onValueChange, disabled, style, title, icon, popupContent, labelCase, "aria-label": label, }: {
+export declare function ToolbarSelect({ children, value, onValueChange, disabled, style, title, icon, popupContent, labelCase, "aria-label": label, ...triggerProps }: {
     children: ReactNode;
     value: string;
     onValueChange: (value: string) => void;
@@ -1164,7 +1181,7 @@ export declare function ToolbarSelect({ children, value, onValueChange, disabled
     popupContent?: ReactNode;
     labelCase?: "title" | "preserve";
     "aria-label": string;
-}): JSX_2.Element;
+} & Pick<React.ComponentProps<"button">, "id" | "aria-required" | "aria-invalid" | "aria-describedby">): JSX_2.Element;
 
 export declare function ToolbarTooltip({ label, children, }: {
     label: string;