Merge branch 'main' into drag_offset

.eslintignore

@@ -0,0 +1,22 @@
+examples/
+node_modules
+review
+**/build
+**/dist
+**/lib
+**/node_modules
+**/static
+**/typings
+**/types
+coverage
+*.map.js
+*.bundle.js
+*.config.js
+.eslintrc.js
+
+# jetbrains IDE stuff
+.idea/
+
+# ms IDE stuff
+.history/
+.vscode/

.eslintrc.js

@@ -0,0 +1,65 @@
+module.exports = {
+ env: {
+ browser: true,
+ es6: true,
+ commonjs: true,
+ node: true
+ },
+ globals: {
+ context: 'readonly',
+ describe: 'readonly',
+ it: 'readonly',
+ before: 'readonly',
+ after: 'readonly',
+ beforeAll: 'readonly',
+ afterAll: 'readonly',
+ beforeEach: 'readonly',
+ afterEach: 'readonly'
+ },
+ root: true,
+ extends: [
+ 'eslint:recommended',
+ 'plugin:@typescript-eslint/recommended',
+ 'prettier'
+ ],
+ parser: '@typescript-eslint/parser',
+ parserOptions: {
+ ecmaVersion: 'ES6',
+ project: ['./tsconfigbase.json']
+ },
+ plugins: ['@typescript-eslint'],
+ rules: {
+ '@typescript-eslint/no-unused-vars': ['warn', { args: 'none' }],
+ '@typescript-eslint/no-use-before-define': 'off',
+ '@typescript-eslint/no-explicit-any': 'off',
+ '@typescript-eslint/no-non-null-assertion': 'off',
+ '@typescript-eslint/no-namespace': 'off',
+ '@typescript-eslint/interface-name-prefix': 'off',
+ '@typescript-eslint/explicit-function-return-type': 'off',
+ '@typescript-eslint/ban-ts-comment': ['warn', { 'ts-ignore': true }],
+ '@typescript-eslint/ban-types': 'warn',
+ '@typescript-eslint/no-non-null-asserted-optional-chain': 'warn',
+ '@typescript-eslint/no-var-requires': 'off',
+ '@typescript-eslint/no-empty-interface': 'off',
+ '@typescript-eslint/triple-slash-reference': 'warn',
+ '@typescript-eslint/no-inferrable-types': 'off',
+ camelcase: 'warn',
+ 'no-inner-declarations': 'off',
+ 'no-prototype-builtins': 'off',
+ 'no-control-regex': 'warn',
+ 'no-undef': 'off',
+ 'no-case-declarations': 'warn',
+ 'no-useless-escape': 'off',
+ 'prefer-const': 'off',
+ 'sort-imports': [
+ 'error',
+ {
+ ignoreCase: true,
+ ignoreDeclarationSort: true,
+ ignoreMemberSort: false,
+ memberSyntaxSortOrder: ['none', 'all', 'multiple', 'single'],
+ allowSeparatedGroups: false
+ }
+ ]
+ }
+};

.git-blame-ignore-revs

@@ -0,0 +1 @@
+78028483abe79f559bcb789b94e067ce3d64624f

.github/scripts/verdaccio.yml

