statelyai 0.11.5 → 0.12.0

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { Command } from "@oclif/core";
 import { z } from "zod";
+import { StatelyGraph } from "@statelyai/sdk/graph";
 import { ConnectedRepo, CreateProjectInput, OAuthAuthorizationServerMetadata, OAuthProtectedResourceMetadata, ProjectData, ProjectMachineSummary, StudioClient } from "@statelyai/sdk";
-import { SyncPlan } from "@statelyai/sdk/sync";
 import * as _oclif_core_interfaces0 from "@oclif/core/interfaces";
 
 //#region src/verifyCommand.d.ts
@@ -71,6 +71,207 @@ declare function createStatelyProjectConfig(options: {
   defaultXStateVersion?: number;
 }): StatelyProjectConfig;
 //#endregion
+//#region ../../node_modules/.pnpm/@statelyai+graph@2.1.0_@statelyai+layout@0.1.2_cytoscape@3.34.0_d3-force@3.0.0_d3-hiera_3600605a69f548f83255fd3d12957cf4/node_modules/@statelyai/graph/dist/types-BAEQTwK_.d.mts
+//#region src/types.d.ts
+/**
+ * Directedness of a graph or an individual edge.
+ *
+ * - `'directed'` — edge points from source to target.
+ * - `'undirected'` — edge has no direction; traversable both ways.
+ * - `'bidirectional'` — edge points both ways (arrows on both ends).
+ *
+ * Set at the graph level as the default ({@link Graph.mode}); individual edges
+ * may override it ({@link GraphEdge.mode}).
+ */
+type GraphMode = 'directed' | 'undirected' | 'bidirectional';
+/** A 2D point, used for edge routing waypoints. */
+interface Point {
+  x: number;
+  y: number;
+}
+/**
+ * How an edge's {@link GraphEdge.points} should be interpreted by renderers:
+ *
+ * - `'polyline'` — straight segments through the points.
+ * - `'orthogonal'` — axis-aligned segments (ELK layered routing).
+ * - `'splines'` — bezier control points (Graphviz convention: 3n+1 chained
+ *   cubic curves, tail → head).
+ */
+type EdgeRouting = 'polyline' | 'orthogonal' | 'splines';
+/** Shared optional visual/style props for nodes, edges, ports. */
+interface GraphEntity {
+  x?: number;
+  y?: number;
+  width?: number;
+  height?: number;
+  style?: Record<string, string | number | boolean>;
+}
+/** Visual entity base — required position/size. */
+type PortDirection = 'in' | 'out' | 'inout';
+interface PortConfig<TPortData = any> extends GraphEntity {
+  name: string;
+  direction?: PortDirection;
+  label?: string;
+  data?: TPortData;
+}
+interface GraphPort<TPortData = any> extends GraphEntity {
+  name: string;
+  direction: PortDirection;
+  label?: string;
+  data: TPortData;
+}
+interface NodeConfig<TNodeData = any, TPortData = any> extends GraphEntity {
+  id: string;
+  parentId?: string | null;
+  initialNodeId?: string | null;
+  label?: string | null;
+  data?: TNodeData;
+  ports?: PortConfig<TPortData>[];
+  shape?: string;
+  color?: string;
+}
+/**
+ * Note on edge geometry: an edge's `x`/`y`/`width`/`height` are canonically
+ * the **label rect** (top-left + size). Layout adapters write computed edge
+ * label positions here, and engines that need label dimensions as input
+ * (dagre, ELK) read `width`/`height`. The edge's *route* lives in
+ * {@link EdgeConfig.points}.
+ */
+interface EdgeConfig<TEdgeData = any> extends GraphEntity {
+  /**
+   * The id of the edge.
+   */
+  id: string;
+  /**
+   * The id of the source node.
+   */
+  sourceId: string;
+  /**
+   * The id of the target node.
+   */
+  targetId: string;
+  /**
+   * The label of the edge.
+   */
+  label?: string | null;
+  /**
+   * Optional numeric weight for the edge.
+   * Used by pathfinding, MST, and other weighted algorithms.
+   * When `getWeight` is not provided, algorithms default to `edge.weight ?? 1`.
+   */
+  weight?: number;
+  /** Port name on the source node this edge connects from. */
+  sourcePort?: string;
+  /** Port name on the target node this edge connects to. */
+  targetPort?: string;
+  /**
+   * Per-edge directedness override. When absent, the edge inherits the graph's
+   * {@link GraphConfig.mode}.
+   */
+  mode?: GraphMode;
+  /**
+   * Edge route waypoints (including endpoints, tail → head), as computed by a
+   * layout engine. Interpretation is governed by {@link EdgeConfig.routing}.
+   */
+  points?: Point[];
+  /** How {@link EdgeConfig.points} should be interpreted. Default: polyline. */
+  routing?: EdgeRouting;
+  data?: TEdgeData;
+  color?: string;
+}
+interface GraphNode<TNodeData = any, TPortData = any> extends GraphEntity {
+  type: 'node';
+  id: string;
+  parentId?: string | null;
+  initialNodeId?: string | null;
+  label?: string | null;
+  data: TNodeData;
+  ports?: GraphPort<TPortData>[];
+  shape?: string;
+  color?: string;
+}
+/**
+ * Note on edge geometry: an edge's `x`/`y`/`width`/`height` are canonically
+ * the **label rect** (top-left + size); the edge's *route* lives in
+ * {@link GraphEdge.points}. See {@link EdgeConfig} for details.
+ */
+interface GraphEdge<TEdgeData = any> extends GraphEntity {
+  type: 'edge';
+  id: string;
+  sourceId: string;
+  targetId: string;
+  label?: string | null;
+  /**
+   * Optional numeric weight for the edge.
+   * Used by pathfinding, MST, and other weighted algorithms.
+   * When `getWeight` is not provided, algorithms default to `edge.weight ?? 1`.
+   */
+  weight?: number;
+  /** Port name on the source node this edge connects from. */
+  sourcePort?: string;
+  /** Port name on the target node this edge connects to. */
+  targetPort?: string;
+  /**
+   * Per-edge directedness override. When absent, the edge inherits the graph's
+   * {@link Graph.mode}.
+   */
+  mode?: GraphMode;
+  /**
+   * Edge route waypoints (including endpoints, tail → head), as computed by a
+   * layout engine. Interpretation is governed by {@link GraphEdge.routing}.
+   */
+  points?: Point[];
+  /** How {@link GraphEdge.points} should be interpreted. Default: polyline. */
+  routing?: EdgeRouting;
+  data: TEdgeData;
+  color?: string;
+}
+interface NodeChange<TNodeData = any> {
+  id: string;
+  old: Partial<GraphNode<TNodeData>>;
+  new: Partial<GraphNode<TNodeData>>;
+}
+interface EdgeChange<TEdgeData = any> {
+  id: string;
+  old: Partial<GraphEdge<TEdgeData>>;
+  new: Partial<GraphEdge<TEdgeData>>;
+}
+interface GraphDiff<TNodeData = any, TEdgeData = any> {
+  nodes: {
+    added: NodeConfig<TNodeData>[];
+    removed: NodeConfig<TNodeData>[];
+    updated: NodeChange<TNodeData>[];
+  };
+  edges: {
+    added: EdgeConfig<TEdgeData>[];
+    removed: EdgeConfig<TEdgeData>[];
+    updated: EdgeChange<TEdgeData>[];
+  };
+}
+//#endregion
+//#region ../editor-sync/dist/sync.d.mts
+type ResolvedSyncInputKind = 'local-file' | 'studio-machine-id' | 'studio-url';
+type SyncInputFormat = 'digraph' | 'graph' | 'xstate';
+interface ResolvedSyncInput {
+  kind: ResolvedSyncInputKind;
+  locator: string;
+  format: SyncInputFormat;
+  graph: StatelyGraph;
+  remoteMachineId?: string;
+}
+interface SyncPlanSummary {
+  hasChanges: boolean;
+  nodeChanges: number;
+  edgeChanges: number;
+}
+interface SyncPlan {
+  source: ResolvedSyncInput;
+  target: ResolvedSyncInput;
+  diff: GraphDiff;
+  summary: SyncPlanSummary;
+  warnings: string[];
+}
+//#endregion
 //#region src/cli.d.ts
 interface InitProjectOptions {
   apiKey?: string;
@@ -99,6 +300,7 @@ interface DiscoveredMachine {
   line: number;
   machineIndex: number;
   name: string;
+  sourceReference?: string;
   relativePath: string;
 }
 interface LinkedPullTarget {
@@ -336,6 +538,7 @@ declare class OpenCommand extends Command {
   };
   run(): Promise<void>;
 }
+declare function resolveOpenRootDir(cwd: string, fileArg?: string): string;
 declare class InitCommand extends Command {
   static enableJsonFlag: boolean;
   static summary: string;
@@ -1340,4 +1543,4 @@ declare function verifyProject(options?: VerifyProjectOptions): Promise<{
 /** One case per recorded path/probe. Unattributed divergences remain separate cases. */
 declare function formatVerificationJUnit(report: VerificationRunReport): string;
 //#endregion
-export { ApiKeyResolution, COMMANDS, CredentialStatus, DiscoveredMachine, InitProjectOptions, InitProjectResult, LinkedPullTarget, OAuthLoginDiscovery, ProjectMachineStatus, ProjectStatusMachine, ProjectStatusResult, PushCandidateClassification, RemoteProjectMachineTarget, ResolveApiKeyOptions, ResolvedConfiguredPullTargets, ScanProjectSourcesOptions, type VerificationExecutor, type VerificationRequest, type VerificationRunReport, type VerifyProjectOptions, buildOAuthLoginStart, classifyPushCandidates, createStatelyProjectConfig, discoverLinkedPullTargets, discoverMachinesInSource, discoverOAuthLogin, discoverRemoteProjectMachineTargets, formatDiscoveredMachines, formatMissingNewMachineDirMessage, formatPlanSummary, formatProjectStatus, formatStoredCredentialSource, formatVerificationJUnit, getEnvApiKey, getEnvCredential, inferInitProjectName, initProject, isFileGitDirty, resolveApiKey, resolveConfiguredPullTargets, resolveCredentialStatus, resolveProjectStatus, resolveVerificationRequest, run, scanProjectMachines, scanProjectSources, verifyProject };
+export { ApiKeyResolution, COMMANDS, CredentialStatus, DiscoveredMachine, InitProjectOptions, InitProjectResult, LinkedPullTarget, OAuthLoginDiscovery, ProjectMachineStatus, ProjectStatusMachine, ProjectStatusResult, PushCandidateClassification, RemoteProjectMachineTarget, ResolveApiKeyOptions, ResolvedConfiguredPullTargets, ScanProjectSourcesOptions, type VerificationExecutor, type VerificationRequest, type VerificationRunReport, type VerifyProjectOptions, buildOAuthLoginStart, classifyPushCandidates, createStatelyProjectConfig, discoverLinkedPullTargets, discoverMachinesInSource, discoverOAuthLogin, discoverRemoteProjectMachineTargets, formatDiscoveredMachines, formatMissingNewMachineDirMessage, formatPlanSummary, formatProjectStatus, formatStoredCredentialSource, formatVerificationJUnit, getEnvApiKey, getEnvCredential, inferInitProjectName, initProject, isFileGitDirty, resolveApiKey, resolveConfiguredPullTargets, resolveCredentialStatus, resolveOpenRootDir, resolveProjectStatus, resolveVerificationRequest, run, scanProjectMachines, scanProjectSources, verifyProject };

package/dist/index.mjs

@@ -1,3 +1,3 @@
-import { C as scanProjectMachines, D as formatVerificationJUnit, E as verifyProject, O as createStatelyProjectConfig, S as run, T as resolveVerificationRequest, _ as isFileGitDirty, a as discoverMachinesInSource, b as resolveCredentialStatus, c as formatDiscoveredMachines, d as formatProjectStatus, f as formatStoredCredentialSource, g as initProject, h as inferInitProjectName, i as discoverLinkedPullTargets, l as formatMissingNewMachineDirMessage, m as getEnvCredential, n as buildOAuthLoginStart, o as discoverOAuthLogin, p as getEnvApiKey, r as classifyPushCandidates, s as discoverRemoteProjectMachineTargets, t as COMMANDS, u as formatPlanSummary, v as resolveApiKey, w as scanProjectSources, x as resolveProjectStatus, y as resolveConfiguredPullTargets } from "./cli-DNPoG2A0.mjs";
+import { C as run, D as verifyProject, E as resolveVerificationRequest, O as formatVerificationJUnit, S as resolveProjectStatus, T as scanProjectSources, _ as isFileGitDirty, a as discoverMachinesInSource, b as resolveCredentialStatus, c as formatDiscoveredMachines, d as formatProjectStatus, f as formatStoredCredentialSource, g as initProject, h as inferInitProjectName, i as discoverLinkedPullTargets, k as createStatelyProjectConfig, l as formatMissingNewMachineDirMessage, m as getEnvCredential, n as buildOAuthLoginStart, o as discoverOAuthLogin, p as getEnvApiKey, r as classifyPushCandidates, s as discoverRemoteProjectMachineTargets, t as COMMANDS, u as formatPlanSummary, v as resolveApiKey, w as scanProjectMachines, x as resolveOpenRootDir, y as resolveConfiguredPullTargets } from "./cli-Dr85YlA5.mjs";
 
-export { COMMANDS, buildOAuthLoginStart, classifyPushCandidates, createStatelyProjectConfig, discoverLinkedPullTargets, discoverMachinesInSource, discoverOAuthLogin, discoverRemoteProjectMachineTargets, formatDiscoveredMachines, formatMissingNewMachineDirMessage, formatPlanSummary, formatProjectStatus, formatStoredCredentialSource, formatVerificationJUnit, getEnvApiKey, getEnvCredential, inferInitProjectName, initProject, isFileGitDirty, resolveApiKey, resolveConfiguredPullTargets, resolveCredentialStatus, resolveProjectStatus, resolveVerificationRequest, run, scanProjectMachines, scanProjectSources, verifyProject };
+export { COMMANDS, buildOAuthLoginStart, classifyPushCandidates, createStatelyProjectConfig, discoverLinkedPullTargets, discoverMachinesInSource, discoverOAuthLogin, discoverRemoteProjectMachineTargets, formatDiscoveredMachines, formatMissingNewMachineDirMessage, formatPlanSummary, formatProjectStatus, formatStoredCredentialSource, formatVerificationJUnit, getEnvApiKey, getEnvCredential, inferInitProjectName, initProject, isFileGitDirty, resolveApiKey, resolveConfiguredPullTargets, resolveCredentialStatus, resolveOpenRootDir, resolveProjectStatus, resolveVerificationRequest, run, scanProjectMachines, scanProjectSources, verifyProject };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "statelyai",
-  "version": "0.11.5",
+  "version": "0.12.0",
   "description": "Command-line tools for Stately",
   "license": "MIT",
   "bin": {
@@ -24,13 +24,14 @@
     "typescript": "^5.9.3",
     "ws": "^8.21.0",
     "zod": "^4.4.1",
-    "@statelyai/sdk": "0.34.2"
+    "@statelyai/sdk": "0.36.0"
   },
   "devDependencies": {
     "@types/ws": "^8.18.1",
     "tsdown": "0.21.0-beta.2",
     "vitest": "^3.2.4",
-    "@statelyai/api-contract": "0.5.2"
+    "@statelyai/api-contract": "0.5.3",
+    "@statelyai/editor-sync": "0.1.41"
   },
   "oclif": {
     "bin": "statelyai",