feat(graph): add expandedTargets to project details on nx dev (#26911)

<!-- Please make sure you have read the submission guidelines before
posting an PR -->
<!--
https://github.com/nrwl/nx/blob/master/CONTRIBUTING.md#-submitting-a-pr
-->

<!-- Please make sure that your commit message follows our format -->
<!-- Example: `fix(nx): must begin with lowercase` -->

<!-- If this is a particularly complex change or feature addition, you
can request a dedicated Nx release for this pull request branch. Mention
someone from the Nx team or the `@nrwl/nx-pipelines-reviewers` and they
will confirm if the PR warrants its own release for testing purposes,
and generate it for you if appropriate. -->

## Current Behavior
<!-- This is the behavior we have today -->

https://nx.dev/getting-started/tutorials/gradle-tutorial#running-tasks

## Expected Behavior
<!-- This is the behavior we should expect with the changes in this PR
-->


https://nx-dev-git-feat-graph-add-expand-targets-nrwl.vercel.app/getting-started/tutorials/gradle-tutorial#running-tasks

## Related Issue(s)
<!-- Please link the issue being fixed so it gets closed when this is
merged. -->

Fixes #

---------

Co-authored-by: Max Kless <[email protected]>

docs/nx-cloud/features/split-e2e-tasks.md

@@ -55,7 +55,7 @@ You can view the available tasks for your project in the project detail view:
 nx show project myproject-e2e --web
 ```
 
-{% project-details title="Project Details View" height="100px" %}
+{% project-details title="Project Details View" %}
 
 ```json
 {

docs/shared/migration/adding-to-existing-project.md

@@ -111,7 +111,7 @@ details in a browser window.
 nx show project my-workspace --web
 ```
 
-{% project-details title="Project Details View" height="100px" %}
+{% project-details title="Project Details View" %}
 
 ```json
 {

docs/shared/migration/adding-to-monorepo.md

@@ -110,7 +110,7 @@ details in a browser window.
 nx show project my-workspace --web
 ```
 
-{% project-details title="Project Details View" height="100px" %}
+{% project-details title="Project Details View" %}
 
 ```json
 {

docs/shared/recipes/running-tasks/pass-args-to-commands.md

@@ -21,7 +21,7 @@ For this recipe we'll use a project with the following `project.json` file:
 
 And the following [final configuration](/reference/project-configuration):
 
-{% project-details title="Project Details View" height="100px" %}
+{% project-details title="Project Details View" %}
 
 ```json
 {

docs/shared/reference/project-configuration.md

@@ -12,7 +12,7 @@ Each source will [overwrite the previous source](/recipes/running-tasks/pass-arg
 nx show project myproject --web
 ```
 
-{% project-details title="Project Details View" height="100px" %}
+{% project-details title="Project Details View" %}
 
 ```json
 {

docs/shared/tutorials/angular-monorepo.md

@@ -619,7 +619,7 @@ Nx identifies available tasks for your project from [tooling configuration files
 npx nx show project angular-store-e2e --web
 ```
 
-{% project-details title="Project Details View" height="100px" %}
+{% project-details title="Project Details View" %}
 
 ```json
 {

docs/shared/tutorials/angular-standalone.md

@@ -211,7 +211,7 @@ Nx identifies available tasks for your project from [tooling configuration files
 nx show project e2e --web
 ```
 
-{% project-details title="Project Details View" height="100px" %}
+{% project-details title="Project Details View" %}
 
 ```json
 {

docs/shared/tutorials/gradle.md

@@ -126,7 +126,7 @@ that we've installed reflects Gradle's tasks to Nx, which allows it to run any o
 ./nx show project application --web
 ```
 
-{% project-details title="Project Details View" jsonFile="shared/tutorials/gradle-pdv.json" %}
+{% project-details title="Project Details View" jsonFile="shared/tutorials/gradle-pdv.json" expandedTargets=["build"] height="520px" %}
 {% /project-details %}
 
 The Nx command to run the `build` task for the `application` project is:

docs/shared/tutorials/react-monorepo.md

@@ -134,7 +134,7 @@ Nx identifies available tasks for your project from [tooling configuration files
 npx nx show project react-store
 ```
 
-{% project-details title="Project Details View (Simplified)" height="100px" %}
+{% project-details title="Project Details View (Simplified)" %}
 
 ```json
 {

graph/shared/src/lib/expanded-targets-provider.tsx

@@ -7,8 +7,16 @@ export const ExpandedTargetsContext = createContext<{
   collapseAllTargets?: () => void;
 }>({});
 
-export const ExpandedTargetsProvider = ({ children }) => {
-  const [expandedTargets, setExpandedTargets] = useState<string[]>([]);
+export const ExpandedTargetsProvider = ({
+  children,
+  initialExpanededTargets = [],
+}: {
+  children: React.ReactNode;
+  initialExpanededTargets?: string[];
+}) => {
+  const [expandedTargets, setExpandedTargets] = useState<string[]>(
+    initialExpanededTargets
+  );
 
   const toggleTarget = (targetName: string) => {
     setExpandedTargets((prevExpandedTargets) => {

graph/ui-project-details/src/lib/target-configuration-details-group-container/target-configuration-details-group-container.tsx

@@ -15,7 +15,10 @@ export function TargetConfigurationGroupContainer({
     return null;
   }
   return (
-    <div className="mb-4 w-full">
+    <div
+      id={`target-group-container-${targetGroupName}`}
+      className="mb-4 w-full"
+    >
       <TargetConfigurationGroupHeader
         targetGroupName={targetGroupName}
         targetsNumber={targetsNumber}

graph/ui-project-details/src/lib/target-configuration-details-group-header/target-configuration-details-group-header.tsx

@@ -16,6 +16,7 @@ export const TargetConfigurationGroupHeader = ({
 }: TargetConfigurationGroupHeaderProps) => {
   return (
     <header
+      id={`target-group-header-${targetGroupName}`}
       className={`flex items-center gap-2 px-4 py-2 text-lg capitalize ${className}`}
     >
       {targetGroupName}{' '}

graph/ui-project-details/src/lib/target-configuration-details-header/target-configuration-details-header.tsx

@@ -71,6 +71,7 @@ export const TargetConfigurationDetailsHeader = ({
           ? 'border-b bg-slate-50 dark:border-slate-700/60 dark:bg-slate-800'
           : ''
       )}
+      id={`target-${targetName}`}
       onClick={collapsable ? toggleCollapse : undefined}
     >
       <div className="flex items-center justify-between gap-4">

nx-dev/ui-markdoc/src/lib/tags/project-details.component.tsx

@@ -1,5 +1,12 @@
 'use client';
-import { JSX, ReactElement, useEffect, useState } from 'react';
+import {
+  createRef,
+  JSX,
+  ReactElement,
+  useEffect,
+  useLayoutEffect,
+  useState,
+} from 'react';
 import { ProjectDetails as ProjectDetailsUi } from '@nx/graph/ui-project-details';
 import { ExpandedTargetsProvider } from '@nx/graph/shared';
 
@@ -20,14 +27,17 @@ export function ProjectDetails({
   height,
   title,
   jsonFile,
+  expandedTargets = [],
   children,
 }: {
   height: string;
   title: string;
   jsonFile?: string;
+  expandedTargets?: string[];
   children: ReactElement;
 }): JSX.Element {
   const [parsedProps, setParsedProps] = useState<any>();
+  const elementRef = createRef<HTMLDivElement>();
   const getData = async (path: string) => {
     const response = await fetch('/documentation/' + path, {
       headers: {
@@ -43,6 +53,27 @@ export function ProjectDetails({
     }
   }, [jsonFile, setParsedProps]);
 
+  useLayoutEffect(() => {
+    if (elementRef && expandedTargets?.length > 0) {
+      const header = document.getElementById('target-' + expandedTargets[0]);
+      const container = document.getElementById('project-details-container');
+      if (header && container) {
+        const groupHeaderOffset =
+          header
+            .closest('[id^="target-group-container-"]')
+            ?.querySelector('[id^="target-group-header-"]')
+            ?.getBoundingClientRect().height ?? 0;
+        elementRef.current?.scrollTo({
+          top:
+            header?.getBoundingClientRect().top -
+            container.getBoundingClientRect()?.top -
+            groupHeaderOffset,
+          behavior: 'instant',
+        });
+      }
+    }
+  }, [elementRef, expandedTargets]);
+
   if (!jsonFile && !parsedProps) {
     if (!children || !children.hasOwnProperty('props')) {
       return (
@@ -78,17 +109,20 @@ export function ProjectDetails({
         </div>
       )}
       <div
-        className={`not-prose ${
-          height ? `p-4 h-[${height}] overflow-y-auto` : 'p-4'
-        }`}
+        id="project-details-container"
+        className="not-prose overflow-y-auto"
+        style={{ height }}
+        ref={elementRef}
       >
-        <ExpandedTargetsProvider>
-          <ProjectDetailsUi
-            project={parsedProps.project}
-            sourceMap={parsedProps.sourceMap}
-            variant="compact"
-          />
-        </ExpandedTargetsProvider>
+        <div className="m-4">
+          <ExpandedTargetsProvider initialExpanededTargets={expandedTargets}>
+            <ProjectDetailsUi
+              project={parsedProps.project}
+              sourceMap={parsedProps.sourceMap}
+              variant="compact"
+            />
+          </ExpandedTargetsProvider>
+        </div>
       </div>
     </div>
   );

nx-dev/ui-markdoc/src/lib/tags/project-details.schema.ts

@@ -14,5 +14,8 @@ export const projectDetails: Schema = {
     height: {
       type: 'String',
     },
+    expandedTargets: {
+      type: 'Array',
+    },
   },
 };