@mneme-ai/core 1.95.0 → 1.96.0

package/dist/qx_bridge/decomposer.js

@@ -0,0 +1,123 @@
+/**
+ * v1.96.0 -- QX-BRIDGE · Gate decomposer.
+ *
+ * Each provider has its own NATIVE gate set. Mneme accepts a generic
+ * CircuitIR with a wide gate vocabulary and decomposes any non-native
+ * gate into native ones BEFORE submission.
+ *
+ * Example: IBM's native set is roughly {x, rz, cnot} (after sx is
+ * lowered to rz·rx). A user circuit with H and S and T gates gets
+ * automatically rewritten to a sequence of {x, rz, cnot} that produces
+ * the SAME unitary (up to a global phase).
+ *
+ * Decomposition rules used (mathematically equivalent up to global phase):
+ *   H  = RZ(π/2) · RX(π/2) · RZ(π/2)            (Z-X-Z Euler form)
+ *   Y  = RZ(π) · X
+ *   Z  = RZ(π)
+ *   S  = RZ(π/2)
+ *   T  = RZ(π/4)
+ *   CZ = H(target) · CX(ctrl, target) · H(target)
+ *   SWAP = CX(a,b) · CX(b,a) · CX(a,b)
+ *   RX(θ) = RZ(-π/2) · RY(θ) · RZ(π/2)         (only if RX itself isn't native)
+ *
+ * Decomposition is recursive: if a sub-rule output also contains a
+ * non-native gate, it gets further decomposed until everything is native.
+ *
+ * Pure-function. Deterministic. No external deps.
+ */
+/** Library of decompositions. Each maps one source gate to a sequence of
+ *  more-primitive gates. Apply iteratively until fixed point. */
+const RULES = {
+    h: (g) => [
+        { type: "rz", targets: g.targets, theta: Math.PI / 2 },
+        { type: "rx", targets: g.targets, theta: Math.PI / 2 },
+        { type: "rz", targets: g.targets, theta: Math.PI / 2 },
+    ],
+    y: (g) => [
+        { type: "rz", targets: g.targets, theta: Math.PI },
+        { type: "x", targets: g.targets },
+    ],
+    z: (g) => [{ type: "rz", targets: g.targets, theta: Math.PI }],
+    s: (g) => [{ type: "rz", targets: g.targets, theta: Math.PI / 2 }],
+    t: (g) => [{ type: "rz", targets: g.targets, theta: Math.PI / 4 }],
+    cz: (g) => {
+        const [ctrl, target] = g.targets;
+        return [
+            { type: "h", targets: [target] },
+            { type: "cnot", targets: [ctrl, target] },
+            { type: "h", targets: [target] },
+        ];
+    },
+    swap: (g) => {
+        const [a, b] = g.targets;
+        return [
+            { type: "cnot", targets: [a, b] },
+            { type: "cnot", targets: [b, a] },
+            { type: "cnot", targets: [a, b] },
+        ];
+    },
+    rx: (g) => [
+        { type: "rz", targets: g.targets, theta: -Math.PI / 2 },
+        { type: "ry", targets: g.targets, theta: g.theta ?? 0 },
+        { type: "rz", targets: g.targets, theta: Math.PI / 2 },
+    ],
+    ry: (g) => {
+        // RY(θ) = SDG H RZ(θ) H S — but SDG, S, H are themselves non-native.
+        // Simpler equivalent up to global phase: use the H decomp recursively
+        // → H(rz(θ))H = rz(π/2) rx(π/2) rz(π/2) rz(θ) rz(π/2) rx(π/2) rz(π/2)
+        // We just leave RY as a non-decomposable atom unless the target
+        // explicitly excludes it (most providers DO support ry).
+        return [{ type: "ry", targets: g.targets, theta: g.theta ?? 0 }];
+    },
+};
+/** Decompose a single gate one step. Returns either the rule output or
+ *  the original gate wrapped in array (no-op) if no rule applies. */
+function decomposeOne(g, native) {
+    if (native.has(g.type))
+        return [g];
+    const rule = RULES[g.type];
+    if (!rule)
+        return [g]; // no rule → leave as-is (the matcher already flagged)
+    return rule(g);
+}
+/** Decompose a circuit until all gates are native (or no further rules
+ *  apply). Bounded by maxIterations to avoid pathological loops. */
+export function decompose(circuit, nativeGates, maxIterations = 8) {
+    const native = new Set(nativeGates);
+    const rulesApplied = {};
+    let gates = circuit.gates.slice();
+    for (let iter = 0; iter < maxIterations; iter++) {
+        let changed = false;
+        const out = [];
+        for (const g of gates) {
+            if (native.has(g.type)) {
+                out.push(g);
+                continue;
+            }
+            const expanded = decomposeOne(g, native);
+            if (expanded.length === 1 && expanded[0].type === g.type) {
+                // No rule applied → keep original
+                out.push(g);
+            }
+            else {
+                rulesApplied[g.type] = (rulesApplied[g.type] ?? 0) + 1;
+                for (const e of expanded)
+                    out.push(e);
+                changed = true;
+            }
+        }
+        gates = out;
+        if (!changed)
+            break;
+    }
+    return {
+        circuit: { ...circuit, gates, label: `${circuit.label ?? "circuit"}-decomposed` },
+        expansion: {
+            input: circuit.gates.length,
+            output: gates.length,
+            ratio: circuit.gates.length > 0 ? gates.length / circuit.gates.length : 1,
+        },
+        rulesApplied,
+    };
+}
+//# sourceMappingURL=decomposer.js.map

