qsharp-lang 1.17.1-dev → 1.17.2-dev

package/docs/Std.ResourceEstimation/BeginEstimateCaching.md

@@ -2,7 +2,7 @@
 uid: Qdk.Std.ResourceEstimation.BeginEstimateCaching
 title: BeginEstimateCaching function
 description: "Q# BeginEstimateCaching function: Informs the resource estimator of the start of the code fragment for which estimates caching can be done. This function is only available when using resource estimator execution target."
-ms.date: 05/28/2025
+ms.date: 06/18/2025
 qsharp.kind: function
 qsharp.package: __Std__
 qsharp.namespace: Std.ResourceEstimation

package/docs/Std.ResourceEstimation/BeginRepeatEstimates.md

@@ -2,7 +2,7 @@
 uid: Qdk.Std.ResourceEstimation.BeginRepeatEstimates
 title: BeginRepeatEstimates operation
 description: "Q# BeginRepeatEstimates operation: Instructs the resource estimator to assume that the resources from the call of this operation until a call to `EndRepeatEstimates` are accounted for `count` times, without the need to execute the code that many times. Calls to `BeginRepeatEstimates` and `EndRepeatEstimates` can be nested. A helper operation `RepeatEstimates` allows to call the two functions in a `within` block."
-ms.date: 05/28/2025
+ms.date: 06/18/2025
 qsharp.kind: operation
 qsharp.package: __Std__
 qsharp.namespace: Std.ResourceEstimation

package/docs/Std.ResourceEstimation/CczCount.md

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

package/docs/Std.ResourceEstimation/EndEstimateCaching.md

@@ -2,7 +2,7 @@
 uid: Qdk.Std.ResourceEstimation.EndEstimateCaching
 title: EndEstimateCaching function
 description: "Q# EndEstimateCaching function: Instructs the resource estimator to stop estimates caching because the code fragment in consideration is over. This function is only available when using resource estimator execution target."
-ms.date: 05/28/2025
+ms.date: 06/18/2025
 qsharp.kind: function
 qsharp.package: __Std__
 qsharp.namespace: Std.ResourceEstimation

package/docs/Std.ResourceEstimation/EndRepeatEstimates.md

@@ -2,7 +2,7 @@
 uid: Qdk.Std.ResourceEstimation.EndRepeatEstimates
 title: EndRepeatEstimates operation
 description: "Q# EndRepeatEstimates operation: Companion operation to `BeginRepeatEstimates`."
-ms.date: 05/28/2025
+ms.date: 06/18/2025
 qsharp.kind: operation
 qsharp.package: __Std__
 qsharp.namespace: Std.ResourceEstimation

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: 05/28/2025
+ms.date: 06/18/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: 05/28/2025
+ms.date: 06/18/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: 05/28/2025
+ms.date: 06/18/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: 05/28/2025
+ms.date: 06/18/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: 05/28/2025
+ms.date: 06/18/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: 05/28/2025
+ms.date: 06/18/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: 05/28/2025
+ms.date: 06/18/2025
 qsharp.kind: function
 qsharp.package: __Std__
 qsharp.namespace: Std.ResourceEstimation

package/docs/Std.ResourceEstimation/index.md

@@ -2,9 +2,7 @@
 uid: Qdk.Std.ResourceEstimation-toc
 title: Std.ResourceEstimation namespace
 description: Table of contents for the Q# ResourceEstimation namespace
-author: {AUTHOR}
-ms.author: {MS_AUTHOR}
-ms.date: 05/28/2025
+ms.date: 06/18/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: 05/28/2025
+ms.date: 06/18/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: 05/28/2025
+ms.date: 06/18/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: 05/28/2025
+ms.date: 06/18/2025
 qsharp.kind: operation
 qsharp.package: __Std__
 qsharp.namespace: Std.StatePreparation

package/docs/Std.StatePreparation/index.md

@@ -2,9 +2,7 @@
 uid: Qdk.Std.StatePreparation-toc
 title: Std.StatePreparation namespace
 description: Table of contents for the Q# StatePreparation namespace
-author: {AUTHOR}
-ms.author: {MS_AUTHOR}
-ms.date: 05/28/2025
+ms.date: 06/18/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: 05/28/2025
+ms.date: 06/18/2025
 qsharp.kind: operation
 qsharp.package: __Std__
 qsharp.namespace: Std.TableLookup

package/docs/Std.TableLookup/index.md

