@qontinui/shared-types 0.2.1

package/src/generated/StateDiscoveryResult.d.ts

@@ -0,0 +1,104 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+import type { DiscoveredState } from './DiscoveredState';
+import type { DiscoveredStateImage } from './DiscoveredStateImage';
+import type { DiscoveredTransition } from './DiscoveredTransition';
+import type { DiscoveryBoundingBox } from './DiscoveryBoundingBox';
+import type { DiscoverySourceType } from './DiscoverySourceType';
+import type { DiscoveryTransitionTrigger } from './DiscoveryTransitionTrigger';
+import type { TransitionTriggerType } from './TransitionTriggerType';
+
+/**
+ * Complete state-machine result from discovery.
+ *
+ * Unified output format regardless of the source (Playwright, UI Bridge,
+ * Recording, Vision, Manual).
+ */
+export interface StateDiscoveryResult {
+  /**
+   * Overall confidence score (0.0–1.0).
+   */
+  confidence: number;
+  /**
+   * ISO 8601 timestamp of creation.
+   */
+  createdAt: string;
+  /**
+   * Description of this state machine.
+   */
+  description?: string | null;
+  /**
+   * Additional discovery metadata.
+   */
+  discoveryMetadata?: {
+    [k: string]: unknown;
+  };
+  /**
+   * Strategy used for discovery (`auto`, `fingerprint`, `legacy`, …).
+   */
+  discoveryStrategy?: string | null;
+  /**
+   * Mapping of element IDs to render IDs where they appear.
+   */
+  elementToRenders?: {
+    [k: string]: string[];
+  };
+  /**
+   * Unique identifier for the result.
+   */
+  id: string;
+  /**
+   * Number of images (statistic).
+   */
+  imageCount: number;
+  /**
+   * All discovered images.
+   */
+  images?: DiscoveredStateImage[];
+  /**
+   * Human-readable name.
+   */
+  name: string;
+  /**
+   * ID of the project this belongs to.
+   */
+  projectId: string;
+  /**
+   * Number of renders analyzed (statistic).
+   */
+  renderCount: number;
+  /**
+   * ID of the source session (extraction, recording, …).
+   */
+  sourceSessionId?: string | null;
+  sourceType: DiscoverySourceType;
+  /**
+   * Number of states (statistic).
+   */
+  stateCount: number;
+  /**
+   * All discovered states.
+   */
+  states?: DiscoveredState[];
+  /**
+   * Number of transitions (statistic).
+   */
+  transitionCount: number;
+  /**
+   * All discovered transitions.
+   */
+  transitions?: DiscoveredTransition[];
+  /**
+   * Number of unique elements (statistic).
+   */
+  uniqueElementCount: number;
+  /**
+   * ISO 8601 timestamp of last update.
+   */
+  updatedAt: string;
+}

package/src/generated/StateDiscoveryResultCreate.d.ts

@@ -0,0 +1,65 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+import type { DiscoveredState } from './DiscoveredState';
+import type { DiscoveredStateImage } from './DiscoveredStateImage';
+import type { DiscoveredTransition } from './DiscoveredTransition';
+import type { DiscoveryBoundingBox } from './DiscoveryBoundingBox';
+import type { DiscoverySourceType } from './DiscoverySourceType';
+import type { DiscoveryTransitionTrigger } from './DiscoveryTransitionTrigger';
+import type { TransitionTriggerType } from './TransitionTriggerType';
+
+/**
+ * Request payload to create a state-discovery result.
+ */
+export interface StateDiscoveryResultCreate {
+  /**
+   * Confidence score (0.0–1.0).
+   */
+  confidence: number;
+  /**
+   * Description.
+   */
+  description?: string | null;
+  /**
+   * Additional metadata.
+   */
+  discoveryMetadata?: {
+    [k: string]: unknown;
+  };
+  /**
+   * Strategy used.
+   */
+  discoveryStrategy?: string | null;
+  /**
+   * Element to renders mapping.
+   */
+  elementToRenders?: {
+    [k: string]: string[];
+  };
+  /**
+   * Discovered images.
+   */
+  images?: DiscoveredStateImage[];
+  /**
+   * Human-readable name.
+   */
+  name: string;
+  /**
+   * ID of the source session.
+   */
+  sourceSessionId?: string | null;
+  sourceType: DiscoverySourceType;
+  /**
+   * Discovered states.
+   */
+  states?: DiscoveredState[];
+  /**
+   * Discovered transitions.
+   */
+  transitions?: DiscoveredTransition[];
+}