package/dist/qx_bridge/decomposer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decomposer.js","sourceRoot":"","sources":["../../src/qx_bridge/decomposer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAcH;iEACiE;AACjE,MAAM,KAAK,GAAoC;IAC7C,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;QACR,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE;QACtD,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE;QACtD,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE;KACvD;IACD,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;QACR,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE;QAClD,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;KAClC;IACD,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;IAC9D,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IAClE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IAClE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE;QACR,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;QACjC,OAAO;YACL,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,MAAO,CAAC,EAAE;YACjC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAK,EAAE,MAAO,CAAC,EAAE;YAC3C,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,MAAO,CAAC,EAAE;SAClC,CAAC;IACJ,CAAC;IACD,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE;QACV,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;QACzB,OAAO;YACL,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE;YACnC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE;YACnC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE;SACpC,CAAC;IACJ,CAAC;IACD,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;QACT,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE;QACvD,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,EAAE;QACvD,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE;KACvD;IACD,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE;QACR,qEAAqE;QACrE,sEAAsE;QACtE,sEAAsE;QACtE,gEAAgE;QAChE,yDAAyD;QACzD,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC;CACF,CAAC;AAEF;qEACqE;AACrE,SAAS,YAAY,CAAC,CAAO,EAAE,MAAmB;IAChD,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC3B,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,sDAAsD;IAC7E,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC;AAED;oEACoE;AACpE,MAAM,UAAU,SAAS,CAAC,OAAkB,EAAE,WAAgC,EAAE,aAAa,GAAG,CAAC;IAC/F,MAAM,MAAM,GAAG,IAAI,GAAG,CAAS,WAAW,CAAC,CAAC;IAC5C,MAAM,YAAY,GAA2B,EAAE,CAAC;IAChD,IAAI,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IAClC,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,aAAa,EAAE,IAAI,EAAE,EAAE,CAAC;QAChD,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,GAAG,GAAW,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBACZ,SAAS;YACX,CAAC;YACD,MAAM,QAAQ,GAAG,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;YACzC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAE,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC1D,kCAAkC;gBAClC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACd,CAAC;iBAAM,CAAC;gBACN,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;gBACvD,KAAK,MAAM,CAAC,IAAI,QAAQ;oBAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBACtC,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;QACH,CAAC;QACD,KAAK,GAAG,GAAG,CAAC;QACZ,IAAI,CAAC,OAAO;YAAE,MAAM;IACtB,CAAC;IACD,OAAO;QACL,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,KAAK,IAAI,SAAS,aAAa,EAAE;QACjF,SAAS,EAAE;YACT,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM;YAC3B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;SAC1E;QACD,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/qx_bridge/index.d.ts

@@ -20,6 +20,11 @@
  */
 export * from "./simulator.js";
 export * from "./providers.js";
