@qontinui/shared-types 0.2.1

package/src/generated/UIBridgeCapturedToast.d.ts

@@ -0,0 +1,22 @@
+/* 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 captured toast/notification entry.
+ */
+export interface UIBridgeCapturedToast {
+  appearedAt: number;
+  dismissedAt?: number | null;
+  durationMs: number;
+  id: string;
+  /**
+   * Severity level. One of: info|success|warning|error|loading|unknown.
+   */
+  level: string;
+  message: string;
+  visible: boolean;
+}

package/src/generated/UIBridgeComponent.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`.
+ */
+
+import type { ComponentActionInfo } from './ComponentActionInfo';
+
+/**
+ * A registered component in the UI Bridge registry.
+ *
+ * Components group related elements and expose higher-level actions
+ * (e.g. "submit form", "reset filters").
+ */
+export interface UIBridgeComponent {
+  /**
+   * Actions exposed by this component.
+   */
+  actions?: ComponentActionInfo[];
+  /**
+   * Human-readable description.
+   */
+  description?: string | null;
+  /**
+   * IDs of elements that belong to this component.
+   */
+  elementIds?: string[] | null;
+  /**
+   * Unique component ID within the registry.
+   */
+  id: string;
+  /**
+   * Whether the component's React component is currently mounted.
+   */
+  mounted: boolean;
+  /**
+   * Component name.
+   */
+  name: string;
+  /**
+   * Unix-epoch millisecond timestamp when the component was registered.
+   */
+  registeredAt: number;
+}

package/src/generated/UIBridgeElement.d.ts

@@ -0,0 +1,62 @@
+/* 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 { ElementBbox } from './ElementBbox';
+import type { ElementIdentifier } from './ElementIdentifier';
+import type { ElementRect } from './ElementRect';
+import type { ElementState } from './ElementState';
+
+/**
+ * A registered element in the UI Bridge registry.
+ *
+ * This is the serializable subset of the React `RegisteredElement`; it
+ * includes identity, available actions, current state, and lifecycle info.
+ */
+export interface UIBridgeElement {
+  /**
+   * Standard actions available on this element.
+   */
+  actions?: string[];
+  /**
+   * Viewport-relative bounding box in CSS pixels, when the SDK has a
+   * live DOM ref. Absent for elements registered without a ref or when
+   * the snapshot is served from the DOM-fallback scanner.
+   */
+  bbox?: ElementBbox | null;
+  /**
+   * Custom (application-defined) actions.
+   */
+  customActions?: string[] | null;
+  /**
+   * Unique element ID within the registry.
+   */
+  id: string;
+  identifier: ElementIdentifier;
+  /**
+   * Human-readable label for the element.
+   */
+  label?: string | null;
+  /**
+   * Whether the element's React component is currently mounted.
+   */
+  mounted: boolean;
+  /**
+   * Unix-epoch millisecond timestamp when the element was registered.
+   */
+  registeredAt: number;
+  state: ElementState;
+  /**
+   * Element type (e.g. `"button"`, `"input"`, `"select"`).
+   */
+  type: string;
+  /**
+   * Cheap viewport-visibility signal derived by the SDK as
+   * `bbox.width > 0 && bbox.height > 0`. Use `state.visible` for the
+   * richer occlusion check.
+   */
+  visible?: boolean | null;
+}

package/src/generated/UIBridgeModalInfo.d.ts

@@ -0,0 +1,40 @@
+/* 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`.
+ */
+
+/**
+ * Modal/dialog entry in the active modal stack.
+ */
+export interface UIBridgeModalInfo {
+  /**
+   * Whether this modal blocks interaction with content behind it.
+   */
+  blocking: boolean;
+  /**
+   * Timestamp when the modal was detected (epoch ms).
+   */
+  detectedAt: number;
+  /**
+   * Whether the modal is dismissible (RN-specific). Optional so the
+   * web shape (which doesn't carry this bit) round-trips cleanly.
+   */
+  dismissible?: boolean | null;
+  /**
+   * Web-only: whether a backdrop/overlay is present.
+   */
+  hasBackdrop?: boolean | null;
+  id: string;
+  title?: string | null;
+  /**
+   * Modal kind. Web: dialog/alertdialog/modal/drawer/popover/sheet.
+   * Native (RN): modal/sheet/drawer/popover/alertdialog/dialog.
+   */
+  type?: string | null;
+  /**
+   * Web-only: computed z-index of the modal.
+   */
+  zIndex?: number | null;
+}

package/src/generated/UIBridgeModalStack.d.ts