package/src/generated/StateDiscoveryResultListResponse.d.ts

@@ -0,0 +1,23 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+import type { DiscoverySourceType } from './DiscoverySourceType';
+import type { StateDiscoveryResultSummary } from './StateDiscoveryResultSummary';
+
+/**
+ * API response for listing discovery results.
+ */
+export interface StateDiscoveryResultListResponse {
+  /**
+   * List of result summaries.
+   */
+  items: StateDiscoveryResultSummary[];
+  /**
+   * Total count of results.
+   */
+  total: number;
+}

package/src/generated/StateDiscoveryResultSummary.d.ts

@@ -0,0 +1,57 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+import type { DiscoverySourceType } from './DiscoverySourceType';
+
+/**
+ * Summary of a state-discovery result (for listings).
+ *
+ * Lightweight projection of `StateDiscoveryResult` used by list endpoints.
+ */
+export interface StateDiscoveryResultSummary {
+  /**
+   * Confidence score (0.0–1.0).
+   */
+  confidence: number;
+  /**
+   * ISO 8601 timestamp of creation.
+   */
+  createdAt: string;
+  /**
+   * Description.
+   */
+  description?: string | null;
+  /**
+   * Strategy used.
+   */
+  discoveryStrategy?: string | null;
+  /**
+   * Unique identifier.
+   */
+  id: string;
+  /**
+   * Number of images.
+   */
+  imageCount: number;
+  /**
+   * Human-readable name.
+   */
+  name: string;
+  /**
+   * ID of the project.
+   */
+  projectId: string;
+  sourceType: DiscoverySourceType;
+  /**
+   * Number of states.
+   */
+  stateCount: number;
+  /**
+   * Number of transitions.
+   */
+  transitionCount: number;
+}

package/src/generated/StateDiscoveryResultUpdate.d.ts

@@ -0,0 +1,47 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+import type { DiscoveredState } from './DiscoveredState';
+import type { DiscoveredStateImage } from './DiscoveredStateImage';
+import type { DiscoveredTransition } from './DiscoveredTransition';
+import type { DiscoveryBoundingBox } from './DiscoveryBoundingBox';
+import type { DiscoveryTransitionTrigger } from './DiscoveryTransitionTrigger';
+import type { TransitionTriggerType } from './TransitionTriggerType';
+
+/**
+ * Request payload to update a state-discovery result.
+ *
+ * All fields optional; only supplied fields are applied.
+ */
+export interface StateDiscoveryResultUpdate {
+  /**
+   * Description.
+   */
+  description?: string | null;
+  /**
+   * Updated metadata.
+   */
+  discoveryMetadata?: {
+    [k: string]: unknown;
+  } | null;
+  /**
+   * Updated images.
+   */
+  images?: DiscoveredStateImage[] | null;
+  /**
+   * Human-readable name.
+   */
+  name?: string | null;
+  /**
+   * Updated states.
+   */
+  states?: DiscoveredState[] | null;
+  /**
+   * Updated transitions.
+   */
+  transitions?: DiscoveredTransition[] | null;
+}

package/src/generated/StateFilterItem.d.ts

@@ -0,0 +1,18 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * State item for the filter dropdown.
+ */
+export interface StateFilterItem {
+  /**
+   * Number of embeddings in this state.
+   */
+  count: number;
+  state_id: string;
+  state_name: string;
+}

package/src/generated/StateMachineConfig.d.ts