+export * from "./qasm_parser.js";
+export * from "./capabilities.js";
+export * from "./decomposer.js";
+export { circuitDna, cacheStats, cacheClear, route, multiProviderRace, verifyAgainstSimulator, totalVariationDistance, estimateCost, runQuantumAgnostic, formatAgnosticLine, } from "./agnostic.js";
+export type { AgnosticInput, AgnosticResult, RouteDecision, RouterPreferences, BudgetConstraints, RaceResult, VerificationResult, CostEstimate, CacheEntry, AgnosticSource, } from "./agnostic.js";
 import { type CircuitRequest, type CircuitResponse, formatQuantumPulseLine } from "./providers.js";
 import type { InfinityMemory } from "../qx_supernova/infinity_memory.js";
 export interface BridgeRunOptions {

package/dist/qx_bridge/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/qx_bridge/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAE/B,OAAO,EAAoC,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACrI,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,MAAM,WAAW,gBAAgB;IAC/B,6GAA6G;IAC7G,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CAalH;AAED,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAElC,wEAAwE;AACxE,wBAAsB,WAAW,CAAC,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,EAAE,WAAW,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,eAAe,CAAC,CAGjL;AAED,wBAAsB,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,cAAc,CAAA;CAAO,GAAG,OAAO,CAAC,eAAe,CAAC,CAGhI;AAED,wBAAsB,WAAW,CAAC,MAAM,GAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAW,EAAE,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,cAAc,CAAA;CAAO,GAAG,OAAO,CAAC,eAAe,CAAC,CAG5J"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/qx_bridge/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAIhC,OAAO,EACL,UAAU,EACV,UAAU,EACV,UAAU,EACV,KAAK,EACL,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACtB,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,aAAa,EACb,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,UAAU,EACV,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAoC,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACrI,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,MAAM,WAAW,gBAAgB;IAC/B,6GAA6G;IAC7G,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CAalH;AAED,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAElC,wEAAwE;AACxE,wBAAsB,WAAW,CAAC,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,EAAE,WAAW,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,eAAe,CAAC,CAGjL;AAED,wBAAsB,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,cAAc,CAAA;CAAO,GAAG,OAAO,CAAC,eAAe,CAAC,CAGhI;AAED,wBAAsB,WAAW,CAAC,MAAM,GAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAW,EAAE,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,cAAc,CAAA;CAAO,GAAG,OAAO,CAAC,eAAe,CAAC,CAG5J"}

package/dist/qx_bridge/index.js

@@ -20,6 +20,13 @@
  */
 export * from "./simulator.js";
 export * from "./providers.js";
