@diplodoc/lint 1.14.0 → 1.14.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diplodoc/lint",
-  "version": "1.14.0",
+  "version": "1.14.2",
   "description": "Diplodoc platform internal utility set for linting",
   "bin": {
     "lint": "./bin/lint.js",

package/scaffolding/.github/workflows/coverage.yml

@@ -37,7 +37,7 @@ jobs:
 
       - name: Install latest npm (>= 11.5.1)
         run: |
-          [ "$(printf '%s\n' "11.5.1" "$(npm -v)" | sort -V | head -n1)" = "11.5.1" ] || npm install -g npm@latest
+          [ "$(printf '%s\n' "11.5.1" "$(npm -v)" | sort -V | head -n1)" = "11.5.1" ] || npm install -g npm@11.5.1
         shell: bash
 
       - name: Install dependencies

package/scaffolding/.github/workflows/package-lock.yml

@@ -33,7 +33,7 @@ jobs:
 
       - name: Install latest npm (>= 11.5.1)
         run: |
-          [ "$(printf '%s\n' "11.5.1" "$(npm -v)" | sort -V | head -n1)" = "11.5.1" ] || npm install -g npm@latest
+          [ "$(printf '%s\n' "11.5.1" "$(npm -v)" | sort -V | head -n1)" = "11.5.1" ] || npm install -g npm@11.5.1
         shell: bash
 
       - name: Regenerate package-lock.json

package/scaffolding/.github/workflows/release.yml

@@ -3,11 +3,12 @@
 # To modify this workflow, edit it in diplodoc/devops/lint/scaffolding/.github/workflows/
 # and then run the scaffolding update process.
 
-name: Release to npm
+name: Release Package to npm
 
-# This workflow handles both stable and prerelease publishing to npm
+# This workflow handles stable releases, prereleases, and deprecation:
 # - Stable: triggered by release event or manual dispatch with 'stable' type
 # - Prerelease: triggered by manual dispatch with 'prerelease' type (only from non-protected branches)
+# - Deprecate: triggered by manual dispatch with 'deprecate' type (marks a version as deprecated)
 
 on:
   release:
@@ -22,6 +23,19 @@ on:
         options:
           - prerelease
           - stable
+          - deprecate
+      deprecate_version:
+        description: 'Version to deprecate (only for deprecate type)'
+        required: false
+        type: string
+      deprecate_message:
+        description: 'Deprecation message (only for deprecate type)'
+        required: false
+        type: string
+      deprecate_new_latest:
+        description: 'New latest version (required when deprecating current latest)'
+        required: false
+        type: string
 
 permissions:
   contents: read
@@ -32,10 +46,12 @@ jobs:
     name: Publish to npm
     runs-on: ubuntu-latest
     # For prerelease - only from non-protected branches
+    # For deprecate - always allowed
     if: |
       github.event_name == 'release' ||
       (github.event_name == 'workflow_dispatch' && inputs.release_type == 'stable') ||
-      (github.event_name == 'workflow_dispatch' && inputs.release_type == 'prerelease' && github.ref_protected != true)
+      (github.event_name == 'workflow_dispatch' && inputs.release_type == 'prerelease' && github.ref_protected != true) ||
+      (github.event_name == 'workflow_dispatch' && inputs.release_type == 'deprecate')
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
@@ -48,21 +64,28 @@ jobs:
           node-version: 22
           registry-url: 'https://registry.npmjs.org'
 
+      - uses: codex-team/action-nodejs-package-info@v1
+        id: package
+
       - name: Install latest npm (>= 11.5.1)
         run: |
-          [ "$(printf '%s\n' "11.5.1" "$(npm -v)" | sort -V | head -n1)" = "11.5.1" ] || npm install -g npm@latest
+          [ "$(printf '%s\n' "11.5.1" "$(npm -v)" | sort -V | head -n1)" = "11.5.1" ] || npm install -g npm@11.5.1
         shell: bash
 
       - name: Install dependencies
+        if: inputs.release_type != 'deprecate'
         run: npm ci
 
       - name: Run tests
+        if: inputs.release_type != 'deprecate'
         run: npm test
 
       - name: Run type check
+        if: inputs.release_type != 'deprecate'
         run: npm run typecheck
 
       - name: Build package
+        if: inputs.release_type != 'deprecate'
         run: npm run build
 
       # === STABLE RELEASE STEPS ===
@@ -100,3 +123,41 @@ jobs:
         run: npm publish --tag $(git branch --show-current) --provenance --access public
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      # === DEPRECATE STEPS ===
+      - name: Validate deprecate inputs
+        if: github.event_name == 'workflow_dispatch' && inputs.release_type == 'deprecate'
+        run: |
+          if [[ -z "${{ inputs.deprecate_version }}" ]]; then
+            echo "::error::deprecate_version is required for deprecate action"
+            exit 1
+          fi
+          if [[ -z "${{ inputs.deprecate_message }}" ]]; then
+            echo "::error::deprecate_message is required for deprecate action"
+            exit 1
+          fi
+
+      - name: Deprecate version
+        if: github.event_name == 'workflow_dispatch' && inputs.release_type == 'deprecate'
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: |
+          set -e
+
+          PACKAGE="${{ steps.package.outputs.name }}"
+          LATEST="$(npm view $PACKAGE@latest version 2>/dev/null || echo '')"
+          VERSION="${{ inputs.deprecate_version }}"
+          MESSAGE="${{ inputs.deprecate_message }}"
+          TARGET="$PACKAGE@$VERSION"
+
+          if [[ "$LATEST" == "$VERSION" ]]; then
+            if [[ -z "${{ inputs.deprecate_new_latest }}" ]]; then
+              echo "::error::deprecate_new_latest is required when deprecating the current latest version ($LATEST)"
+              exit 1
+            fi
+            echo "::notice::Setting new latest tag to $PACKAGE@${{ inputs.deprecate_new_latest }}"
+            npm dist-tag add "$PACKAGE@${{ inputs.deprecate_new_latest }}" latest
+          fi
+
+          echo "::notice::Deprecating $TARGET. Reason: $MESSAGE"
+          npm deprecate "$TARGET" "$MESSAGE"

package/scaffolding/.github/workflows/security.yml

@@ -30,7 +30,7 @@ jobs:
 
       - name: Install latest npm (>= 11.5.1)
         run: |
-          [ "$(printf '%s\n' "11.5.1" "$(npm -v)" | sort -V | head -n1)" = "11.5.1" ] || npm install -g npm@latest
+          [ "$(printf '%s\n' "11.5.1" "$(npm -v)" | sort -V | head -n1)" = "11.5.1" ] || npm install -g npm@11.5.1
         shell: bash
 
       - name: Install dependencies

package/scaffolding/.github/workflows/tests.yml

@@ -38,7 +38,7 @@ jobs:
 
       - name: Install latest npm (>= 11.5.1)
         run: |
-          [ "$(printf '%s\n' "11.5.1" "$(npm -v)" | sort -V | head -n1)" = "11.5.1" ] || npm install -g npm@latest
+          [ "$(printf '%s\n' "11.5.1" "$(npm -v)" | sort -V | head -n1)" = "11.5.1" ] || npm install -g npm@11.5.1
         shell: bash
 
       - name: Install dependencies

package/scaffolding/.github/workflows/update-deps.yml

@@ -9,8 +9,42 @@ on:
   workflow_dispatch:
     inputs:
       package:
-        description: 'Package name to update'
-        required: true
+        description: 'Package name to update (single selection)'
+        required: false
+        type: choice
+        options:
+          # === packages ===
+          - '@diplodoc/client'
+          - '@diplodoc/components'
+          - '@diplodoc/directive'
+          - '@diplodoc/liquid'
+          - '@diplodoc/sentenizer'
+          - '@diplodoc/transform'
+          - '@diplodoc/translation'
+          - '@diplodoc/utils'
+          - '@diplodoc/yfmlint'
+          # === extensions ===
+          - '@diplodoc/algolia-extension'
+          - '@diplodoc/color-extension'
+          - '@diplodoc/cut-extension'
+          - '@diplodoc/file-extension'
+          - '@diplodoc/folding-headings-extension'
+          - '@diplodoc/html-extension'
+          - '@diplodoc/latex-extension'
+          - '@diplodoc/mermaid-extension'
+          - '@diplodoc/openapi-extension'
+          - '@diplodoc/page-constructor-extension'
+          - '@diplodoc/quote-link-extension'
+          - '@diplodoc/search-extension'
+          - '@diplodoc/tabs-extension'
+      update_as_dev:
+        description: 'Update as devDependency (only for single package selection)'
+        required: false
+        type: boolean
+        default: false
+      packages:
+        description: 'Package names to update (comma-separated, e.g., "@diplodoc/transform,dev:@diplodoc/client"). Use "dev:" prefix for devDependencies. If empty, uses single package selection above.'
+        required: false
         type: string
       version:
         description: 'Package version (use "latest" for latest version)'
@@ -41,14 +75,54 @@ jobs:
 
       - name: Install latest npm (>= 11.5.1)
         run: |
-          [ "$(printf '%s\n' "11.5.1" "$(npm -v)" | sort -V | head -n1)" = "11.5.1" ] || npm install -g npm@latest
+          [ "$(printf '%s\n' "11.5.1" "$(npm -v)" | sort -V | head -n1)" = "11.5.1" ] || npm install -g npm@11.5.1
         shell: bash
 
       - name: Install dependencies
         run: npm ci
 
-      - name: Update package
-        run: npm install --no-workspaces ${{ inputs.package }}@${{ inputs.version }}
+      - name: Update packages
+        run: |
+          set -e
+
+          # Determine which packages to update
+          if [[ -n "${{ inputs.packages }}" ]]; then
+            # Use multi-selection field with dev: prefix support
+            PACKAGES_INPUT="${{ inputs.packages }}"
+            
+            # Parse comma-separated packages
+            IFS=',' read -ra PACKAGES <<< "$PACKAGES_INPUT"
+            
+            for PACKAGE_ENTRY in "${PACKAGES[@]}"; do
+              # Trim whitespace
+              PACKAGE_ENTRY=$(echo "$PACKAGE_ENTRY" | xargs)
+              
+              # Check for dev: prefix
+              if [[ "$PACKAGE_ENTRY" == dev:* ]]; then
+                PACKAGE="${PACKAGE_ENTRY#dev:}"
+                echo "::info::Updating $PACKAGE to ${{ inputs.version }} as devDependency"
+                npm install --no-workspaces --save-dev "$PACKAGE@${{ inputs.version }}"
+              else
+                PACKAGE="$PACKAGE_ENTRY"
+                echo "::info::Updating $PACKAGE to ${{ inputs.version }}"
+                npm install --no-workspaces "$PACKAGE@${{ inputs.version }}"
+              fi
+            done
+          elif [[ -n "${{ inputs.package }}" ]]; then
+            # Use single selection field
+            PACKAGE="${{ inputs.package }}"
+            
+            if [[ "${{ inputs.update_as_dev }}" == "true" ]]; then
+              echo "::info::Updating $PACKAGE to ${{ inputs.version }} as devDependency"
+              npm install --no-workspaces --save-dev "$PACKAGE@${{ inputs.version }}"
+            else
+              echo "::info::Updating $PACKAGE to ${{ inputs.version }}"
+              npm install --no-workspaces "$PACKAGE@${{ inputs.version }}"
+            fi
+          else
+            echo "::error::Either package or packages must be specified"
+            exit 1
+          fi
 
       - name: Regenerate package-lock.json for standalone mode
         run: npm install --no-workspaces --package-lock-only
@@ -65,20 +139,64 @@ jobs:
             exit 0
           fi
 
-          # Get actual installed version
-          VERSION=$(npm explore --no-workspaces ${{ inputs.package }} "node -pe 'require(\"./package.json\").version'" --shell sh)
+          # Determine which packages to update
+          if [[ -n "${{ inputs.packages }}" ]]; then
+            # Use multi-selection field with dev: prefix support
+            PACKAGES_INPUT="${{ inputs.packages }}"
+            
+            # Parse comma-separated packages
+            IFS=',' read -ra PACKAGES <<< "$PACKAGES_INPUT"
+            
+            # Get actual installed versions for all packages
+            VERSIONS=""
+            for PACKAGE_ENTRY in "${PACKAGES[@]}"; do
+              # Trim whitespace
+              PACKAGE_ENTRY=$(echo "$PACKAGE_ENTRY" | xargs)
+              
+              # Check for dev: prefix
+              if [[ "$PACKAGE_ENTRY" == dev:* ]]; then
+                PACKAGE="${PACKAGE_ENTRY#dev:}"
+                DEV_PREFIX="dev:"
+              else
+                PACKAGE="$PACKAGE_ENTRY"
+                DEV_PREFIX=""
+              fi
+              
+              VERSION=$(npm explore --no-workspaces "$PACKAGE" "node -pe 'require(\"./package.json\").version'" --shell sh)
+              if [[ -n "$VERSIONS" ]]; then
+                VERSIONS="$VERSIONS, "
+              fi
+              VERSIONS="$VERSIONS$DEV_PREFIX$PACKAGE@$VERSION"
+            done
+          elif [[ -n "${{ inputs.package }}" ]]; then
+            # Use single selection field
+            PACKAGE="${{ inputs.package }}"
+            VERSION=$(npm explore --no-workspaces "$PACKAGE" "node -pe 'require(\"./package.json\").version'" --shell sh)
+            
+            if [[ "${{ inputs.update_as_dev }}" == "true" ]]; then
+              VERSIONS="dev:$PACKAGE@$VERSION"
+            else
+              VERSIONS="$PACKAGE@$VERSION"
+            fi
+          else
+            echo "::error::Either package or packages must be specified"
+            exit 1
+          fi
 
           # Configure git
           git config --global user.email "95919151+yc-ui-bot@users.noreply.github.com"
           git config --global user.name "yc-ui-bot"
 
-          # Create branch and commit
-          BRANCH_NAME="ci/update-deps/${{ inputs.package }}-$VERSION"
+          # Create branch name (use first package for simplicity)
+          # Remove dev: prefix and @ symbol for valid branch name
+          FIRST_PACKAGE=$(echo "$PACKAGES_INPUT" | cut -d',' -f1 | xargs)
+          FIRST_PACKAGE=$(echo "$FIRST_PACKAGE" | sed 's/^dev://; s/@//g')
+          BRANCH_NAME="ci/update-deps/$FIRST_PACKAGE-${{ inputs.version }}"
           git push -f origin :$BRANCH_NAME || true
           git checkout -b $BRANCH_NAME
           git add package.json package-lock.json
-          git commit -m "fix(deps): Update ${{ inputs.package }} to $VERSION" --no-verify
+          git commit -m "fix(deps): Update $VERSIONS" --no-verify
           git push -u origin $BRANCH_NAME
 
           # Create PR
-          gh pr create --title "fix(deps): Update ${{ inputs.package }} to $VERSION" --body "Automated dependency update" --base master
+          gh pr create --title "fix(deps): Update $VERSIONS" --body "Automated dependency update" --base master

package/src/esbuild.mjs

@@ -1,4 +1,6 @@
 export * from 'esbuild';
-export * from 'esbuild-sass-plugin';
+export {sassPlugin} from 'esbuild-sass-plugin';
 
-export default require('esbuild');
+import esbuild from 'esbuild';
+
+export default esbuild;