@@ -0,0 +1,19 @@
+/* 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 { UIBridgeModalInfo } from './UIBridgeModalInfo';
+
+/**
+ * Modal stack context attached to a snapshot when the SDK has a
+ * `ModalDetector` enricher configured.
+ */
+export interface UIBridgeModalStack {
+  count: number;
+  hasBlockingModal: boolean;
+  modals?: UIBridgeModalInfo[];
+  topModal?: UIBridgeModalInfo | null;
+}

package/src/generated/UIBridgeSnapshot.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 { ComponentActionInfo } from './ComponentActionInfo';
+import type { ElementBbox } from './ElementBbox';
+import type { ElementIdentifier } from './ElementIdentifier';
+import type { ElementRect } from './ElementRect';
+import type { ElementState } from './ElementState';
+import type { UIBridgeCapturedToast } from './UIBridgeCapturedToast';
+import type { UIBridgeComponent } from './UIBridgeComponent';
+import type { UIBridgeElement } from './UIBridgeElement';
+import type { UIBridgeModalInfo } from './UIBridgeModalInfo';
+import type { UIBridgeModalStack } from './UIBridgeModalStack';
+import type { UIBridgeToastContext } from './UIBridgeToastContext';
+import type { UIBridgeUndoContext } from './UIBridgeUndoContext';
+import type { WorkflowInfo } from './WorkflowInfo';
+
+/**
+ * Full snapshot of the UI Bridge state.
+ *
+ * Captures all registered elements, components, and active workflows
+ * at a single point in time. The optional `modalStack` / `toasts` /
+ * `undoRedo` fields are populated by the SDK's enricher slot when
+ * configured (see `setEnrichers` on web and native registries).
+ */
+export interface UIBridgeSnapshot {
+  /**
+   * All registered components.
+   */
+  components?: UIBridgeComponent[];
+  /**
+   * Native-only: current navigation route (Expo Router pathname).
+   */
+  currentRoute?: string | null;
+  /**
+   * All registered elements.
+   */
+  elements?: UIBridgeElement[];
+  /**
+   * Modal/sheet stack (populated when ModalDetector enricher is set).
+   */
+  modalStack?: UIBridgeModalStack | null;
+  /**
+   * Native-only: current route segments.
+   */
+  segments?: string[];
+  /**
+   * Unix-epoch millisecond timestamp of the snapshot.
+   */
+  timestamp: number;
+  /**
+   * Active and recently dismissed toasts (populated by ToastCapture).
+   */
+  toasts?: UIBridgeToastContext | null;
+  /**
+   * Undo/redo availability (populated by UndoTracker).
+   */
+  undoRedo?: UIBridgeUndoContext | null;
+  /**
+   * Active workflows.
+   */
+  workflows?: WorkflowInfo[];
+}

package/src/generated/UIBridgeToastContext.d.ts

@@ -0,0 +1,17 @@
+/* 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 { UIBridgeCapturedToast } from './UIBridgeCapturedToast';
+
+/**
+ * Toast snapshot context.
+ */
+export interface UIBridgeToastContext {
+  active?: UIBridgeCapturedToast[];
+  recent?: UIBridgeCapturedToast[];
+  totalCaptured: number;
+}

package/src/generated/UIBridgeUndoContext.d.ts

@@ -0,0 +1,19 @@
+/* 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`.
+ */
+
+/**
+ * Undo/redo availability snapshot context.
+ */
+export interface UIBridgeUndoContext {
+  canRedo: boolean;
+  canUndo: boolean;
+  redoDepth?: number | null;
+  redoDescription?: string | null;
+  summary: string;
+  undoDepth?: number | null;
+  undoDescription?: string | null;
+}

package/src/generated/UiBridgeAction.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`.
+ */
+
+/**
+ * UI Bridge action kind.
+ */
+export type UiBridgeAction =
+  | "navigate"
+  | "execute"
+  | "assert"
+  | "snapshot"
+  | "compare"
+  | "snapshot_assert"
+  | "action_plan";

package/src/generated/UiBridgeAssertType.d.ts

@@ -0,0 +1,11 @@
+/* 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`.
+ */
+
+/**
+ * Kinds of assertion supported by `assert` actions.
+ */
+export type UiBridgeAssertType = "exists" | "text_equals" | "contains" | "visible" | "enabled";

package/src/generated/UiBridgeComparisonMode.d.ts

@@ -0,0 +1,11 @@
+/* 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`.
+ */
+
+/**
+ * Comparison mode for `compare` / `snapshot_assert` actions.
+ */
+export type UiBridgeComparisonMode = "structural" | "visual" | "both";

package/src/generated/UiBridgeDesignAuditStep.d.ts