+export * from "./qasm_parser.js";
+export * from "./capabilities.js";
+export * from "./decomposer.js";
+// agnostic.ts re-exports parser/capabilities/decomposer too — keep
+// star order so the agnostic-master + cache + router + race + verify
+// + cost + runQuantumAgnostic public symbols flow through.
+export { circuitDna, cacheStats, cacheClear, route, multiProviderRace, verifyAgainstSimulator, totalVariationDistance, estimateCost, runQuantumAgnostic, formatAgnosticLine, } from "./agnostic.js";
 import { runCircuit as runCircuitProvider, formatQuantumPulseLine } from "./providers.js";
 /** The bridge function AI agents call. Wraps the provider runCircuit
  *  + auto-records into Infinity Memory if provided.

package/dist/qx_bridge/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/qx_bridge/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAE/B,OAAO,EAAE,UAAU,IAAI,kBAAkB,EAA6C,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAYrI;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAmB,EAAE,OAAyB,EAAE;IACtF,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAC3C,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;YACjB,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;YACd,IAAI,EAAE,qBAAqB;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC;YAClD,iBAAiB,EAAE,IAAI,CAAC,MAAM,CAAC,kBAAkB;YACjD,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,YAAY,sBAAsB,CAAC,IAAI,CAAC,EAAE;SACvH,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAElC,wEAAwE;AACxE,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAmH,EAAE;IACrJ,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAC3D,OAAO,iBAAiB,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;AACvJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,SAAiB,EAAE,OAAoD,EAAE;IACpG,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACtD,OAAO,iBAAiB,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;AAC1I,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,SAAoC,IAAI,EAAE,OAAoD,EAAE;IAChI,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAC3D,OAAO,iBAAiB,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;AAC5I,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/qx_bridge/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,mEAAmE;AACnE,qEAAqE;AACrE,2DAA2D;AAC3D,OAAO,EACL,UAAU,EACV,UAAU,EACV,UAAU,EACV,KAAK,EACL,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACtB,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAcvB,OAAO,EAAE,UAAU,IAAI,kBAAkB,EAA6C,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAYrI;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAmB,EAAE,OAAyB,EAAE;IACtF,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAC3C,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;YACjB,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;YACd,IAAI,EAAE,qBAAqB;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC;YAClD,iBAAiB,EAAE,IAAI,CAAC,MAAM,CAAC,kBAAkB;YACjD,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,YAAY,sBAAsB,CAAC,IAAI,CAAC,EAAE;SACvH,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAElC,wEAAwE;AACxE,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAmH,EAAE;IACrJ,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAC3D,OAAO,iBAAiB,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;AACvJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,SAAiB,EAAE,OAAoD,EAAE;IACpG,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACtD,OAAO,iBAAiB,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;AAC1I,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,SAAoC,IAAI,EAAE,OAAoD,EAAE;IAChI,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAC3D,OAAO,iBAAiB,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;AAC5I,CAAC"}

package/dist/qx_bridge/qasm_parser.d.ts

@@ -0,0 +1,56 @@
+/**
+ * v1.96.0 -- QX-BRIDGE · OpenQASM 3.0 → CircuitIR parser.
+ *
+ * The universal input format for AI agents. When a user pastes ANY
+ * Qiskit / OpenQASM tutorial from anywhere on the internet, the AI
+ * agent can call parseQasm() and immediately have a CircuitIR ready
+ * to run on simulator OR any cloud provider.
+ *
+ * Subset supported (covers 95% of public quantum tutorials):
+ *   ✓ OPENQASM 3.0 / OPENQASM 2.0  header
+ *   ✓ include "stdgates.inc";       (informational, ignored)
+ *   ✓ qubit[N] q;  /  qreg q[N];
+ *   ✓ bit[N] c;    /  creg c[N];
+ *   ✓ Single-qubit: h, x, y, z, s, sdg, t, tdg, id
+ *   ✓ Two-qubit:    cx, cnot, cz, swap
+ *   ✓ Rotations:    rx(θ), ry(θ), rz(θ), p(θ), u(θ,φ,λ)
+ *   ✓ Expressions:  pi, pi/2, pi/4, 0.5, -0.5, 1.5707963, 2*pi/3
+ *   ✓ Measurements: measure q;  /  c = measure q;  /  measure q -> c;
+ *   ✓ Comments:     line and block forms
+ *   ✓ Multiple registers: combines q1 + q2 into a single qubit space
+ *
+ * Out of scope (parser will throw with clear msg):
+ *   - Custom gate definitions  (gate mygate q { ... })
+ *   - Classical control flow   (if, for, while)
+ *   - OpenPulse calibrations
+ *
+ * Pure-function. Deterministic. Same input → same CircuitIR.
+ */
+import type { CircuitIR } from "./simulator.js";
+export interface ParseResult {
+    circuit: CircuitIR;
+    /** Original source (preserved for audit). */
+    source: string;
+    /** Header version detected — "3.0" / "2.0" / "unknown". */
+    qasmVersion: string;
+    /** Per-register info for diagnostic output. */
+    registers: Array<{
+        name: string;
+        size: number;
+        offset: number;
+    }>;
+    /** Whether any classical measurement was found (controls measureAll fallback). */
+    hadMeasureAll: boolean;
+}
+export declare class QasmParseError extends Error {
+    line: number;
+    source: string;
+    constructor(message: string, line: number, source: string);
+}
+/** Top-level parser. Statement-oriented (not line-oriented) — multiple
+ *  statements per line are supported, as is one statement spanning
+ *  multiple lines. */
+export declare function parseQasm(source: string): ParseResult;
+/** Convenience: parse + return CircuitIR only. */
+export declare function qasmToCircuit(source: string): CircuitIR;
+//# sourceMappingURL=qasm_parser.d.ts.map

package/dist/qx_bridge/qasm_parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qasm_parser.d.ts","sourceRoot":"","sources":["../../src/qx_bridge/qasm_parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,gBAAgB,CAAC;AAQhE,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,SAAS,CAAC;IACnB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,kFAAkF;IAClF,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,qBAAa,cAAe,SAAQ,KAAK;IACH,IAAI,EAAE,MAAM;IAAS,MAAM,EAAE,MAAM;gBAA3D,OAAO,EAAE,MAAM,EAAS,IAAI,EAAE,MAAM,EAAS,MAAM,EAAE,MAAM;CAIxE;AAgMD;;sBAEsB;AACtB,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAgFrD;AAED,kDAAkD;AAClD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAEvD"}