@@ -2,9 +2,7 @@
 uid: Qdk.Std.TableLookup-toc
 title: Std.TableLookup namespace
 description: Table of contents for the Q# TableLookup namespace
-author: {AUTHOR}
-ms.author: {MS_AUTHOR}
-ms.date: 05/28/2025
+ms.date: 06/18/2025
 ms.topic: landing-page
 ---
 

package/docs/index.md

@@ -2,9 +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
-author: {AUTHOR}
-ms.author: {MS_AUTHOR}
-ms.date: 05/28/2025
+ms.date: 06/18/2025
 ms.topic: landing-page
 ---
 
@@ -12,21 +10,21 @@ ms.topic: landing-page
 
 The Q# standard library contains the following namespaces:
 
-| Namespace                                                                                                 | Description                                                  |
-| --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
-| [`Microsoft.Quantum.Core`](xref:Qdk.Microsoft.Quantum.Core-toc)                                           | Re-exported functions.                                       |
-| [`Std.Arrays`](xref:Qdk.Std.Arrays-toc)                                                                   | Items for working with arrays.                               |
-| [`Std.Canon`](xref:Qdk.Std.Canon-toc)                                                                     | Canonical implementations of common classical and quantum utilities.|
-| [`Std.Convert`](xref:Qdk.Std.Convert-toc)                                                                 | Items for converting between different types.                |
-| [`Std.Core`](xref:Qdk.Std.Core-toc)                                                                       | Items for language built-in operations.                      |
-| [`Std.Diagnostics`](xref:Qdk.Std.Diagnostics-toc)                                                         | Items for debugging and testing quantum programs.            |
-| [`Std.Intrinsic`](xref:Qdk.Std.Intrinsic-toc)                                                             | Items that provide core quantum operations.                  |
-| [`Std.Logical`](xref:Qdk.Std.Logical-toc)                                                                 | Boolean Logic functions.                                     |
-| [`Std.Math`](xref:Qdk.Std.Math-toc)                                                                       | Items for classical math operations.                         |
-| [`Std.Measurement`](xref:Qdk.Std.Measurement-toc)                                                         | Items for measuring quantum results.                         |
-| [`Std.Random`](xref:Qdk.Std.Random-toc)                                                                   | Items for creating random values.                            |
-| [`Std.Range`](xref:Qdk.Std.Range-toc)                                                                     | Items for working with ranges.                               |
-| [`Std.ResourceEstimation`](xref:Qdk.Std.ResourceEstimation-toc)                                           | Items for working with the Azure Quantum Resource Estimator. |
-| [`Microsoft.Quantum.Unstable.Arithmetic`](xref:Qdk.Microsoft.Quantum.Unstable.Arithmetic-toc)             | Items for working with quantum arithmetic operations.        |
-| [`Microsoft.Quantum.Unstable.StatePreparation`](xref:Qdk.Microsoft.Quantum.Unstable.StatePreparation-toc) | Items for preparing a quantum state.                         |
-| [`Microsoft.Quantum.Unstable.TableLookup`](xref:Qdk.Microsoft.Quantum.Unstable.TableLookup-toc)           | Items for performing quantum table lookups.                  |
+| Namespace                                                       | Description                                                          |
+| --------------------------------------------------------------- | -------------------------------------------------------------------- |
+| [`Microsoft.Quantum.Core`](xref:Qdk.Microsoft.Quantum.Core-toc) | Re-exported functions.                                               |
+| [`Std.Arithmetic`](xref:Qdk.Std.Arithmetic-toc)                 | Items for working with quantum arithmetic operations.                |
+| [`Std.Arrays`](xref:Qdk.Std.Arrays-toc)                         | Items for working with arrays.                                       |
+| [`Std.Canon`](xref:Qdk.Std.Canon-toc)                           | Canonical implementations of common classical and quantum utilities. |
+| [`Std.Convert`](xref:Qdk.Std.Convert-toc)                       | Items for converting between different types.                        |
+| [`Std.Core`](xref:Qdk.Std.Core-toc)                             | Items for language built-in operations.                              |
+| [`Std.Diagnostics`](xref:Qdk.Std.Diagnostics-toc)               | Items for debugging and testing quantum programs.                    |
+| [`Std.Intrinsic`](xref:Qdk.Std.Intrinsic-toc)                   | Items that provide core quantum operations.                          |
+| [`Std.Logical`](xref:Qdk.Std.Logical-toc)                       | Boolean Logic functions.                                             |
+| [`Std.Math`](xref:Qdk.Std.Math-toc)                             | Items for classical math operations.                                 |
+| [`Std.Measurement`](xref:Qdk.Std.Measurement-toc)               | Items for measuring quantum results.                                 |
+| [`Std.Random`](xref:Qdk.Std.Random-toc)                         | Items for creating random values.                                    |
+| [`Std.Range`](xref:Qdk.Std.Range-toc)                           | Items for working with ranges.                                       |
+| [`Std.ResourceEstimation`](xref:Qdk.Std.ResourceEstimation-toc) | Items for working with the Azure Quantum Resource Estimator.         |
+| [`Std.StatePreparation`](xref:Qdk.Std.StatePreparation-toc)     | Items for preparing a quantum state.                                 |
+| [`Std.TableLookup`](xref:Qdk.Std.TableLookup-toc)               | Items for performing quantum table lookups.                          |