@@ -0,0 +1,62 @@
+#
+# This is based on verdaccio's default config file. It allows all users
+# to do anything, so don't use it on production systems.
+#
+# Look here for more config file examples:
+# https://github.com/verdaccio/verdaccio/tree/master/conf
+#
+
+# path to a directory with all packages
+storage: ./storage
+
+auth:
+ htpasswd:
+ file: ./htpasswd
+ # Maximum amount of users allowed to register, defaults to "+inf".
+ # You can set this to -1 to disable registration.
+ #max_users: 1000
+
+# a list of other known repositories we can talk to
+uplinks:
+ npmjs:
+ url: https://registry.npmjs.org/
+ max_fails: 40
+ maxage: 30m
+ timeout: 60s
+ agent_options:
+ keepAlive: true
+ # Avoid exceeding the max sockets that are allocated per VM.
+ # https://docs.microsoft.com/en-us/azure/app-service/app-service-web-nodejs-best-practices-and-troubleshoot-guide#my-node-application-is-making-excessive-outbound-calls
+ maxSockets: 40
+ maxFreeSockets: 10
+
+packages:
+ '@*/*':
+ # scoped packages
+ access: $all
+ publish: $all
+ proxy: npmjs
+
+ '**':
+ # allow all users (including non-authenticated users) to read and
+ # publish all packages
+ #
+ # you can specify usernames/groupnames (depending on your auth plugin)
+ # and three keywords: "$all", "$anonymous", "$authenticated"
+ access: $all
+
+ # allow all known users to publish packages
+ # (anyone can register by default, remember?)
+ publish: $all
+
+ # if package is not available locally, proxy requests to 'npmjs' registry
+ proxy: npmjs
+
+# log settings
+logs:
+ - { type: stdout, format: pretty, level: warn }
+ #- {type: file, path: verdaccio.log, level: info}
+
+# See https://github.com/verdaccio/verdaccio/issues/301
+server:
+ keepAliveTimeout: 0

.github/workflows/enforce-label.yml

@@ -0,0 +1,13 @@
+name: Enforce PR label
+
+on:
+ pull_request:
+ types: [labeled, unlabeled, opened, edited, synchronize]
+jobs:
+ enforce-label:
+ runs-on: ubuntu-latest
+ permissions:
+ pull-requests: write
+ steps:
+ - name: enforce-triage-label
+ uses: jupyterlab/maintainer-tools/.github/actions/enforce-label@v1

.github/workflows/tests.yml