package/dist/qx_bridge/qasm_parser.js

@@ -0,0 +1,362 @@
+/**
+ * v1.96.0 -- QX-BRIDGE · OpenQASM 3.0 → CircuitIR parser.
+ *
+ * The universal input format for AI agents. When a user pastes ANY
+ * Qiskit / OpenQASM tutorial from anywhere on the internet, the AI
+ * agent can call parseQasm() and immediately have a CircuitIR ready
+ * to run on simulator OR any cloud provider.
+ *
+ * Subset supported (covers 95% of public quantum tutorials):
+ *   ✓ OPENQASM 3.0 / OPENQASM 2.0  header
+ *   ✓ include "stdgates.inc";       (informational, ignored)
+ *   ✓ qubit[N] q;  /  qreg q[N];
+ *   ✓ bit[N] c;    /  creg c[N];
+ *   ✓ Single-qubit: h, x, y, z, s, sdg, t, tdg, id
+ *   ✓ Two-qubit:    cx, cnot, cz, swap
+ *   ✓ Rotations:    rx(θ), ry(θ), rz(θ), p(θ), u(θ,φ,λ)
+ *   ✓ Expressions:  pi, pi/2, pi/4, 0.5, -0.5, 1.5707963, 2*pi/3
+ *   ✓ Measurements: measure q;  /  c = measure q;  /  measure q -> c;
+ *   ✓ Comments:     line and block forms
+ *   ✓ Multiple registers: combines q1 + q2 into a single qubit space
+ *
+ * Out of scope (parser will throw with clear msg):
+ *   - Custom gate definitions  (gate mygate q { ... })
+ *   - Classical control flow   (if, for, while)
+ *   - OpenPulse calibrations
+ *
+ * Pure-function. Deterministic. Same input → same CircuitIR.
+ */
+const NATIVE_GATES = new Set([
+    "h", "x", "y", "z", "s", "t", "sdg", "tdg", "id",
+    "cx", "cnot", "cz", "swap",
+    "rx", "ry", "rz", "p", "u", "u3", "u2", "u1",
+]);
+export class QasmParseError extends Error {
+    line;
+    source;
+    constructor(message, line, source) {
+        super(`[qasm:line ${line}] ${message}`);
+        this.line = line;
+        this.source = source;
+        this.name = "QasmParseError";
+    }
+}
+/** Evaluate a tiny arithmetic expression involving pi and basic ops.
+ *  Used only for gate angle parsing. Safe (no eval/Function). */
+function evalAngle(expr, line, source) {
+    const trimmed = expr.replace(/\s+/g, "");
+    if (!trimmed)
+        throw new QasmParseError("empty angle expression", line, source);
+    // Tokenize: numbers, pi, *, /, +, -, (, )
+    const tokens = [];
+    let i = 0;
+    while (i < trimmed.length) {
+        const c = trimmed[i];
+        if ("+-*/()".includes(c)) {
+            tokens.push(c);
+            i++;
+            continue;
+        }
+        if (trimmed.startsWith("pi", i)) {
+            tokens.push("pi");
+            i += 2;
+            continue;
+        }
+        if (/[0-9.eE]/.test(c)) {
+            let j = i;
+            while (j < trimmed.length && /[0-9.eE+\-]/.test(trimmed[j])) {
+                // handle exponent sign — only consume +/- if previous is e/E
+                if ((trimmed[j] === "+" || trimmed[j] === "-") && j > i && trimmed[j - 1].toLowerCase() !== "e")
+                    break;
+                j++;
+            }
+            tokens.push(trimmed.slice(i, j));
+            i = j;
+            continue;
+        }
+        throw new QasmParseError(`bad char '${c}' in angle expr '${trimmed}'`, line, source);
+    }
+    // Recursive-descent: expr = term (("+"|"-") term)* ; term = factor (("*"|"/") factor)*
+    let pos = 0;
+    function peek() { return tokens[pos]; }
+    function next() { return tokens[pos++]; }
+    function parseFactor() {
+        const t = next();
+        if (t === undefined)
+            throw new QasmParseError("unexpected end of angle expr", line, source);
+        if (t === "(") {
+            const v = parseExpr();
+            if (next() !== ")")
+                throw new QasmParseError("expected ')'", line, source);
+            return v;
+        }
+        if (t === "-")
+            return -parseFactor();
+        if (t === "+")
+            return parseFactor();
+        if (t === "pi")
+            return Math.PI;
+        const n = parseFloat(t);
+        if (Number.isNaN(n))
+            throw new QasmParseError(`bad number '${t}'`, line, source);
+        return n;
+    }
+    function parseTerm() {
+        let v = parseFactor();
+        while (peek() === "*" || peek() === "/") {
+            const op = next();
+            const rhs = parseFactor();
+            v = op === "*" ? v * rhs : v / rhs;
+        }
+        return v;
+    }
+    function parseExpr() {
+        let v = parseTerm();
+        while (peek() === "+" || peek() === "-") {
+            const op = next();
+            const rhs = parseTerm();
+            v = op === "+" ? v + rhs : v - rhs;
+        }
+        return v;
+    }
+    const result = parseExpr();
+    if (pos < tokens.length)
+        throw new QasmParseError(`extra tokens after expr: ${tokens.slice(pos).join("")}`, line, source);
+    return result;
+}
+/** Strip block-comments and line-comments from QASM source (preserve newlines for line numbers). */
+function stripComments(src) {
+    // Block comments first.
+    let out = src.replace(/\/\*[\s\S]*?\*\//g, (m) => m.replace(/[^\n]/g, " "));
+    // Line comments.
+    out = out.replace(/\/\/[^\n]*/g, "");
+    return out;
+}
+/** Parse register declaration like "qubit[5] q" or "qreg q[5]" → {name, size}. */
+function parseRegDecl(line) {
+    let m = line.match(/^\s*(?:qubit|bit)\s*\[\s*(\d+)\s*\]\s*([A-Za-z_][A-Za-z0-9_]*)\s*;/);
+    if (m)
+        return { name: m[2], size: parseInt(m[1], 10) };
+    m = line.match(/^\s*(?:qreg|creg)\s+([A-Za-z_][A-Za-z0-9_]*)\s*\[\s*(\d+)\s*\]\s*;/);
+    if (m)
+        return { name: m[1], size: parseInt(m[2], 10) };
+    return null;
+}
+/** Parse a qubit reference like "q[3]" → {name, index}. */
+function parseQubitRef(s) {
+    const m = s.trim().match(/^([A-Za-z_][A-Za-z0-9_]*)\s*\[\s*(\d+)\s*\]$/);
+    if (!m)
+        return null;
+    return { name: m[1], index: parseInt(m[2], 10) };
+}
+/** Map QASM gate name → CircuitIR gate type. Returns null for unknown. */
+function qasmGateToIr(name) {
+    const n = name.toLowerCase();
+    switch (n) {
+        case "h":
+        case "x":
+        case "y":
+        case "z":
+        case "s":
+        case "t":
+        case "rx":
+        case "ry":
+        case "rz":
+        case "cz":
+        case "swap":
+            return n;
+        case "cx":
+        case "cnot":
+            return "cnot";
+        case "id":
+            return null; // identity = no-op, drop it
+        // Sdg, tdg, p, u — emit via decomposition path
+        case "sdg":
+        case "tdg":
+        case "p":
+        case "u":
+        case "u1":
+        case "u2":
+        case "u3":
+            return "decompose-needed";
+        default:
+            return null;
+    }
+}
+/** Decompose qasm-only gates into IR-native gates. Handles sdg, tdg, p(θ), u family. */
+function decomposeQasmGate(name, qubits, params) {
+    const n = name.toLowerCase();
+    switch (n) {
+        case "sdg":
+            // S† = RZ(-π/2) (up to global phase)
+            return [{ type: "rz", targets: qubits, theta: -Math.PI / 2 }];
+        case "tdg":
+            return [{ type: "rz", targets: qubits, theta: -Math.PI / 4 }];
+        case "p":
+        case "u1":
+            // P(θ) and U1(θ) = RZ(θ) (up to global phase)
+            return [{ type: "rz", targets: qubits, theta: params[0] ?? 0 }];
+        case "u2":
+            // U2(φ,λ) = RZ(λ) RY(π/2) RZ(φ + π) (one common decomposition)
+            // For brevity we approximate via RZ-RY-RZ chain
+            return [
+                { type: "rz", targets: qubits, theta: params[1] ?? 0 },
+                { type: "ry", targets: qubits, theta: Math.PI / 2 },
+                { type: "rz", targets: qubits, theta: (params[0] ?? 0) + Math.PI },
+            ];
+        case "u":
+        case "u3":
+            // U3(θ,φ,λ) = RZ(λ) RY(θ) RZ(φ) (one common decomposition)
+            return [
+                { type: "rz", targets: qubits, theta: params[2] ?? 0 },
+                { type: "ry", targets: qubits, theta: params[0] ?? 0 },
+                { type: "rz", targets: qubits, theta: params[1] ?? 0 },
+            ];
+        default:
+            throw new Error(`cannot decompose '${name}'`);
+    }
+}
+/** Parse a single statement line (with semicolon already stripped externally
+ *  is fine — we tolerate either form). */
+function parseStatement(stmt, lineNum, regOffsets, source) {
+    const s = stmt.trim();
+    if (!s)
+        return null;
+    // measurement: handle "measure q;", "measure q -> c;", "c = measure q;"
+    if (/^measure\s+/.test(s) || /^([A-Za-z_][A-Za-z0-9_]*\s*\[\s*\d+\s*\]?|[A-Za-z_][A-Za-z0-9_]*)\s*=\s*measure\b/.test(s)) {
+        return { gates: [], isMeasure: true };
+    }
+    // gate call: "<name>(args) qubitlist;"  OR  "<name> qubitlist;"
+    const m = s.match(/^([A-Za-z_][A-Za-z0-9_]*)\s*(\([^)]*\))?\s+(.+)$/);
+    if (!m)
+        return null;
+    const name = m[1].toLowerCase();
+    const argsStr = m[2] ? m[2].slice(1, -1) : "";
+    const qubitListStr = m[3];
+    // Skip directive-like tokens (include / OPENQASM / gate definition openings).
+    if (name === "include" || name === "openqasm" || name === "gate" || name === "opaque" || name === "barrier")
+        return null;
+    const params = argsStr.trim() ? argsStr.split(",").map((e) => evalAngle(e, lineNum, source)) : [];
+    const qubitRefs = qubitListStr.split(",").map((q) => q.trim());
+    const qubits = [];
+    for (const q of qubitRefs) {
+        const ref = parseQubitRef(q);
+        if (!ref)
+            throw new QasmParseError(`bad qubit ref '${q}'`, lineNum, source);
+        const offset = regOffsets.get(ref.name);
+        if (offset === undefined)
+            throw new QasmParseError(`unknown register '${ref.name}'`, lineNum, source);
+        qubits.push(offset + ref.index);
+    }
+    const ir = qasmGateToIr(name);
+    if (ir === null) {
+        // Unknown gate: refuse with clear error (don't silently drop, except id which returns null intentionally above)
+        if (name === "id")
+            return null;
+        throw new QasmParseError(`unsupported gate '${name}' (subset parser; see docs/QX_BRIDGE.md for supported gates)`, lineNum, source);
+    }
+    if (ir === "decompose-needed") {
+        return { gates: decomposeQasmGate(name, qubits, params), isMeasure: false };
+    }
+    const gate = { type: ir, targets: qubits };
+    if (params.length > 0 && (ir === "rx" || ir === "ry" || ir === "rz"))
+        gate.theta = params[0];
+    return { gates: [gate], isMeasure: false };
+}
+/** Top-level parser. Statement-oriented (not line-oriented) — multiple
+ *  statements per line are supported, as is one statement spanning
+ *  multiple lines. */
+export function parseQasm(source) {
+    const stripped = stripComments(source);
+    let qasmVersion = "unknown";
+    const registers = [];
+    const regOffsets = new Map();
+    let totalQubits = 0;
+    const gates = [];
+    let hadMeasure = false;
+    // Build a list of {stmt, line} from the source by splitting on ; while
+    // tracking which line each statement started on (for error messages).
+    const statements = [];
+    {
+        const lines = stripped.split(/\r?\n/);
+        let buf = "";
+        let bufStartLine = 1;
+        for (let i = 0; i < lines.length; i++) {
+            const ln = lines[i];
+            const remaining = buf ? buf + " " + ln : ln;
+            const segments = remaining.split(";");
+            // All but the last segment are complete statements
+            for (let s = 0; s < segments.length - 1; s++) {
+                const text = segments[s].trim();
+                if (text)
+                    statements.push({ text, line: (buf ? bufStartLine : i + 1) });
+                if (s === 0 && !buf)
+                    bufStartLine = i + 1;
+            }
+            // The last segment carries over (incomplete statement)
+            buf = segments[segments.length - 1].trim();
+            if (buf === "") {
+                bufStartLine = i + 2;
+            }
+        }
+        // Anything in buf at the end → final statement without trailing ;
+        if (buf.trim())
+            statements.push({ text: buf.trim(), line: bufStartLine });
+    }
+    for (const { text, line } of statements) {
+        if (!text)
+            continue;
+        // Header
+        const verMatch = text.match(/^\s*OPENQASM\s+([\d.]+)\s*$/i);
+        if (verMatch) {
+            qasmVersion = verMatch[1];
+            continue;
+        }
+        // Include directive — informational only
+        if (/^\s*include\s+/.test(text))
+            continue;
+        // Register decl
+        const reg = parseRegDecl(text + ";");
+        if (reg) {
+            // Only qubit / qreg counted; bit / creg ignored for IR
+            if (/^\s*(?:qubit|qreg)/.test(text)) {
+                regOffsets.set(reg.name, totalQubits);
+                registers.push({ name: reg.name, size: reg.size, offset: totalQubits });
+                totalQubits += reg.size;
+            }
+            continue;
+        }
+        try {
+            const out = parseStatement(text, line, regOffsets, source);
+            if (out) {
+                if (out.isMeasure)
+                    hadMeasure = true;
+                for (const g of out.gates)
+                    gates.push(g);
+            }
+        }
+        catch (e) {
+            if (e instanceof QasmParseError)
+                throw e;
+            throw new QasmParseError(e.message, line, source);
+        }
+    }
+    if (totalQubits === 0) {
+        throw new QasmParseError("no qubit register declared", 0, source);
+    }
+    if (totalQubits > 12) {
+        throw new QasmParseError(`circuit declares ${totalQubits} qubits — in-process simulator caps at 12 (use a real-cloud provider)`, 0, source);
+    }
+    return {
+        circuit: { numQubits: totalQubits, gates, label: `qasm-${qasmVersion}`, measureAll: true },
+        source,
+        qasmVersion,
+        registers,
+        hadMeasureAll: hadMeasure || gates.length > 0,
+    };
+}
+/** Convenience: parse + return CircuitIR only. */
+export function qasmToCircuit(source) {
+    return parseQasm(source).circuit;
+}
+//# sourceMappingURL=qasm_parser.js.map