package/docs/toc.yml

@@ -93,11 +93,13 @@
   - {name: ApplyControlledOnBitString, uid: Qdk.Std.Canon.ApplyControlledOnBitString}
   - {name: ApplyControlledOnInt, uid: Qdk.Std.Canon.ApplyControlledOnInt}
   - {name: ApplyOperationPowerA, uid: Qdk.Std.Canon.ApplyOperationPowerA}
+  - {name: ApplyOperationPowerCA, uid: Qdk.Std.Canon.ApplyOperationPowerCA}
   - {name: ApplyP, uid: Qdk.Std.Canon.ApplyP}
   - {name: ApplyPauli, uid: Qdk.Std.Canon.ApplyPauli}
   - {name: ApplyPauliFromBitString, uid: Qdk.Std.Canon.ApplyPauliFromBitString}
   - {name: ApplyPauliFromInt, uid: Qdk.Std.Canon.ApplyPauliFromInt}
   - {name: ApplyQFT, uid: Qdk.Std.Canon.ApplyQFT}
+  - {name: ApplyQPE, uid: Qdk.Std.Canon.ApplyQPE}
   - {name: ApplyToEach, uid: Qdk.Std.Canon.ApplyToEach}
   - {name: ApplyToEachA, uid: Qdk.Std.Canon.ApplyToEachA}
   - {name: ApplyToEachC, uid: Qdk.Std.Canon.ApplyToEachC}

package/lib/node/qsc_wasm.cjs

@@ -1102,12 +1102,15 @@ class ProjectLoader {
     }
     /**
      * @param {string} file_path
+     * @param {string | null} [source]
      * @returns {Promise<IProjectConfig>}
      */