@@ -0,0 +1,76 @@
+/* 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 { RetrySpec } from './RetrySpec';
+import type { VerificationCategoryKind } from './VerificationCategoryKind';
+
+/**
+ * Run a UI Bridge design-audit check (contrast, accessibility, select visibility).
+ *
+ * Wire tag: `"ui_bridge_design_audit"`.
+ */
+export interface UiBridgeDesignAuditStep {
+  /**
+   * Acceptance criterion IDs verified by this step.
+   */
+  criterionIds?: string[];
+  /**
+   * IDs of other steps that must complete first.
+   */
+  dependsOn?: string[];
+  /**
+   * Extractions published to subsequent steps.
+   */
+  extract?: {
+    [k: string]: string;
+  };
+  /**
+   * If `Some(true)`, a console-error signal from the UI fails this step.
+   */
+  failOnConsoleErrors?: boolean | null;
+  /**
+   * Unique identifier for the step.
+   */
+  id: string;
+  /**
+   * Named input bindings evaluated at step entry.
+   */
+  inputs?: {
+    [k: string]: string;
+  };
+  /**
+   * Display name for the step.
+   */
+  name: string;
+  /**
+   * Whether this step is required (default: `true` on consumer side).
+   */
+  required?: boolean | null;
+  /**
+   * Per-step retry configuration.
+   */
+  retry?: RetrySpec | null;
+  /**
+   * Provenance of this step when generated from a skill template.
+   *
+   * Typed as `serde_json::Value` here to avoid pulling the `skill`
+   * dependency chain into this module; the TS side re-imports the typed
+   * `SkillOrigin` after regeneration.
+   */
+  skillOrigin?: {
+    [k: string]: unknown;
+  };
+  /**
+   * Timeout in seconds.
+   */
+  timeoutSeconds?: number | null;
+  /**
+   * Verification depth category.
+   */
+  verificationCategory?: VerificationCategoryKind | null;
+  [k: string]: unknown;
+}

package/src/generated/UiBridgeSeverity.d.ts

@@ -0,0 +1,11 @@
+/* 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`.
+ */
+
+/**
+ * Severity threshold for `compare` / `snapshot_assert` actions.
+ */
+export type UiBridgeSeverity = "critical" | "major" | "minor" | "info";

package/src/generated/UiBridgeStep.d.ts

@@ -0,0 +1,127 @@
+/* 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 { RetrySpec } from './RetrySpec';
+import type { UiBridgeAction } from './UiBridgeAction';
+import type { UiBridgeAssertType } from './UiBridgeAssertType';
+import type { UiBridgeComparisonMode } from './UiBridgeComparisonMode';
+import type { UiBridgeSeverity } from './UiBridgeSeverity';
+import type { UiBridgeStepPhase } from './UiBridgeStepPhase';
+import type { VerificationCategoryKind } from './VerificationCategoryKind';
+
+/**
+ * UI Bridge SDK interaction — navigate, execute, assert, snapshot, compare.
+ */
+export interface UiBridgeStep {
+  action: UiBridgeAction;
+  /**
+   * Structured action plan (for `action_plan`).
+   *
+   * Typed as `serde_json::Value` here to avoid pulling the `action-plan`
+   * module into this crate; the TS side re-imports the typed `ActionPlan`
+   * after regeneration.
+   */
+  actionPlan?: {
+    [k: string]: unknown;
+  };
+  /**
+   * Assertion kind (for `assert`).
+   */
+  assertType?: UiBridgeAssertType | null;
+  /**
+   * Comparison mode (for `compare` / `snapshot_assert`).
+   */
+  comparisonMode?: UiBridgeComparisonMode | null;
+  /**
+   * Acceptance criterion IDs verified by this step.
+   */
+  criterionIds?: string[];
+  /**
+   * IDs of other steps that must complete first.
+   */
+  dependsOn?: string[];
+  /**
+   * Expected value for assertions.
+   */
+  expected?: string | null;
+  /**
+   * Extractions published to subsequent steps.
+   */
+  extract?: {
+    [k: string]: string;
+  };
+  /**
+   * If `Some(true)`, a console-error signal from the UI fails this step.
+   */
+  failOnConsoleErrors?: boolean | null;
+  /**
+   * Unique identifier for the step.
+   */
+  id: string;
+  /**
+   * Named input bindings evaluated at step entry.
+   */
+  inputs?: {
+    [k: string]: string;
+  };
+  /**
+   * Free-form instruction text (for `execute`).
+   */
+  instruction?: string | null;
+  /**
+   * Display name for the step.
+   */
+  name: string;
+  phase: UiBridgeStepPhase;
+  /**
+   * Reference snapshot ID (for `compare` / `snapshot_assert`).
+   */
+  referenceSnapshotId?: string | null;
+  /**
+   * Whether this step is required (default: `true` on consumer side).
+   */
+  required?: boolean | null;
+  /**
+   * Per-step retry configuration.
+   */
+  retry?: RetrySpec | null;
+  /**
+   * Severity threshold (for `compare` / `snapshot_assert`).
+   */
+  severityThreshold?: UiBridgeSeverity | null;
+  /**
+   * Provenance of this step when generated from a skill template.
+   *
+   * Typed as `serde_json::Value` here to avoid pulling the `skill`
+   * dependency chain into this module; the TS side re-imports the typed
+   * `SkillOrigin` after regeneration.
+   */
+  skillOrigin?: {
+    [k: string]: unknown;
+  };
+  /**
+   * Target selector or element ID.
+   */
+  target?: string | null;
+  /**
+   * Timeout in milliseconds.
+   */
+  timeoutMs?: number | null;
+  /**
+   * Snapshot target — `"control"`, `"sdk"`, or `"proxy:PORT"`.
+   */
+  uiBridgeSnapshotTarget?: string | null;
+  /**
+   * Navigation URL (for `navigate`).
+   */
+  url?: string | null;
+  /**
+   * Verification depth category.
+   */
+  verificationCategory?: VerificationCategoryKind | null;
+  [k: string]: unknown;
+}

