[development] Add turborepo convenience npm script using dot (#927)

Author: silesky

.buildkite/pipeline.yml

@@ -80,7 +80,7 @@ steps:
       - echo "--- Install dependencies"
       - PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1 HUSKY=0 yarn install --immutable
       - echo "--- Build bundles"
-      - yarn run -T core+deps build
+      - yarn run -T core . build
       - echo "+++ Run tests"
       - yarn run -T core lint
       - yarn run -T core test

DEVELOPMENT.md

@@ -1,8 +1,30 @@
-## Development
+# Development
 
+This project uses [Turborepo](https://turbo.build/repo/docs), for dependency-aware builds and linting. Please read up!
+
+### Setup
 ```sh
  git clone git@github.com:segmentio/analytics-next.git && cd analytics-next
  nvm use  # install version of node defined in .nvmrc.
  yarn && yarn build
  yarn lint && yarn test
 ```
+
+### 
+
+### Build a specific package and all dependencies
+You have a couple options:
+1. you can _cd_ into a single package and run `yarn . build`  build a package and all its dependencies (most convenient!).
+
+2. You can use turborepo directly to build a package and all dependencies. See: Turborepo https://turbo.build/repo/docs/core-concepts/monorepos/filtering#filter-syntax.
+
+For example: 
+```
+yarn run -T turbo run build --filter=@segment/analytics-next
+```
+or
+```
+yarn run -T turbo run build --filter='./packages/node*'
+```
+
+^ Note, the following applies to not only `build`, but other tasks such as `test`, `lint`, etc.

examples/standalone-playground/package.json

@@ -5,6 +5,7 @@
     "hoistingLimits": "workspaces"
   },
   "scripts": {
+    ".": "yarn run -T turbo run --filter=@example/standalone-playground",
     "dev": "yarn concurrently 'yarn run -T watch --filter=standalone-playground' 'sleep 10 && yarn http-server .'",
     "concurrently": "yarn run -T concurrently"
   },

examples/with-next-js/package.json

@@ -3,6 +3,7 @@
   "version": "0.1.0",
   "private": true,
   "scripts": {
+    ".": "yarn run -T turbo run --filter=@example/with-next-js",
     "concurrently": "yarn run -T concurrently",
     "dev": "yarn partytown && yarn concurrently 'yarn run -T watch --filter=with-next-js' 'sleep 10 && next dev'",
     "build": "yarn partytown && next build",

examples/with-vite/package.json

@@ -2,6 +2,7 @@
   "name": "@example/with-vite",
   "private": true,
   "scripts": {
+    ".": "yarn run -T turbo run --filter=@example/with-vite",
     "concurrently": "yarn run -T concurrently",
     "dev": "yarn concurrently 'yarn run -T watch --filter=with-vite' 'sleep 10 && vite'",
     "build": "tsc && vite build",

package.json

@@ -25,11 +25,8 @@
     "release": "yarn clean && yarn build --force && changeset publish && git push origin HEAD:master --follow-tags --no-verify",
     "version-run-all": "yarn workspaces foreach -vpt --no-private run version",
     "core": "yarn workspace @segment/analytics-core",
-    "core+deps": "turbo run --filter=@segment/analytics-core",
     "browser": "yarn workspace @segment/analytics-next",
-    "browser+deps": "turbo run --filter=@segment/analytics-next",
     "node": "yarn workspace @segment/analytics-node",
-    "node+deps": "turbo run --filter=@segment/analytics-node",
     "clean": "bash scripts/clean.sh",
     "turbo": "turbo"
   },

packages/browser/Makefile

@@ -18,7 +18,7 @@ build-browser: build # build dependencies
 .PHONY: build-browser
 
 build: ## Builds libraries in prod mode, and all dependencies
-	yarn run -T browser+deps build
+	yarn run -T browser . build
 .PHONY: build
 
 clean: ## Clean the build directory

packages/browser/package.json

@@ -24,6 +24,7 @@
   ],
   "sideEffects": false,
   "scripts": {
+    ".": "yarn run -T turbo run --filter=@segment/analytics-next",
     "build-prep": "sh scripts/build-prep.sh",
     "version": "yarn run build-prep && git add src/generated/version.ts",
     "umd": "webpack",
@@ -33,7 +34,7 @@
     "concurrently": "yarn run -T concurrently",
     "watch": "yarn concurrently 'NODE_ENV=production WATCH=true yarn umd --watch' 'yarn pkg --watch'",
     "build": "yarn clean && yarn build-prep && yarn concurrently 'NODE_ENV=production yarn umd' 'yarn pkg' 'yarn cjs'",
-    "release:cdn": "yarn run -T browser+deps build && NODE_ENV=production bash scripts/release.sh && NODE_ENV=stage bash scripts/release.sh",
+    "release:cdn": "yarn . build && NODE_ENV=production bash scripts/release.sh && NODE_ENV=stage bash scripts/release.sh",
     "pkg": "yarn tsc -p tsconfig.build.json",
     "cjs": "yarn tsc -p tsconfig.build.json --outDir ./dist/cjs --module commonjs",
     "clean": "rm -rf dist",

packages/consent/consent-tools-integration-tests/README.md

@@ -17,8 +17,7 @@ Why is this using wd.io instead of playwright?
 ## Development
 ### 1. Build this package + deps
 ```sh
-# include the "..."
-yarn build... 
+yarn . build
 ```
 ### 2. Start server + run tests (and exit gracefully)
 ```

packages/consent/consent-tools-integration-tests/package.json

@@ -2,10 +2,10 @@
   "name": "@internal/consent-tools-integration-tests",
   "private": true,
   "scripts": {
+    ".": "yarn -T turbo run --filter=@internal/consent-tools-integration-tests",
     "dev": "yarn concurrently 'yarn watch' 'yarn build serve --open'",
     "build": "webpack",
     "watch": "yarn build --watch",
-    "build...": "yarn run -T turbo run build --filter=@internal/consent-tools-integration-tests",
     "test:local": "wdio wdio.conf.local.ts",
     "start-server-and-test": "yarn concurrently -k 'yarn build serve' 'sleep 5 && yarn test:local'",
     "lint": "yarn concurrently 'yarn:eslint .' 'yarn:tsc --noEmit'",