@qontinui/shared-types 0.2.4 → 0.3.0

package/src/runner/_api.ts

@@ -1,14 +1,14 @@
-/**
- * Runner Types
- *
- * Canonical wire-format types for a registered runner. One row per registered
- * runner; the same shape is served to every consumer (mobile, web, runner UI).
- *
- * Types generated from Rust (source of truth:
- * `qontinui-schemas/rust/src/runner.rs`). Do not edit by hand — regenerate via
- * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
- */
-export type { Runner } from "../generated/Runner";
-export type { RunnerStatus } from "../generated/RunnerStatus";
-export type { RunnerUiError } from "../generated/RunnerUiError";
-export type { RunnerCrash } from "../generated/RunnerCrash";
+/**
+ * Runner Types
+ *
+ * Canonical wire-format types for a registered runner. One row per registered
+ * runner; the same shape is served to every consumer (mobile, web, runner UI).
+ *
+ * Types generated from Rust (source of truth:
+ * `qontinui-schemas/rust/src/runner.rs`). Do not edit by hand — regenerate via
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+export type { Runner } from "../generated/Runner";
+export type { RunnerStatus } from "../generated/RunnerStatus";
+export type { RunnerUiError } from "../generated/RunnerUiError";
+export type { RunnerCrash } from "../generated/RunnerCrash";

package/src/runner/index.ts

@@ -1 +1 @@
-export * from "./_api";
+export * from "./_api";

package/src/scheduler/_api.ts

@@ -1,21 +1,21 @@
-// Types generated from Rust (source of truth: qontinui-schemas/rust/src/scheduler.rs).
-// Do not edit by hand — regenerate via `just generate-types` (or
-// `qontinui-runner/src-tauri/scripts/generate_types.sh`).
-export type { ScheduleExpression } from "../generated/ScheduleExpression";
-export type { ConditionScheduleConfig } from "../generated/ConditionScheduleConfig";
-export type { ScheduleConditions } from "../generated/ScheduleConditions";
-export type { IdleCondition } from "../generated/IdleCondition";
-export type { RepositoryInactiveCondition } from "../generated/RepositoryInactiveCondition";
-export type { RepositoryWatch } from "../generated/RepositoryWatch";
-export type { ConditionStatus } from "../generated/ConditionStatus";
-export type { ScheduledTask } from "../generated/ScheduledTask";
-export type { ScheduledTaskType } from "../generated/ScheduledTaskType";
-export type { ScheduledTaskStatus } from "../generated/ScheduledTaskStatus";
-export type { TaskExecutionRecord } from "../generated/TaskExecutionRecord";
-export type { SchedulerSettings } from "../generated/SchedulerSettings";
-export type { SchedulerStatus } from "../generated/SchedulerStatus";
-export type { NextTaskInfo } from "../generated/NextTaskInfo";
-export type { CreateScheduledTaskRequest } from "../generated/CreateScheduledTaskRequest";
-export type { UpdateScheduledTaskRequest } from "../generated/UpdateScheduledTaskRequest";
-export type { CatchUpPolicy } from "../generated/CatchUpPolicy";
-export type { McpConnectionRef } from "../generated/McpConnectionRef";
+// Types generated from Rust (source of truth: qontinui-schemas/rust/src/scheduler.rs).
+// Do not edit by hand — regenerate via `just generate-types` (or
+// `qontinui-runner/src-tauri/scripts/generate_types.sh`).
+export type { ScheduleExpression } from "../generated/ScheduleExpression";
+export type { ConditionScheduleConfig } from "../generated/ConditionScheduleConfig";
+export type { ScheduleConditions } from "../generated/ScheduleConditions";
+export type { IdleCondition } from "../generated/IdleCondition";
+export type { RepositoryInactiveCondition } from "../generated/RepositoryInactiveCondition";
+export type { RepositoryWatch } from "../generated/RepositoryWatch";
+export type { ConditionStatus } from "../generated/ConditionStatus";
+export type { ScheduledTask } from "../generated/ScheduledTask";
+export type { ScheduledTaskType } from "../generated/ScheduledTaskType";
+export type { ScheduledTaskStatus } from "../generated/ScheduledTaskStatus";
+export type { TaskExecutionRecord } from "../generated/TaskExecutionRecord";
+export type { SchedulerSettings } from "../generated/SchedulerSettings";
+export type { SchedulerStatus } from "../generated/SchedulerStatus";
+export type { NextTaskInfo } from "../generated/NextTaskInfo";
+export type { CreateScheduledTaskRequest } from "../generated/CreateScheduledTaskRequest";
+export type { UpdateScheduledTaskRequest } from "../generated/UpdateScheduledTaskRequest";
+export type { CatchUpPolicy } from "../generated/CatchUpPolicy";
+export type { McpConnectionRef } from "../generated/McpConnectionRef";

package/src/scheduler/index.ts

@@ -1 +1 @@
-export * from "./_api";
+export * from "./_api";

package/src/state-machine/_api.ts

@@ -1,145 +1,145 @@
-/**
- * Unified State Machine types for the Qontinui ecosystem.
- *
- * These types are the single source of truth for state machine data structures
- * used by both qontinui-web and qontinui-runner. They use snake_case to match
- * the API/database layer.
- *
- * Architecture:
- * - Config: A named state machine configuration (collection of states + transitions)
- * - State: A UI state defined by which elements are present
- * - Transition: A named action sequence that moves between states
- * - Action: A single UI interaction (click, type, navigate, etc.)
- *
- * Runtime navigation (pathfinding through states) is handled by the qontinui
- * Python library using multistate. The TypeScript pathfinding types here are
- * for the graph editor's path preview only.
- *
- * Most wire types in this module are generated from Rust (source of truth:
- * qontinui-schemas/rust/src/state_machine.rs). Do not edit those by hand —
- * regenerate via `just generate-types` (or the runner's generate_types.sh).
- * A small number of UI-only sugar types remain hand-authored below.
- */
-
-// =============================================================================
-// Action Types
-// =============================================================================
-
-export type { StandardActionType } from "../generated/StandardActionType";
-export type { Point } from "../generated/Point";
-export type { ScrollDirection } from "../generated/ScrollDirection";
-export type { MouseButton } from "../generated/MouseButton";
-export type { TransitionActionValue } from "../generated/TransitionActionValue";
-export type { TransitionAction } from "../generated/TransitionAction";
-
-// =============================================================================
-// Domain Knowledge
-// =============================================================================
-
-export type { DomainKnowledge } from "../generated/DomainKnowledge";
-
-// =============================================================================
-// State Machine Config
-// =============================================================================
-
-export type { StateMachineConfig } from "../generated/StateMachineConfig";
-export type { StateMachineConfigCreate } from "../generated/StateMachineConfigCreate";
-export type { StateMachineConfigUpdate } from "../generated/StateMachineConfigUpdate";
-export type { StateMachineConfigFull } from "../generated/StateMachineConfigFull";
-
-// =============================================================================
-// State
-// =============================================================================
-
-export type { StateMachineState } from "../generated/StateMachineState";
-export type { StateMachineStateCreate } from "../generated/StateMachineStateCreate";
-export type { StateMachineStateUpdate } from "../generated/StateMachineStateUpdate";
-
-// =============================================================================
-// Transition
-// =============================================================================
-
-export type { StateMachineTransition } from "../generated/StateMachineTransition";
-export type { StateMachineTransitionCreate } from "../generated/StateMachineTransitionCreate";
-export type { StateMachineTransitionUpdate } from "../generated/StateMachineTransitionUpdate";
-
-// =============================================================================
-// Pathfinding (Graph Editor Visualization)
-// =============================================================================
-
-/**
- * These pathfinding types are for the graph editor's path preview feature.
- * Runtime navigation uses the qontinui Python library (multistate) directly.
- */
-
-export type { PathfindingRequest } from "../generated/PathfindingRequest";
-export type { PathfindingStep } from "../generated/PathfindingStep";
-export type { PathfindingResult } from "../generated/PathfindingResult";
-
-// =============================================================================
-// Execution Results (Runtime)
-// =============================================================================
-
-export type { TransitionExecutionResult } from "../generated/TransitionExecutionResult";
-export type { NavigationResult } from "../generated/NavigationResult";
-export type { ActiveStatesResult } from "../generated/ActiveStatesResult";
-
-export type { TransitionInfo } from "../generated/TransitionInfo";
-export type { AvailableTransitionsResult } from "../generated/AvailableTransitionsResult";
-
-// =============================================================================
-// Initial States
-// =============================================================================
-
-export type { InitialStatesSource } from "../generated/InitialStatesSource";
-export type { InitialStateRef } from "../generated/InitialStateRef";
-export type { ResolvedInitialStates } from "../generated/ResolvedInitialStates";
-export type { ResolvedInitialStatesResult } from "../generated/ResolvedInitialStatesResult";
-
-// =============================================================================
-// Discovery
-// =============================================================================
-
-export type { DiscoveryStrategy } from "../generated/DiscoveryStrategy";
-
-// =============================================================================
-// Graph Display Types (ReactFlow)
-// =============================================================================
-
-// NOTE: `StateNodeData` is kept hand-authored because the generated DTO
-// intentionally omits the `onStartElementDrag` callback (a UI-layer concern
-// with no Rust analogue). Downstream ReactFlow nodes need the callback, so we
-// can't silently substitute the generated shape. The rest of the fields match
-// the generated `StateNodeData` one-for-one.
-
-/**
- * Data passed to a state node in the ReactFlow graph editor.
- *
- * UI-only sugar: mirrors the generated `StateNodeData` but adds the
- * `onStartElementDrag` callback that the graph editor wires up at render time.
- */
-export interface StateNodeData {
-  stateId: string;
-  name: string;
-  elementCount: number;
-  confidence: number;
-  elementIds: string[];
-  description: string | null;
-  isBlocking: boolean;
-  isSelected: boolean;
-  isInitial: boolean;
-  outgoingCount?: number;
-  incomingCount?: number;
-  isDropTarget?: boolean;
-  onStartElementDrag?: (stateId: string, elementId: string) => void;
-  /** Optional map of element ID → base64 thumbnail image (data URL or raw base64 PNG). */
-  elementThumbnails?: Record<string, string>;
-}
-
-export type { TransitionEdgeData } from "../generated/TransitionEdgeData";
-
-// =============================================================================
-// Export/Import
-// =============================================================================
-
-export type { StateMachineExportFormat } from "../generated/StateMachineExportFormat";
+/**
+ * Unified State Machine types for the Qontinui ecosystem.
+ *
+ * These types are the single source of truth for state machine data structures
+ * used by both qontinui-web and qontinui-runner. They use snake_case to match
+ * the API/database layer.
+ *
+ * Architecture:
+ * - Config: A named state machine configuration (collection of states + transitions)
+ * - State: A UI state defined by which elements are present
+ * - Transition: A named action sequence that moves between states
+ * - Action: A single UI interaction (click, type, navigate, etc.)
+ *
+ * Runtime navigation (pathfinding through states) is handled by the qontinui
+ * Python library using multistate. The TypeScript pathfinding types here are
+ * for the graph editor's path preview only.
+ *
+ * Most wire types in this module are generated from Rust (source of truth:
+ * qontinui-schemas/rust/src/state_machine.rs). Do not edit those by hand —
+ * regenerate via `just generate-types` (or the runner's generate_types.sh).
+ * A small number of UI-only sugar types remain hand-authored below.
+ */
+
+// =============================================================================
+// Action Types
+// =============================================================================
+
+export type { StandardActionType } from "../generated/StandardActionType";
+export type { Point } from "../generated/Point";
+export type { ScrollDirection } from "../generated/ScrollDirection";
+export type { MouseButton } from "../generated/MouseButton";
+export type { TransitionActionValue } from "../generated/TransitionActionValue";
+export type { TransitionAction } from "../generated/TransitionAction";
+
+// =============================================================================
+// Domain Knowledge
+// =============================================================================
+
+export type { DomainKnowledge } from "../generated/DomainKnowledge";
+
+// =============================================================================
+// State Machine Config
+// =============================================================================
+
+export type { StateMachineConfig } from "../generated/StateMachineConfig";
+export type { StateMachineConfigCreate } from "../generated/StateMachineConfigCreate";
+export type { StateMachineConfigUpdate } from "../generated/StateMachineConfigUpdate";
+export type { StateMachineConfigFull } from "../generated/StateMachineConfigFull";
+
+// =============================================================================
+// State
+// =============================================================================
+
+export type { StateMachineState } from "../generated/StateMachineState";
+export type { StateMachineStateCreate } from "../generated/StateMachineStateCreate";
+export type { StateMachineStateUpdate } from "../generated/StateMachineStateUpdate";
+
+// =============================================================================
+// Transition
+// =============================================================================
+
+export type { StateMachineTransition } from "../generated/StateMachineTransition";
+export type { StateMachineTransitionCreate } from "../generated/StateMachineTransitionCreate";
+export type { StateMachineTransitionUpdate } from "../generated/StateMachineTransitionUpdate";
+
+// =============================================================================
+// Pathfinding (Graph Editor Visualization)
+// =============================================================================
+
+/**
+ * These pathfinding types are for the graph editor's path preview feature.
+ * Runtime navigation uses the qontinui Python library (multistate) directly.
+ */
+
+export type { PathfindingRequest } from "../generated/PathfindingRequest";
+export type { PathfindingStep } from "../generated/PathfindingStep";
+export type { PathfindingResult } from "../generated/PathfindingResult";
+
+// =============================================================================
+// Execution Results (Runtime)
+// =============================================================================
+
+export type { TransitionExecutionResult } from "../generated/TransitionExecutionResult";
+export type { NavigationResult } from "../generated/NavigationResult";
+export type { ActiveStatesResult } from "../generated/ActiveStatesResult";
+
+export type { TransitionInfo } from "../generated/TransitionInfo";
+export type { AvailableTransitionsResult } from "../generated/AvailableTransitionsResult";
+
+// =============================================================================
+// Initial States
+// =============================================================================
+
+export type { InitialStatesSource } from "../generated/InitialStatesSource";
+export type { InitialStateRef } from "../generated/InitialStateRef";
+export type { ResolvedInitialStates } from "../generated/ResolvedInitialStates";
+export type { ResolvedInitialStatesResult } from "../generated/ResolvedInitialStatesResult";
+
+// =============================================================================
+// Discovery
+// =============================================================================
+
+export type { DiscoveryStrategy } from "../generated/DiscoveryStrategy";
+
+// =============================================================================
+// Graph Display Types (ReactFlow)
+// =============================================================================
+
+// NOTE: `StateNodeData` is kept hand-authored because the generated DTO
+// intentionally omits the `onStartElementDrag` callback (a UI-layer concern
+// with no Rust analogue). Downstream ReactFlow nodes need the callback, so we
+// can't silently substitute the generated shape. The rest of the fields match
+// the generated `StateNodeData` one-for-one.
+
+/**
+ * Data passed to a state node in the ReactFlow graph editor.
+ *
+ * UI-only sugar: mirrors the generated `StateNodeData` but adds the
+ * `onStartElementDrag` callback that the graph editor wires up at render time.
+ */
+export interface StateNodeData {
+  stateId: string;
+  name: string;
+  elementCount: number;
+  confidence: number;
+  elementIds: string[];
+  description: string | null;
+  isBlocking: boolean;
+  isSelected: boolean;
+  isInitial: boolean;
+  outgoingCount?: number;
+  incomingCount?: number;
+  isDropTarget?: boolean;
+  onStartElementDrag?: (stateId: string, elementId: string) => void;
+  /** Optional map of element ID → base64 thumbnail image (data URL or raw base64 PNG). */
+  elementThumbnails?: Record<string, string>;
+}
+
+export type { TransitionEdgeData } from "../generated/TransitionEdgeData";
+
+// =============================================================================
+// Export/Import
+// =============================================================================
+
+export type { StateMachineExportFormat } from "../generated/StateMachineExportFormat";