@@ -0,0 +1,45 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * A state machine configuration — a named collection of states and
+ * transitions that describe the navigable structure of an application's UI.
+ */
+export interface StateMachineConfig {
+  /**
+   * ISO 8601 timestamp of creation.
+   */
+  created_at: string;
+  /**
+   * Optional description.
+   */
+  description?: string | null;
+  /**
+   * Number of unique elements discovered in this config.
+   */
+  element_count: number;
+  /**
+   * Unique identifier (UUID).
+   */
+  id: string;
+  /**
+   * Whether to include HTML IDs when generating selectors.
+   */
+  include_html_ids: boolean;
+  /**
+   * Display name.
+   */
+  name: string;
+  /**
+   * Number of DOM renders collected for this config.
+   */
+  render_count: number;
+  /**
+   * ISO 8601 timestamp of last modification.
+   */
+  updated_at: string;
+}

package/src/generated/StateMachineConfigCreate.d.ts

@@ -0,0 +1,20 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * Payload for creating a new state machine configuration.
+ */
+export interface StateMachineConfigCreate {
+  /**
+   * Optional description.
+   */
+  description?: string | null;
+  /**
+   * Display name.
+   */
+  name: string;
+}

package/src/generated/StateMachineConfigFull.d.ts

@@ -0,0 +1,67 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+import type { DomainKnowledge } from './DomainKnowledge';
+import type { MouseButton } from './MouseButton';
+import type { Point } from './Point';
+import type { ScrollDirection } from './ScrollDirection';
+import type { StandardActionType } from './StandardActionType';
+import type { StateMachineState } from './StateMachineState';
+import type { StateMachineTransition } from './StateMachineTransition';
+import type { TransitionAction } from './TransitionAction';
+import type { TransitionActionValue } from './TransitionActionValue';
+
+/**
+ * A config with all its states and transitions loaded.
+ *
+ * Used when the full state machine needs to be displayed or exported. This
+ * mirrors the TypeScript `StateMachineConfigFull extends StateMachineConfig`
+ * by flattening the base config's fields via `#[serde(flatten)]`.
+ */
+export interface StateMachineConfigFull {
+  /**
+   * ISO 8601 timestamp of creation.
+   */
+  created_at: string;
+  /**
+   * Optional description.
+   */
+  description?: string | null;
+  /**
+   * Number of unique elements discovered in this config.
+   */
+  element_count: number;
+  /**
+   * Unique identifier (UUID).
+   */
+  id: string;
+  /**
+   * Whether to include HTML IDs when generating selectors.
+   */
+  include_html_ids: boolean;
+  /**
+   * Display name.
+   */
+  name: string;
+  /**
+   * Number of DOM renders collected for this config.
+   */
+  render_count: number;
+  /**
+   * All states belonging to this config.
+   */
+  states: StateMachineState[];
+  /**
+   * All transitions belonging to this config.
+   */
+  transitions: StateMachineTransition[];
+  /**
+   * ISO 8601 timestamp of last modification.
+   */
+  updated_at: string;
+  [k: string]: unknown;
+}

package/src/generated/StateMachineConfigUpdate.d.ts

@@ -0,0 +1,20 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * Payload for updating an existing state machine configuration.
+ */
+export interface StateMachineConfigUpdate {
+  /**
+   * New description.
+   */
+  description?: string | null;
+  /**
+   * New display name.
+   */
+  name?: string | null;
+}

package/src/generated/StateMachineExport.d.ts

@@ -0,0 +1,64 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+import type { DiscoveredState } from './DiscoveredState';
+import type { DiscoveredStateImage } from './DiscoveredStateImage';
+import type { DiscoveredTransition } from './DiscoveredTransition';
+import type { DiscoveryBoundingBox } from './DiscoveryBoundingBox';
+import type { DiscoveryTransitionTrigger } from './DiscoveryTransitionTrigger';
+import type { TransitionTriggerType } from './TransitionTriggerType';
+
+/**
+ * Portable export format for state machines.
+ *
+ * Used when exporting a discovery result to a shareable artifact.
+ * `source_type` is kept as a free-form `String` to match Python's
+ * `DiscoverySourceType | str` union (enabling imports that predate the enum).
+ */
+export interface StateMachineExport {
+  /**
+   * Description.
+   */
+  description?: string | null;
+  /**
+   * Element to renders mapping.
+   */
+  elementToRenders?: {
+    [k: string]: string[];
+  };
+  /**
+   * State images.
+   */
+  images?: DiscoveredStateImage[];
+  /**
+   * Export metadata (original ID, export timestamp, …).
+   */
+  metadata?: {
+    [k: string]: unknown;
+  };
+  /**
+   * State machine name.
+   */
+  name: string;
+  /**
+   * Original discovery source (string for forward compatibility — Python
+   * accepts `DiscoverySourceType | str`).
+   */
+  sourceType: string;
+  /**
+   * States.
+   */
+  states?: DiscoveredState[];
+  /**
+   * Transitions.
+   */
+  transitions?: DiscoveredTransition[];
+  /**
+   * Export format version. Defaults to `"1.0.0"`.
+   */
+  version: string;
+}