-    load_openqasm_project(file_path) {
+    load_openqasm_project(file_path, source) {
         const ptr0 = passStringToWasm0(file_path, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
         const len0 = WASM_VECTOR_LEN;
-        const ret = wasm.projectloader_load_openqasm_project(this.__wbg_ptr, ptr0, len0);
+        var ptr1 = isLikeNone(source) ? 0 : passStringToWasm0(source, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
+        var len1 = WASM_VECTOR_LEN;
+        const ret = wasm.projectloader_load_openqasm_project(this.__wbg_ptr, ptr0, len0, ptr1, len1);
         return takeObject(ret);
     }
 }
@@ -1412,10 +1415,10 @@ module.exports.__wbg_require_79b1e9274cde3c87 = function() { return handleError(
     return addHeapObject(ret);
 }, arguments) };
 
-module.exports.__wbg_resolvePath_589375b90e08e655 = function(arg0, arg1, arg2, arg3, arg4) {
+module.exports.__wbg_resolvePath_b4556f7b4689ad4a = function() { return handleError(function (arg0, arg1, arg2, arg3, arg4) {
     const ret = getObject(arg0).resolvePath(getStringFromWasm0(arg1, arg2), getStringFromWasm0(arg3, arg4));
     return addHeapObject(ret);
-};
+}, arguments) };
 
 module.exports.__wbg_resolve_03bf127fbf612c20 = function(arg0) {
     const ret = Promise.resolve(getObject(arg0));
@@ -1524,8 +1527,8 @@ module.exports.__wbindgen_cb_drop = function(arg0) {
     return ret;
 };
 
-module.exports.__wbindgen_closure_wrapper1005 = function(arg0, arg1, arg2) {
-    const ret = makeMutClosure(arg0, arg1, 392, __wbg_adapter_52);
+module.exports.__wbindgen_closure_wrapper981 = function(arg0, arg1, arg2) {
+    const ret = makeMutClosure(arg0, arg1, 385, __wbg_adapter_52);
     return addHeapObject(ret);
 };
 

package/lib/node/qsc_wasm.d.cts

@@ -104,6 +104,7 @@ export interface IWorkspaceConfiguration {
         packageType?: "exe" | "lib";
         languageFeatures?: LanguageFeatures[];
         lints?: ({ lint: string; level: string } | { group: string; level: string })[];
+        devDiagnostics?: boolean;
     }
 
 export interface ICodeAction {
@@ -318,5 +319,5 @@ export class ProjectLoader {
   free(): void;
   constructor(project_host: IProjectHost);
   load_project_with_deps(directory: string): Promise<IProjectConfig>;
-  load_openqasm_project(file_path: string): Promise<IProjectConfig>;
+  load_openqasm_project(file_path: string, source?: string | null): Promise<IProjectConfig>;
 }

package/lib/web/qsc_wasm.d.ts

@@ -104,6 +104,7 @@ export interface IWorkspaceConfiguration {
         packageType?: "exe" | "lib";
         languageFeatures?: LanguageFeatures[];
         lints?: ({ lint: string; level: string } | { group: string; level: string })[];
+        devDiagnostics?: boolean;
     }
 
 export interface ICodeAction {
@@ -318,7 +319,7 @@ export class ProjectLoader {
   free(): void;
   constructor(project_host: IProjectHost);
   load_project_with_deps(directory: string): Promise<IProjectConfig>;
-  load_openqasm_project(file_path: string): Promise<IProjectConfig>;
+  load_openqasm_project(file_path: string, source?: string | null): Promise<IProjectConfig>;
 }
 
 export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
@@ -361,7 +362,7 @@ export interface InitOutput {
   readonly __wbg_projectloader_free: (a: number, b: number) => void;
   readonly projectloader_new: (a: number) => number;
   readonly projectloader_load_project_with_deps: (a: number, b: number, c: number) => number;
-  readonly projectloader_load_openqasm_project: (a: number, b: number, c: number) => number;
+  readonly projectloader_load_openqasm_project: (a: number, b: number, c: number, d: number, e: number) => number;
   readonly git_hash: (a: number) => void;
   readonly get_qir: (a: number, b: number) => void;
   readonly get_estimates: (a: number, b: number, c: number, d: number, e: number, f: number) => void;

package/lib/web/qsc_wasm.js

@@ -1096,12 +1096,15 @@ export class ProjectLoader {
     }
     /**
      * @param {string} file_path
+     * @param {string | null} [source]
      * @returns {Promise<IProjectConfig>}
      */
-    load_openqasm_project(file_path) {
+    load_openqasm_project(file_path, source) {
         const ptr0 = passStringToWasm0(file_path, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
         const len0 = WASM_VECTOR_LEN;
-        const ret = wasm.projectloader_load_openqasm_project(this.__wbg_ptr, ptr0, len0);
+        var ptr1 = isLikeNone(source) ? 0 : passStringToWasm0(source, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
+        var len1 = WASM_VECTOR_LEN;
+        const ret = wasm.projectloader_load_openqasm_project(this.__wbg_ptr, ptr0, len0, ptr1, len1);
         return takeObject(ret);
     }
 }
@@ -1388,10 +1391,10 @@ function __wbg_get_imports() {
         const ret = module.require;
         return addHeapObject(ret);
     }, arguments) };
-    imports.wbg.__wbg_resolvePath_589375b90e08e655 = function(arg0, arg1, arg2, arg3, arg4) {
+    imports.wbg.__wbg_resolvePath_b4556f7b4689ad4a = function() { return handleError(function (arg0, arg1, arg2, arg3, arg4) {
         const ret = getObject(arg0).resolvePath(getStringFromWasm0(arg1, arg2), getStringFromWasm0(arg3, arg4));
         return addHeapObject(ret);
-    };
+    }, arguments) };
     imports.wbg.__wbg_resolve_03bf127fbf612c20 = function(arg0) {
         const ret = Promise.resolve(getObject(arg0));
         return addHeapObject(ret);
@@ -1479,8 +1482,8 @@ function __wbg_get_imports() {
         const ret = false;
         return ret;
     };
-    imports.wbg.__wbindgen_closure_wrapper1005 = function(arg0, arg1, arg2) {
-        const ret = makeMutClosure(arg0, arg1, 392, __wbg_adapter_52);
+    imports.wbg.__wbindgen_closure_wrapper981 = function(arg0, arg1, arg2) {
+        const ret = makeMutClosure(arg0, arg1, 385, __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.17.1-dev",
+  "version": "1.17.2-dev",
   "license": "MIT",
   "engines": {
     "node": ">=16.17.0"
@@ -27,9 +27,10 @@
   "scripts": {
     "build": "npm run docs && npm run generate && npm run build:tsc",
     "generate": "node generate_katas_content.js && node generate_samples_content.js",
+    "generate:force": "node generate_katas_content.js --force && node generate_samples_content.js",
     "docs": "node generate_docs.js",
-    "build:tsc": "node ../../node_modules/typescript/bin/tsc -p ./src/tsconfig.json",
-    "tsc:watch": "node ../../node_modules/typescript/bin/tsc -p ./src/tsconfig.json --watch --preserveWatchOutput",
+    "build:tsc": "node ../../../node_modules/typescript/bin/tsc -p ./src/tsconfig.json",
+    "tsc:watch": "node ../../../node_modules/typescript/bin/tsc -p ./src/tsconfig.json --watch --preserveWatchOutput",
     "test": "node --test"
   },
   "type": "module",

package/ux/circuit-vis/circuit.ts

@@ -15,7 +15,7 @@ export {
   type Unitary,
   type Parameter,
   type Qubit,
-} from "../../src/shared/circuit";
+} from "../../src/data-structures/circuit";
 
-export { CURRENT_VERSION } from "../../src/shared/circuit";
-export { toCircuitGroup } from "../../src/shared/legacyCircuitUpdate";
+export { CURRENT_VERSION } from "../../src/data-structures/circuit";
+export { toCircuitGroup } from "../../src/data-structures/legacyCircuitUpdate";

package/ux/circuit-vis/draggable.ts

@@ -1,7 +1,6 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT license.
 
-import { getMinMaxRegIdx } from "../../src/utils";
 import { ComponentGrid, Operation } from "./circuit";
 import {
   gatePadding,
@@ -18,6 +17,7 @@ import { Sqore } from "./sqore";
 import {
   findLocation,
   getHostElems,
+  getMinMaxRegIdx,
   getToolboxElems,
   getWireData,
   locationStringToIndexes,

package/ux/circuit-vis/events.ts

@@ -15,6 +15,7 @@ import {
   findParentArray,
   deepEqual,
   getQubitLabelElems,
+  getMinMaxRegIdx,
 } from "./utils";
 import { addContextMenuToHostElem, promptForArguments } from "./contextMenu";
 import {
@@ -35,7 +36,7 @@ import {
   makeDropzoneBox,
   removeAllWireDropzones,
 } from "./draggable";
-import { getMinMaxRegIdx, getOperationRegisters } from "../../src/utils";
+import { getOperationRegisters } from "../../src/utils";
 
 let events: CircuitEvents | null = null;
 

package/ux/circuit-vis/index.ts

@@ -12,6 +12,7 @@ import { CircuitGroup } from "./circuit";
  * @param renderDepth Initial layer depth at which to render gates.
  * @param isEditable Whether the circuit is editable.
  * @param editCallback Callback function to be called when the circuit is edited.
+ * @param runCallback Callback function to be called when the circuit is run.
  */
 export const draw = (
   circuitGroup: CircuitGroup,
@@ -19,8 +20,9 @@ export const draw = (
   renderDepth = 0,
   isEditable = false,
   editCallback?: (circuitGroup: CircuitGroup) => void,
+  runCallback?: () => void,
 ): void => {
-  const sqore = new Sqore(circuitGroup, isEditable, editCallback);
+  const sqore = new Sqore(circuitGroup, isEditable, editCallback, runCallback);
   sqore.draw(container, renderDepth);
 };
 

package/ux/circuit-vis/panel.ts

@@ -63,6 +63,23 @@ const createPanel = (container: HTMLElement): void => {
   }
 };
 
+/**
+ * Enable the run button in the toolbox panel.
+ * This function makes the run button visible and adds a click event listener.
+ * @param container     HTML element containing the toolbox panel
+ * @param callback      Callback function to execute when the run button is clicked
+ */
+const enableRunButton = (
+  container: HTMLElement,
+  callback: () => void,
+): void => {
+  const runButton = container.querySelector(".svg-run-button");
+  if (runButton && runButton.getAttribute("visibility") !== "visible") {
+    runButton.setAttribute("visibility", "visible");
+    runButton.addEventListener("click", callback);
+  }
+};
+
 /**
  * Function to produce panel element
  * @param context       Context object to manage extension state
@@ -108,6 +125,10 @@ const _createToolbox = (): HTMLElement => {
   svgElem.classList.add("toolbox-panel-svg");
   _childrenSvg(svgElem, gateElems);
 
+  // Append run button
+  const runButtonGroup = _createRunButton(prefixY + gateHeight + 20);
+  svgElem.appendChild(runButtonGroup);
+
   // Generate toolbox panel
   const toolboxElem = _elem("div", "toolbox-panel");
   _children(toolboxElem, [_title("Toolbox")]);
@@ -116,6 +137,48 @@ const _createToolbox = (): HTMLElement => {
   return toolboxElem;
 };
 
+/**
+ * Function to create the run button in the toolbox panel
+ * @param buttonY      Y coordinate for the top of the button
+ * @returns            SVG group element containing the run button
+ */
+const _createRunButton = (buttonY: number): SVGGElement => {
+  const buttonWidth = minGateWidth * 2 + horizontalGap;
+  const buttonHeight = gateHeight;
+  const buttonX = 1;
+
+  const runButtonGroup = document.createElementNS(
+    "http://www.w3.org/2000/svg",
+    "g",
+  );
+  runButtonGroup.setAttribute("class", "svg-run-button");
+  runButtonGroup.setAttribute("tabindex", "0");
+  runButtonGroup.setAttribute("role", "button");
+
+  // Rectangle background
+  const rect = document.createElementNS("http://www.w3.org/2000/svg", "rect");
+  rect.setAttribute("x", buttonX.toString());
+  rect.setAttribute("y", buttonY.toString());
+  rect.setAttribute("width", buttonWidth.toString());
+  rect.setAttribute("height", buttonHeight.toString());
+  rect.setAttribute("class", "svg-run-button-rect");
+
+  // Text label
+  const text = document.createElementNS("http://www.w3.org/2000/svg", "text");
+  text.setAttribute("x", (buttonX + buttonWidth / 2).toString());
+  text.setAttribute("y", (buttonY + buttonHeight / 2).toString());
+  text.setAttribute("class", "svg-run-button-text");
+  text.textContent = "Run";
+
+  // Add elements to group
+  runButtonGroup.appendChild(rect);
+  runButtonGroup.appendChild(text);
+
+  // The run button should be hidden by default
+  runButtonGroup.setAttribute("visibility", "hidden");
+  return runButtonGroup;
+};
+
 /**
  * Factory function to produce HTML element
  * @param tag       Tag name
@@ -331,4 +394,4 @@ toolboxGateDictionary["RX"].params = [{ name: "theta", type: "Double" }];
 toolboxGateDictionary["RY"].params = [{ name: "theta", type: "Double" }];
 toolboxGateDictionary["RZ"].params = [{ name: "theta", type: "Double" }];
 
-export { createPanel, toolboxGateDictionary, toRenderData };
+export { createPanel, enableRunButton, toolboxGateDictionary, toRenderData };

package/ux/circuit-vis/register.ts

@@ -6,4 +6,4 @@ export {
   type Register,
   type RegisterMap,
   type RegisterRenderData,
-} from "../../src/shared/register";
+} from "../../src/data-structures/register";

package/ux/circuit-vis/sqore.ts

@@ -18,7 +18,7 @@ import { createUUID } from "./utils";
 import { gateHeight, minGateWidth, minToolboxHeight, svgNS } from "./constants";
 import { createDropzones } from "./draggable";
 import { enableEvents } from "./events";
-import { createPanel } from "./panel";
+import { createPanel, enableRunButton } from "./panel";
 
 /**
  * Contains render data for visualization.
@@ -54,11 +54,13 @@ export class Sqore {
    * @param circuitGroup Group of circuits to be visualized.
    * @param isEditable Whether the circuit is editable.
    * @param editCallback Callback function to be called when the circuit is edited.
+   * @param runCallback Callback function to be called when the circuit is run.
    */
   constructor(
     public circuitGroup: CircuitGroup,
     readonly isEditable = false,
     private editCallback?: (circuitGroup: CircuitGroup) => void,
+    private runCallback?: () => void,
   ) {
     if (
       this.circuitGroup == null ||
@@ -147,6 +149,10 @@ export class Sqore {
     if (this.isEditable) {
       createDropzones(container, this);
       createPanel(container);
+      if (this.runCallback != undefined) {
+        const callback = this.runCallback;
+        enableRunButton(container, callback);
+      }
       enableEvents(container, this, () => this.renderCircuit(container));
       if (this.editCallback != undefined) {
         this.editCallback(this.minimizeCircuits(this.circuitGroup));