package/src/state-machine/index.ts

@@ -1 +1 @@
-export * from "./_api";
+export * from "./_api";

package/src/targets/_api.ts

@@ -1,47 +1,47 @@
-/**
- * Target Configuration Types
- *
- * Discriminated union of 14 action-target variants (image, region, text,
- * coordinates, stateImage, stateRegion, stateLocation, stateString,
- * currentPosition, lastFindResult, resultIndex, allResults, resultByImage,
- * accessibility) + supporting search/pattern/OCR options.
- *
- * Source of truth: qontinui-schemas/rust/src/targets.rs.
- *
- * Wire format: `type` discriminator uses camelCase ("stateImage",
- * "currentPosition", "resultByImage", etc.).
- */
-
-import type { TargetConfig } from "../generated/TargetConfig";
-
-export type { TargetConfig } from "../generated/TargetConfig";
-export type { SearchStrategy } from "../generated/SearchStrategy";
-export type { MatchMethod } from "../generated/MatchMethod";
-export type { PollingConfig } from "../generated/PollingConfig";
-export type { PatternOptions } from "../generated/PatternOptions";
-export type { MatchAdjustment } from "../generated/MatchAdjustment";
-export type { SearchOptions } from "../generated/SearchOptions";
-export type { OcrEngine } from "../generated/OcrEngine";
-export type { TextMatchType } from "../generated/TextMatchType";
-export type { TextSearchOptions } from "../generated/TextSearchOptions";
-
-// Per-variant narrowed aliases for consumers that want to Omit/Extend a
-// single target shape. `TargetConfig` itself is the discriminated union;
-// each alias is `TargetConfig` narrowed on the `type` discriminator.
-export type ImageTarget = Extract<TargetConfig, { type: "image" }>;
-export type RegionTarget = Extract<TargetConfig, { type: "region" }>;
-export type TextTarget = Extract<TargetConfig, { type: "text" }>;
-export type CoordinatesTarget = Extract<TargetConfig, { type: "coordinates" }>;
-export type StateStringTarget = Extract<TargetConfig, { type: "stateString" }>;
-export type StateRegionTarget = Extract<TargetConfig, { type: "stateRegion" }>;
-export type StateLocationTarget = Extract<TargetConfig, { type: "stateLocation" }>;
-export type StateImageTarget = Extract<TargetConfig, { type: "stateImage" }>;
-export type CurrentPositionTarget = Extract<TargetConfig, { type: "currentPosition" }>;
-export type LastFindResultTarget = Extract<TargetConfig, { type: "lastFindResult" }>;
-export type ResultIndexTarget = Extract<TargetConfig, { type: "resultIndex" }>;
-export type AllResultsTarget = Extract<TargetConfig, { type: "allResults" }>;
-export type ResultByImageTarget = Extract<TargetConfig, { type: "resultByImage" }>;
-export type AccessibilityTarget = Extract<TargetConfig, { type: "accessibility" }>;
-
-/** Wire-format type discriminator string for `TargetConfig`. */
-export type TargetType = TargetConfig["type"];
+/**
+ * Target Configuration Types
+ *
+ * Discriminated union of 14 action-target variants (image, region, text,
+ * coordinates, stateImage, stateRegion, stateLocation, stateString,
+ * currentPosition, lastFindResult, resultIndex, allResults, resultByImage,
+ * accessibility) + supporting search/pattern/OCR options.
+ *
+ * Source of truth: qontinui-schemas/rust/src/targets.rs.
+ *
+ * Wire format: `type` discriminator uses camelCase ("stateImage",
+ * "currentPosition", "resultByImage", etc.).
+ */
+
+import type { TargetConfig } from "../generated/TargetConfig";
+
+export type { TargetConfig } from "../generated/TargetConfig";
+export type { SearchStrategy } from "../generated/SearchStrategy";
+export type { MatchMethod } from "../generated/MatchMethod";
+export type { PollingConfig } from "../generated/PollingConfig";
+export type { PatternOptions } from "../generated/PatternOptions";
+export type { MatchAdjustment } from "../generated/MatchAdjustment";
+export type { SearchOptions } from "../generated/SearchOptions";
+export type { OcrEngine } from "../generated/OcrEngine";
+export type { TextMatchType } from "../generated/TextMatchType";
+export type { TextSearchOptions } from "../generated/TextSearchOptions";
+
+// Per-variant narrowed aliases for consumers that want to Omit/Extend a
+// single target shape. `TargetConfig` itself is the discriminated union;
+// each alias is `TargetConfig` narrowed on the `type` discriminator.
+export type ImageTarget = Extract<TargetConfig, { type: "image" }>;
+export type RegionTarget = Extract<TargetConfig, { type: "region" }>;
+export type TextTarget = Extract<TargetConfig, { type: "text" }>;
+export type CoordinatesTarget = Extract<TargetConfig, { type: "coordinates" }>;
+export type StateStringTarget = Extract<TargetConfig, { type: "stateString" }>;
+export type StateRegionTarget = Extract<TargetConfig, { type: "stateRegion" }>;
+export type StateLocationTarget = Extract<TargetConfig, { type: "stateLocation" }>;
+export type StateImageTarget = Extract<TargetConfig, { type: "stateImage" }>;
+export type CurrentPositionTarget = Extract<TargetConfig, { type: "currentPosition" }>;
+export type LastFindResultTarget = Extract<TargetConfig, { type: "lastFindResult" }>;
+export type ResultIndexTarget = Extract<TargetConfig, { type: "resultIndex" }>;
+export type AllResultsTarget = Extract<TargetConfig, { type: "allResults" }>;
+export type ResultByImageTarget = Extract<TargetConfig, { type: "resultByImage" }>;
+export type AccessibilityTarget = Extract<TargetConfig, { type: "accessibility" }>;
+
+/** Wire-format type discriminator string for `TargetConfig`. */
+export type TargetType = TargetConfig["type"];

package/src/targets/index.ts

@@ -1 +1 @@
-export * from "./_api";
+export * from "./_api";