package/src/generated/UiBridgeStepPhase.d.ts

@@ -0,0 +1,14 @@
+/* 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`.
+ */
+
+/**
+ * Phases in which a [`UiBridgeStep`] may appear.
+ *
+ * UI-bridge interactions only run in deterministic phases — never inside
+ * the agentic loop (where the AI drives steps directly via prompts).
+ */
+export type UiBridgeStepPhase = "setup" | "verification" | "completion";

package/src/generated/UiBridgeVisualAssertionStep.d.ts

@@ -0,0 +1,97 @@
+/* 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 { RetrySpec } from './RetrySpec';
+import type { VerificationCategoryKind } from './VerificationCategoryKind';
+import type { VisualAssertionType } from './VisualAssertionType';
+
+/**
+ * Assert visual properties of UI elements via the UI Bridge.
+ *
+ * Wire tag: `"ui_bridge_visual_assertion"`.
+ */
+export interface UiBridgeVisualAssertionStep {
+  /**
+   * Acceptance criterion IDs verified by this step.
+   */
+  criterionIds?: string[];
+  /**
+   * IDs of other steps that must complete first.
+   */
+  dependsOn?: string[];
+  /**
+   * Extractions published to subsequent steps.
+   */
+  extract?: {
+    [k: string]: string;
+  };
+  /**
+   * If `Some(true)`, a console-error signal from the UI fails this step.
+   */
+  failOnConsoleErrors?: boolean | null;
+  /**
+   * Unique identifier for the step.
+   */
+  id: string;
+  /**
+   * Named input bindings evaluated at step entry.
+   */
+  inputs?: {
+    [k: string]: string;
+  };
+  /**
+   * Display name for the step.
+   */
+  name: string;
+  /**
+   * Whether this step is required (default: `true` on consumer side).
+   */
+  required?: boolean | null;
+  /**
+   * Per-step retry configuration.
+   */
+  retry?: RetrySpec | null;
+  /**
+   * Provenance of this step when generated from a skill template.
+   *
+   * Typed as `serde_json::Value` here to avoid pulling the `skill`
+   * dependency chain into this module; the TS side re-imports the typed
+   * `SkillOrigin` after regeneration.
+   */
+  skillOrigin?: {
+    [k: string]: unknown;
+  };
+  /**
+   * Timeout in seconds.
+   */
+  timeoutSeconds?: number | null;
+  /**
+   * Verification depth category.
+   */
+  verificationCategory?: VerificationCategoryKind | null;
+  /**
+   * Expected text (for text assertion) or element ID (for screenshot/highlight).
+   */
+  visualAssertionExpected?: string | null;
+  /**
+   * Options JSON for the assertion.
+   */
+  visualAssertionOptions?: {
+    [k: string]: unknown;
+  };
+  /**
+   * Element query JSON for text assertions.
+   */
+  visualAssertionQuery?: {
+    [k: string]: unknown;
+  };
+  /**
+   * Assertion type: `"text"`, `"screenshot"`, or `"highlight"`.
+   */
+  visualAssertionType?: VisualAssertionType | null;
+  [k: string]: unknown;
+}