@qamposer/react 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,185 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { Q as QamposerProviderProps$1, T as Theme, C as Circuit, S as SimulationAdapter, a as SimulationCompleteEvent, b as QamposerConfig, c as QamposerContextValue, d as QasmParseResult } from './index-BbUFQqpD.cjs';
+export { h as CircuitRequest, G as Gate, g as GateInfo, f as GateType, j as QSpherePoint, i as SimulationResult, e as ThemeProvider, u as useTheme } from './index-BbUFQqpD.cjs';
+import { ReactNode } from 'react';
+
+interface QamposerMicroProps extends Omit<QamposerProviderProps$1, 'children'> {
+    /** Additional CSS class */
+    className?: string;
+    /** Show header (default: true) */
+    showHeader?: boolean;
+    /** Custom title (default: 'Qamposer') */
+    title?: string;
+    /** Custom ratio for operations:circuit (default: '1fr 3fr') */
+    gridTemplate?: string;
+    /** Default theme (default: 'dark') */
+    defaultTheme?: Theme;
+    /** Show theme toggle button (default: true) */
+    showThemeToggle?: boolean;
+}
+/**
+ * QamposerMicro - Minimal Quantum Circuit Composer
+ *
+ * A compact circuit editor with:
+ * - Operations panel (gate library)
+ * - Circuit editor (drag & drop)
+ * - Simulation controls
+ *
+ * Ideal for embedding in games, educational apps, or space-constrained layouts.
+ * Exposes the same data callbacks as the full Qamposer component.
+ */
+declare function QamposerMicro({ className, showHeader, title, gridTemplate, defaultTheme, showThemeToggle, ...providerProps }: QamposerMicroProps): react_jsx_runtime.JSX.Element;
+
+interface CircuitEditorProps {
+    /** Additional CSS class */
+    className?: string;
+}
+declare function CircuitEditor({ className }?: CircuitEditorProps): react_jsx_runtime.JSX.Element;
+
+interface OperationsProps {
+    /** Additional CSS class */
+    className?: string;
+}
+declare function Operations({ className }?: OperationsProps): react_jsx_runtime.JSX.Element;
+
+interface CodeEditorProps {
+    /** Additional CSS class */
+    className?: string;
+    /** Whether to show the header */
+    showHeader?: boolean;
+    /** Placeholder text */
+    placeholder?: string;
+    /** Read-only mode */
+    readOnly?: boolean;
+}
+declare function CodeEditor({ className, showHeader, placeholder, readOnly, }: CodeEditorProps): react_jsx_runtime.JSX.Element;
+
+interface SimulationControlsProps {
+    /** Render as button only (without dialog) */
+    buttonOnly?: boolean;
+    /** Custom button label */
+    buttonLabel?: string;
+    /** Additional CSS class */
+    className?: string;
+}
+declare function SimulationControls({ buttonOnly, buttonLabel, className, }: SimulationControlsProps): react_jsx_runtime.JSX.Element;
+
+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: ReactNode;
+}
+declare function QamposerProvider({ circuit: controlledCircuit, onCircuitChange, defaultCircuit, adapter, onSimulationComplete, config: userConfig, children, }: QamposerProviderProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Hook to access Qamposer context
+ *
+ * Must be used within a QamposerProvider
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { circuit, addGate, simulate } = useQamposer();
+ *
+ *   return (
+ *     <div>
+ *       <p>Qubits: {circuit.qubits}</p>
+ *       <p>Gates: {circuit.gates.length}</p>
+ *       <button onClick={() => simulate(1024)}>Run</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useQamposer(): QamposerContextValue;
+
+/**
+ * Simulation adapter types
+ */
+
+interface QiskitAdapterConfig {
+    /** Base URL of the Qiskit backend API */
+    baseUrl: string;
+    /** Additional headers to include in requests */
+    headers?: Record<string, string>;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+}
+
+/**
+ * Qiskit backend simulation adapter
+ */
+
+/**
+ * Create a simulation adapter for Qiskit backend
+ *
+ * @example
+ * ```tsx
+ * // Simple usage with just URL
+ * const adapter = qiskitAdapter('https://api.example.com');
+ *
+ * // With configuration
+ * const adapter = qiskitAdapter({
+ *   baseUrl: 'https://api.example.com',
+ *   headers: { 'Authorization': 'Bearer token' },
+ *   timeout: 30000,
+ * });
+ * ```
+ */
+declare function qiskitAdapter(configOrUrl: string | QiskitAdapterConfig): SimulationAdapter;
+
+/**
+ * No-operation adapter for editor-only mode
+ *
+ * Use this adapter when you only need the circuit editor
+ * without simulation capabilities.
+ */
+
+/**
+ * No-op adapter that disables simulation
+ *
+ * @example
+ * ```tsx
+ * import { QamposerProvider, QamposerMicro, noopAdapter } from '@qamposer/react';
+ *
+ * // Editor-only mode - RunButton will be disabled
+ * <QamposerProvider adapter={noopAdapter}>
+ *   <QamposerMicro />
+ * </QamposerProvider>
+ * ```
+ */
+declare const noopAdapter: SimulationAdapter;
+
+/**
+ * OpenQASM 2.0 utilities for bidirectional conversion between
+ * circuit representation and QASM code.
+ */
+
+/**
+ * Convert circuit to OpenQASM 2.0 code
+ */
+declare function circuitToQasm(circuit: Circuit): string;
+/**
+ * Parse OpenQASM 2.0 code to circuit representation
+ */
+declare function qasmToCircuit(qasm: string): QasmParseResult;
+/**
+ * Generate unique gate ID
+ */
+declare function generateGateId(): string;
+/**
+ * Create a default empty circuit
+ */
+declare function createDefaultCircuit(qubits?: number): Circuit;
+
+export { Circuit, CircuitEditor, type CircuitEditorProps, CodeEditor, type CodeEditorProps, Operations, type OperationsProps, QamposerConfig, QamposerContextValue, QamposerMicro, type QamposerMicroProps, QamposerProvider, QamposerProviderProps$1 as QamposerProviderProps, QasmParseResult, type QiskitAdapterConfig, SimulationAdapter, SimulationCompleteEvent, SimulationControls, type SimulationControlsProps, Theme, circuitToQasm, createDefaultCircuit, generateGateId, noopAdapter, qasmToCircuit, qiskitAdapter, useQamposer };

package/dist/index.d.ts

@@ -0,0 +1,185 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { Q as QamposerProviderProps$1, T as Theme, C as Circuit, S as SimulationAdapter, a as SimulationCompleteEvent, b as QamposerConfig, c as QamposerContextValue, d as QasmParseResult } from './index-BbUFQqpD.js';
+export { h as CircuitRequest, G as Gate, g as GateInfo, f as GateType, j as QSpherePoint, i as SimulationResult, e as ThemeProvider, u as useTheme } from './index-BbUFQqpD.js';
+import { ReactNode } from 'react';
+
+interface QamposerMicroProps extends Omit<QamposerProviderProps$1, 'children'> {
+    /** Additional CSS class */
+    className?: string;
+    /** Show header (default: true) */
+    showHeader?: boolean;
+    /** Custom title (default: 'Qamposer') */
+    title?: string;
+    /** Custom ratio for operations:circuit (default: '1fr 3fr') */
+    gridTemplate?: string;
+    /** Default theme (default: 'dark') */
+    defaultTheme?: Theme;
+    /** Show theme toggle button (default: true) */
+    showThemeToggle?: boolean;
+}
+/**
+ * QamposerMicro - Minimal Quantum Circuit Composer
+ *
+ * A compact circuit editor with:
+ * - Operations panel (gate library)
+ * - Circuit editor (drag & drop)
+ * - Simulation controls
+ *
+ * Ideal for embedding in games, educational apps, or space-constrained layouts.
+ * Exposes the same data callbacks as the full Qamposer component.
+ */
+declare function QamposerMicro({ className, showHeader, title, gridTemplate, defaultTheme, showThemeToggle, ...providerProps }: QamposerMicroProps): react_jsx_runtime.JSX.Element;
+
+interface CircuitEditorProps {
+    /** Additional CSS class */
+    className?: string;
+}
+declare function CircuitEditor({ className }?: CircuitEditorProps): react_jsx_runtime.JSX.Element;
+
+interface OperationsProps {
+    /** Additional CSS class */
+    className?: string;
+}
+declare function Operations({ className }?: OperationsProps): react_jsx_runtime.JSX.Element;
+
+interface CodeEditorProps {
+    /** Additional CSS class */
+    className?: string;
+    /** Whether to show the header */
+    showHeader?: boolean;
+    /** Placeholder text */
+    placeholder?: string;
+    /** Read-only mode */
+    readOnly?: boolean;
+}
+declare function CodeEditor({ className, showHeader, placeholder, readOnly, }: CodeEditorProps): react_jsx_runtime.JSX.Element;
+
+interface SimulationControlsProps {
+    /** Render as button only (without dialog) */
+    buttonOnly?: boolean;
+    /** Custom button label */
+    buttonLabel?: string;
+    /** Additional CSS class */
+    className?: string;
+}
+declare function SimulationControls({ buttonOnly, buttonLabel, className, }: SimulationControlsProps): react_jsx_runtime.JSX.Element;
+
+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: ReactNode;
+}
+declare function QamposerProvider({ circuit: controlledCircuit, onCircuitChange, defaultCircuit, adapter, onSimulationComplete, config: userConfig, children, }: QamposerProviderProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Hook to access Qamposer context
+ *
+ * Must be used within a QamposerProvider
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { circuit, addGate, simulate } = useQamposer();
+ *
+ *   return (
+ *     <div>
+ *       <p>Qubits: {circuit.qubits}</p>
+ *       <p>Gates: {circuit.gates.length}</p>
+ *       <button onClick={() => simulate(1024)}>Run</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useQamposer(): QamposerContextValue;
+
+/**
+ * Simulation adapter types
+ */
+
+interface QiskitAdapterConfig {
+    /** Base URL of the Qiskit backend API */
+    baseUrl: string;
+    /** Additional headers to include in requests */
+    headers?: Record<string, string>;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+}
+
+/**
+ * Qiskit backend simulation adapter
+ */
+
+/**
+ * Create a simulation adapter for Qiskit backend
+ *
+ * @example
+ * ```tsx
+ * // Simple usage with just URL
+ * const adapter = qiskitAdapter('https://api.example.com');
+ *
+ * // With configuration
+ * const adapter = qiskitAdapter({
+ *   baseUrl: 'https://api.example.com',
+ *   headers: { 'Authorization': 'Bearer token' },
+ *   timeout: 30000,
+ * });
+ * ```
+ */
+declare function qiskitAdapter(configOrUrl: string | QiskitAdapterConfig): SimulationAdapter;
+
+/**
+ * No-operation adapter for editor-only mode
+ *
+ * Use this adapter when you only need the circuit editor
+ * without simulation capabilities.
+ */
+
+/**
+ * No-op adapter that disables simulation
+ *
+ * @example
+ * ```tsx
+ * import { QamposerProvider, QamposerMicro, noopAdapter } from '@qamposer/react';
+ *
+ * // Editor-only mode - RunButton will be disabled
+ * <QamposerProvider adapter={noopAdapter}>
+ *   <QamposerMicro />
+ * </QamposerProvider>
+ * ```
+ */
+declare const noopAdapter: SimulationAdapter;
+
+/**
+ * OpenQASM 2.0 utilities for bidirectional conversion between
+ * circuit representation and QASM code.
+ */
+
+/**
+ * Convert circuit to OpenQASM 2.0 code
+ */
+declare function circuitToQasm(circuit: Circuit): string;
+/**
+ * Parse OpenQASM 2.0 code to circuit representation
+ */
+declare function qasmToCircuit(qasm: string): QasmParseResult;
+/**
+ * Generate unique gate ID
+ */
+declare function generateGateId(): string;
+/**
+ * Create a default empty circuit
+ */
+declare function createDefaultCircuit(qubits?: number): Circuit;
+
+export { Circuit, CircuitEditor, type CircuitEditorProps, CodeEditor, type CodeEditorProps, Operations, type OperationsProps, QamposerConfig, QamposerContextValue, QamposerMicro, type QamposerMicroProps, QamposerProvider, QamposerProviderProps$1 as QamposerProviderProps, QasmParseResult, type QiskitAdapterConfig, SimulationAdapter, SimulationCompleteEvent, SimulationControls, type SimulationControlsProps, Theme, circuitToQasm, createDefaultCircuit, generateGateId, noopAdapter, qasmToCircuit, qiskitAdapter, useQamposer };