qsharp-lang 1.22.2-dev → 1.22.4-dev

package/docs/Std.ResourceEstimation/MeasurementCount.md

@@ -2,7 +2,7 @@
 uid: Qdk.Std.ResourceEstimation.MeasurementCount
 title: MeasurementCount function
 description: "Q# MeasurementCount function: Returns a tuple that can be passed to the `AccountForEstimates` operation to specify that the number Measurements is equal to the `amount`."
-ms.date: 11/11/2025
+ms.date: 11/25/2025
 qsharp.kind: function
 qsharp.package: __Std__
 qsharp.namespace: Std.ResourceEstimation

package/docs/Std.ResourceEstimation/PSSPCLayout.md

@@ -2,7 +2,7 @@
 uid: Qdk.Std.ResourceEstimation.PSSPCLayout
 title: PSSPCLayout function
 description: "Q# PSSPCLayout function: Pass the value returned by the function to the `AccountForEstimates` operation to indicate Parallel Synthesis Sequential Pauli Computation (PSSPC) layout. See https://arxiv.org/pdf/2211.07629.pdf for details."
-ms.date: 11/11/2025
+ms.date: 11/25/2025
 qsharp.kind: function
 qsharp.package: __Std__
 qsharp.namespace: Std.ResourceEstimation

package/docs/Std.ResourceEstimation/RepeatEstimates.md

@@ -2,7 +2,7 @@
 uid: Qdk.Std.ResourceEstimation.RepeatEstimates
 title: RepeatEstimates operation
 description: "Q# RepeatEstimates operation: Instructs the resource estimator to assume that the resources from the call of this operation until a call to `Adjoint RepeatEstimates` are accounted for `count` times, without the need to execute the code that many times."
-ms.date: 11/11/2025
+ms.date: 11/25/2025
 qsharp.kind: operation
 qsharp.package: __Std__
 qsharp.namespace: Std.ResourceEstimation

package/docs/Std.ResourceEstimation/RotationCount.md

@@ -2,7 +2,7 @@
 uid: Qdk.Std.ResourceEstimation.RotationCount
 title: RotationCount function
 description: "Q# RotationCount function: Returns a tuple that can be passed to the `AccountForEstimates` operation to specify that the number of rotations is equal to the `amount`."
-ms.date: 11/11/2025
+ms.date: 11/25/2025
 qsharp.kind: function
 qsharp.package: __Std__
 qsharp.namespace: Std.ResourceEstimation

package/docs/Std.ResourceEstimation/RotationDepth.md

@@ -2,7 +2,7 @@
 uid: Qdk.Std.ResourceEstimation.RotationDepth
 title: RotationDepth function
 description: "Q# RotationDepth function: Returns a tuple that can be passed to the `AccountForEstimates` operation to specify that the rotation depth is equal to the `amount`."
-ms.date: 11/11/2025
+ms.date: 11/25/2025
 qsharp.kind: function
 qsharp.package: __Std__
 qsharp.namespace: Std.ResourceEstimation

package/docs/Std.ResourceEstimation/SingleVariant.md

@@ -2,7 +2,7 @@
 uid: Qdk.Std.ResourceEstimation.SingleVariant
 title: SingleVariant function
 description: "Q# SingleVariant function: Used to specify that there's only one execution variant in `BeginEstimateCaching` function"
-ms.date: 11/11/2025
+ms.date: 11/25/2025
 qsharp.kind: function
 qsharp.package: __Std__
 qsharp.namespace: Std.ResourceEstimation

package/docs/Std.ResourceEstimation/TCount.md

@@ -2,7 +2,7 @@
 uid: Qdk.Std.ResourceEstimation.TCount
 title: TCount function
 description: "Q# TCount function: Returns a tuple that can be passed to the `AccountForEstimates` operation to specify that the number of the T gates is equal to the `amount`."
-ms.date: 11/11/2025
+ms.date: 11/25/2025
 qsharp.kind: function
 qsharp.package: __Std__
 qsharp.namespace: Std.ResourceEstimation

package/docs/Std.ResourceEstimation/index.md

@@ -2,7 +2,7 @@
 uid: Qdk.Std.ResourceEstimation-toc
 title: Std.ResourceEstimation namespace
 description: Table of contents for the Q# ResourceEstimation namespace