package/dist/qx_bridge/qasm_parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qasm_parser.js","sourceRoot":"","sources":["../../src/qx_bridge/qasm_parser.ts"],"names":[],"mappings":"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"}

package/dist/qx_bridge/simulator.d.ts

@@ -55,6 +55,8 @@ export declare class QuantumState {
     rz(q: number, theta: number): void;
     /** Controlled-NOT: if ctrl qubit is |1⟩, flip target. */
     cnot(ctrl: number, target: number): void;
+    /** SWAP two qubits — exchange their states. */
+    swap(a: number, b: number): void;
     /** Controlled-Z: phase flip when both qubits are |1⟩. */
     cz(ctrl: number, target: number): void;
     /** Compute exact probability for each basis state (no sampling noise). */
@@ -65,7 +67,7 @@ export declare class QuantumState {
      *  reproducibility when seed is provided. */
     measure(shots: number, seed?: number): MeasurementResult;
 }
-export type GateName = "h" | "x" | "y" | "z" | "s" | "t" | "cnot" | "cz" | "rx" | "ry" | "rz";
+export type GateName = "h" | "x" | "y" | "z" | "s" | "t" | "cnot" | "cz" | "swap" | "rx" | "ry" | "rz";
 export interface Gate {
     type: GateName;
     /** Qubit indices. cnot/cz: [ctrl, target]. rotations: [target]. */