ci: revert doc publishing workflow changes from #980

Restore the doc publishing workflow that was removed in PR #980:
- Restore docs-sync.yml for daily auto-generated docs
- Restore doc generation steps in release.yml after package publish
- Restore NPM_TOKEN environment variable

Author: claude

.github/workflows/docs-sync.yml

@@ -0,0 +1,104 @@
+name: Sync Generated Docs
+
+on:
+  schedule:
+    # Run daily at 2 AM UTC
+    - cron: '0 2 * * *'
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  sync-docs:
+    name: Generate and Sync Docs
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/[email protected]
+        with:
+          fetch-depth: 0
+
+      - name: Setup Tools
+        uses: tanstack/config/.github/setup@main
+
+      - name: Build Packages
+        run: pnpm run build
+
+      - name: Generate Docs
+        run: pnpm generate-docs
+
+      - name: Check for changes
+        id: check_changes
+        run: |
+          if [ -n "$(git status --porcelain)" ]; then
+            echo "has_changes=true" >> $GITHUB_OUTPUT
+            echo "Changes detected in generated docs"
+          else
+            echo "has_changes=false" >> $GITHUB_OUTPUT
+            echo "No changes in generated docs"
+          fi
+
+      - name: Configure Git
+        if: steps.check_changes.outputs.has_changes == 'true'
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Commit and Push Changes
+        if: steps.check_changes.outputs.has_changes == 'true'
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          BRANCH_NAME="docs/auto-generate"
+
+          # Check if branch exists remotely
+          if git ls-remote --exit-code --heads origin $BRANCH_NAME; then
+            echo "Branch exists, checking out and updating"
+            git fetch origin $BRANCH_NAME
+            git checkout $BRANCH_NAME
+            git pull origin $BRANCH_NAME
+          else
+            echo "Creating new branch"
+            git checkout -b $BRANCH_NAME
+          fi
+
+          # Stage and commit changes
+          git add docs/
+          git commit -m "docs: regenerate API documentation
+
+          Auto-generated by daily docs sync workflow"
+
+          # Push changes
+          git push origin $BRANCH_NAME
+
+      - name: Create or Update PR
+        if: steps.check_changes.outputs.has_changes == 'true'
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          BRANCH_NAME="docs/auto-generate"
+
+          # Check if PR already exists
+          existing_pr=$(gh pr list --head $BRANCH_NAME --json number --jq '.[0].number')
+
+          if [ -n "$existing_pr" ]; then
+            echo "PR #$existing_pr already exists, it has been updated with the latest changes"
+            gh pr comment $existing_pr --body "Updated with latest generated docs from scheduled workflow run."
+          else
+            echo "Creating new PR"
+            gh pr create \
+              --title "docs: sync generated API documentation" \
+              --body "This PR was automatically created by the daily docs sync workflow.
+
+          The generated API documentation has been updated to reflect the latest changes in the codebase.
+
+          **Generated by**: [Docs Sync Workflow](https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }})
+
+          Please review and merge if the changes look correct." \
+              --head $BRANCH_NAME \
+              --base main
+          fi

.github/workflows/release.yml

@@ -40,6 +40,33 @@ jobs:
           title: 'ci: Version Packages'
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+      - name: Generate Docs
+        if: steps.changesets.outputs.published == 'true'
+        run: pnpm generate-docs
+      - name: Commit Generated Docs
+        if: steps.changesets.outputs.published == 'true'
+        run: |
+          if [ -n "$(git status --porcelain)" ]; then
+            git config user.name "github-actions[bot]"
+            git config user.email "github-actions[bot]@users.noreply.github.com"
+
+            BRANCH="docs/auto-update-$(date +%s)"
+            git checkout -b "$BRANCH"
+            git add docs/
+            git commit -m "docs: regenerate API documentation"
+            git push origin "$BRANCH"
+
+            gh pr create \
+              --title "docs: regenerate API documentation" \
+              --body "Automated documentation update from release" \
+              --base main \
+              --head "$BRANCH"
+          else
+            echo "No changes in generated docs"
+          fi
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
       - name: Comment on PRs about release
         if: steps.changesets.outputs.published == 'true'
         uses: tanstack/config/.github/comment-on-release@main