@@ -0,0 +1,200 @@
+name: Tests
+
+on:
+ push:
+ branches: [main]
+ pull_request:
+ branches: [main]
+
+jobs:
+ test:
+ name: JS
+ strategy:
+ fail-fast: false
+ matrix:
+ os: [ubuntu-latest, windows-latest, macos-latest]
+ browser: [chrome-headless, firefox-headless]
+ exclude:
+ # macos and firefox-headless seems to consistently fail.
+ - os: macos-latest
+ browser: firefox-headless
+ runs-on: ${{ matrix.os }}
+ steps:
+ - uses: actions/checkout@v2
+ - name: Set up Node
+ uses: actions/setup-node@v1
+ with:
+ node-version: '14.x'
+
+ # Cache yarn
+ - name: Get yarn cache directory path
+ id: yarn-cache-dir-path
+ run: echo "::set-output name=dir::$(yarn cache dir)"
+ - name: Cache yarn
+ uses: actions/cache@v2
+ id: yarn-cache # use this to check for `cache-hit` (`steps.yarn-cache.outputs.cache-hit != 'true'`)
+ with:
+ path: ${{ steps.yarn-cache-dir-path.outputs.dir }}
+ key: ${{ runner.os }}-yarn-${{ hashFiles('**/yarn.lock') }}
+ restore-keys: |
+ ${{ runner.os }}-yarn-
+
+ - name: Install dependencies
+ shell: bash
+ run: |
+ set -eux
+ npm install -g yarn
+ yarn
+
+ - name: Build Source
+ shell: bash
+ run: |
+ set -eux
+ yarn build
+ yarn build:test
+
+ - name: Run Tests
+ run: |
+ yarn run test:${{ matrix.browser }}
+
+ build:
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v2
+ - name: Set up Node
+ uses: actions/setup-node@v1
+ with:
+ node-version: '14.x'
+
+ # Cache yarn
+ - name: Get yarn cache directory path
+ id: yarn-cache-dir-path
+ run: echo "::set-output name=dir::$(yarn cache dir)"
+ - name: Cache yarn
+ uses: actions/cache@v2
+ id: yarn-cache # use this to check for `cache-hit` (`steps.yarn-cache.outputs.cache-hit != 'true'`)
+ with:
+ path: ${{ steps.yarn-cache-dir-path.outputs.dir }}
+ key: ${{ runner.os }}-yarn-${{ hashFiles('**/yarn.lock') }}
+ restore-keys: |
+ ${{ runner.os }}-yarn-
+
+ - name: Install dependencies
+ shell: bash
+ run: |
+ set -eux
+ npm install -g yarn
+ yarn
+
+ - name: Check linters
+ shell: bash
+ run: |
+ set -eux
+ yarn lint:check
+
+ - name: Build Source
+ shell: bash
+ run: |
+ set -eux
+ yarn build
+ yarn build:test
+
+ - name: Test Examples
+ shell: bash
+ run: |
+ set -eux
+ yarn minimize
+ yarn build:examples
+ yarn test:examples
+
+ - name: Build Docs
+ run: |
+ set -eux
+ yarn clean
+ yarn docs
+
+ - name: Publish with Verdaccio
+ run: |
+ set -eux
+ npm install -g verdaccio
+ verdaccio --config .github/scripts/verdaccio.yml &
+ npm set registry http://localhost:4873/
+ yarn config set registry http://localhost:4873/
+ git config --global user.email "[email protected]"
+ git config --global user.name "Your Name"
+ yarn run update:versions patch --yes
+ git commit -a -m "Update versions"
+ yarn run publish
+
+ check_release:
+ runs-on: ubuntu-latest
+ strategy:
+ matrix:
+ group: [check_release, link_check]
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v2
+
+ - name: Set up Node
+ uses: actions/setup-node@v1
+ with:
+ node-version: '14.x'
+
+ - name: Install Python
+ uses: actions/setup-python@v2
+ with:
+ python-version: 3.9
+ architecture: "x64"
+
+ # Cache pip
+ - name: Get Date
+ id: get-date
+ run: |
+ echo "::set-output name=date::$(/bin/date -u "+%Y%m%d")"
+ shell: bash
+
+ - name: Get pip cache dir
+ id: pip-cache
+ run: |
+ echo "::set-output name=dir::$(pip cache dir)"
+
+ - name: Cache pip
+ uses: actions/cache@v2
+ with:
+ path: ${{ steps.pip-cache.outputs.dir }}
+ key: ${{ runner.os }}-pip-${{ steps.get-date.outputs.date }}
+ restore-keys: |
+ ${{ runner.os }}-pip-
+ ${{ runner.os }}-pip-
+
+ # Cache yarn
+ - name: Get yarn cache directory path
+ id: yarn-cache-dir-path
+ run: echo "::set-output name=dir::$(yarn cache dir)"
+ - name: Cache yarn
+ uses: actions/cache@v2
+ id: yarn-cache # use this to check for `cache-hit` (`steps.yarn-cache.outputs.cache-hit != 'true'`)
+ with:
+ path: ${{ steps.yarn-cache-dir-path.outputs.dir }}
+ key: ${{ runner.os }}-yarn-${{ hashFiles('**/yarn.lock') }}
+ restore-keys: |
+ ${{ runner.os }}-yarn-
+
+ - name: Cache checked links
+ if: ${{ matrix.group == 'link_check' }}
+ uses: actions/cache@v2
+ with:
+ path: ~/.cache/pytest-link-check
+ key: ${{ runner.os }}-linkcheck-${{ hashFiles('**/*.md') }}-md-links
+ restore-keys: |
+ ${{ runner.os }}-linkcheck-
+
+ - name: Check Release
+ if: ${{ matrix.group == 'check_release' }}
+ uses: jupyter-server/jupyter_releaser/.github/actions/check-release@v1
+ with:
+ token: ${{ secrets.GITHUB_TOKEN }}
+
+ - name: Run Link Check
+ if: ${{ matrix.group == 'link_check' }}
+ uses: jupyter-server/jupyter_releaser/.github/actions/check-links@v1

.gitignore

@@ -9,6 +9,15 @@ build
 review/api/temp
 *.tsbuildinfo
 
+# copied changelog file
+docs/source/changelog.md
+
+# generated api files
+docs/source/api
+
+# generated example files
+docs/source/examples
+
 # jetbrains ide stuff
 *.iml
 .idea/
@@ -18,3 +27,5 @@ review/api/temp
 .history
 .vscode
 
+.jupyter_releaser_checkout
+.eslintcache