-ms.date: 11/11/2025
+ms.date: 11/25/2025
 ms.topic: landing-page
 ---
 

package/docs/Std.StatePreparation/ApproximatelyPreparePureStateCP.md

@@ -2,7 +2,7 @@
 uid: Qdk.Std.StatePreparation.ApproximatelyPreparePureStateCP
 title: ApproximatelyPreparePureStateCP operation
 description: "Q# ApproximatelyPreparePureStateCP operation: Given a set of coefficients and a big-endian quantum register, prepares a state on that register described by the given coefficients, up to a given approximation tolerance."
-ms.date: 11/11/2025
+ms.date: 11/25/2025
 qsharp.kind: operation
 qsharp.package: __Std__
 qsharp.namespace: Std.StatePreparation

package/docs/Std.StatePreparation/PreparePureStateD.md

@@ -2,7 +2,7 @@
 uid: Qdk.Std.StatePreparation.PreparePureStateD
 title: PreparePureStateD operation
 description: "Q# PreparePureStateD operation: Given a set of coefficients and a big-endian quantum register, prepares a state on that register described by the given coefficients."
-ms.date: 11/11/2025
+ms.date: 11/25/2025
 qsharp.kind: operation
 qsharp.package: __Std__
 qsharp.namespace: Std.StatePreparation

package/docs/Std.StatePreparation/PrepareUniformSuperposition.md

@@ -2,7 +2,7 @@
 uid: Qdk.Std.StatePreparation.PrepareUniformSuperposition
 title: PrepareUniformSuperposition operation
 description: "Q# PrepareUniformSuperposition operation: Prepares a uniform superposition of states that represent integers 0 through `nStates - 1` in a little-endian `qubits` register."
-ms.date: 11/11/2025
+ms.date: 11/25/2025
 qsharp.kind: operation
 qsharp.package: __Std__
 qsharp.namespace: Std.StatePreparation

package/docs/Std.StatePreparation/index.md

@@ -2,7 +2,7 @@
 uid: Qdk.Std.StatePreparation-toc
 title: Std.StatePreparation namespace
 description: Table of contents for the Q# StatePreparation namespace
-ms.date: 11/11/2025
+ms.date: 11/25/2025
 ms.topic: landing-page
 ---
 

package/docs/Std.TableLookup/Select.md

@@ -2,7 +2,7 @@
 uid: Qdk.Std.TableLookup.Select
 title: Select operation
 description: "Q# Select operation: Performs table lookup using a SELECT network"
-ms.date: 11/11/2025
+ms.date: 11/25/2025
 qsharp.kind: operation
 qsharp.package: __Std__
 qsharp.namespace: Std.TableLookup

package/docs/Std.TableLookup/index.md

@@ -2,7 +2,7 @@
 uid: Qdk.Std.TableLookup-toc
 title: Std.TableLookup namespace
 description: Table of contents for the Q# TableLookup namespace
-ms.date: 11/11/2025
+ms.date: 11/25/2025
 ms.topic: landing-page
 ---
 

package/docs/index.md

@@ -2,7 +2,7 @@
 uid: Microsoft.Quantum.apiref-toc
 title: Q# standard libraries for the Azure Quantum Development Kit
 description: Table of contents for the Q# standard libraries for Azure Quantum Development Kit
-ms.date: 11/11/2025
+ms.date: 11/25/2025
 ms.topic: landing-page
 ---
 

package/lib/nodejs/qsc_wasm.cjs

