Merge branch 'main' into kg-vscode-ui-tests

.github/workflows/contract.yaml

@@ -61,8 +61,10 @@ jobs:
       - run: just bats test common
       - run: just bats test init
       - run: just bats test deploy
+
       # vscode ui tests
       - run: just package
       - run: just vscode configure
       - run: just vscode-ui install
       - run: just vscode-ui test
+

.github/workflows/publish.yaml

@@ -29,7 +29,7 @@ jobs:
       - uses: extractions/setup-just@v2
       - uses: actions/setup-node@v4
         with:
-          node-version: "18.x"
+          node-version: "20"
       - uses: actions/download-artifact@v4
         with:
           name: dist

.github/workflows/vscode.yaml

@@ -17,7 +17,7 @@ jobs:
       - uses: ./.github/actions/setup
       - uses: actions/setup-node@v4
         with:
-          node-version: 18.x
+          node-version: "20"
       - id: get-date
         run: echo "date=$(/bin/date -u "+%Y%m%d")" >> $GITHUB_OUTPUT
         shell: bash

extensions/vscode/package.json

@@ -594,6 +594,69 @@
         "contents": "Scanning folder for a Posit project...",
         "when": "workbenchState == folder && posit.publish.state == 'uninitialized'"
       }
+    ],
+    "walkthroughs": [
+      {
+        "id": "posit.publisher.walkthrough.gettingStarted",
+        "title": "Get Started with Posit Publisher",
+        "description": "Deploy your First Project",
+        "steps": [
+          {
+            "id": "posit.publisher.walkthrough.gettingStarted.openProject",
+            "title": "Open project",
+            "description": "Open the folder containing your project.",
+            "media": {
+              "image": "assets/walkthroughs/open-folder.png",
+              "altText": "Posit Publisher"
+            }
+          },
+          {
+            "id": "posit.publisher.walkthrough.gettingStarted.activateExtension",
+            "title": "Activate Posit Publisher Extension",
+            "description": "Click on the Posit Publisher icon in the left taskbar.",
+            "media": {
+              "image": "assets/walkthroughs/activate-extension.png",
+              "altText": "Posit Publisher"
+            }
+          },
+          {
+            "id": "posit.publisher.walkthrough.gettingStarted.createDeployment",
+            "title": "Create a Deployment",
+            "description": "A deployment represents a single piece of content on a Posit Connect server. You can iterate on it locally and redeploy it at any time.",
+            "media": {
+              "image": "assets/walkthroughs/create-new-deployment.png",
+              "altText": "Posit Publisher"
+            }
+          },
+          {
+            "id": "posit.publisher.walkthrough.gettingStarted.editConfig",
+            "title": "Edit your deployment's configuration",
+            "description": "Each deployment is deployed using a configuration file. Edit the configuration before deploying.",
+            "media": {
+              "image": "assets/walkthroughs/edit-configuration.png",
+              "altText": "Posit Publisher"
+            }
+          },
+          {
+            "id": "posit.publisher.walkthrough.gettingStarted.publishContent",
+            "title": "Deploy your content to Posit Connect",
+            "description": "Once you have configured your deployment, you are ready to deploy your latest code changes up to the Posit Connect server. Click the Deploy button to proceed.",
+            "media": {
+              "image": "assets/walkthroughs/deploy.png",
+              "altText": "Posit Publisher"
+            }
+          },
+          {
+            "id": "posit.publisher.walkthrough.gettingStarted.accessContent",
+            "title": "View your content on Posit Connect",
+            "description": "Click on the button to view your content running on the Posit Connect server.",
+            "media": {
+              "image": "assets/walkthroughs/visit-content.png",
+              "altText": "Posit Publisher"
+            }
+          }
+        ]
+      }
     ]
   },
   "scripts": {
@@ -627,6 +690,7 @@
     "@hypersphere/omnibus": "0.1.6",
     "@vscode/codicons": "^0.0.36",
     "axios": "^1.6.0",
+    "debounce": "^2.1.0",
     "eventsource": "^2.0.2",
     "get-port": "5.1.1",
     "mutexify": "^1.4.0",

extensions/vscode/src/views/homeView.ts

@@ -1,5 +1,7 @@
 // Copyright (C) 2024 by Posit Software, PBC.
 
+import debounce from "debounce";
+
 import {
   CancellationToken,
   Disposable,
@@ -74,6 +76,8 @@ enum HomeViewInitialized {
 
 const lastSelectionState = "posit.publisher.homeView.lastSelectionState.v2";
 
+const fileEventDebounce = 200;
+
 export class HomeViewProvider implements WebviewViewProvider, Disposable {
   private _disposables: Disposable[] = [];
   private _contentRecords: (
@@ -1230,7 +1234,11 @@ export class HomeViewProvider implements WebviewViewProvider, Disposable {
     watchers.contentRecords?.onDidDelete(this.refreshContentRecords, this);
     watchers.contentRecords?.onDidChange(this.refreshContentRecords, this);
 
-    watchers.allFiles?.onDidCreate(this.sendRefreshedFilesLists, this);
-    watchers.allFiles?.onDidDelete(this.sendRefreshedFilesLists, this);
+    const fileEventCallback = debounce(
+      this.sendRefreshedFilesLists,
+      fileEventDebounce,
+    );
+    watchers.allFiles?.onDidCreate(fileEventCallback, this);
+    watchers.allFiles?.onDidDelete(fileEventCallback, this);
   }
 }

extensions/vscode/src/views/logs.ts

@@ -88,6 +88,13 @@ export class LogsTreeDataProvider implements TreeDataProvider<LogsTreeItem> {
 
   private resetStages() {
     this.stages = new Map([
+      [
+        "publish/getRPackageDescriptions",
+        createLogStage(
+          "Get Package Descriptions",
+          "Getting Package Descriptions",
+        ),
+      ],
       [
         "publish/checkCapabilities",
         createLogStage("Check Capabilities", "Checking Capabilities"),

extensions/vscode/webviews/homeView/package.json

@@ -14,7 +14,7 @@
     "vue": "^3.4.21"
   },
   "devDependencies": {
-    "@tsconfig/node18": "^18.2.4",
+    "@tsconfig/node20": "^20.1.4",
     "@types/node": "^20.14.2",
     "@types/vscode-webview": "^1.57.5",
     "@vitejs/plugin-vue": "^5.0.4",

extensions/vscode/webviews/homeView/tsconfig.json

@@ -1,6 +1,6 @@
 {
   "extends": [
-    "@tsconfig/node18/tsconfig.json",
+    "@tsconfig/node20/tsconfig.json",
     "@vue/tsconfig/tsconfig.dom.json"
   ],
   "include": ["src/**/*", "src/**/*.vue"],

internal/bundles/manifest.go

@@ -145,13 +145,9 @@ func ReadManifestFile(path util.Path) (*Manifest, error) {
 
 func NewManifest() *Manifest {
 	return &Manifest{
-		Version:     1,
-		Python:      &Python{},
-		Quarto:      &Quarto{},
-		Jupyter:     &Jupyter{},
-		Environment: &Environment{},
-		Packages:    make(PackageMap),
-		Files:       make(ManifestFileMap),
+		Version:  1,
+		Packages: make(PackageMap),
+		Files:    make(ManifestFileMap),
 	}
 }
 

internal/bundles/manifest_test.go

@@ -60,14 +60,10 @@ func (s *ManifestSuite) TestReadManifest() {
 	manifest, err := ReadManifest(reader)
 	s.Nil(err)
 	s.Equal(&Manifest{
-		Version:     1,
-		Platform:    "4.1.0",
-		Python:      &Python{},
-		Quarto:      &Quarto{},
-		Jupyter:     &Jupyter{},
-		Environment: &Environment{},
-		Packages:    PackageMap{},
-		Files:       ManifestFileMap{},
+		Version:  1,
+		Platform: "4.1.0",
+		Packages: PackageMap{},
+		Files:    ManifestFileMap{},
 	}, manifest)
 }
 
@@ -102,14 +98,10 @@ func (s *ManifestSuite) TestReadManifestFile() {
 	manifest, err := ReadManifestFile(manifestPath)
 	s.Nil(err)
 	s.Equal(&Manifest{
-		Version:     1,
-		Platform:    "4.1.0",
-		Python:      &Python{},
-		Quarto:      &Quarto{},
-		Jupyter:     &Jupyter{},
-		Environment: &Environment{},
-		Packages:    PackageMap{},
-		Files:       ManifestFileMap{},
+		Version:  1,
+		Platform: "4.1.0",
+		Packages: PackageMap{},
+		Files:    ManifestFileMap{},
 	}, manifest)
 }
 

internal/config/config_test.go

@@ -98,7 +98,7 @@ func (s *ConfigSuite) TestWriteFile() {
 	s.NoError(err)
 }
 
-func (s *ConfigSuite) TestWriteFileEmptyEntrypoing() {
+func (s *ConfigSuite) TestWriteFileEmptyEntrypoint() {
 	configFile := GetConfigPath(s.cwd, "myConfig")
 	cfg := New()
 	cfg.Type = ContentTypeHTML
@@ -114,6 +114,8 @@ func (s *ConfigSuite) TestWriteFileEmptyEntrypoing() {
 	s.NoError(err)
 	lines := strings.Split(string(contents), "\n")
 	s.Contains(lines, "entrypoint = ''")
+
+	s.NotContains(contents, []byte("has_parameters"))
 }
 
 func (s *ConfigSuite) TestWriteFileErr() {

internal/config/types.go

@@ -88,7 +88,7 @@ type Config struct {
 	Type          ContentType `toml:"type" json:"type"`
 	Entrypoint    string      `toml:"entrypoint" json:"entrypoint,omitempty"`
 	Validate      bool        `toml:"validate" json:"validate"`
-	HasParameters bool        `toml:"has_parameters" json:"hasParameters"`
+	HasParameters bool        `toml:"has_parameters,omitempty" json:"hasParameters"`
 	Files         []string    `toml:"files" json:"files"`
 	Title         string      `toml:"title,omitempty" json:"title,omitempty"`
 	Description   string      `toml:"description,multiline,omitempty" json:"description,omitempty"`

internal/events/events.go

@@ -44,19 +44,20 @@ const (
 const (
 	AgentOp Operation = "agent"
 
-	PublishCheckCapabilitiesOp   Operation = "publish/checkCapabilities"
-	PublishCreateNewDeploymentOp Operation = "publish/createNewDeployment"
-	PublishSetEnvVarsOp          Operation = "publish/setEnvVars"
-	PublishCreateBundleOp        Operation = "publish/createBundle"
-	PublishUpdateDeploymentOp    Operation = "publish/createDeployment"
-	PublishUploadBundleOp        Operation = "publish/uploadBundle"
-	PublishDeployBundleOp        Operation = "publish/deployBundle"
-	PublishRestorePythonEnvOp    Operation = "publish/restorePythonEnv"
-	PublishRestoreREnvOp         Operation = "publish/restoreREnv"
-	PublishRunContentOp          Operation = "publish/runContent"
-	PublishSetVanityUrlOp        Operation = "publish/setVanityURL"
-	PublishValidateDeploymentOp  Operation = "publish/validateDeployment"
-	PublishOp                    Operation = "publish"
+	PublishCheckCapabilitiesOp       Operation = "publish/checkCapabilities"
+	PublishGetRPackageDescriptionsOp Operation = "publish/getRPackageDescriptions"
+	PublishCreateNewDeploymentOp     Operation = "publish/createNewDeployment"
+	PublishSetEnvVarsOp              Operation = "publish/setEnvVars"
+	PublishCreateBundleOp            Operation = "publish/createBundle"
+	PublishUpdateDeploymentOp        Operation = "publish/createDeployment"
+	PublishUploadBundleOp            Operation = "publish/uploadBundle"
+	PublishDeployBundleOp            Operation = "publish/deployBundle"
+	PublishRestorePythonEnvOp        Operation = "publish/restorePythonEnv"
+	PublishRestoreREnvOp             Operation = "publish/restoreREnv"
+	PublishRunContentOp              Operation = "publish/runContent"
+	PublishSetVanityUrlOp            Operation = "publish/setVanityURL"
+	PublishValidateDeploymentOp      Operation = "publish/validateDeployment"
+	PublishOp                        Operation = "publish"
 )
 
 func New(op Operation, phase Phase, errCode ErrorCode, data any) *Event {