refactor(publish): Improve manual tagging (#94)

Author: lachlancollins

bin/config.js

@@ -4,7 +4,6 @@ import { fileURLToPath, pathToFileURL } from 'node:url'
 import { createRequire } from 'node:module'
 import { readFileSync } from 'node:fs'
 import { dirname, join } from 'node:path'
-import chalk from 'chalk'
 import Liftoff from 'liftoff'
 import minimist from 'minimist'
 import v8flags from 'v8flags'
@@ -55,10 +54,9 @@ function checkForConfigFile(configPath) {
   if (configPath) return
   console.error(
     [
-      chalk.red('No tanstack.config.js file found!'),
+      'No tanstack.config.js file found!',
       'This may be because you\'re not passing the --config or --cwd flags.',
       'If you are passing these flags, check that the path is correct.',
-      '',
       'Otherwise, you can create a `tanstack.config.js` file in your project root.',
     ].join('\n'),
   )

docs/publish.md

@@ -23,7 +23,7 @@ pnpm run tanstack-config publish
 To use the TanStack Config programmatically, you can import the `publish` function:
 
 ```ts
-import { publish } from '@tanstack/config'
+import { publish } from '@tanstack/config/publish'
 
 publish({
   branchConfigs: configOpts.branchConfigs,

package.json

@@ -64,7 +64,6 @@
   },
   "dependencies": {
     "@commitlint/parse": "^19.0.3",
-    "chalk": "^5.3.0",
     "commander": "^12.0.0",
     "current-git-branch": "^1.1.0",
     "esbuild-register": "^3.5.0",

pnpm-lock.yaml

@@ -4,7 +4,6 @@
 import path from 'node:path'
 import { execSync } from 'node:child_process'
 import { existsSync, readdirSync } from 'node:fs'
-import chalk from 'chalk'
 import * as semver from 'semver'
 import currentGitBranch from 'current-git-branch'
 import { parse as parseCommit } from '@commitlint/parse'
@@ -62,35 +61,32 @@ export const publish = async (options) => {
   let latestTag = /** @type {string} */ ([...tags].pop())
 
   let range = `${latestTag}..HEAD`
-  // let range = ``;
 
   // If RELEASE_ALL is set via a commit subject or body, all packages will be
   // released regardless if they have changed files matching the package srcDir.
   let RELEASE_ALL = false
 
   if (!latestTag || tag) {
     if (tag) {
+      if (!semver.valid(tag)) {
+        throw new Error(`tag '${tag}' is not a semantically valid version`)
+      }
       if (!tag.startsWith('v')) {
-        throw new Error(
-          `tag must start with "v", eg. v0.0.0. You supplied ${tag}`,
-        )
+        throw new Error(`tag must start with "v" (e.g. v0.0.0). You supplied ${tag}`)
       }
-      console.info(
-        chalk.yellow(
-          `Tag is set to ${tag}. This will force release all packages. Publishing...`,
-        ),
-      )
+      if (tags.includes(tag)) {
+        throw new Error(`tag ${tag} has already been released`)
+      }
+      console.info(`Tag is set to ${tag}. This will force release all packages. Publishing...`)
       RELEASE_ALL = true
 
       // Is it the first release? Is it a major version?
-      if (!latestTag || (!semver.patch(tag) && !semver.minor(tag))) {
+      if (!latestTag || (semver.patch(tag) === 0 && semver.minor(tag) === 0)) {
         range = `origin/main..HEAD`
         latestTag = tag
       }
     } else {
-      throw new Error(
-        'Could not find latest tag! To make a release tag of v0.0.1, run with TAG=v0.0.1',
-      )
+      throw new Error('Could not find latest tag! To make a release tag of v0.0.1, run with TAG=v0.0.1')
     }
   }
 

src/publish/index.js

@@ -49,6 +49,7 @@ export type RunOptions = {
   branchConfigs: Record<string, BranchConfig>
   // List your npm packages here. The first package will be used as the versioner.
   packages: Array<Package>
+  // Path to root directory of your project.
   rootDir: string
   // The branch to publish. Defaults to the current branch if none supplied.
   branch?: string