@@ -378,14 +378,14 @@ module.exports.get_estimates = function(program, expr, params) {
 
 /**
  * @param {IProgramConfig} program
- * @param {boolean} simulate
- * @param {IOperationInfo | null} [operation]
+ * @param {IOperationInfo | null | undefined} operation
+ * @param {ICircuitConfig} config
  * @returns {any}
  */
-module.exports.get_circuit = function(program, simulate, operation) {
+module.exports.get_circuit = function(program, operation, config) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        wasm.get_circuit(retptr, addHeapObject(program), simulate, isLikeNone(operation) ? 0 : addHeapObject(operation));
+        wasm.get_circuit(retptr, addHeapObject(program), isLikeNone(operation) ? 0 : addHeapObject(operation), addHeapObject(config));
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -1570,8 +1570,8 @@ module.exports.__wbindgen_cb_drop = function(arg0) {
     return ret;
 };
 
-module.exports.__wbindgen_closure_wrapper1006 = function(arg0, arg1, arg2) {
-    const ret = makeMutClosure(arg0, arg1, 384, __wbg_adapter_52);
+module.exports.__wbindgen_closure_wrapper986 = function(arg0, arg1, arg2) {
+    const ret = makeMutClosure(arg0, arg1, 333, __wbg_adapter_52);
     return addHeapObject(ret);
 };
 

package/lib/nodejs/qsc_wasm.d.cts

@@ -5,7 +5,7 @@ export function setLogLevel(level: number): void;
 export function git_hash(): string;
 export function get_qir(program: IProgramConfig): string;
 export function get_estimates(program: IProgramConfig, expr: string, params: string): string;
-export function get_circuit(program: IProgramConfig, simulate: boolean, operation?: IOperationInfo | null): any;
+export function get_circuit(program: IProgramConfig, operation: IOperationInfo | null | undefined, config: ICircuitConfig): any;
 export function get_library_source_content(name: string): string | undefined;
 export function get_ast(code: string, language_features: string[]): string;
 export function get_hir(code: string, language_features: string[]): string;
@@ -266,6 +266,12 @@ export interface ITestDescriptor {
         friendlyName: string;
     }
 
+export interface ICircuitConfig {
+        maxOperations: number;
+        generationMethod: "simulate" | "classicalEval" ;
+        sourceLocations: boolean;
+    }
+
 export interface IDocFile {
         filename: string;
         metadata: string;

package/lib/web/qsc_wasm.d.ts

@@ -5,7 +5,7 @@ export function setLogLevel(level: number): void;
 export function git_hash(): string;
 export function get_qir(program: IProgramConfig): string;
 export function get_estimates(program: IProgramConfig, expr: string, params: string): string;
-export function get_circuit(program: IProgramConfig, simulate: boolean, operation?: IOperationInfo | null): any;
+export function get_circuit(program: IProgramConfig, operation: IOperationInfo | null | undefined, config: ICircuitConfig): any;
 export function get_library_source_content(name: string): string | undefined;
 export function get_ast(code: string, language_features: string[]): string;
 export function get_hir(code: string, language_features: string[]): string;
@@ -266,6 +266,12 @@ export interface ITestDescriptor {
         friendlyName: string;
     }
 
+export interface ICircuitConfig {
+        maxOperations: number;
+        generationMethod: "simulate" | "classicalEval" ;
+        sourceLocations: boolean;
+    }
+
 export interface IDocFile {
         filename: string;
         metadata: string;

package/lib/web/qsc_wasm.js

@@ -374,14 +374,14 @@ export function get_estimates(program, expr, params) {
 
 /**
  * @param {IProgramConfig} program
- * @param {boolean} simulate
- * @param {IOperationInfo | null} [operation]
+ * @param {IOperationInfo | null | undefined} operation
+ * @param {ICircuitConfig} config
  * @returns {any}
  */
-export function get_circuit(program, simulate, operation) {
+export function get_circuit(program, operation, config) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        wasm.get_circuit(retptr, addHeapObject(program), simulate, isLikeNone(operation) ? 0 : addHeapObject(operation));
+        wasm.get_circuit(retptr, addHeapObject(program), isLikeNone(operation) ? 0 : addHeapObject(operation), addHeapObject(config));
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -1525,8 +1525,8 @@ function __wbg_get_imports() {
         const ret = false;
         return ret;
     };
-    imports.wbg.__wbindgen_closure_wrapper1006 = function(arg0, arg1, arg2) {
-        const ret = makeMutClosure(arg0, arg1, 384, __wbg_adapter_52);
+    imports.wbg.__wbindgen_closure_wrapper986 = function(arg0, arg1, arg2) {
+        const ret = makeMutClosure(arg0, arg1, 333, __wbg_adapter_52);
         return addHeapObject(ret);
     };
     imports.wbg.__wbindgen_debug_string = function(arg0, arg1) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "qsharp-lang",
   "description": "qsharp language package for quantum development",
-  "version": "1.22.2-dev",
+  "version": "1.22.4-dev",
   "license": "MIT",
   "engines": {
     "node": ">=16.17.0"

package/ux/circuit-vis/circuit.ts

@@ -15,6 +15,7 @@ export {
   type Unitary,
   type Parameter,
   type Qubit,
+  type SourceLocation,
 } from "../../src/data-structures/circuit.js";
 
 export { CURRENT_VERSION } from "../../src/data-structures/circuit.js";

package/ux/circuit-vis/formatters/gateFormatter.ts

@@ -119,7 +119,27 @@ const _createGate = (
 
   const zoomBtn: SVGElement | null = _zoomButton(renderData, nestedDepth);
   if (zoomBtn != null) svgElems = svgElems.concat([zoomBtn]);
-  return group(svgElems, attributes);
+
+  const gateElem = group(svgElems, attributes);
+
+  // If there's a source location, wrap the gate in an SVG <a> element to make it clickable
+  if (renderData.link) {
+    const linkElem = createSvgElement("a", {
+      href: renderData.link.href,
+      class: "qs-circuit-source-link",
+    });
+
+    // Add title as a child <title> element for accessibility and hover tooltip
+    const titleElem = createSvgElement("title");
+    titleElem.textContent = renderData.link.title;
+    linkElem.appendChild(titleElem);
+
+    // Add the gate as a child of the link
+    linkElem.appendChild(gateElem);
+    return linkElem;
+  }
+
+  return gateElem;
 };
 
 /**
@@ -137,14 +157,17 @@ const _zoomButton = (
 ): SVGElement | null => {
   if (renderData == undefined) return null;
 
-  const [x1, y1] = _gatePosition(renderData, nestedDepth);
+  const [gateBoundingBoxX, gateBoundingBoxY] = _gateBoundingBox(
+    renderData,
+    nestedDepth,
+  );
   let { dataAttributes } = renderData;
   dataAttributes = dataAttributes || {};
 
   const expanded = "expanded" in dataAttributes;
 
-  const x = x1 + 2;
-  const y = y1 + 2;
+  const x = gateBoundingBoxX + 2;
+  const y = gateBoundingBoxY + 2;
   const circleBorder: SVGElement = circle(x, y, 10);
 
   if (expanded) {
@@ -167,45 +190,51 @@ const _zoomButton = (
 };
 
 /**
- * Calculate position of gate.
+ * Calculate the bounding box for a given operation, which
+ * may itself be a group of operations.
  *
  * @param renderData Operation render data.
  * @param nestedDepth Depth of nested operations.
  *
- * @returns Coordinates of gate: [x1, y1, x2, y2].
+ * @returns [x, y, width, height]
  */
-const _gatePosition = (
+const _gateBoundingBox = (
   renderData: GateRenderData,
   nestedDepth: number,
 ): [number, number, number, number] => {
-  const { x, width, type, targetsY } = renderData;
+  const {
+    x: xFromRenderData,
+    width: widthFromRenderData,
+    type,
+    targetsY,
+  } = renderData;
 
   const ys = targetsY?.flatMap((y) => y as number[]) || [];
   const maxY = Math.max(...ys);
   const minY = Math.min(...ys);
 
-  let x1: number, y1: number, x2: number, y2: number;
+  let x: number, y: number, width: number, height: number;
 
   switch (type) {
     case GateType.Group: {
       const padding = groupBoxPadding - nestedDepth * nestedGroupPadding;
 
-      x1 = x - 2 * padding;
-      y1 = minY - gateHeight / 2 - padding;
-      x2 = width + 2 * padding;
-      y2 = maxY + +gateHeight / 2 + padding - (minY - gateHeight / 2 - padding);
+      x = xFromRenderData - 2 * padding;
+      y = minY - gateHeight / 2 - padding;
+      width = widthFromRenderData + 2 * padding;
+      height = maxY - minY + gateHeight + 2 * padding;
 
-      return [x1, y1, x2, y2];
+      return [x, y, width, height];
     }
 
     default:
-      x1 = x - width / 2;
-      y1 = minY - gateHeight / 2;
-      x2 = x + width;
-      y2 = maxY + gateHeight / 2;
+      x = xFromRenderData - widthFromRenderData / 2;
+      y = minY - gateHeight / 2;
+      width = widthFromRenderData;
+      height = maxY - minY + gateHeight;
   }
 
-  return [x1, y1, x2, y2];
+  return [x, y, width, height];
 };
 
 /**
@@ -236,6 +265,7 @@ const _measure = (x: number, y: number, wireYs: number[]): SVGElement => {
     y + 8,
     x + width - 8,
     y - height / 2 + 8,
+    "qs-line-measure",
   );
   meter.style.pointerEvents = "none";
   mBox.setAttribute("data-wire-ys", JSON.stringify(wireYs));
@@ -376,6 +406,7 @@ const _unitaryBox = (
     argButton.setAttribute("class", "arg-button");
     elems.push(argButton);
   }
+
   return group(elems);
 };
 
@@ -388,15 +419,23 @@ const _unitaryBox = (
  * @returns SVG representation of SWAP gate.
  */
 const _swap = (renderData: GateRenderData, nestedDepth: number): SVGElement => {
-  const { x, targetsY } = renderData;
+  const { x: centerX, targetsY } = renderData;
 
   // Get SVGs of crosses
-  const [x1, y1, x2, y2] = _gatePosition(renderData, nestedDepth);
+  const [boundingBoxX, boundingBoxY, width, height] = _gateBoundingBox(
+    renderData,
+    nestedDepth,
+  );
   const ys = targetsY?.flatMap((y) => y as number[]) || [];
-
-  const bg: SVGElement = box(x1, y1, x2, y2, "gate-swap");
-  const crosses: SVGElement[] = ys.map((y) => _cross(x, y));
-  const vertLine: SVGElement = line(x, ys[0], x, ys[1]);
+  const bg: SVGElement = box(
+    boundingBoxX,
+    boundingBoxY,
+    width,
+    height,
+    "gate-swap",
+  );
+  const crosses: SVGElement[] = ys.map((y) => _cross(centerX, y));
+  const vertLine: SVGElement = line(centerX, ys[0], centerX, ys[1]);
   vertLine.style.pointerEvents = "none";
   return group([bg, ...crosses, vertLine]);
 };
@@ -549,10 +588,10 @@ const _groupedOperations = (
   nestedDepth: number,
 ): SVGElement => {
   const { children } = renderData;
-  const [x1, y1, x2, y2] = _gatePosition(renderData, nestedDepth);
+  const [x, y, w, h] = _gateBoundingBox(renderData, nestedDepth);
 
   // Draw dashed box around children gates
-  const box: SVGElement = dashedBox(x1, y1, x2, y2, "gate-unitary");
+  const box: SVGElement = dashedBox(x, y, w, h, "gate-unitary");
   const elems: SVGElement[] = [box];
   if (children != null)
     elems.push(formatGates(children as GateRenderData[][], nestedDepth + 1));

package/ux/circuit-vis/formatters/inputFormatter.ts

@@ -1,7 +1,7 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT license.
 
-import { Qubit } from "../circuit.js";
+import { Qubit, SourceLocation } from "../circuit.js";
 import { RegisterType, RegisterMap, RegisterRenderData } from "../register.js";
 import {
   leftPadding,
@@ -9,7 +9,7 @@ import {
   registerHeight,
   classicalRegHeight,
 } from "../constants.js";
-import { group, text } from "./formatUtils.js";
+import { createSvgElement, group, text } from "./formatUtils.js";
 import { mathChars } from "../utils.js";
 
 /**
@@ -23,14 +23,20 @@ import { mathChars } from "../utils.js";
  */
 const formatInputs = (
   qubits: Qubit[],
+  renderLocations?: (s: SourceLocation[]) => { title: string; href: string },
 ): { qubitWires: SVGElement; registers: RegisterMap; svgHeight: number } => {
   const qubitWires: SVGElement[] = [];
   const registers: RegisterMap = {};
 
   let currY: number = startY;
-  qubits.forEach(({ id, numResults }, wireIndex) => {
+  qubits.forEach(({ id, numResults, declarations }, wireIndex) => {
+    const link: { link?: { href: string; title: string } } = {};
+    if (renderLocations && declarations && declarations.length > 0) {
+      link.link = renderLocations(declarations);
+    }
+
     // Add qubit wire to list of qubit wires
-    qubitWires.push(qubitInput(currY, wireIndex, id.toString()));
+    qubitWires.push(qubitInput(currY, wireIndex, id.toString(), link.link));
 
     // Create qubit register
     registers[id] = { type: RegisterType.Qubit, y: currY };
@@ -73,6 +79,7 @@ const qubitInput = (
   y: number,
   wireIndex: number,
   subscript?: string,
+  link?: { href: string; title: string },
 ): SVGElement => {
   const el: SVGElement = text("", leftPadding, y, 16);
 
@@ -85,7 +92,23 @@ const qubitInput = (
   el.setAttribute("text-anchor", "start");
   el.setAttribute("dominant-baseline", "middle");
   el.setAttribute("data-wire", wireIndex.toString());
-  el.classList.add("qs-maintext");
+  el.classList.add("qs-maintext", "qs-qubit-label");
+
+  if (link) {
+    const linkElem = createSvgElement("a", {
+      href: link.href,
+      class: "qs-circuit-source-link",
+    });
+
+    // Add title as a child <title> element for accessibility and hover tooltip
+    const titleElem = createSvgElement("title");
+    titleElem.textContent = link.title;
+    linkElem.appendChild(titleElem);
+
+    // Add the gate as a child of the link
+    linkElem.appendChild(el);
+    return linkElem;
+  }
   return el;
 };
 

package/ux/circuit-vis/gateRenderData.ts

@@ -55,4 +55,6 @@ export interface GateRenderData {
   children?: GateRenderData[][] | GateRenderData[][][];
   /** Custom data attributes to attach to gate element. */
   dataAttributes?: DataAttributes;
+  /** Link href and title for clickable gate. */
+  link?: { href: string; title: string };
 }

package/ux/circuit-vis/index.ts

@@ -1,7 +1,7 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT license.
 
-import { Sqore } from "./sqore.js";
+import { DrawOptions, Sqore } from "./sqore.js";
 import { CircuitGroup } from "./circuit.js";
 
 /**
@@ -17,13 +17,10 @@ import { CircuitGroup } from "./circuit.js";
 export const draw = (
   circuitGroup: CircuitGroup,
   container: HTMLElement,
-  renderDepth = 0,
-  isEditable = false,
-  editCallback?: (circuitGroup: CircuitGroup) => void,
-  runCallback?: () => void,
+  options: DrawOptions = {},
 ): void => {
-  const sqore = new Sqore(circuitGroup, isEditable, editCallback, runCallback);
-  sqore.draw(container, renderDepth);
+  const sqore = new Sqore(circuitGroup, options);
+  sqore.draw(container);
 };
 
 // Export types

package/ux/circuit-vis/process.ts

@@ -8,7 +8,12 @@ import {
   controlBtnOffset,
   groupBoxPadding,
 } from "./constants.js";
-import { ComponentGrid, Operation, ConditionalRender } from "./circuit.js";
+import {
+  ComponentGrid,
+  Operation,
+  ConditionalRender,
+  SourceLocation,
+} from "./circuit.js";
 import { GateRenderData, GateType } from "./gateRenderData.js";
 import { Register, RegisterMap } from "./register.js";
 import { getGateWidth } from "./utils.js";
@@ -26,6 +31,7 @@ import { getGateWidth } from "./utils.js";
 const processOperations = (
   componentGrid: ComponentGrid,
   registers: RegisterMap,
+  renderLocations?: (s: SourceLocation[]) => { title: string; href: string },
 ): { renderDataArray: GateRenderData[][]; svgWidth: number } => {
   if (componentGrid.length === 0)
     return { renderDataArray: [], svgWidth: startX + gatePadding * 2 };
@@ -40,7 +46,11 @@ const processOperations = (
   const renderDataArray: GateRenderData[][] = componentGrid.map(
     (col, colIndex) =>
       col.components.map((op) => {
-        const renderData: GateRenderData = _opToRenderData(op, registers);
+        const renderData: GateRenderData = _opToRenderData(
+          op,
+          registers,
+          renderLocations,
+        );
 
         if (
           op != null &&
@@ -141,6 +151,7 @@ const _getClassicalRegStart = (
 const _opToRenderData = (
   op: Operation | null,
   registers: RegisterMap,
+  renderLocations?: (s: SourceLocation[]) => { title: string; href: string },
 ): GateRenderData => {
   const renderData: GateRenderData = {
     type: GateType.Invalid,
@@ -274,6 +285,10 @@ const _opToRenderData = (
   // Set gate width
   renderData.width = getGateWidth(renderData);
 
+  if (op.source && renderLocations) {
+    renderData.link = renderLocations([op.source]);
+  }
+
   // Extend existing data attributes with user-provided data attributes
   if (dataAttributes != null)
     renderData.dataAttributes = {