@qamposer/react 0.1.0

package/dist/index-BbUFQqpD.d.ts

@@ -0,0 +1,155 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+type Theme = 'light' | 'dark';
+interface ThemeContextValue {
+    theme: Theme;
+    toggleTheme: () => void;
+    setTheme: (theme: Theme) => void;
+}
+interface ThemeProviderProps {
+    children: ReactNode;
+    defaultTheme?: Theme;
+}
+declare function ThemeProvider({ children, defaultTheme }: ThemeProviderProps): react_jsx_runtime.JSX.Element;
+declare function useTheme(): ThemeContextValue;
+
+/**
+ * Qamposer type definitions
+ */
+type GateType = 'H' | 'X' | 'Y' | 'Z' | 'CNOT' | 'RX' | 'RY' | 'RZ';
+interface Gate {
+    id: string;
+    type: GateType;
+    /** Target qubit for single-qubit gates */
+    qubit?: number;
+    /** Control qubit for CNOT */
+    control?: number;
+    /** Target qubit for CNOT */
+    target?: number;
+    /** Parameter in radians for rotation gates (RX, RY, RZ) */
+    parameter?: number;
+    /** Position in the circuit (column index) */
+    position: number;
+}
+interface GateInfo {
+    type: GateType;
+    label: string;
+    description: string;
+    category: 'single' | 'rotation' | 'multi';
+    color: string;
+}
+interface Circuit {
+    qubits: number;
+    gates: Gate[];
+}
+type BackendType = 'ideal' | 'noisy_fake';
+interface SimulationProfile {
+    type: BackendType;
+    backend_name?: string;
+    seed?: number;
+}
+interface BackendInfo {
+    id: string;
+    name: string;
+    num_qubits: number;
+    backend_type: BackendType;
+    description?: string;
+}
+interface CircuitRequest {
+    qubits: number;
+    gates: Omit<Gate, 'id'>[];
+    shots: number;
+    profile?: SimulationProfile;
+}
+interface QSpherePoint {
+    state: string;
+    x: number;
+    y: number;
+    z: number;
+    probability: number;
+    phase: number;
+}
+interface SimulationResult {
+    counts: Record<string, number>;
+    execution_time: number;
+    qsphere?: QSpherePoint[];
+}
+/**
+ * Event passed to onSimulationComplete callback
+ * Contains simulation result along with circuit information
+ */
+interface SimulationCompleteEvent {
+    /** Simulation result from the adapter */
+    result: SimulationResult;
+    /** Circuit that was simulated */
+    circuit: Circuit;
+    /** OpenQASM 2.0 representation of the circuit */
+    qasm: string;
+}
+type SimulationStatus = 'idle' | 'simulating' | 'error';
+interface QamposerConfig {
+    /** Maximum number of qubits (default: 5) */
+    maxQubits?: number;
+    /** Maximum number of gates (default: 500) */
+    maxGates?: number;
+    /** Maximum number of shots (default: 10000) */
+    maxShots?: number;
+}
+interface QamposerProviderProps {
+    /** Controlled mode: external circuit state */
+    circuit?: Circuit;
+    /** Controlled mode: callback when circuit changes */
+    onCircuitChange?: (circuit: Circuit) => void;
+    /** Uncontrolled mode: initial circuit */
+    defaultCircuit?: Circuit;
+    /** Simulation adapter for backend communication */
+    adapter?: SimulationAdapter;
+    /** Callback when simulation completes (includes circuit info) */
+    onSimulationComplete?: (event: SimulationCompleteEvent) => void;
+    /** Configuration options */
+    config?: QamposerConfig;
+    children: React.ReactNode;
+}
+interface SimulationAdapter {
+    /** Adapter name for display */
+    name: string;
+    /** Execute simulation */
+    simulate(request: CircuitRequest): Promise<SimulationResult>;
+    /** Check if adapter is available */
+    isAvailable(): Promise<boolean>;
+    /** Get available backends (optional) */
+    getBackends?(): Promise<BackendInfo[]>;
+}
+interface QamposerContextValue {
+    circuit: Circuit;
+    result: SimulationResult | null;
+    status: SimulationStatus;
+    error: Error | null;
+    qasmCode: string;
+    parseError: string | null;
+    editingGate: Gate | null;
+    addGate: (gate: Omit<Gate, 'id'>) => void;
+    removeGate: (id: string) => void;
+    updateGate: (id: string, updates: Partial<Gate>) => void;
+    updateGates: (gates: Gate[]) => void;
+    setQubits: (count: number) => void;
+    addQubit: () => void;
+    removeQubit: (qubitIndex?: number) => void;
+    clearCircuit: () => void;
+    setEditingGate: (gate: Gate | null) => void;
+    importQasm: (code: string) => QasmParseResult;
+    exportQasm: () => string;
+    setQasmCode: (code: string) => void;
+    simulate: (shots?: number, profile?: SimulationProfile) => Promise<SimulationResult>;
+    canSimulate: boolean;
+    adapter: SimulationAdapter;
+    config: Required<QamposerConfig>;
+}
+interface QasmParseResult {
+    success: boolean;
+    circuit?: Circuit;
+    errors: string[];
+}
+
+export { type Circuit as C, type Gate as G, type QamposerProviderProps as Q, type SimulationAdapter as S, type Theme as T, type SimulationCompleteEvent as a, type QamposerConfig as b, type QamposerContextValue as c, type QasmParseResult as d, ThemeProvider as e, type GateType as f, type GateInfo as g, type CircuitRequest as h, type SimulationResult as i, type QSpherePoint as j, useTheme as u };