package/src/generated/StateMachineExportFormat.d.ts

@@ -0,0 +1,39 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * Format for exporting a state machine config to JSON.
+ *
+ * Compatible with `UIBridgeRuntime.from_dict()` in the qontinui library. The
+ * nested maps hold opaque per-state / per-transition / per-config dictionaries
+ * because the exporter serializes implementation-specific fields not captured
+ * by the DTO types.
+ */
+export interface StateMachineExportFormat {
+  /**
+   * Config-level payload.
+   */
+  config: {
+    [k: string]: unknown;
+  };
+  /**
+   * State ID → state payload.
+   */
+  states: {
+    [k: string]: {
+      [k: string]: unknown;
+    };
+  };
+  /**
+   * Transition ID → transition payload.
+   */
+  transitions: {
+    [k: string]: {
+      [k: string]: unknown;
+    };
+  };
+}

package/src/generated/StateMachineImport.d.ts

@@ -0,0 +1,25 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+import type { DiscoveredState } from './DiscoveredState';
+import type { DiscoveredStateImage } from './DiscoveredStateImage';
+import type { DiscoveredTransition } from './DiscoveredTransition';
+import type { DiscoveryBoundingBox } from './DiscoveryBoundingBox';
+import type { DiscoveryTransitionTrigger } from './DiscoveryTransitionTrigger';
+import type { StateMachineExport } from './StateMachineExport';
+import type { TransitionTriggerType } from './TransitionTriggerType';
+
+/**
+ * Request payload to import a state machine.
+ */
+export interface StateMachineImport {
+  /**
+   * Override name (uses export name when omitted).
+   */
+  name?: string | null;
+  stateMachine: StateMachineExport;
+}

package/src/generated/StateMachineState.d.ts

@@ -0,0 +1,71 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+import type { DomainKnowledge } from './DomainKnowledge';
+
+/**
+ * A UI state, defined by which elements are present on screen.
+ *
+ * States are discovered via co-occurrence analysis of DOM snapshots.
+ */
+export interface StateMachineState {
+  /**
+   * Acceptance criteria for verifying the state is reached.
+   */
+  acceptance_criteria: string[];
+  /**
+   * Confidence score (0.0–1.0) from the discovery pass.
+   */
+  confidence: number;
+  /**
+   * Parent config ID.
+   */
+  config_id: string;
+  /**
+   * ISO 8601 timestamp of creation.
+   */
+  created_at: string;
+  /**
+   * Optional description.
+   */
+  description?: string | null;
+  /**
+   * Domain knowledge entries attached to this state.
+   */
+  domain_knowledge: DomainKnowledge[];
+  /**
+   * Element IDs that must be present for this state to be active.
+   */
+  element_ids: string[];
+  /**
+   * Free-form metadata bag.
+   */
+  extra_metadata: {
+    [k: string]: unknown;
+  };
+  /**
+   * Unique database identifier (UUID).
+   */
+  id: string;
+  /**
+   * Display name.
+   */
+  name: string;
+  /**
+   * Render IDs that contributed to discovering this state.
+   */
+  render_ids: string[];
+  /**
+   * Stable logical state ID (distinct from `id`; set by the user or
+   * generator).
+   */
+  state_id: string;
+  /**
+   * ISO 8601 timestamp of last modification.
+   */
+  updated_at: string;
+}