Bundled output for commit 1ced907e52

Includes transpiled JS/TS, and Typescript declaration files (typings).

[skip ci]

.editorconfig

@@ -12,21 +12,8 @@ insert_final_newline = true
 indent_style = space
 indent_size = 2
 
-[*.js]
-indent_style = space
-indent_size = 2
-
-[*.{css,less}]
-indent_style = space
-indent_size = 2
-
-[*.html]
-indent_style = space
-indent_size = 2
-
 [*.{diff,md}]
 trim_trailing_whitespace = false
 
-[*.php]
-indent_style = space
+[*.{php,xml,json}]
 indent_size = 4

.eslintignore

@@ -1,5 +0,0 @@
-**/bower_components/**/*
-**/node_modules/**/*
-vendor/**/*
-**/Gulpfile.js
-**/dist/**/*

.eslintrc

@@ -1,170 +0,0 @@
-{
-  "parser": "babel-eslint",          // https://github.com/babel/babel-eslint
-  "env": {                           // http://eslint.org/docs/user-guide/configuring.html#specifying-environments
-    "browser": true                  // browser global variables
-  },
-  "ecmaFeatures": {
-    "arrowFunctions": true,
-    "blockBindings": true,
-    "classes": true,
-    "defaultParams": true,
-    "destructuring": true,
-    "forOf": true,
-    "generators": false,
-    "modules": true,
-    "objectLiteralComputedProperties": true,
-    "objectLiteralDuplicateProperties": false,
-    "objectLiteralShorthandMethods": true,
-    "objectLiteralShorthandProperties": true,
-    "spread": true,
-    "superInFunctions": true,
-    "templateStrings": true,
-    "jsx": true
-  },
-  "globals": {
-    "m": true,
-    "app": true,
-    "$": true,
-    "moment": true
-  },
-  "rules": {
-/**
- * Strict mode
- */
-    // babel inserts "use strict"; for us
-    "strict": [2, "never"],          // http://eslint.org/docs/rules/strict
-
-/**
- * ES6
- */
-    "no-var": 2,                     // http://eslint.org/docs/rules/no-var
-    "prefer-const": 2,               // http://eslint.org/docs/rules/prefer-const
-
-/**
- * Variables
- */
-    "no-shadow": 2,                  // http://eslint.org/docs/rules/no-shadow
-    "no-shadow-restricted-names": 2, // http://eslint.org/docs/rules/no-shadow-restricted-names
-    "no-unused-vars": [2, {          // http://eslint.org/docs/rules/no-unused-vars
-      "vars": "local",
-      "args": "after-used"
-    }],
-    "no-use-before-define": 2,       // http://eslint.org/docs/rules/no-use-before-define
-
-/**
- * Possible errors
- */
-    "comma-dangle": [2, "never"],    // http://eslint.org/docs/rules/comma-dangle
-    "no-cond-assign": [2, "always"], // http://eslint.org/docs/rules/no-cond-assign
-    "no-console": 1,                 // http://eslint.org/docs/rules/no-console
-    "no-debugger": 1,                // http://eslint.org/docs/rules/no-debugger
-    "no-alert": 1,                   // http://eslint.org/docs/rules/no-alert
-    "no-constant-condition": 1,      // http://eslint.org/docs/rules/no-constant-condition
-    "no-dupe-keys": 2,               // http://eslint.org/docs/rules/no-dupe-keys
-    "no-duplicate-case": 2,          // http://eslint.org/docs/rules/no-duplicate-case
-    "no-empty": 2,                   // http://eslint.org/docs/rules/no-empty
-    "no-ex-assign": 2,               // http://eslint.org/docs/rules/no-ex-assign
-    "no-extra-boolean-cast": 0,      // http://eslint.org/docs/rules/no-extra-boolean-cast
-    "no-extra-semi": 2,              // http://eslint.org/docs/rules/no-extra-semi
-    "no-func-assign": 2,             // http://eslint.org/docs/rules/no-func-assign
-    "no-inner-declarations": 2,      // http://eslint.org/docs/rules/no-inner-declarations
-    "no-invalid-regexp": 2,          // http://eslint.org/docs/rules/no-invalid-regexp
-    "no-irregular-whitespace": 2,    // http://eslint.org/docs/rules/no-irregular-whitespace
-    "no-obj-calls": 2,               // http://eslint.org/docs/rules/no-obj-calls
-    "no-reserved-keys": 2,           // http://eslint.org/docs/rules/no-reserved-keys
-    "no-sparse-arrays": 2,           // http://eslint.org/docs/rules/no-sparse-arrays
-    "no-unreachable": 2,             // http://eslint.org/docs/rules/no-unreachable
-    "use-isnan": 2,                  // http://eslint.org/docs/rules/use-isnan
-    "block-scoped-var": 2,           // http://eslint.org/docs/rules/block-scoped-var
-
-/**
- * Best practices
- */
-    "consistent-return": 2,          // http://eslint.org/docs/rules/consistent-return
-    "curly": [2, "multi-line"],      // http://eslint.org/docs/rules/curly
-    "default-case": 2,               // http://eslint.org/docs/rules/default-case
-    "dot-notation": [2, {            // http://eslint.org/docs/rules/dot-notation
-      "allowKeywords": true
-    }],
-    "eqeqeq": 2,                     // http://eslint.org/docs/rules/eqeqeq
-    "no-caller": 2,                  // http://eslint.org/docs/rules/no-caller
-    "no-else-return": 2,             // http://eslint.org/docs/rules/no-else-return
-    "no-eq-null": 2,                 // http://eslint.org/docs/rules/no-eq-null
-    "no-eval": 2,                    // http://eslint.org/docs/rules/no-eval
-    "no-extend-native": 2,           // http://eslint.org/docs/rules/no-extend-native
-    "no-extra-bind": 2,              // http://eslint.org/docs/rules/no-extra-bind
-    "no-fallthrough": 2,             // http://eslint.org/docs/rules/no-fallthrough
-    "no-floating-decimal": 2,        // http://eslint.org/docs/rules/no-floating-decimal
-    "no-implied-eval": 2,            // http://eslint.org/docs/rules/no-implied-eval
-    "no-lone-blocks": 2,             // http://eslint.org/docs/rules/no-lone-blocks
-    "no-loop-func": 2,               // http://eslint.org/docs/rules/no-loop-func
-    "no-multi-str": 2,               // http://eslint.org/docs/rules/no-multi-str
-    "no-native-reassign": 2,         // http://eslint.org/docs/rules/no-native-reassign
-    "no-new": 2,                     // http://eslint.org/docs/rules/no-new
-    "no-new-func": 2,                // http://eslint.org/docs/rules/no-new-func
-    "no-new-wrappers": 2,            // http://eslint.org/docs/rules/no-new-wrappers
-    "no-octal": 2,                   // http://eslint.org/docs/rules/no-octal
-    "no-octal-escape": 2,            // http://eslint.org/docs/rules/no-octal-escape
-    "no-param-reassign": 2,          // http://eslint.org/docs/rules/no-param-reassign
-    "no-proto": 2,                   // http://eslint.org/docs/rules/no-proto
-    "no-redeclare": 2,               // http://eslint.org/docs/rules/no-redeclare
-    "no-return-assign": 2,           // http://eslint.org/docs/rules/no-return-assign
-    "no-self-compare": 2,            // http://eslint.org/docs/rules/no-self-compare
-    "no-sequences": 2,               // http://eslint.org/docs/rules/no-sequences
-    "no-throw-literal": 2,           // http://eslint.org/docs/rules/no-throw-literal
-    "no-with": 2,                    // http://eslint.org/docs/rules/no-with
-    "radix": 2,                      // http://eslint.org/docs/rules/radix
-    "vars-on-top": 2,                // http://eslint.org/docs/rules/vars-on-top
-    "wrap-iife": [2, "any"],         // http://eslint.org/docs/rules/wrap-iife
-    "yoda": 2,                       // http://eslint.org/docs/rules/yoda
-
-/**
- * Style
- */
-    "indent": [2, 2],                // http://eslint.org/docs/rules/indent
-    "brace-style": [2,               // http://eslint.org/docs/rules/brace-style
-      "1tbs", {
-      "allowSingleLine": true
-    }],
-    "quotes": [
-      2, "single", "avoid-escape"    // http://eslint.org/docs/rules/quotes
-    ],
-    "camelcase": [2, {               // http://eslint.org/docs/rules/camelcase
-      "properties": "never"
-    }],
-    "comma-spacing": [2, {           // http://eslint.org/docs/rules/comma-spacing
-      "before": false,
-      "after": true
-    }],
-    "comma-style": [2, "last"],      // http://eslint.org/docs/rules/comma-style
-    "eol-last": 2,                   // http://eslint.org/docs/rules/eol-last
-    "key-spacing": [2, {             // http://eslint.org/docs/rules/key-spacing
-        "beforeColon": false,
-        "afterColon": true
-    }],
-    "new-cap": [2, {                 // http://eslint.org/docs/rules/new-cap
-      "newIsCap": true
-    }],
-    "no-multiple-empty-lines": [2, { // http://eslint.org/docs/rules/no-multiple-empty-lines
-      "max": 2
-    }],
-    "no-new-object": 2,              // http://eslint.org/docs/rules/no-new-object
-    "no-spaced-func": 2,             // http://eslint.org/docs/rules/no-spaced-func
-    "no-trailing-spaces": 2,         // http://eslint.org/docs/rules/no-trailing-spaces
-    "no-wrap-func": 2,               // http://eslint.org/docs/rules/no-wrap-func
-    "no-underscore-dangle": 0,       // http://eslint.org/docs/rules/no-underscore-dangle
-    "one-var": [2, "never"],         // http://eslint.org/docs/rules/one-var
-    "padded-blocks": [2, "never"],   // http://eslint.org/docs/rules/padded-blocks
-    "semi": [2, "always"],           // http://eslint.org/docs/rules/semi
-    "semi-spacing": [2, {            // http://eslint.org/docs/rules/semi-spacing
-      "before": false,
-      "after": true
-    }],
-    "space-after-keywords": 2,       // http://eslint.org/docs/rules/space-after-keywords
-    "space-before-blocks": 2,        // http://eslint.org/docs/rules/space-before-blocks
-    "space-before-function-paren": [2, "never"], // http://eslint.org/docs/rules/space-before-function-paren
-    "space-infix-ops": 2,            // http://eslint.org/docs/rules/space-infix-ops
-    "space-return-throw-case": 2,    // http://eslint.org/docs/rules/space-return-throw-case
-    "spaced-line-comment": 2,        // http://eslint.org/docs/rules/spaced-line-comment
-  }
-}

.gitattributes

@@ -1,4 +1,16 @@
 .gitattributes export-ignore
 .gitignore export-ignore
 .gitmodules export-ignore
+.github export-ignore
+.travis export-ignore
 .travis.yml export-ignore
+.editorconfig export-ignore
+.styleci.yml export-ignore
+
+phpunit.xml export-ignore
+tests export-ignore
+
+js/dist/* -diff
+js/dist/* linguist-generated
+
+* text=auto eol=lf

.github/FUNDING.yml

@@ -0,0 +1,3 @@
+github: flarum
+open_collective: flarum
+tidelift: packagist/flarum/core

.github/ISSUE_TEMPLATE/bug-report.md

@@ -0,0 +1,39 @@
+---
+name: "🐛 Bug Report"
+about: "If something isn't working as expected"
+
+---
+## Bug Report
+
+**Current Behavior**
+A clear and concise description of the behavior.
+
+**Steps to Reproduce**
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected Behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Environment**
+- Flarum version: x.y.z
+- Website URL: http://example.com
+- Webserver: [e.g. apache, nginx]
+- Hosting environment: [e.g. shared, vps]
+- PHP version: x.y.z
+- Browser: [e.g. chrome 67, safari 11]
+
+```
+Output of "php flarum info", run this in terminal in your Flarum directory.
+```
+
+**Possible Solution**
+<!--- Only if you have suggestions or a fix for the bug -->
+
+**Additional Context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature-request.md

@@ -0,0 +1,26 @@
+---
+name: "🚀 Feature Request"
+about: "I have a suggestion (and may want to implement it!)"
+
+---
+
+<!--
+IMPORTANT: Feature requests on this GitHub issue tracker are only accepted in case they have been approved by a core developer or contain extensive argumentation and directions for implementation. For all other feature requests, ideas and feedback please post in the Flarum Community: https://discuss.flarum.org/t/feedback.
+-->
+
+## Feature Request
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. eg. I have an issue when [...]
+
+**Describe the solution you'd like**
+A detailed description of your proposed solution. Include:
+- How the feature would work/behave
+- Any potential drawbacks
+- Maybe a screenshot, design, or example code
+
+**Justify why this feature belongs in Flarum's core, rather than in a third-party extension**
+Consider who this change will be useful to – most Flarum forums, or just a few?
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.

.github/ISSUE_TEMPLATE/support-question.md

@@ -0,0 +1,11 @@
+---
+name: "🙋‍ Support Question"
+about: "If you have a question, please check out our forum or Discord!"
+
+---
+
+We primarily use GitHub as an issue tracker; for usage and support questions, please check out these resources below. Thanks!
+
+* Flarum Community: https://discuss.flarum.org/
+* Discord Chat: https://flarum.org/discord/
+* Twitter: https://twitter.com/Flarum

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,24 @@
+<!--
+IMPORTANT: We applaud pull requests, they excite us every single time. As we have an obligation to maintain a healthy code standard and quality, we take sufficient time for reviews. Please do create a separate pull request per change/issue/feature; we will ask you to split bundled pull requests.
+-->
+
+**Fixes #0000**
+
+**Changes proposed in this pull request:**
+<!-- fill this out, mention the pages and/or components which have been impacted -->
+
+**Reviewers should focus on:**
+<!-- fill this out, ask for feedback on specific changes you are unsure about -->
+
+**Screenshot**
+<!-- include an image of the most relevant user-facing change, if any -->
+
+**Confirmed**
+
+- [ ] Frontend changes: tested on a local Flarum installation.
+- [ ] Backend changes: tests are green (run `composer test`).
+
+**Required changes:**
+
+- [ ] Related documentation PR: (Remove if irrelevant)
+- [ ] Related core extension PRs: (Remove if irrelevant)

.github/SECURITY.md

@@ -0,0 +1,13 @@
+# Security Policy
+
+## Supported Versions
+
+We will only patch security vulnerabilities in the stable 1.x release.
+
+## Reporting a Vulnerability
+
+If you discover a security vulnerability within Flarum, please send an email to security@flarum.org so we can address it promptly.
+
+We will get back to you as time allows.
+Discussions may commence internally, so you may not hear back immediately.
+When reporting a vulnerability, please provide your GitHub username (if available), so that we can invite you to collaborate on a [security advisory on GitHub](https://help.github.com/en/articles/about-maintainer-security-advisories).

.github/stale.yml

@@ -0,0 +1,26 @@
+daysUntilStale: 90
+daysUntilClose: 30
+
+staleLabel: stale
+
+exemptLabels:
+- org/keep
+- type/bug
+- type/regression
+- critical
+- security
+exemptAssignees: true
+exemptMilestones: true
+exemptProjects: true
+
+markComment: >
+  This issue has been automatically marked as stale because it has not had
+  recent activity. It will be closed if no further activity occurs. We do this
+  to keep the amount of open issues to a manageable minimum.
+
+  In any case, thanks for taking an interest in this software and contributing
+  by opening the issue in the first place!
+
+closeComment: >
+  We are closing this issue as it seems to have grown stale. If you still
+  encounter this problem with the latest version, feel free to re-open it.

.github/workflows/build.yml

@@ -0,0 +1,33 @@
+name: JavaScript
+
+on:
+  push:
+    branches:
+      - master
+
+jobs:
+  build:
+    name: JS / Build
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v2
+
+      - name: Restore npm cache
+        uses: actions/cache@v2
+        with:
+          path: ~/.npm
+          key: ${{ runner.os }}-node-${{ hashFiles('js/package-lock.json') }}
+          restore-keys: |
+            ${{ runner.os }}-node-
+
+      # Our action will install npm, cd into `./js`, run `npm run build` and
+      # `npm run build-typings`, then commit and upload any changes
+      - name: Build production JS
+        uses: flarum/action-build@2
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          build_script: build
+          package_manager: npm
+          typings_script: build-typings

.github/workflows/codeql-analysis.yml

@@ -0,0 +1,76 @@
+# For most projects, this workflow file will not need changing; you simply need
+# to commit it to your repository.
+#
+# You may wish to alter this file to override the set of languages analyzed,
+# or to provide custom queries or build logic.
+#
+# ******** NOTE ********
+# We have attempted to detect the languages in your repository. Please check
+# the `language` matrix defined below to confirm you have the correct set of
+# supported CodeQL languages.
+#
+name: "CodeQL"
+
+# Run on:
+# - pushes to master, or
+# - PRs with a base of `master`
+# - which do not **only** consist of changes to .md or .less files
+on:
+  push:
+    branches: [ master ]
+    paths-ignore:
+      - '**/*.md'
+      - '**/*.less'
+  pull_request:
+    branches: [ master ]
+    paths-ignore:
+      - '**/*.md'
+      - '**/*.less'
+  schedule:
+    - cron: '0 0 * * 1,3,5'
+
+jobs:
+  analyze:
+    name: Analyze / ${{ matrix.language }}
+    runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [ 'javascript' ]
+        # CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python' ]
+        # Learn more:
+        # https://docs.github.com/en/free-pro-team@latest/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#changing-the-languages-that-are-analyzed
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v2
+
+      # Initializes the CodeQL tools for scanning.
+      - name: Initialize CodeQL
+        uses: github/codeql-action/init@v1
+        with:
+          languages: ${{ matrix.language }}
+          # If you wish to specify custom queries, you can do so here or in a config file.
+          # By default, queries listed here will override any specified in a config file.
+          # Prefix the list here with "+" to use these queries and those in the config file.
+          # queries: ./path/to/local/query, your-org/your-repo/queries@main
+
+      # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
+      # If this step fails, then you should remove it and run the build manually (see below)
+      - name: Autobuild
+        uses: github/codeql-action/autobuild@v1
+
+      # ℹ️ Command-line programs to run using the OS shell.
+      # 📚 https://git.io/JvXDl
+
+      # ✏️ If the Autobuild fails above, remove it and uncomment the following three lines
+      #    and modify them (or add more) to build your code if your project
+      #    uses a compiled language
+
+      #- run: |
+      #   make bootstrap
+      #   make release
+
+      - name: Perform CodeQL Analysis
+        uses: github/codeql-action/analyze@v1

.github/workflows/lint.yml

@@ -0,0 +1,28 @@
+name: Lint
+
+on:
+  workflow_dispatch:
+  push:
+    paths:
+      - 'js/src/**'
+  pull_request:
+    paths:
+      - 'js/src/**'
+
+jobs:
+  prettier:
+    name: JS / Prettier
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v2
+
+      - name: Set up Node
+        uses: actions/setup-node@v2
+        with:
+          node-version: "14"
+
+      - name: Check JS formatting
+        run: npx prettier --check src
+        working-directory: ./js

.github/workflows/pr_size_change.yml

@@ -0,0 +1,45 @@
+name: Bundle size checker
+
+on:
+  workflow_dispatch:
+
+  push:
+    paths:
+      - "js/**"
+  pull_request:
+    paths:
+      - "js/**"
+
+jobs:
+  bundlewatch:
+    runs-on: ubuntu-latest
+
+    name: Bundlewatch
+
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v2
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v2
+        with:
+          node-version: "14"
+
+      - name: Use npm v7
+        run: sudo npm install -g npm@7.x.x
+
+      - name: Install JS dependencies
+        # We need to use `npm install` here. If we don't, the workflow will fail.
+        run: npm install
+        working-directory: ./js
+
+      - name: Build production assets
+        run: npm run build
+        working-directory: ./js
+
+      - name: Check bundle size change
+        run: node_modules/.bin/bundlewatch --config .bundlewatch.config.json
+        working-directory: ./js
+        env:
+          BUNDLEWATCH_GITHUB_TOKEN: ${{ secrets.BUNDLEWATCH_GITHUB_TOKEN }}
+          CI_COMMIT_SHA: ${{ github.event.pull_request.head.sha }}

.github/workflows/test.yml

@@ -0,0 +1,79 @@
+name: Tests
+
+on: [push, pull_request]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        php: [7.3, 7.4, '8.0']
+        service: ['mysql:5.7', mariadb]
+        prefix: ['', flarum_]
+
+        include:
+          - service: 'mysql:5.7'
+            db: MySQL
+          - service: mariadb
+            db: MariaDB
+          - prefix: flarum_
+            prefixStr: (prefix)
+
+        exclude:
+          - php: 7.3
+            service: 'mysql:5.7'
+            prefix: flarum_
+          - php: 7.3
+            service: mariadb
+            prefix: flarum_
+          - php: 8.0
+            service: 'mysql:5.7'
+            prefix: flarum_
+          - php: 8.0
+            service: mariadb
+            prefix: flarum_
+
+    services:
+      mysql:
+        image: ${{ matrix.service }}
+        ports:
+          - 13306:3306
+
+    name: 'PHP ${{ matrix.php }} / ${{ matrix.db }} ${{ matrix.prefixStr }}'
+
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v2
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@0b9d33cd0782337377999751fc10ea079fdd7104 # pin@v2
+        with:
+          php-version: ${{ matrix.php }}
+          coverage: xdebug
+          extensions: curl, dom, gd, json, mbstring, openssl, pdo_mysql, tokenizer, zip
+          tools: phpunit, composer:v2
+
+      # The authentication alter is necessary because newer mysql versions use the `caching_sha2_password` driver,
+      # which isn't supported prior to PHP7.4
+      # When we drop support for PHP7.3, we should remove this from the setup.
+      - name: Create MySQL Database
+        run: |
+          sudo systemctl start mysql
+          mysql -uroot -proot -e 'CREATE DATABASE flarum_test;' --port 13306
+          mysql -uroot -proot -e "ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'root';" --port 13306
+
+      - name: Install Composer dependencies
+        run: composer install
+
+      - name: Setup Composer tests
+        run: composer test:setup
+        env:
+          DB_PORT: 13306
+          DB_PASSWORD: root
+          DB_PREFIX: ${{ matrix.prefix }}
+
+      - name: Run Composer tests
+        run: composer test
+        env:
+          COMPOSER_PROCESS_TIMEOUT: 600

.gitignore

@@ -1,6 +1,11 @@
 /vendor
+composer.lock
 composer.phar
+node_modules
 .DS_Store
 Thumbs.db
-tests/_output/*
+tests/.phpunit.result.cache
+/tests/integration/tmp
 .vagrant
+.idea/*
+.vscode

.php_cs

@@ -1,26 +0,0 @@
-<?php
-
-$header = <<<EOF
-This file is part of Flarum.
-
-(c) Toby Zerner <toby.zerner@gmail.com>
-
-For the full copyright and license information, please view the LICENSE
-file that was distributed with this source code.
-EOF;
-
-Symfony\CS\Fixer\Contrib\HeaderCommentFixer::setHeader($header);
-
-$finder = Symfony\CS\Finder\DefaultFinder::create()
-    ->exclude('stubs')
-    ->in(__DIR__);
-
-return Symfony\CS\Config\Config::create()
-    ->setUsingCache(true)
-    ->level(Symfony\CS\FixerInterface::PSR2_LEVEL)
-    ->fixers([
-        'short_array_syntax',
-        'header_comment',
-        '-psr0'
-    ])
-    ->finder($finder);

.styleci.yml

@@ -0,0 +1,14 @@
+preset: recommended
+
+enabled:
+  - logical_not_operators_with_successor_space
+
+disabled:
+  - align_double_arrow
+  - blank_line_after_opening_tag
+  - multiline_array_trailing_comma
+  - new_with_braces
+  - phpdoc_align
+  - phpdoc_order
+  - phpdoc_separation
+  - phpdoc_types

.travis.yml

@@ -1,30 +0,0 @@
-language: php
-
-php:
-  - 5.5
-  - 5.6
-
-matrix:
-  allow_failures:
-    - php: hhvm
-  fast_finish: true
-
-before_script:
-  - curl -s http://getcomposer.org/installer | php
-  - php composer.phar install
-
-script:
-  - vendor/bin/phpcs --standard=PSR2 -np src
-  - vendor/bin/phpspec run
-
-notifications:
-  email:
-    on_failure: change
-  webhooks:
-    urls:
-      - https://webhooks.gitter.im/e/7b9e9827a03b44a16588
-    on_success: always
-    on_failure: always
-    on_start: false
-
-sudo: false

CHANGELOG.md

@@ -0,0 +1,528 @@
+# Changelog
+
+## [1.0.2](https://github.com/flarum/core/compare/v1.0.1...v1.0.2)
+
+### Fixed
+- Critical XSS vulnerability
+
+## [1.0.1](https://github.com/flarum/core/compare/v1.0.0...v1.0.1)
+
+### Fixed
+- Installation fails on environments without proc_* functions enabled or mysql client binary (https://github.com/flarum/core/issues/2890)
+
+## [1.0.0](https://github.com/flarum/core/compare/v0.1.0-beta.16...v1.0.0)
+
+### Added
+- Task scheduling
+- `load()` method on `ApiController` extender to allow eager loading of relations (https://github.com/flarum/core/pull/2724)
+- Installation supports enabling a set of extensions (https://github.com/flarum/core/pull/2757)
+- RequestUtil helper class added to abstract the logic of the actor, session, locale and route name from the request (https://github.com/flarum/core/pull/2449)
+- Code scanning action with GitHub CodeQL (https://github.com/flarum/core/pull/2744)
+- The Formatter extender now has an `unparse` method to allow extensions to hook into the unparsing of content (https://github.com/flarum/core/pull/2780)
+- A Filesystem extender allows direct modification and addition of filesystem disks (https://github.com/flarum/core/pull/2732)
+- A slug driver based on the User ID was introduced (https://github.com/flarum/core/pull/2787)
+- An extensible users list was added to the admin area (https://github.com/flarum/core/pull/2626)
+- Headers hardened by adding Referer Policy, Xss Protection and Content type (https://github.com/flarum/core/pull/2721)
+- Tooltip component (https://github.com/flarum/core/pull/2843)
+- Moved `insertText` and `styleSelectedText` from markdown to core (https://github.com/flarum/core/pull/2826)
+- A squashed database schema install dump to speed up new installs (https://github.com/flarum/core/pull/2842)
+- Pagination in the canonical URL for discussion pages (https://github.com/flarum/core/pull/2853)
+- PaginatedListState for the DiscussionList and to support paginated lists in the frontend (https://github.com/flarum/core/pull/2781)
+- Introduce the new webpack config and flarum-tsconfig for typehinting (https://github.com/flarum/core/pull/2856)
+
+### Changed
+- Now tracking bundle sizes to keep an eye on web performance (https://github.com/flarum/core/pull/2695)
+- Eager load relations on ListPostsController to improve performance (https://github.com/flarum/core/pull/2717)
+- Replace classList with clsx library (https://github.com/flarum/core/pull/2760)
+- Replaced the javascript based loading spinner with a pure CSS version (https://github.com/flarum/core/pull/2764)
+- Route names now have to be unique (https://github.com/flarum/core/pull/2771)
+- ActorReference is now available from the error handler middleware (https://github.com/flarum/core/pull/2410)
+- The `migrations` table now has an Auto Increment ID (https://github.com/flarum/core/pull/2794)
+- Assets and avatars are now managed using Laravel filesystem disks (https://github.com/flarum/core/pull/2729)
+- Extracted asset publishing (`php flarum assets:publish`) from migrating (https://github.com/flarum/core/pull/2731)
+- Assets were compiled in the format `<asset>-<revision>.<js|css>`, this is now `<asset>.<js|css>?v=<revision>` (https://github.com/flarum/core/pull/2805)
+- The powered by header can now be configured in the config under `headers` (https://github.com/flarum/core/pull/2777)
+- Switched to the ICU format for translation files (https://github.com/flarum/core/pull/2759)
+- Allow extend and override to apply to multiple methods in one call
+- Notifications dropdown and list refactored (https://github.com/flarum/core/pull/2822)
+- Updated validation locale strings based on Laravel 8 changes (https://github.com/flarum/core/pull/2829)
+- Caching of permissions is now taken care of centrally, reducing code duplication (https://github.com/flarum/core/pull/2832)
+- Replaced lodash-es by throttle-debounce to reduce bundle size (https://github.com/flarum/core/pull/2827)
+- Internal API requests are now executed through middleware (https://github.com/flarum/core/pull/2783)
+- Permission changes: `viewDiscussions` to `viewForum` and `viewUserList` to `searchUsers` (https://github.com/flarum/core/pull/2854)
+
+### Fixes
+- Javascript is shown when editing the title of a discussion (https://github.com/flarum/core/pull/2693)
+- Canonical url logic uses request object which causes wrong URL's when a different page is default (https://github.com/flarum/core/pull/2674)
+- Dropdown toggle has no aria label (https://github.com/flarum/core/pull/2668)
+- Nav drawer is focusable when off-screen on small viewports (https://github.com/flarum/core/pull/2666)
+- Search input has no aria-label and no role (https://github.com/flarum/core/pull/2669)
+- Code duplication exists between SendConfirmationEmailController and AccountActivationMailer (https://github.com/flarum/core/pull/2493)
+- When setting tags as homepage default, visiting a tag will show all posts (https://github.com/flarum/core/pull/2754)
+- Locale cache is cleared twice when cache clearing (https://github.com/flarum/core/pull/2738)
+- When cache clearing fails an exception can be thrown due to a partial flush (https://github.com/flarum/core/pull/2756)
+- Database migrations rely on MyISAM even though the eventual migrated database does not use it (https://github.com/flarum/core/pull/2442)
+- Discussion search result is not sorted by relevance by default (https://github.com/flarum/core/pull/2773)
+- Extensions cannot register custom searcher classes (https://github.com/flarum/core/pull/2755)
+- Searching discussion titles is not possible (https://github.com/flarum/core/pull/2698)
+- Boot errors due to failing extenders throw a generic error (https://github.com/flarum/core/pull/2740)
+- Required argument to `Component.$()` isn't really required (https://github.com/flarum/core/pull/2844)
+- Component does not allows use of all mithril lifecycle functionality (https://github.com/flarum/core/pull/2847)
+
+### Removed
+- The `make:migration` command has been removed (https://github.com/flarum/core/pull/2686)
+- Background fade on the header has been removed (https://github.com/flarum/core/pull/2685)
+- Remove vendor prefixes in less (https://github.com/flarum/core/pull/2766)
+- The session is no longer available from the User class (https://github.com/flarum/core/pull/2790)
+- The `mail` key is removed from the laravel related config (https://github.com/flarum/core/pull/2796)
+
+## [0.1.0-beta.16](https://github.com/flarum/core/compare/v0.1.0-beta.15...v0.1.0-beta.16)
+
+### Added
+- Allow event subscribers (https://github.com/flarum/core/pull/2535)
+- Allow Settings extender to have a default value (https://github.com/flarum/core/pull/2495)
+- Allow hooking into the sending of notifications before being send (https://github.com/flarum/core/pull/2533)
+- PHP 8 support (https://github.com/flarum/core/pull/2507)
+- Search extender (https://github.com/flarum/core/pull/2483)
+- User badges to post preview (https://github.com/flarum/core/pull/2555)
+- Optional extension dependencies allow a booting order (https://github.com/flarum/core/pull/2579)
+- Auth extender (https://github.com/flarum/core/pull/2176)
+- `X-Powered-By` header added to allow indexers easier data aggregation of Flarum adoption (https://github.com/flarum/core/pull/2618)
+
+### Changed
+- Run integration tests in transaction (https://github.com/flarum/core/pull/2304)
+- Allow policies to return a boolean for simplified allow/deny (https://github.com/flarum/core/pull/2534)
+- Converted highlight helper to typescript (https://github.com/flarum/core/pull/2532)
+- Add accessibility attributes to Mark as Read button (https://github.com/flarum/core/pull/2564)
+- Dismiss errors on change email modal upon a new request ([00913d5](https://github.com/flarum/core/commit/00913d5b0be2172cfce1f16aaf64a24f3d2e6d4b))
+- Disabled extensions now are marked with a red circle instead of a red dot (https://github.com/flarum/core/pull/2562)
+- Extension dependency errors now show the extension title instead of the ID (https://github.com/flarum/core/pull/2563)
+- Change `mutate` method on ApiSerializer extender to `attributes` (https://github.com/flarum/core/pull/2578)
+- Moved locale files to the core from the language pack (https://github.com/flarum/core/pull/2408)
+- AdminPage extensibility and generic improvements (https://github.com/flarum/core/pull/2593)
+- Remove entry of authors, link to https://flarum.org/team (https://github.com/flarum/core/pull/2625)
+- Search and filtering are split (https://github.com/flarum/core/pull/2454)
+- Move IP identification into a middleware (https://github.com/flarum/core/pull/2624)
+- Editor Driver abstraction introduced (https://github.com/flarum/core/pull/2594)
+- Allow overriding routes (https://github.com/flarum/core/pull/2577)
+- Split user edit permissions into permissions for editing of user credentials, username, groups and suspending (https://github.com/flarum/core/pull/2620)
+- Reduced number of admin extension categories (https://github.com/flarum/core/pull/2604)
+- Move search related classes to a dedicated Query namespace (https://github.com/flarum/core/pull/2645)
+- Rewrite common helpers into typescript (https://github.com/flarum/core/pull/2541)
+- `TextEditor` is moved to the common namespace for use in the admin frontend (https://github.com/flarum/core/pull/2649)
+- Update Laravel/Illuminate components to 8 (https://github.com/flarum/core/pull/2576)
+- Eager load relations in discussion listing to improve performance (https://github.com/flarum/core/pull/2639)
+- Adopt flarum/testing package (https://github.com/flarum/core/pull/2545)
+- Replace `user` gambit with `author` gambit ([612a57c](https://github.com/flarum/core/commit/612a57c4664415a3ea120103483645c32acc6f12))
+- Posts page of on user profile loads posts using username instead of id ([30017ee](https://github.com/flarum/core/commit/30017eef09ae9e78640c4e2cacd4909fffa8d775))
+
+### Fixed
+- Transform css breaks iOS scroll functionality (https://github.com/flarum/core/pull/2527)
+- Composer header is hidden on mobile devices (https://github.com/flarum/core/pull/2279)
+- Cannot delete a post or discussion of a deleted user (https://github.com/flarum/core/pull/2521)
+- DiscussionListPane jumps around not keeping the scroll position (https://github.com/flarum/core/pull/2402)
+- Infinite scroll on notifications dropdown broken (https://github.com/flarum/core/pull/2524)
+- The show language selector switch remains toggled on ([9347b12](https://github.com/flarum/core/commit/9347b12b47bf4ab97ffb7ca92673604b237c1012))
+- Model Visibility extender throws exception on extensions that aren't installed or enabled (https://github.com/flarum/core/pull/2580)
+- Extensions are marked as enabled when enabling fails to unmet extension dependencies (https://github.com/flarum/core/pull/2558)
+- Routes to admin extension pages without a valid ID break the admin page (https://github.com/flarum/core/pull/2584)
+- Disabled fieldset use an incorrect CSS property `disallowed` (https://github.com/flarum/core/pull/2585)
+- Scrolling to a post that is already loaded the Load More button shows and does not trigger (https://github.com/flarum/core/pull/2388)
+- Opening discussions on some mobile devices require a double tap (https://github.com/flarum/core/pull/2607)
+- iOS devices show erratic behavior in the post stream while updating (https://github.com/flarum/core/pull/2548)
+- Small mobile screens partially hides the composer when the keyboard is open (https://github.com/flarum/core/pull/2631)
+- Clearing cache does not clear the template cache in storage/views (https://github.com/flarum/core/pull/2648)
+- Boot errors show critical information (https://github.com/flarum/core/pull/2633)
+- List user endpoint discloses last online even if user choose against it (https://github.com/flarum/core/pull/2634)
+- Group gambit disclosed hidden groups (https://github.com/flarum/core/pull/2657)
+- Search results on small windows not fully visible (https://github.com/flarum/core/pull/2650)
+- Composer goes off screen on Safari when starting to type (https://github.com/flarum/core/pull/2660)
+- A search that has no results shows the search results dropdown ([b88a7cb](https://github.com/flarum/core/commit/b88a7cb33b56e318f11670e9e2d563aef94db039))
+- The composer modal moves around when typing on Safari ([a64c398](https://github.com/flarum/core/commit/a64c39835aba43e831209609f4a9638ae589aa41))
+
+### Removed
+- Deprecated CSRF wildcard path match
+- Deprecated policy and visibility scoping events
+- Deprecated post types event
+- Deprecated validation events
+- Deprecated notification events
+- Deprecated floodgate
+- Deprecated user preferences event
+- Deprecated formatting events
+- Deprecated api events
+- Deprecated bootstrap.php support
+- PHP 7.2 support (https://github.com/flarum/core/pull/2507)
+- Bidi attribute in the rendered HTML (https://github.com/flarum/core/pull/2602)
+- `AccessToken::find`, use `AccessToken::findValid` instead (https://github.com/flarum/core/pull/2651)
+
+### Deprecated
+- `GetModelIsPrivate` event (https://github.com/flarum/core/pull/2587)
+- `CheckingPassword` event (https://github.com/flarum/core/pull/2176)
+- `event()` helper (https://github.com/flarum/core/pull/2608)
+- `AccessToken::generate` argument `$lifetime` (https://github.com/flarum/core/pull/2651)
+- `Rememberer::remember` argument `$token` should receive an instance of `RememberAccessToken` with `AccessToken` being deprecated (https://github.com/flarum/core/pull/2651)
+- `Rememberer::rememberUser` (https://github.com/flarum/core/pull/2651)
+- `SessionAuthenticator::logIn` argument `$userId`, should be replaced with `AccessToken` (https://github.com/flarum/core/pull/2651)
+- `TextEditor` has been moved to `common` (https://github.com/flarum/core/pull/2649) 
+- `UserFilter` ([91e8b56](https://github.com/flarum/core/commit/91e8b569618957c86757ef89bac666e9102db5ae))
+
+
+## [0.1.0-beta.15](https://github.com/flarum/core/compare/v0.1.0-beta.14.1...v0.1.0-beta.15)
+
+### Added
+
+- Slug drivers support (https://github.com/flarum/core/pull/2456).
+- Notification type extender (https://github.com/flarum/core/pull/2424).
+- Validation extender (https://github.com/flarum/core/pull/2102).
+- Post extender (https://github.com/flarum/core/pull/2101).
+- Notification channel extender (https://github.com/flarum/core/pull/2432).
+- Service provider extender (https://github.com/flarum/core/pull/2437).
+- API serializer extender (https://github.com/flarum/core/pull/2438).
+- User preferences extender (https://github.com/flarum/core/pull/2463).
+- Settings extender (https://github.com/flarum/core/pull/2452).
+- ApiController extender (https://github.com/flarum/core/pull/2451).
+- Model visibility extender (https://github.com/flarum/core/pull/2460).
+- Policy extender (https://github.com/flarum/core/pull/2461).
+
+### Changed
+
+- Time helpers converted to Typescript (https://github.com/flarum/core/pull/2391).
+- Improved the formatter extender (https://github.com/flarum/core/pull/2098).
+- Improve wording on installer when facing file permission issues (https://github.com/flarum/core/pull/2435).
+- Background color of checkbox toggles improved for better usability (https://github.com/flarum/core/pull/2443).
+- Route resolving refactored (https://github.com/flarum/core/pull/2425).
+- Administration panel UX refactored (https://github.com/flarum/core/pull/2409).
+- Floodgate moved to middleware and extender added (https://github.com/flarum/core/pull/2170).
+- DRY up image uploading logic (https://github.com/flarum/core/pull/2477).
+- Process isolation on testing (https://github.com/flarum/core/commit/984f751c718c89501cc09857bc271efa2c7eea8c).
+- Forum and admin javascript exports namespaced (https://github.com/flarum/core/pull/2488).
+
+### Fixed
+
+- Web updater does not take into account subfolder installations (https://github.com/flarum/core/pull/2426).
+- Callables handling in extenders failed (https://github.com/flarum/core/pull/2423).
+- Scrolling on mobile from PostSteam changes didn't work correctly (https://github.com/flarum/core/pull/2385).
+- Side pane covers part of the discussion page due to `app.discussions` being empty (https://github.com/flarum/core/commit/102e76b084bf47fdfb4c73f95e1fbb322537f7aa).
+- Change email modal keeps showing the previous error message even on success (https://github.com/flarum/core/pull/2467).
+- Comment count not updated when discussions are deleted (https://github.com/flarum/core/pull/2472).
+- `goToIndex` in PostStream does not trigger an xhr to retrieve new data (https://github.com/flarum/core/commit/09e2736cbcc267594b660beabbd001d9030f9880).
+- On refresh the post number is reduced by one (https://github.com/flarum/core/pull/2476).
+- Queue worker would instantiate a new Queue factory, not the bound one (https://github.com/flarum/core/pull/2481).
+- Header accidentally has a border bottom (https://github.com/flarum/core/pull/2489).
+- Namespace mentioned in docblock is incorrect (https://github.com/flarum/core/pull/2494).
+- Scrolling inside longer discussions (especially Firefox) skips posts (https://github.com/flarum/core/commit/210a6b3e253d7917bd1eacd3ed8d2f95073ae99d).
+- Uploading avatars that are jpg/jpeg fails with a validation error (https://github.com/flarum/core/pull/2497).
+
+### Removed
+
+- MomentJS alias (https://github.com/flarum/core/pull/2428).
+- Deprecated user events `GetDisplayName` and `PrepareUserGroups` (https://github.com/flarum/core/pull/2428).
+- AssertPermissionTrait (https://github.com/flarum/core/pull/2428).
+- Path related helpers and methods in Application (https://github.com/flarum/core/pull/2428).
+- Backward compatibility layers from the frontend rewrite (https://github.com/flarum/core/pull/2428).
+
+### Deprecated
+
+- `CheckingForFlooding` (https://github.com/flarum/core/commit/8e25bcb68f86cc992c46dfa70368419fe9f936ac).
+
+## [0.1.0-beta.14.1](https://github.com/flarum/core/compare/v0.1.0-beta.14...v0.1.0-beta.14.1)
+
+### Fixed
+
+- SuperTextarea component is not exported.
+- Symfony dependencies do not match those depended on by Laravel (https://github.com/flarum/core/pull/2407).
+- Scripts from textformatter aren't executed (https://github.com/flarum/core/pull/2415)
+- Sub path installations have no page title.
+- Losing focus of Composer area when coming from fullscreen.
+
+## [0.1.0-beta.14](https://github.com/flarum/core/compare/v0.1.0-beta.13...v0.1.0-beta.14)
+
+### Added
+
+- Check dependencies before enabling / disabling extensions (https://github.com/flarum/core/pull/2188)
+- Set up temporary infrastructure for TypeScript in core (https://github.com/flarum/core/pull/2206)
+- Better UI for request error modals (https://github.com/flarum/core/pull/1929)
+- Display name extender, tests, frontend UI (https://github.com/flarum/core/pull/2174)
+- Scroll to post or show alert when editing a post from another page (https://github.com/flarum/core/pull/2108)
+- Feature to test email config by sending an email to the current user (https://github.com/flarum/core/pull/2023)
+- Allow searching users by group ID using the group gambit (https://github.com/flarum/core/pull/2192)
+- Use `liveHumanTimes` helper to update times without reload/rerender (https://github.com/flarum/core/pull/2208)
+- View extender, tests (https://github.com/flarum/core/pull/2134)
+- User extender to replace `PrepareUserGroups` (https://github.com/flarum/core/pull/2110)
+- Increase extensibility of skeleton PHP (https://github.com/flarum/core/pull/2308, https://github.com/flarum/core/pull/2318)
+- Pass a translator instance to `getEmailSubject` in `MailableInterface` (https://github.com/flarum/core/pull/2244)
+- Force LF line endings on windows (https://github.com/flarum/core/pull/2321)
+- Add a `Link` component for internal and external links (https://github.com/flarum/core/pull/2315)
+- `ConfirmDocumentUnload` component
+- Error handler middleware can now be manipulated by the middleware extender
+
+### Changed
+
+- Update to Mithril 2 (https://github.com/flarum/core/pull/2255)
+- Stop storing component instances (https://github.com/flarum/core/issues/1821, https://github.com/flarum/core/issues/2144)
+- Update to Laravel 6.x (https://github.com/flarum/core/issues/2055)
+- `Flarum\Foundation\Application` no longer implements `Illuminate\Contracts\Foundation\Application` (#2142)
+- `Flarum\Foundation\Application` no longer inherits `Illuminate\Container\Container` (#2142)
+- `paths` have been split off from `Flarum\Foundation\Application` into `Flarum\Foundation\Paths`, which can be injected where needed  (#2142)
+- `Flarum\User\Gate` no longer implements `Illuminate\Contracts\Auth\Access\Gate` (https://github.com/flarum/core/pull/2181)
+- Improve Group Gambit performance (https://github.com/flarum/core/pull/2192)
+- Switch to `dayjs` from `momentjs` (https://github.com/flarum/core/pull/2219)
+- Don't create a `bio` column in `users` for new installations (https://github.com/flarum/core/pull/2215)
+- Start converting core JS to TypeScript (https://github.com/flarum/core/pull/2207)
+- Make Carbon an explicit dependency (https://github.com/flarum/core/commit/3b39c212e0fef7522e7d541a9214ff3817138d5d)
+- Use Symfony's translator interface instead of Laravel's (https://github.com/flarum/core/pull/2243)
+- Use newer versions of fontawesome (https://github.com/flarum/core/pull/2274)
+- Use URL generator instead of `app()->url()` where possible (https://github.com/flarum/core/pull/2302)
+- Move config from `config.php` into an injectable helper class (https://github.com/flarum/core/pull/2271)
+- Use reserved TLD for bogus and test urls (https://github.com/flarum/core/commit/6860b24b70bd04544dde90e537ce021a5fc5a689)
+- Replace `m.stream` with `flarum/utils/Stream` (https://github.com/flarum/core/pull/2316)
+- Replace `affixedSidebar` util with `AffixedSidebar` component
+- Replace `m.withAttr` with `flarum/utils/withAttr`
+- Scroll Listener is now passive, performance improvement (https://github.com/flarum/core/pull/2387)
+
+### Fixed
+
+- `generate:migration` command for extensions (https://github.com/flarum/core/commit/443949f7b9d7558dbc1e0994cb898cbac59bec87)
+- Container config for `UninstalledSite` (https://github.com/flarum/core/commit/ecdce44d555dd36a365fd472b2916e677ef173cf)
+- Tooltip glitch on page chang (https://github.com/flarum/core/issues/2118)
+- Using multiple extenders in tests (https://github.com/flarum/core/commit/c4f4f218bf4b175a30880b807f9ccb1a37a25330)
+- Header glitch when opening modals (https://github.com/flarum/core/pull/2131)
+- Ensure `SameSite` is explicitly set for cookies (https://github.com/flarum/core/pull/2159)
+- Ensure `Flarum\User\Event\AvatarChanged` event is properly dispatched (https://github.com/flarum/core/pull/2197)
+- Show correct error message on wrong password when changing email (https://github.com/flarum/core/pull/2171)
+- Discussion unreadCount could be higher than commentCount if posts deleted (https://github.com/flarum/core/pull/2195)
+- Don't show page title on the default route (https://github.com/flarum/core/pull/2047)
+- Add page title to `All Discussions` page when it isn't the default route (https://github.com/flarum/core/pull/2047)
+- Accept `'0'` as `false` for `flarum/components/Checkbox` (https://github.com/flarum/core/pull/2210)
+- Fix PostStreamScrubber background (https://github.com/flarum/core/pull/2222)
+- Test port on BaseUrl tests (https://github.com/flarum/core/pull/2226)
+- `UrlGenerator` can now generate urls with optional parameters (https://github.com/flarum/core/pull/2246)
+- Allow `less` to be compiled independently of Flarum (https://github.com/flarum/core/pull/2252)
+- Use correct number abbreviation (https://github.com/flarum/core/pull/2261)
+- Ensure avatar html uses alt tags for accessibility (https://github.com/flarum/core/pull/2269)
+- Escape regex when searching (https://github.com/flarum/core/pull/2273)
+- Remove unneeded semicolons inserted during JS compilation (https://github.com/flarum/core/pull/2280)
+- Don't require a username/password for SMTP (https://github.com/flarum/core/pull/2287)
+- Allow uppercase entries for SMTP encryption validation (https://github.com/flarum/core/pull/2289)
+- Ensure that the right number of posts is returned from list posts API (https://github.com/flarum/core/pull/2291)
+- Fix a variety of PostStream bugs (https://github.com/flarum/core/pull/2160, https://github.com/flarum/core/pull/2160)
+- Sliding discussion glitch on mobile (https://github.com/flarum/core/pull/2324)
+- Sliding discussion button in wrong place (https://github.com/flarum/core/pull/2330, https://github.com/flarum/core/pull/2383)
+- Sliding discussion glitch on mobile (https://github.com/flarum/core/pull/2381)
+- Fix PostStream for posts with top margins, and scrubber position when scrolling below posts (https://github.com/flarum/core/pull/2369)
+
+### Removed
+
+- `Flarum\Event\AbstractConfigureRoutes` event class
+- `Flarum\Event\ConfigureApiRoutes` event class
+- `Flarum\Event\ConfigureForumRoutes` event class
+- `Flarum\Console\Event\Configuring` event class
+- `Flarum\Event\ConfigureModelDates` event class
+- `Flarum\Event\ConfigureLocales` event class
+- `Flarum\Event\ConfigureModelDefaultAttributes` event class
+- `Flarum\Event\GetModelRelationship` event class
+- `Flarum\User\Event\BioChanged` event class
+- `Flarum\Database\MigrationServiceProvider` moved into `Flarum\Database\DatabaseServiceProvider`
+- Unused `admin/components/Widget` component (`admin/component/DashboardWidget` should be used instead)
+- Mandrill mail driver (https://github.com/flarum/core/commit/bca833d3f1c34d45d95bf905902368a2753b8908)
+
+### Deprecated
+
+- `Flarum\User\Event\GetDisplayName` event class
+- Global path helpers, `Flarum\Foundation\Application` path methods (https://github.com/flarum/core/pull/2155)
+- `Flarum\User\AssertPermissionTrait` (https://github.com/flarum/core/pull/2044)
+
+## [0.1.0-beta.13](https://github.com/flarum/core/compare/v0.1.0-beta.12...v0.1.0-beta.13)
+
+### Added
+- Console extender (#2057)
+- CSRF extender (#2095)
+- Event extender (#2097)
+- Mail extender (#2012)
+- Model extender (#2100)
+- Posts by users that started a discussion now have the CSS class `.Post--by-start-user`
+- PHPUnit 8 compatibility
+- Composer 2 compatibility
+- Permission groups can now be hidden (#2129)
+- Confirmation popup when hiding or deleting posts (#2135)
+
+### Changed
+- Updated less.php dependency version to 3.0
+- Updated JS dependencies
+- All notifications and other emails now processed through the queue, if enabled (#978, #1928, #1931, #2096)
+- Simplified uploads, removing need to store intermediate files (#2117)
+- Improved date handling for dates older than 1 year (#2034)
+- Linting and automatic formatting for JS (#2099)
+- Translation files from Language Packs are only loaded for extensions that are enabled (#2020)
+- PHP extenders' properties are now `private` instead of `protected`, intentionally making it harder to extend these classes (#1958)
+- Preparation for upgrading Laravel components to 5.8 and then 6.0 (#2055, #2117)
+- Allowed permission checks based on model classes in addition to instances (#1977)
+
+### Fixed
+- Users can no longer restore discussions hidden by admins (#2037)
+- Issues of the Modal not showing or auto hiding (#1504, #1813, #2080)
+- Columnar layout on admin extensions page was broken in Firefox (#2029, #2111)
+- Non-dismissible modals could still be dismissed using the ESC key (#1917)
+- New discussions were added to the discussion list above unread sticky posts (#1751, #1868)
+- New discussions not visible to users when using Pusher (#2076, #2077)
+- Permission icons were aligned unevenly in admin permissions list (#2016, #2018)
+- Notification bubble not inversed on mobile with colored header (#1983, #2109)
+- Post stream scrubber clicks jumped back to first post (#1945)
+- Loading state of Switch toggle component was hard to see (#2039, #1491)
+- `Flarum\Extend\Middleware`: The methods `insertBefore()` and `insertAfter()` did not work as described (#2063, #2084)
+
+### Removed
+- Support for PHP 7.1 (#2014)
+- Zend compatibility bridge (#2010)
+- SES mail support (#2011)
+- Backward compatibility layer for `Flarum\Mail\DriverInterface`, new methods from beta.12 are now required
+- `Flarum\Util\Str` helper class
+- `Flarum\Event\ConfigureMiddleware` event
+
+### Deprecated
+- `Flarum\Event\AbstractConfigureRoutes` event class
+- `Flarum\Event\ConfigureApiRoutes` event class
+- `Flarum\Event\ConfigureForumRoutes` event class
+- `Flarum\Event\ConfigureLocales` event class
+
+## [0.1.0-beta.12](https://github.com/flarum/core/compare/v0.1.0-beta.11.1...v0.1.0-beta.12)
+
+### Added
+- Full support for PHP 7.4 (#1980)
+- Mail settings: Configure region for the Mailgun driver (#1834, #1850)
+- Mail settings: Alert admins about incomplete settings (#1763, #1921)
+- New permission that allows users to post without throttling (#1255, #1938)
+- Basic transliteration of discussion "slugs" / pretty URLs (#194, #1975)
+- User profiles: Render basic content on server side (#1901)
+- New extender for configuring middleware (#1919, #1952, #1957, #1971)
+- New extender for configuring error handling (#1781, #1970)
+- Automated tests for PHP extenders to guarantee their backwards compatibility
+
+### Changed
+- Profile URLs for non-existing users properly return HTTP 404 (#1846, #1901)
+- Confirmation email subject no longer contains the forum title (#1613)
+- Improved error handling during Flarum's early boot phase (#1607)
+- Updated deprecated "Zend" libraries to their new "Laminas" equivalents (#1963)
+
+### Fixed
+- Update page did not work when installed in subdirectories (#1947)
+- Avatar upload did not work in IE11 / Edge (#1125, #1570)
+- Translation fallback was ignored for client-rendered pages (#1774, #1961)
+- The success alert when posting replies was invisible (#1976)
+
+## [0.1.0-beta.11.1](https://github.com/flarum/core/compare/v0.1.0-beta.11...v0.1.0-beta.11.1)
+
+### Fixed
+- Saving custom css in admin failed (#1946)
+
+## [0.1.0-beta.11](https://github.com/flarum/core/compare/v0.1.0-beta.10...v0.1.0-beta.11)
+
+### Added
+- Comments have an additional class `Post--by-actor` when posted by the user (#1927)
+
+### Changed
+- Improved support for URL identification during installation (#1861)
+- KeyboardNavigatable now has a callback ability (#1922)
+- Links are no longer opened with target `_blank` but in the same window (#859)
+- Links now have `nofollow ugc` by default as their `rel` attribute (#859, #1884)
+- Improved performance of the full text gambit when searching for users (#1877)
+- The Queue implementation is now available under its Illuminate contract
+
+### Fixed
+- No error handling was possible in the console/cli (#1789)
+- Enable scrollbars in log in modals so it fits for GitHub (#1716)
+- Reduce log in modal for SSO so it fits for Facebook (#1727)
+- Deleting discussions permanently did not delete its posts (#1909)
+- Fixed the queue:restart command (#1932)
+- Deleted posts were visible to all visitors (#1827)
+- Old avatars weren't being deleted when replaced (#1918)
+- The search performance regression was reverted (#1764)
+- No profile background could be set for remote images (#445)
+- Back button sends to home even though it could actually go back (#1942)
+- Debug button no longer visible (#1687)
+- Modals on smaller screens use the whole width of the page
+
+## [0.1.0-beta.10](https://github.com/flarum/core/compare/v0.1.0-beta.9...v0.1.0-beta.10)
+
+### Added
+- Initial queue support: Infrastructure for offloading long-running tasks (e.g. email sending) to background workers (#1773)
+- Notifications can now be marked as read without visiting a discussion (#151)
+- SEO: The discussion list now has a `rel="canonical"` meta tag, preventing duplicate content (#1134, #1814)
+- The "Edit User" permission can now be edited in the UI (#1845)
+- New status message and redirect after user deletion (#1750, #1777)
+- Errors in Flarum's boot process are now presented with more detailed information (#1607)
+
+### Changed
+- Better, more detailed and extensible error handling (#1641, #1843)
+- Error pages in debug mode now return the same HTTP status codes as in production (#1648)
+- Tweak HTTP status codes for authentication / authorization errors (#1854)
+- Already-used links from account activation emails now show a better error message (#1337)
+
+### Fixed
+- Security vulnerabilities in dependencies
+- Performance: High CPU usage when scrolling in a discussion (#1222)
+- Special characters crashed the search (#1498)
+- Missing declarations for language and text direction in HTML output (#1772)
+- Private messages were counted in user post counts (#1695)
+- Extensions could not change the forum's default page (#1819)
+- API requests authenticated using access tokens needed to provide a CSRF token (#1828)
+- Accessibility: Screenreaders did not read the "Back to discussion list" link (#1835)
+
+## [0.1.0-beta.9](https://github.com/flarum/core/compare/v0.1.0-beta.8.2...v0.1.0-beta.9)
+
+### Added
+- New `hasPermission()` helper method for `Group` objects ([9684fbc](https://github.com/flarum/core/commit/9684fbc4da07d32aa322d9228302a23418412cb9))
+- Expose supported mail drivers in IoC container ([208bad3](https://github.com/flarum/core/commit/208bad393f37bfdb76007afcddfa4b7451563e9d))
+- More test for some API endpoints ([1670590](https://github.com/flarum/core/commit/167059027e5a066d618599c90164ef1b5a509148))
+- The `Formatter\Rendering` event now receives the HTTP request instance as well ([0ab9fac](https://github.com/flarum/core/commit/0ab9facc4bd59a260575e6fc650793c663e5866a))
+- More and better validation in installer UIs
+- Check and enforce minimum MariaDB ([7ff9a90](https://github.com/flarum/core/commit/7ff9a90204923293adc520d3c02dc984845d4f9f))
+- Revert publication of assets when installation fails ([ed9591c](https://github.com/flarum/core/commit/ed9591c16fb2ea7a4be3387b805d855a53e0a7d5))
+- Benefit from Laravel's database reconnection logic in long-running tasks ([e0becd0](https://github.com/flarum/core/commit/e0becd0c7bda939048923c1f86648793feee78d5))
+- The "vendor path" (where Composer dependencies can be found) can now be configured ([5e1680c](https://github.com/flarum/core/commit/5e1680c458cd3ba274faeb92de3ac2053789131e))
+
+### Changed
+- Performance: Actually cache translations on disk ([0d16fac](https://github.com/flarum/core/commit/0d16fac001bb735ee66e82871183516aeac269b7))
+- Allow per-site extenders to override extension extenders ([ba594de](https://github.com/flarum/core/commit/ba594de13a033480834d53d73f747b05fe9796f8))
+- Do not resolve objects from the IoC container (in service providers and extenders) until they are actually used
+- Replace event subscribers (that resolve objects from the IoC container) with listeners (that resolve lazily)
+- Use custom service provider for Mail component ([ac5e26a](https://github.com/flarum/core/commit/ac5e26a254d89e21bd4c115b6cbd40338e2e4b4b))
+- Update to Laravel 5.7, revert custom logic for building database index names
+- Refactored installer, extracted Installation class and pipeline for reuse in CLI and web installers ([790d5be](https://github.com/flarum/core/commit/790d5beee5e283178716bc8f9901c758d9e5b6a0))
+- Use whitelist for enabling pre-installed extensions during installation ([4585f03](https://github.com/flarum/core/commit/4585f03ee356c92942fbc2ae8c683c651b473954))
+- Update minimum MySQL version ([7ff9a90](https://github.com/flarum/core/commit/7ff9a90204923293adc520d3c02dc984845d4f9f))
+
+### Fixed
+- Signing up via OAuth providers was broken ([67f9375](https://github.com/flarum/core/commit/67f9375d4745add194ae3249d526197c32fd5461))
+- Group badges were overlapping ([16eb1fa](https://github.com/flarum/core/commit/16eb1fa63b6d7b80ec30c24c0e406a2b7ab09934))
+- API: Endpoint for uninstalling extensions returned an error ([c761802](https://github.com/flarum/core/commit/c76180290056ddbab67baf5ede814fcedf1dcf14))
+- Documentation links in installer were outdated ([b58380e](https://github.com/flarum/core/commit/b58380e224ee54abdade3d0a4cc107ef5c91c9a9))
+- Event posts where counted when aggregating user posts ([671fdec](https://github.com/flarum/core/commit/671fdec8d0a092ccceb5d4d5f657d0f4287fc4c7))
+- Admins could not reset user passwords ([c67fb2d](https://github.com/flarum/core/commit/c67fb2d4b6a128c71d65dc6703310c0b62f91be2))
+- Several down migrations were invalid
+- Validation errors on reset password page resulted in HTTP 404 ([4611abe](https://github.com/flarum/core/commit/4611abe5db8b94ca3dc7bf9c447fca7c67358ee3))
+- `is:unread` gambit generated an invalid query ([e17bb0b](https://github.com/flarum/core/commit/e17bb0b4331f2c92459292195c6b7db8cde1f9f3))
+- Entire forum was breaking when the `custom_less` setting was missing from the database ([bf2c5a5](https://github.com/flarum/core/commit/bf2c5a5564dff3f5ef13efe7a8d69f2617570ce6))
+- Dropdown icon was not showing in user card when on user page ([12fdfc9](https://github.com/flarum/core/commit/12fdfc9b544a27f6fe59c82ad6bddd3420cc0181))
+- Requests were missing the `original*` attributes, which broke installations in subfolders ([56fde28](https://github.com/flarum/core/commit/56fde28e436f52fee0c03c538f0a6049bc584b53))
+- Special characters such as `%` and `_` could return incorrect results ([ee3640e](https://github.com/flarum/core/commit/ee3640e1605ff67fef4b3d5cd0596f14a6ae73c9))
+- FontAwesome component package changed paths in version 5.9.0 ([5eb69e1](https://github.com/flarum/core/commit/5eb69e1f59fa73fdfd5badbf41a05a6a040e7426))
+- Some server environments had problems accessing the system-wide tmp path for storing JS file maps ([54660eb](https://github.com/flarum/core/commit/54660ebd6311f9ea142f1b573263d0d907400786))
+- Content length of posts.content was not migrated to mediumText in 2017 ([590b311](https://github.com/flarum/core/commit/590b3115708bf94a9c7f169d98c6126380c7056e))
+- An error occurred when going to the previous route if there was no previous route found ([985b87da](https://github.com/flarum/core/commit/985b87da6c9942c568a1a192e2fdcfde72e030ee))
+
+### Removed
+- `php flarum install --defaults` - this was meant to be used in our old development VM ([44c9109](https://github.com/flarum/core/commit/44c91099cd77138bb5fc29f14fb1e81a9781272d))
+- Obsolete `id` attributes in JSON-API responses ([ecc3b5e](https://github.com/flarum/core/commit/ecc3b5e2271f8d9b38d52cd54476d86995dbe32e) and [7a44086](https://github.com/flarum/core/commit/7a44086bf3a0e3ba907dceb13d07ac695eca05ea))
+
+## [0.1.0-beta.8.1](https://github.com/flarum/core/compare/v0.1.0-beta.8...v0.1.0-beta.8.1)
+
+### Fixed
+- Fix live output in `migrate:reset` command ([f591585](https://github.com/flarum/core/commit/f591585d02f8c4ff0211c5bf4413dd6baa724c05))
+- Fix search with database prefix ([7705a2b](https://github.com/flarum/core/commit/7705a2b7d751943ef9d0c7379ec34f8530b99310))
+- Fix invalid join time of admin user created by installer ([57f73c9](https://github.com/flarum/core/commit/57f73c9638eeb825f9e336ed3c443afccfd8995e))
+- Ensure InnoDB engine is used for all tables ([fb6b51b](https://github.com/flarum/core/commit/fb6b51b1cfef0af399607fe038603c8240800b2b), [6370f7e](https://github.com/flarum/core/commit/6370f7ecffa9ea7d5fb64d9551400edbc63318db))
+- Fix dropping foreign keys in `down` migrations ([57d5846](https://github.com/flarum/core/commit/57d5846b647881009d9e60f9ffca20b1bb77776e))
+- Fix discussion list scroll position not being maintained when hero is not visible ([40dc6ac](https://github.com/flarum/core/commit/40dc6ac604c2a0973356b38217aa8d09352daae5))
+- Fix empty meta description tag ([88e43cc](https://github.com/flarum/core/commit/88e43cc6940ee30d6529e9ce659471ec4fb1c474))
+- Remove empty attributes on `<html>` tag ([796b577](https://github.com/flarum/core/commit/796b57753d34d4ea741dbebcbc550b17808f6c94))

LICENSE

@@ -1,6 +1,7 @@
 The MIT License (MIT)
 
-Copyright (c) 2014-2015 Toby Zerner
+Copyright (c) 2019-2021 Stichting Flarum (Flarum Foundation)
+Copyright (c) 2014-2019 Toby Zerner (toby.zerner@gmail.com)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -1,7 +1,36 @@
-# Flarum Core
+<p align="center"><img src="https://flarum.org/assets/img/logo.png"></p>
 
-This repository contains the core code of Flarum. If you want to install Flarum, visit the [main Flarum repository](http://github.com/flarum/flarum).
+<p align="center">
+<a href="https://github.com/flarum/core/actions?query=workflow%3ATests"><img src="https://github.com/flarum/core/workflows/Tests/badge.svg" alt="PHP Tests"></a>
+<a href="https://packagist.org/packages/flarum/core"><img src="https://img.shields.io/packagist/dt/flarum/core" alt="Total Downloads"></a>
+<a href="https://packagist.org/packages/flarum/core"><img src="https://img.shields.io/github/v/release/flarum/core?sort=semver" alt="Latest Version"></a>
+<a href="https://packagist.org/packages/flarum/core"><img src="https://img.shields.io/packagist/l/flarum/core" alt="License"></a>
+<a href="https://github.styleci.io/repos/28257573"><img src="https://github.styleci.io/repos/28257573/shield?style=flat" alt="StyleCI"></a>
+</p>
+
+
+## About Flarum
+
+**[Flarum](https://flarum.org/) is a delightfully simple discussion platform for your website.** It's fast and easy to use, with all the features you need to run a successful community. It is designed to be:
+
+* **Fast and simple.** No clutter, no bloat, no complex dependencies. Flarum is built with PHP so it’s quick and easy to deploy. The interface is powered by Mithril, a performant JavaScript framework with a tiny footprint.
+
+* **Beautiful and responsive.** This is forum software for humans. Flarum is carefully designed to be consistent and intuitive across platforms, out-of-the-box.
+
+* **Powerful and extensible.** Customize, extend, and integrate Flarum to suit your community. Flarum’s architecture is amazingly flexible, with a powerful Extension API.
+
+## Installation
+
+This repository contains Flarum's core code. If you want to set up a forum, visit the [Flarum skeleton repository](https://github.com/flarum/flarum).
 
 ## Contributing
 
-Interested in contributing to Flarum? Please read the [Contributing docs](http://flarum.org/docs/contributing) to learn how you can help.
+Thank you for considering contributing to Flarum! Please read the **[Contributing guide](https://flarum.org/docs/contributing.html)** to learn how you can help.
+
+## Security Vulnerabilities
+
+If you discover a security vulnerability within Flarum, please send an e-mail to [security@flarum.org](mailto:security@flarum.org). All security vulnerabilities will be promptly addressed. More details can be found in our [security policy](https://github.com/flarum/core/security/policy).
+
+## License
+
+Flarum is open-source software licensed under the [MIT License](https://github.com/flarum/flarum/blob/master/LICENSE).

composer.json

@@ -1,42 +1,76 @@
 {
     "name": "flarum/core",
-    "description": "",
+    "description": "Delightfully simple forum software.",
+    "keywords": [
+        "forum",
+        "discussion"
+    ],
+    "homepage": "https://flarum.org/",
+    "license": "MIT",
     "authors": [
         {
-            "name": "Toby Zerner",
-            "email": "toby@flarum.org"
+            "name": "Flarum",
+            "email": "info@flarum.org",
+            "homepage": "https://flarum.org/team"
         }
     ],
+    "support": {
+        "issues": "https://github.com/flarum/core/issues",
+        "source": "https://github.com/flarum/core",
+        "docs": "https://flarum.org/docs/"
+    },
     "require": {
-        "php": ">=5.4.0",
-        "illuminate/bus": "5.1.*",
-        "illuminate/cache": "5.1.*",
-        "illuminate/config": "5.1.*",
-        "illuminate/container": "5.1.*",
-        "illuminate/contracts": "5.1.*",
-        "illuminate/database": "5.1.*",
-        "illuminate/events": "5.1.*",
-        "illuminate/filesystem": "5.1.*",
-        "illuminate/hashing": "5.1.*",
-        "illuminate/mail": "5.1.*",
-        "illuminate/support": "5.1.*",
-        "illuminate/validation": "5.1.*",
-        "illuminate/view": "5.1.*",
+        "php": ">=7.3",
+        "axy/sourcemap": "^0.1.4",
+        "components/font-awesome": "^5.14.0",
+        "dflydev/fig-cookies": "^3.0.0",
+        "doctrine/dbal": "^2.7",
+        "dragonmantank/cron-expression": "^3.1.0",
+        "franzl/whoops-middleware": "^2.0.0",
+        "illuminate/bus": "^8.0",
+        "illuminate/cache": "^8.0",
+        "illuminate/config": "^8.0",
+        "illuminate/console": "^8.0",
+        "illuminate/container": "^8.0",
+        "illuminate/contracts": "^8.0",
+        "illuminate/database": "^8.0",
+        "illuminate/events": "^8.0",
+        "illuminate/filesystem": "^8.0",
+        "illuminate/hashing": "^8.0",
+        "illuminate/mail": "^8.0",
+        "illuminate/queue": "^8.0",
+        "illuminate/session": "^8.0",
+        "illuminate/support": "^8.0",
+        "illuminate/validation": "^8.0",
+        "illuminate/view": "^8.0",
+        "intervention/image": "^2.5.0",
+        "laminas/laminas-diactoros": "^2.4.1",
+        "laminas/laminas-httphandlerrunner": "^1.2.0",
+        "laminas/laminas-stratigility": "^3.2.2",
         "league/flysystem": "^1.0.11",
-        "tobscure/json-api": "^0.1.1",
-        "oyejorge/less.php": "~1.5",
-        "intervention/image": "^2.3.0",
-        "s9e/text-formatter": "^0.1.0",
-        "psr/http-message": "^1.0",
-        "zendframework/zend-diactoros": "^1.1",
+        "matthiasmullie/minify": "^1.3",
+        "middlewares/base-path": "^2.0.1",
+        "middlewares/base-path-router": "^2.0.1",
+        "middlewares/request-handler": "^2.0.1",
+        "monolog/monolog": "^1.16.0",
+        "nesbot/carbon": "^2.0",
         "nikic/fast-route": "^0.6",
-        "dflydev/fig-cookies": "^1.0",
-        "symfony/console": "^2.7",
-        "symfony/yaml": "^2.7"
+        "psr/http-message": "^1.0",
+        "psr/http-server-handler": "^1.0",
+        "psr/http-server-middleware": "^1.0",
+        "s9e/text-formatter": "^2.3.6",
+        "symfony/config": "^5.2.2",
+        "symfony/console": "^5.2.2",
+        "symfony/event-dispatcher": "^5.2.2",
+        "symfony/mime": "^5.2.0",
+        "symfony/polyfill-intl-messageformatter": "^1.22.0",
+        "symfony/translation": "^5.1.5",
+        "symfony/yaml": "^5.2.2",
+        "tobscure/json-api": "^0.3.0",
+        "wikimedia/less.php": "^3.0"
     },
     "require-dev": {
-        "squizlabs/php_codesniffer": "2.*",
-        "phpspec/phpspec": "^2.2"
+        "flarum/testing": "1.0@dev"
     },
     "autoload": {
         "psr-4": {
@@ -45,5 +79,33 @@
         "files": [
             "src/helpers.php"
         ]
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "Flarum\\Tests\\": "tests/"
+        }
+    },
+    "config": {
+        "sort-packages": true
+    },
+    "extra": {
+        "branch-alias": {
+            "dev-master": "1.x-dev"
+        }
+    },
+    "scripts": {
+        "test": [
+            "@test:unit",
+            "@test:integration"
+        ],
+        "test:unit": "phpunit -c tests/phpunit.unit.xml",
+        "test:integration": "phpunit -c tests/phpunit.integration.xml",
+        "test:setup": "@php tests/integration/setup.php"
+    },
+    "scripts-descriptions": {
+        "test": "Runs all tests.",
+        "test:unit": "Runs all unit tests.",
+        "test:integration": "Runs all integration tests.",
+        "test:setup": "Sets up a database for use with integration tests. Execute this only once."
     }
 }

js/.bundlewatch.config.json

@@ -0,0 +1,8 @@
+{
+    "files": [
+        {
+            "path": "./dist/*.js"
+        }
+    ],
+    "defaultCompression": "gzip"
+}

js/.gitignore

@@ -1 +0,0 @@
-bower_components

js/.prettierrc.json

@@ -0,0 +1,6 @@
+{
+  "printWidth": 150,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "trailingComma": "es5"
+}

js/@types/global/index.d.ts

@@ -0,0 +1,39 @@
+// Mithril
+import Mithril from 'mithril';
+
+// Other third-party libs
+import * as _dayjs from 'dayjs';
+import * as _$ from 'jquery';
+
+// Globals from flarum/core
+import Application from '../../src/common/Application';
+
+import type { TooltipJQueryFunction } from '../tooltips';
+
+/**
+ * flarum/core exposes several extensions globally:
+ *
+ * - jQuery for convenient DOM manipulation
+ * - Mithril for VDOM and components
+ * - dayjs for date/time operations
+ *
+ * Since these are already part of the global namespace, extensions won't need
+ * to (and should not) bundle these themselves.
+ */
+declare global {
+  // $ is already defined by `@types/jquery`
+  const m: Mithril.Static;
+  const dayjs: typeof _dayjs;
+
+  // Extend JQuery with our custom functions, defined with $.fn
+  interface JQuery {
+    tooltip: TooltipJQueryFunction;
+  }
+}
+
+/**
+ * All global variables owned by flarum/core.
+ */
+declare global {
+  const app: Application;
+}

js/@types/tooltips/index.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Selection of options accepted by [Bootstrap's tooltips](https://getbootstrap.com/docs/3.3/javascript/#tooltips-options).
+ *
+ * ---
+ *
+ * Not all options are present from Bootstrap to discourage the use of options
+ * that will be deprecated in the future.
+ *
+ * More commonly used options that will be deprecated remain, but are marked as
+ * such.
+ *
+ * @see https://getbootstrap.com/docs/3.3/javascript/#tooltips-options
+ */
+export interface TooltipCreationOptions {
+  /**
+   * Whether HTML content is allowed in the tooltip.
+   *
+   * ---
+   *
+   * **Warning:** this is a possible XSS attack vector. This option shouldn't
+   * be used wherever possible, and will not work when we migrate to CSS-only
+   * tooltips.
+   *
+   * @deprecated
+   */
+  html?: boolean;
+  /**
+   * Tooltip position around the target element.
+   */
+  placement?: 'top' | 'bottom' | 'left' | 'right';
+  /**
+   * Sets the delay between a trigger state occurring and the tooltip appearing
+   * on-screen.
+   *
+   * ---
+   *
+   * **Warning:** this option will be removed when we switch to CSS-only
+   * tooltips.
+   *
+   * @deprecated
+   */
+  delay?: number;
+  /**
+   * Value used if no `title` attribute is present on the HTML element.
+   *
+   * If a function is given, it will be called with its `this` reference set to
+   * the element that the tooltip is attached to.
+   */
+  title?: string;
+  /**
+   * How the tooltip is triggered.
+   *
+   * Either on `hover`, on `hover focus` (either of the two).
+   *
+   * ---
+   *
+   * **Warning:** `manual`, `click` and `focus` on its own are deprecated options
+   * which will not be supported in the future.
+   */
+  trigger?: 'hover' | 'hover focus';
+}
+
+/**
+ * Creates a tooltip on a jQuery element reference.
+ *
+ * Returns the same jQuery reference to allow for method chaining.
+ */
+export type TooltipJQueryFunction = (tooltipOptions?: TooltipCreationOptions | 'destroy' | 'show' | 'hide') => JQuery;

js/admin.js

@@ -0,0 +1,2 @@
+export * from './src/common';
+export * from './src/admin';

js/admin/.gitignore

@@ -1,3 +0,0 @@
-node_modules
-mithril.js
-dist

js/admin/Gulpfile.js

@@ -1,33 +0,0 @@
-var gulp = require('flarum-gulp');
-
-var nodeDir = 'node_modules';
-var bowerDir = '../bower_components';
-
-gulp({
-  files: [
-    nodeDir + '/babel-core/external-helpers.js',
-
-    bowerDir + '/es6-micro-loader/dist/system-polyfill.js',
-
-    bowerDir + '/mithril/mithril.js',
-    bowerDir + '/jquery/dist/jquery.js',
-    bowerDir + '/moment/moment.js',
-
-    bowerDir + '/bootstrap/js/affix.js',
-    bowerDir + '/bootstrap/js/dropdown.js',
-    bowerDir + '/bootstrap/js/modal.js',
-    bowerDir + '/bootstrap/js/tooltip.js',
-    bowerDir + '/bootstrap/js/transition.js',
-
-    bowerDir + '/spin.js/spin.js',
-    bowerDir + '/spin.js/jquery.spin.js'
-  ],
-  modules: {
-    'flarum': [
-      'src/**/*.js',
-      '../lib/**/*.js'
-    ]
-  },
-  externalHelpers: true,
-  outputFile: 'dist/app.js'
-});

js/admin/package.json

@@ -1,8 +0,0 @@
-{
-  "private": true,
-  "devDependencies": {
-    "gulp": "^3.8.11",
-    "flarum-gulp": "git+https://github.com/flarum/gulp.git",
-    "babel-core": "^5.0.0"
-  }
-}

js/admin/src/app.js

@@ -1,17 +0,0 @@
-import App from 'flarum/App';
-import store from 'flarum/initializers/store';
-import preload from 'flarum/initializers/preload';
-import routes from 'flarum/initializers/routes';
-import boot from 'flarum/initializers/boot';
-
-const app = new App();
-
-app.initializers.add('store', store);
-app.initializers.add('routes', routes);
-
-app.initializers.add('preload', preload, -100);
-app.initializers.add('boot', boot, -100);
-
-app.extensionSettings = {};
-
-export default app;

js/admin/src/components/AddExtensionModal.js

@@ -1,30 +0,0 @@
-/*
- * This file is part of Flarum.
- *
- * (c) Toby Zerner <toby.zerner@gmail.com>
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
-
-import Modal from 'flarum/components/Modal';
-
-export default class AddExtensionModal extends Modal {
-  className() {
-    return 'AddExtensionModal Modal--small';
-  }
-
-  title() {
-    return 'Add Extension';
-  }
-
-  content() {
-    return (
-      <div className="Modal-body">
-        <p>One day in the not-too-distant future, this dialog will allow you to add an extension to your forum with ease. We're building an ecosystem as we speak!</p>
-        <p>In the meantime, if you manage to get your hands on a new extension, simply drop it in your forum's <code>extensions</code> directory.</p>
-        <p>If you're a developer, you can <a href="http://flarum.org/docs/extend">read the docs</a> and have a go at building your own.</p>
-      </div>
-    );
-  }
-}

js/admin/src/components/AdminLinkButton.js

@@ -1,24 +0,0 @@
-/*
- * This file is part of Flarum.
- *
- * (c) Toby Zerner <toby.zerner@gmail.com>
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
-
-import LinkButton from 'flarum/components/LinkButton';
-
-export default class AdminLinkButton extends LinkButton {
-  getButtonContent() {
-    const content = super.getButtonContent();
-
-    content.push(
-      <div className="AdminLinkButton-description">
-        {this.props.description}
-      </div>
-    );
-
-    return content;
-  }
-}

js/admin/src/components/AdminNav.js

@@ -1,72 +0,0 @@
-/*
- * This file is part of Flarum.
- *
- * (c) Toby Zerner <toby.zerner@gmail.com>
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
-
-import Component from 'flarum/Component';
-import AdminLinkButton from 'flarum/components/AdminLinkButton';
-import SelectDropdown from 'flarum/components/SelectDropdown';
-
-import ItemList from 'flarum/utils/ItemList';
-
-export default class AdminNav extends Component {
-  view() {
-    return (
-      <SelectDropdown
-        className="AdminNav App-titleControl"
-        buttonClassName="Button"
-        children={this.items().toArray()}
-        />
-    );
-  }
-
-  /**
-   * Build an item list of links to show in the admin navigation.
-   *
-   * @return {ItemList}
-   */
-  items() {
-    const items = new ItemList();
-
-    items.add('dashboard', AdminLinkButton.component({
-      href: app.route('dashboard'),
-      icon: 'bar-chart',
-      children: 'Dashboard',
-      description: 'Your forum at a glance.'
-    }));
-
-    items.add('basics', AdminLinkButton.component({
-      href: app.route('basics'),
-      icon: 'pencil',
-      children: 'Basics',
-      description: 'Set your forum title, language, and other basic settings.'
-    }));
-
-    items.add('permissions', AdminLinkButton.component({
-      href: app.route('permissions'),
-      icon: 'key',
-      children: 'Permissions',
-      description: 'Configure who can see and do what.'
-    }));
-
-    items.add('appearance', AdminLinkButton.component({
-      href: app.route('appearance'),
-      icon: 'paint-brush',
-      children: 'Appearance',
-      description: 'Customize your forum\'s colors, logos, and other variables.'
-    }));
-
-    items.add('extensions', AdminLinkButton.component({
-      href: app.route('extensions'),
-      icon: 'puzzle-piece',
-      children: 'Extensions',
-      description: 'Add extra functionality to your forum and make it your own.'
-    }));
-
-    return items;
-  }
-}

js/admin/src/components/AppearancePage.js

@@ -1,88 +0,0 @@
-import Component from 'flarum/Component';
-import Button from 'flarum/components/Button';
-import Switch from 'flarum/components/Switch';
-import EditCustomCssModal from 'flarum/components/EditCustomCssModal';
-import saveConfig from 'flarum/utils/saveConfig';
-
-export default class AppearancePage extends Component {
-  constructor(...args) {
-    super(...args);
-
-    this.primaryColor = m.prop(app.config.theme_primary_color);
-    this.secondaryColor = m.prop(app.config.theme_secondary_color);
-    this.darkMode = m.prop(app.config.theme_dark_mode === '1');
-    this.coloredHeader = m.prop(app.config.theme_colored_header === '1');
-  }
-
-  view() {
-    return (
-      <div className="AppearancePage">
-        <div className="container">
-          <form onsubmit={this.onsubmit.bind(this)}>
-            <fieldset className="AppearancePage-colors">
-              <legend>Colors</legend>
-              <div className="helpText">
-                Choose two colors to theme your forum with. The first will be used as a highlight color, while the second will be used to style background elements.
-              </div>
-
-              <div className="AppearancePage-colors-input">
-                <input className="FormControl" placeholder="#aaaaaa" value={this.primaryColor()} onchange={m.withAttr('value', this.primaryColor)}/>
-                <input className="FormControl" placeholder="#aaaaaa" value={this.secondaryColor()} onchange={m.withAttr('value', this.secondaryColor)}/>
-              </div>
-
-              {Switch.component({
-                state: this.darkMode(),
-                children: 'Dark Mode',
-                onchange: this.darkMode
-              })}
-
-              {Switch.component({
-                state: this.coloredHeader(),
-                children: 'Colored Header',
-                onchange: this.coloredHeader
-              })}
-
-              {Button.component({
-                className: 'Button Button--primary',
-                children: 'Save Changes',
-                loading: this.loading
-              })}
-            </fieldset>
-          </form>
-
-          <fieldset>
-            <legend>Custom Styles</legend>
-            <div className="helpText">
-              Customize your forum's appearance by adding your own LESS/CSS code to be applied on top of Flarum's default styles.
-            </div>
-            {Button.component({
-              className: 'Button',
-              children: 'Edit Custom CSS',
-              onclick: () => app.modal.show(new EditCustomCssModal())
-            })}
-          </fieldset>
-        </div>
-      </div>
-    );
-  }
-
-  onsubmit(e) {
-    e.preventDefault();
-
-    const hex = /^#[0-9a-f]{3}([0-9a-f]{3})?$/i;
-
-    if (!hex.test(this.primaryColor()) || !hex.test(this.secondaryColor())) {
-      alert('Please enter a hexadecimal color code.');
-      return;
-    }
-
-    this.loading = true;
-
-    saveConfig({
-      theme_primary_color: this.primaryColor(),
-      theme_secondary_color: this.secondaryColor(),
-      theme_dark_mode: this.darkMode(),
-      theme_colored_header: this.coloredHeader()
-    }).then(() => window.location.reload());
-  }
-}

js/admin/src/components/BasicsPage.js

@@ -1,144 +0,0 @@
-import Component from 'flarum/Component';
-import FieldSet from 'flarum/components/FieldSet';
-import Select from 'flarum/components/Select';
-import Button from 'flarum/components/Button';
-import Alert from 'flarum/components/Alert';
-import saveConfig from 'flarum/utils/saveConfig';
-
-export default class BasicsPage extends Component {
-  constructor(...args) {
-    super(...args);
-
-    this.loading = false;
-
-    this.fields = [
-      'forum_title',
-      'forum_description',
-      'default_locale',
-      'default_route',
-      'welcome_title',
-      'welcome_message'
-    ];
-    this.values = {};
-
-    const config = app.config;
-    this.fields.forEach(key => this.values[key] = m.prop(config[key]));
-
-    this.localeOptions = {};
-    const locales = app.locales;
-    for (const i in locales) {
-      this.localeOptions[i] = `${locales[i]} (${i})`;
-    }
-  }
-
-  view() {
-    return (
-      <div className="BasicsPage">
-        <div className="container">
-          <form onsubmit={this.onsubmit.bind(this)}>
-            {FieldSet.component({
-              label: 'Forum Title',
-              children: [
-                <input className="FormControl" value={this.values.forum_title()} oninput={m.withAttr('value', this.values.forum_title)}/>
-              ]
-            })}
-
-            {FieldSet.component({
-              label: 'Forum Description',
-              children: [
-                <div className="helpText">
-                  Enter a short sentence or two that describes your community. This will appear in the meta tag and show up in search engines.
-                </div>,
-                <textarea className="FormControl" value={this.values.forum_description()} oninput={m.withAttr('value', this.values.forum_description)}/>
-              ]
-            })}
-
-            {Object.keys(this.localeOptions).length > 1
-              ? FieldSet.component({
-                label: 'Default Language',
-                children: [
-                  Select.component({
-                    options: this.localeOptions,
-                    onchange: this.values.default_locale
-                  })
-                ]
-              })
-              : ''}
-
-            {FieldSet.component({
-              label: 'Home Page',
-              className: 'BasicsPage-homePage',
-              children: [
-                <div className="helpText">
-                  Choose the page which users will first see when they visit your forum. If entering a custom value, use the path relative to the forum root.
-                </div>,
-                <label className="checkbox">
-                  <input type="radio" name="homePage" value="/all" checked={this.values.default_route() === '/all'} onclick={m.withAttr('value', this.values.default_route)}/>
-                  All Discussions
-                </label>,
-                <label className="checkbox">
-                  <input type="radio" name="homePage" value="custom" checked={this.values.default_route() !== '/all'} onclick={() => {
-                    this.values.default_route('');
-                    m.redraw(true);
-                    this.$('.BasicsPage-homePage input').select();
-                  }}/>
-                  Custom <input className="FormControl" value={this.values.default_route()} oninput={m.withAttr('value', this.values.default_route)} style={this.values.default_route() !== '/all' ? 'margin-top: 5px' : 'display:none'}/>
-                </label>
-              ]
-            })}
-
-            {FieldSet.component({
-              label: 'Welcome Banner',
-              className: 'BasicsPage-welcomeBanner',
-              children: [
-                <div className="helpText">
-                  Configure the text that displays in the banner on the All Discussions page. Use this to welcome guests to your forum.
-                </div>,
-                <div className="BasicsPage-welcomeBanner-input">
-                  <input className="FormControl" value={this.values.welcome_title()} oninput={m.withAttr('value', this.values.welcome_title)}/>
-                  <textarea className="FormControl" value={this.values.welcome_message()} oninput={m.withAttr('value', this.values.welcome_message)}/>
-                </div>
-              ]
-            })}
-
-            {Button.component({
-              type: 'submit',
-              className: 'Button Button--primary',
-              children: 'Save Changes',
-              loading: this.loading,
-              disabled: !this.changed()
-            })}
-          </form>
-        </div>
-      </div>
-    );
-  }
-
-  changed() {
-    const config = app.config;
-
-    return this.fields.some(key => this.values[key]() !== config[key]);
-  }
-
-  onsubmit(e) {
-    e.preventDefault();
-
-    if (this.loading) return;
-
-    this.loading = true;
-    app.alerts.dismiss(this.successAlert);
-
-    const config = {};
-
-    this.fields.forEach(key => config[key] = this.values[key]());
-
-    saveConfig(config)
-      .then(() => {
-        app.alerts.show(this.successAlert = new Alert({type: 'success', children: 'Your changes were saved.'}));
-      })
-      .finally(() => {
-        this.loading = false;
-        m.redraw();
-      });
-  }
-}

js/admin/src/components/ConfigDropdown.js

@@ -1,25 +0,0 @@
-import SelectDropdown from 'flarum/components/SelectDropdown';
-import Button from 'flarum/components/Button';
-import saveConfig from 'flarum/utils/saveConfig';
-
-export default class ConfigDropdown extends SelectDropdown {
-  static initProps(props) {
-    super.initProps(props);
-
-    props.className = 'ConfigDropdown';
-    props.buttonClassName = 'Button Button--text';
-    props.caretIcon = 'caret-down';
-    props.defaultLabel = 'Custom';
-
-    props.children = props.options.map(({value, label}) => {
-      const active = app.config[props.key] === value;
-
-      return Button.component({
-        children: label,
-        icon: active ? 'check' : true,
-        onclick: saveConfig.bind(this, {[props.key]: value}),
-        active
-      });
-    });
-  }
-}

js/admin/src/components/DashboardPage.js

@@ -1,21 +0,0 @@
-import Component from 'flarum/Component';
-
-export default class DashboardPage extends Component {
-  view() {
-    return (
-      <div className="DashboardPage">
-        <div className="container">
-          <h2>Welcome to Flarum Beta</h2>
-          <p>Thanks for trying out Flarum! You are running version <strong>{app.forum.attribute('version')}</strong>. This is beta software, and should not be used in production.</p>
-          <ul>
-            <li>Having problems? Read the <a href="http://flarum.org/docs/troubleshooting" target="_blank">Troubleshooting docs</a>.</li>
-            <li>Found a bug? Please <a href="https://github.com/flarum/core/issues" target="_blank">report it on GitHub</a>.</li>
-            <li>Got some feedback? Let us know what you think on the <a href="http://discuss.flarum.org" target="_blank">Support Forum</a>.</li>
-            <li>Want to contribute? Read the <a href="http://flarum.org/docs/contributing" target="_blank">Contributing docs</a>.</li>
-            <li>Interested in developing extensions? Read the <a href="http://flarum.org/docs/extend" target="_blank">Extension docs</a>.</li>
-          </ul>
-        </div>
-      </div>
-    );
-  }
-}

js/admin/src/components/EditCustomCssModal.js

@@ -1,51 +0,0 @@
-import Modal from 'flarum/components/Modal';
-import Button from 'flarum/components/Button';
-import saveConfig from 'flarum/utils/saveConfig';
-
-export default class EditCustomCssModal extends Modal {
-  constructor(...args) {
-    super(...args);
-
-    this.customLess = m.prop(app.config.custom_less || '');
-  }
-
-  className() {
-    return 'EditCustomCssModal Modal--large';
-  }
-
-  title() {
-    return 'Edit Custom CSS';
-  }
-
-  content() {
-    return (
-      <div className="Modal-body">
-        <p>Customize your forum's appearance by adding your own LESS/CSS code to be applied on top of Flarum's default styles. <a href="">Read the documentation</a> for more information.</p>
-
-        <div className="Form">
-          <div className="Form-group">
-            <textarea className="FormControl" rows="30" value={this.customLess()} onchange={m.withAttr('value', this.customLess)}/>
-          </div>
-
-          <div className="Form-group">
-            {Button.component({
-              className: 'Button Button--primary',
-              children: 'Save Changes',
-              loading: this.loading
-            })}
-          </div>
-        </div>
-      </div>
-    );
-  }
-
-  onsubmit(e) {
-    e.preventDefault();
-
-    this.loading = true;
-
-    saveConfig({
-      custom_less: this.customLess()
-    }).then(() => window.location.reload());
-  }
-}

js/admin/src/components/EditGroupModal.js

@@ -1,105 +0,0 @@
-import Modal from 'flarum/components/Modal';
-import Button from 'flarum/components/Button';
-import Badge from 'flarum/components/Badge';
-import Group from 'flarum/models/Group';
-
-/**
- * The `EditGroupModal` component shows a modal dialog which allows the user
- * to create or edit a group.
- */
-export default class EditGroupModal extends Modal {
-  constructor(...args) {
-    super(...args);
-
-    this.group = this.props.group || app.store.createRecord('groups');
-
-    this.nameSingular = m.prop(this.group.nameSingular() || '');
-    this.namePlural = m.prop(this.group.namePlural() || '');
-    this.icon = m.prop(this.group.icon() || '');
-    this.color = m.prop(this.group.color() || '');
-  }
-
-  className() {
-    return 'EditGroupModal Modal--small';
-  }
-
-  title() {
-    return [
-      this.color() || this.icon() ? Badge.component({
-        icon: this.icon(),
-        style: {backgroundColor: this.color()}
-      }) : '',
-      ' ',
-      this.namePlural() || 'Create Group'
-    ];
-  }
-
-  content() {
-    return (
-      <div className="Modal-body">
-        <div className="Form">
-          <div className="Form-group">
-            <label>Name</label>
-            <div className="EditGroupModal-name-input">
-              <input className="FormControl" placeholder="Singular (e.g. Mod)" value={this.nameSingular()} oninput={m.withAttr('value', this.nameSingular)}/>
-              <input className="FormControl" placeholder="Plural (e.g. Mods)" value={this.namePlural()} oninput={m.withAttr('value', this.namePlural)}/>
-            </div>
-          </div>
-
-          <div className="Form-group">
-            <label>Color</label>
-            <input className="FormControl" placeholder="#aaaaaa" value={this.color()} oninput={m.withAttr('value', this.color)}/>
-          </div>
-
-          <div className="Form-group">
-            <label>Icon</label>
-            <div className="helpText">
-              Enter the name of any <a href="http://fortawesome.github.io/Font-Awesome/icons/" tabindex="-1">FontAwesome</a> icon class, <em>without</em> the <code>fa-</code> prefix.
-            </div>
-            <input className="FormControl" placeholder="bolt" value={this.icon()} oninput={m.withAttr('value', this.icon)}/>
-          </div>
-
-          <div className="Form-group">
-            {Button.component({
-              type: 'submit',
-              className: 'Button Button--primary EditGroupModal-save',
-              loading: this.loading,
-              children: 'Save Changes'
-            })}
-            {this.group.exists && this.group.id() !== Group.ADMINISTRATOR_ID ? (
-              <button type="button" className="Button EditGroupModal-delete" onclick={this.delete.bind(this)}>
-                Delete Group
-              </button>
-            ) : ''}
-          </div>
-        </div>
-      </div>
-    );
-  }
-
-  onsubmit(e) {
-    e.preventDefault();
-
-    this.loading = true;
-
-    this.group.save({
-      nameSingular: this.nameSingular(),
-      namePlural: this.namePlural(),
-      color: this.color(),
-      icon: this.icon()
-    }).then(
-      () => this.hide(),
-      () => {
-        this.loading = false;
-        m.redraw();
-      }
-    );
-  }
-
-  delete() {
-    if (confirm('Are you sure you want to delete this group? The group members will NOT be deleted.')) {
-      this.group.delete().then(() => m.redraw());
-      this.hide();
-    }
-  }
-}

js/admin/src/components/ExtensionsPage.js

@@ -1,115 +0,0 @@
-import Component from 'flarum/Component';
-import LinkButton from 'flarum/components/LinkButton';
-import Button from 'flarum/components/Button';
-import Dropdown from 'flarum/components/Dropdown';
-import Separator from 'flarum/components/Separator';
-import AddExtensionModal from 'flarum/components/AddExtensionModal';
-import LoadingModal from 'flarum/components/LoadingModal';
-import ItemList from 'flarum/utils/ItemList';
-import icon from 'flarum/helpers/icon';
-
-export default class ExtensionsPage extends Component {
-  view() {
-    return (
-      <div className="ExtensionsPage">
-        <div className="ExtensionsPage-header">
-          <div className="container">
-            {Button.component({
-              children: 'Add Extension',
-              icon: 'plus',
-              className: 'Button Button--primary',
-              onclick: () => app.modal.show(new AddExtensionModal())
-            })}
-          </div>
-        </div>
-
-        <div className="ExtensionsPage-list">
-          <div className="container">
-            <ul className="ExtensionList">
-              {app.extensions
-                .sort((a, b) => a.name.localeCompare(b.name))
-                .map(extension => (
-                  <li className={'ExtensionListItem ' + (!this.isEnabled(extension.name) ? 'disabled' : '')}>
-                    {Dropdown.component({
-                      icon: 'ellipsis-v',
-                      children: this.controlItems(extension).toArray(),
-                      className: 'ExtensionListItem-controls',
-                      buttonClassName: 'Button Button--icon Button--flat',
-                      menuClassName: 'Dropdown-menu--right'
-                    })}
-                    <div className="ExtensionListItem-content">
-                      <span className="ExtensionListItem-icon ExtensionIcon" style={extension.icon}>
-                        {extension.icon ? icon(extension.icon.name) : ''}
-                      </span>
-                      <h4 className="ExtensionListItem-title">
-                        {extension.title}{' '}
-                        <small className="ExtensionListItem-version">{extension.version}</small>
-                      </h4>
-                      <div className="ExtensionListItem-description">{extension.description}</div>
-                    </div>
-                  </li>
-                ))}
-            </ul>
-          </div>
-        </div>
-      </div>
-    );
-  }
-
-  controlItems(extension) {
-    const items = new ItemList();
-    const enabled = this.isEnabled(extension.name);
-
-    if (app.extensionSettings[extension.name]) {
-      items.add('settings', Button.component({
-        icon: 'cog',
-        children: 'Settings',
-        onclick: app.extensionSettings[extension.name]
-      }));
-    }
-
-    items.add('toggle', Button.component({
-      icon: 'power-off',
-      children: enabled ? 'Disable' : 'Enable',
-      onclick: () => {
-        app.request({
-          url: app.forum.attribute('apiUrl') + '/extensions/' + extension.name,
-          method: 'PATCH',
-          data: {enabled: !enabled}
-        }).then(() => window.location.reload());
-
-        app.modal.show(new LoadingModal());
-      }
-    }));
-
-    if (!enabled) {
-      items.add('uninstall', Button.component({
-        icon: 'trash-o',
-        children: 'Uninstall',
-        onclick: () => {
-          app.request({
-            url: app.forum.attribute('apiUrl') + '/extensions/' + extension.name,
-            method: 'DELETE',
-          }).then(() => window.location.reload());
-
-          app.modal.show(new LoadingModal());
-        }
-      }));
-    }
-
-    // items.add('separator2', Separator.component());
-
-    // items.add('support', LinkButton.component({
-    //   icon: 'support',
-    //   children: 'Support'
-    // }));
-
-    return items;
-  }
-
-  isEnabled(name) {
-    const enabled = JSON.parse(app.config.extensions_enabled);
-
-    return enabled.indexOf(name) !== -1;
-  }
-}

js/admin/src/components/HeaderSecondary.js

@@ -1,30 +0,0 @@
-import Component from 'flarum/Component';
-import SessionDropdown from 'flarum/components/SessionDropdown';
-import ItemList from 'flarum/utils/ItemList';
-import listItems from 'flarum/helpers/listItems';
-
-/**
- * The `HeaderSecondary` component displays secondary header controls.
- */
-export default class HeaderSecondary extends Component {
-  view() {
-    return (
-      <ul className="Header-controls">
-        {listItems(this.items().toArray())}
-      </ul>
-    );
-  }
-
-  /**
-   * Build an item list for the controls.
-   *
-   * @return {ItemList}
-   */
-  items() {
-    const items = new ItemList();
-
-    items.add('session', SessionDropdown.component());
-
-    return items;
-  }
-}

js/admin/src/components/LoadingModal.js

@@ -1,19 +0,0 @@
-import Modal from 'flarum/components/Modal';
-
-export default class LoadingModal extends Modal {
-  isDismissible() {
-    return false;
-  }
-
-  className() {
-    return 'LoadingModal Modal--small';
-  }
-
-  title() {
-    return 'Please Wait...';
-  }
-
-  content() {
-    return '';
-  }
-}

js/admin/src/components/PermissionDropdown.js

@@ -1,115 +0,0 @@
-import Dropdown from 'flarum/components/Dropdown';
-import Button from 'flarum/components/Button';
-import Separator from 'flarum/components/Separator';
-import Group from 'flarum/models/Group';
-import GroupBadge from 'flarum/components/GroupBadge';
-
-function badgeForId(id) {
-  const group = app.store.getById('groups', id);
-
-  return group ? GroupBadge.component({group, label: null}) : '';
-}
-
-export default class PermissionDropdown extends Dropdown {
-  static initProps(props) {
-    super.initProps(props);
-
-    props.className = 'PermissionDropdown';
-    props.buttonClassName = 'Button Button--text';
-  }
-
-  view() {
-    this.props.children = [];
-
-    const groupIds = app.permissions[this.props.permission] || [];
-    const everyone = groupIds.indexOf(Group.GUEST_ID) !== -1;
-    const members = groupIds.indexOf(Group.MEMBER_ID) !== -1;
-    const adminGroup = app.store.getById('groups', Group.ADMINISTRATOR_ID);
-
-    if (everyone) {
-      this.props.label = 'Everyone';
-    } else if (members) {
-      this.props.label = 'Members';
-    } else {
-      this.props.label = [
-        badgeForId(Group.ADMINISTRATOR_ID),
-        groupIds.map(badgeForId)
-      ];
-    }
-
-    if (this.props.allowGuest) {
-      this.props.children.push(
-        Button.component({
-          children: 'Everyone',
-          icon: everyone ? 'check' : true,
-          onclick: () => this.save([Group.GUEST_ID])
-        })
-      );
-    }
-
-    this.props.children.push(
-      Button.component({
-        children: 'Members',
-        icon: members ? 'check' : true,
-        onclick: () => this.save([Group.MEMBER_ID])
-      }),
-
-      Separator.component(),
-
-      Button.component({
-        children: [GroupBadge.component({group: adminGroup, label: null}), ' ', adminGroup.namePlural()],
-        icon: !everyone && !members ? 'check' : true,
-        disabled: !everyone && !members,
-        onclick: e => {
-          e.stopPropagation();
-          this.save([]);
-        }
-      })
-    );
-
-    [].push.apply(
-      this.props.children,
-      app.store.all('groups')
-        .filter(group => [Group.ADMINISTRATOR_ID, Group.GUEST_ID, Group.MEMBER_ID].indexOf(group.id()) === -1)
-        .map(group => Button.component({
-          children: [GroupBadge.component({group, label: null}), ' ', group.namePlural()],
-          icon: groupIds.indexOf(group.id()) !== -1 ? 'check' : true,
-          onclick: (e) => {
-            e.stopPropagation();
-            this.toggle(group.id());
-          }
-        }))
-    );
-
-    return super.view();
-  }
-
-  save(groupIds) {
-    const permission = this.props.permission;
-
-    app.permissions[permission] = groupIds;
-
-    app.request({
-      method: 'POST',
-      url: app.forum.attribute('apiUrl') + '/permission',
-      data: {permission, groupIds}
-    });
-  }
-
-  toggle(groupId) {
-    const permission = this.props.permission;
-
-    let groupIds = app.permissions[permission] || [];
-
-    const index = groupIds.indexOf(groupId);
-
-    if (index !== -1) {
-      groupIds.splice(index, 1);
-    } else {
-      groupIds.push(groupId);
-      groupIds = groupIds.filter(id => [Group.GUEST_ID, Group.MEMBER_ID].indexOf(id) === -1);
-    }
-
-    this.save(groupIds);
-  }
-}

js/admin/src/components/PermissionGrid.js

@@ -1,212 +0,0 @@
-import Component from 'flarum/Component';
-import PermissionDropdown from 'flarum/components/PermissionDropdown';
-import ConfigDropdown from 'flarum/components/ConfigDropdown';
-import Button from 'flarum/components/Button';
-import ItemList from 'flarum/utils/ItemList';
-
-export default class PermissionGrid extends Component {
-  constructor(...args) {
-    super(...args);
-
-    this.permissions = this.permissionItems().toArray();
-  }
-
-  view() {
-    const scopes = this.scopeItems().toArray();
-
-    const permissionCells = permission => {
-      return scopes.map(scope => (
-        <td>
-          {scope.render(permission)}
-        </td>
-      ));
-    };
-
-    return (
-      <table className="PermissionGrid">
-        <thead>
-          <tr>
-            <td></td>
-            {scopes.map(scope => (
-              <th>
-                {scope.label}{' '}
-                {scope.onremove ? Button.component({icon: 'times', className: 'Button Button--text PermissionGrid-removeScope', onclick: scope.onremove}) : ''}
-              </th>
-            ))}
-            <th>{this.scopeControlItems().toArray()}</th>
-          </tr>
-        </thead>
-        {this.permissions.map(section => (
-          <tbody>
-            <tr className="PermissionGrid-section">
-              <th>{section.label}</th>
-              {permissionCells(section)}
-              <td/>
-            </tr>
-            {section.children.map(child => (
-              <tr className="PermissionGrid-child">
-                <th>{child.label}</th>
-                {permissionCells(child)}
-                <td/>
-              </tr>
-            ))}
-          </tbody>
-        ))}
-      </table>
-    );
-  }
-
-  permissionItems() {
-    const items = new ItemList();
-
-    items.add('view', {
-      label: 'View the forum',
-      children: this.viewItems().toArray()
-    });
-
-    items.add('start', {
-      label: 'Start discussions',
-      children: this.startItems().toArray()
-    });
-
-    items.add('reply', {
-      label: 'Reply to discussions',
-      children: this.replyItems().toArray()
-    });
-
-    items.add('moderate', {
-      label: 'Moderate',
-      children: this.moderateItems().toArray()
-    });
-
-    return items;
-  }
-
-  viewItems() {
-    const items = new ItemList();
-
-    items.add('view', {
-      label: 'View discussions',
-      permission: 'forum.view',
-      allowGuest: true
-    });
-
-    items.add('signUp', {
-      label: 'Sign up',
-      setting: () => ConfigDropdown.component({
-        key: 'allow_sign_up',
-        options: [
-          {value: '1', label: 'Open'},
-          {value: '0', label: 'Closed'}
-        ]
-      })
-    });
-
-    return items;
-  }
-
-  startItems() {
-    const items = new ItemList();
-
-    items.add('start', {
-      label: 'Start discussions',
-      permission: 'forum.startDiscussion'
-    });
-
-    items.add('allowRenaming', {
-      label: 'Allow renaming',
-      setting: () => {
-        const minutes = parseInt(app.config.allow_renaming, 10);
-
-        return ConfigDropdown.component({
-          defaultLabel: minutes ? `For ${minutes} minutes` : 'Indefinitely',
-          key: 'allow_renaming',
-          options: [
-            {value: '-1', label: 'Indefinitely'},
-            {value: '10', label: 'For 10 minutes'},
-            {value: 'reply', label: 'Until next reply'}
-          ]
-        });
-      }
-    });
-
-    return items;
-  }
-
-  replyItems() {
-    const items = new ItemList();
-
-    items.add('reply', {
-      label: 'Reply to discussions',
-      permission: 'discussion.reply'
-    });
-
-    items.add('allowPostEditing', {
-      label: 'Allow post editing',
-      setting: () => {
-        const minutes = parseInt(app.config.allow_post_editing, 10);
-
-        return ConfigDropdown.component({
-          defaultLabel: minutes ? `For ${minutes} minutes` : 'Indefinitely',
-          key: 'allow_post_editing',
-          options: [
-            {value: '-1', label: 'Indefinitely'},
-            {value: '10', label: 'For 10 minutes'},
-            {value: 'reply', label: 'Until next reply'}
-          ]
-        });
-      }
-    });
-
-    return items;
-  }
-
-  moderateItems() {
-    const items = new ItemList();
-
-    items.add('editPosts', {
-      label: 'Edit posts',
-      permission: 'discussion.editPosts'
-    });
-
-    items.add('deletePosts', {
-      label: 'Delete posts',
-      permission: 'discussion.deletePosts'
-    });
-
-    items.add('renameDiscussions', {
-      label: 'Rename discussions',
-      permission: 'discussion.rename'
-    });
-
-    items.add('deleteDiscussions', {
-      label: 'Delete discussions',
-      permission: 'discussion.delete'
-    });
-
-    return items;
-  }
-
-  scopeItems() {
-    const items = new ItemList();
-
-    items.add('global', {
-      label: 'Global',
-      render: item => {
-        if (item.setting) {
-          return item.setting();
-        } else if (item.permission) {
-          return PermissionDropdown.component(Object.assign({}, item));
-        }
-
-        return '';
-      }
-    });
-
-    return items;
-  }
-
-  scopeControlItems() {
-    return new ItemList();
-  }
-}

js/admin/src/components/PermissionsPage.js

@@ -1,41 +0,0 @@
-import Component from 'flarum/Component';
-import GroupBadge from 'flarum/components/GroupBadge';
-import EditGroupModal from 'flarum/components/EditGroupModal';
-import Group from 'flarum/models/Group';
-import icon from 'flarum/helpers/icon';
-import PermissionGrid from 'flarum/components/PermissionGrid';
-
-export default class PermissionsPage extends Component {
-  view() {
-    return (
-      <div className="PermissionsPage">
-        <div className="PermissionsPage-groups">
-          <div className="container">
-            {app.store.all('groups')
-              .filter(group => [Group.GUEST_ID, Group.MEMBER_ID].indexOf(group.id()) === -1)
-              .map(group => (
-                <button className="Button Group" onclick={() => app.modal.show(new EditGroupModal({group}))}>
-                  {GroupBadge.component({
-                    group,
-                    className: 'Group-icon',
-                    label: null
-                  })}
-                  <span className="Group-name">{group.namePlural()}</span>
-                </button>
-              ))}
-            <button className="Button Group Group--add" onclick={() => app.modal.show(new EditGroupModal())}>
-              {icon('plus', {className: 'Group-icon'})}
-              <span className="Group-name">New Group</span>
-            </button>
-          </div>
-        </div>
-
-        <div className="PermissionsPage-permissions">
-          <div className="container">
-            {PermissionGrid.component()}
-          </div>
-        </div>
-      </div>
-    );
-  }
-}

js/admin/src/components/SessionDropdown.js

@@ -1,54 +0,0 @@
-import avatar from 'flarum/helpers/avatar';
-import username from 'flarum/helpers/username';
-import Dropdown from 'flarum/components/Dropdown';
-import Button from 'flarum/components/Button';
-import ItemList from 'flarum/utils/ItemList';
-
-/**
- * The `SessionDropdown` component shows a button with the current user's
- * avatar/name, with a dropdown of session controls.
- */
-export default class SessionDropdown extends Dropdown {
-  static initProps(props) {
-    super.initProps(props);
-
-    props.className = 'SessionDropdown';
-    props.buttonClassName = 'Button Button--user Button--flat';
-    props.menuClassName = 'Dropdown-menu--right';
-  }
-
-  view() {
-    this.props.children = this.items().toArray();
-
-    return super.view();
-  }
-
-  getButtonContent() {
-    const user = app.session.user;
-
-    return [
-      avatar(user), ' ',
-      <span className="Button-label">{username(user)}</span>
-    ];
-  }
-
-  /**
-   * Build an item list for the contents of the dropdown menu.
-   *
-   * @return {ItemList}
-   */
-  items() {
-    const items = new ItemList();
-
-    items.add('logOut',
-      Button.component({
-        icon: 'sign-out',
-        children: app.trans('core.log_out'),
-        onclick: app.session.logout.bind(app.session)
-      }),
-      -100
-    );
-
-    return items;
-  }
-}

js/admin/src/initializers/boot.js

@@ -1,57 +0,0 @@
-/*global FastClick*/
-
-import ScrollListener from 'flarum/utils/ScrollListener';
-import Drawer from 'flarum/utils/Drawer';
-import mapRoutes from 'flarum/utils/mapRoutes';
-
-import Navigation from 'flarum/components/Navigation';
-import HeaderPrimary from 'flarum/components/HeaderPrimary';
-import HeaderSecondary from 'flarum/components/HeaderSecondary';
-import AdminNav from 'flarum/components/AdminNav';
-import ModalManager from 'flarum/components/ModalManager';
-import AlertManager from 'flarum/components/AlertManager';
-
-/**
- * The `boot` initializer boots up the admin app. It initializes some app
- * globals, mounts components to the page, and begins routing.
- *
- * @param {ForumApp} app
- */
-export default function boot(app) {
-  m.startComputation();
-
-  m.mount(document.getElementById('app-navigation'), Navigation.component({className: 'App-backControl', drawer: true}));
-  m.mount(document.getElementById('header-navigation'), Navigation.component());
-  m.mount(document.getElementById('header-primary'), HeaderPrimary.component());
-  m.mount(document.getElementById('header-secondary'), HeaderSecondary.component());
-  m.mount(document.getElementById('admin-navigation'), AdminNav.component());
-
-  app.drawer = new Drawer();
-  app.modal = m.mount(document.getElementById('modal'), ModalManager.component());
-  app.alerts = m.mount(document.getElementById('alerts'), AlertManager.component());
-  app.history = {
-    canGoBack: () => true,
-    backUrl: () => app.forum.attribute('baseUrl'),
-    back: function() {
-      window.location = this.backUrl();
-    }
-  };
-
-  m.route.mode = 'hash';
-  m.route(document.getElementById('content'), '/', mapRoutes(app.routes));
-
-  m.endComputation();
-
-  // Add a class to the body which indicates that the page has been scrolled
-  // down.
-  new ScrollListener(top => {
-    const $app = $('#app');
-    const offset = $app.offset().top;
-
-    $app
-      .toggleClass('affix', top >= offset)
-      .toggleClass('scrolled', top > offset);
-  }).start();
-
-  app.booted = true;
-}

js/admin/src/initializers/routes.js

@@ -1,20 +0,0 @@
-import DashboardPage from 'flarum/components/DashboardPage';
-import BasicsPage from 'flarum/components/BasicsPage';
-import PermissionsPage from 'flarum/components/PermissionsPage';
-import AppearancePage from 'flarum/components/AppearancePage';
-import ExtensionsPage from 'flarum/components/ExtensionsPage';
-
-/**
- * The `routes` initializer defines the admin app's routes.
- *
- * @param {App} app
- */
-export default function(app) {
-  app.routes = {
-    'dashboard': {path: '/', component: DashboardPage.component()},
-    'basics': {path: '/basics', component: BasicsPage.component()},
-    'permissions': {path: '/permissions', component: PermissionsPage.component()},
-    'appearance': {path: '/appearance', component: AppearancePage.component()},
-    'extensions': {path: '/extensions', component: ExtensionsPage.component()}
-  };
-}

js/admin/src/utils/saveConfig.js

@@ -1,14 +0,0 @@
-export default function saveConfig(config) {
-  const oldConfig = JSON.parse(JSON.stringify(app.config));
-
-  Object.assign(app.config, config);
-
-  return app.request({
-    method: 'POST',
-    url: app.forum.attribute('apiUrl') + '/config',
-    data: {config}
-  }).catch(error => {
-    app.config = oldConfig;
-    throw error;
-  });
-}

js/bower.json

@@ -1,15 +0,0 @@
-{
-  "name": "flarum",
-  "dependencies": {
-    "jquery": "~2.1.3",
-    "jquery.hotkeys": "jeresig/jquery.hotkeys#0.2.0",
-    "bootstrap": "~3.3.2",
-    "spin.js": "~2.0.1",
-    "moment": "~2.8.4",
-    "color-thief": "v2.0",
-    "mithril": "lhorie/mithril.js#next",
-    "es6-micro-loader": "caridy/es6-micro-loader#v0.2.1",
-    "fastclick": "~1.0.6",
-    "autolink": "*"
-  }
-}

js/dist-typings/@types/global/index.d.ts

@@ -0,0 +1,39 @@
+// Mithril
+import Mithril from 'mithril';
+
+// Other third-party libs
+import * as _dayjs from 'dayjs';
+import * as _$ from 'jquery';
+
+// Globals from flarum/core
+import Application from '../../src/common/Application';
+
+import type { TooltipJQueryFunction } from '../tooltips';
+
+/**
+ * flarum/core exposes several extensions globally:
+ *
+ * - jQuery for convenient DOM manipulation
+ * - Mithril for VDOM and components
+ * - dayjs for date/time operations
+ *
+ * Since these are already part of the global namespace, extensions won't need
+ * to (and should not) bundle these themselves.
+ */
+declare global {
+  // $ is already defined by `@types/jquery`
+  const m: Mithril.Static;
+  const dayjs: typeof _dayjs;
+
+  // Extend JQuery with our custom functions, defined with $.fn
+  interface JQuery {
+    tooltip: TooltipJQueryFunction;
+  }
+}
+
+/**
+ * All global variables owned by flarum/core.
+ */
+declare global {
+  const app: Application;
+}

js/dist-typings/@types/tooltips/index.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Selection of options accepted by [Bootstrap's tooltips](https://getbootstrap.com/docs/3.3/javascript/#tooltips-options).
+ *
+ * ---
+ *
+ * Not all options are present from Bootstrap to discourage the use of options
+ * that will be deprecated in the future.
+ *
+ * More commonly used options that will be deprecated remain, but are marked as
+ * such.
+ *
+ * @see https://getbootstrap.com/docs/3.3/javascript/#tooltips-options
+ */
+export interface TooltipCreationOptions {
+  /**
+   * Whether HTML content is allowed in the tooltip.
+   *
+   * ---
+   *
+   * **Warning:** this is a possible XSS attack vector. This option shouldn't
+   * be used wherever possible, and will not work when we migrate to CSS-only
+   * tooltips.
+   *
+   * @deprecated
+   */
+  html?: boolean;
+  /**
+   * Tooltip position around the target element.
+   */
+  placement?: 'top' | 'bottom' | 'left' | 'right';
+  /**
+   * Sets the delay between a trigger state occurring and the tooltip appearing
+   * on-screen.
+   *
+   * ---
+   *
+   * **Warning:** this option will be removed when we switch to CSS-only
+   * tooltips.
+   *
+   * @deprecated
+   */
+  delay?: number;
+  /**
+   * Value used if no `title` attribute is present on the HTML element.
+   *
+   * If a function is given, it will be called with its `this` reference set to
+   * the element that the tooltip is attached to.
+   */
+  title?: string;
+  /**
+   * How the tooltip is triggered.
+   *
+   * Either on `hover`, on `hover focus` (either of the two).
+   *
+   * ---
+   *
+   * **Warning:** `manual`, `click` and `focus` on its own are deprecated options
+   * which will not be supported in the future.
+   */
+  trigger?: 'hover' | 'hover focus';
+}
+
+/**
+ * Creates a tooltip on a jQuery element reference.
+ *
+ * Returns the same jQuery reference to allow for method chaining.
+ */
+export type TooltipJQueryFunction = (tooltipOptions?: TooltipCreationOptions | 'destroy' | 'show' | 'hide') => JQuery;

js/dist-typings/admin/AdminApplication.d.ts

@@ -0,0 +1,17 @@
+export default class AdminApplication extends Application {
+    extensionData: ExtensionData;
+    extensionCategories: {
+        feature: number;
+        theme: number;
+        language: number;
+    };
+    history: {
+        canGoBack: () => boolean;
+        getPrevious: () => void;
+        backUrl: () => any;
+        back: () => void;
+    };
+    getRequiredPermissions(permission: any): string[];
+}
+import Application from "../common/Application";
+import ExtensionData from "./utils/ExtensionData";

js/dist-typings/admin/app.d.ts

@@ -0,0 +1,3 @@
+import Admin from './AdminApplication';
+declare const app: Admin;
+export default app;

js/dist-typings/admin/compat.d.ts

@@ -0,0 +1,164 @@
+declare var _default: {
+    extend: typeof import("../common/extend");
+    Session: typeof import("../common/Session").default;
+    Store: typeof import("../common/Store").default;
+    'utils/BasicEditorDriver': typeof import("../common/utils/BasicEditorDriver").default;
+    'utils/evented': {
+        handlers: Object;
+        getHandlers(event: string): any[];
+        trigger(event: string, ...args: any[]): void;
+        on(event: string, handler: Function): void;
+        one(event: string, handler: Function): void;
+        off(event: string, handler: Function): void;
+    };
+    'utils/liveHumanTimes': typeof import("../common/utils/liveHumanTimes").default;
+    'utils/ItemList': typeof import("../common/utils/ItemList").default;
+    'utils/mixin': typeof import("../common/utils/mixin").default;
+    'utils/humanTime': typeof import("../common/utils/humanTime").default;
+    'utils/computed': typeof import("../common/utils/computed").default;
+    'utils/insertText': typeof import("../common/utils/insertText").default;
+    'utils/styleSelectedText': typeof import("../common/utils/styleSelectedText").default;
+    'utils/Drawer': typeof import("../common/utils/Drawer").default;
+    'utils/anchorScroll': typeof import("../common/utils/anchorScroll").default;
+    'utils/RequestError': typeof import("../common/utils/RequestError").default;
+    'utils/abbreviateNumber': typeof import("../common/utils/abbreviateNumber").default;
+    'utils/string': typeof import("../common/utils/string");
+    'utils/SubtreeRetainer': typeof import("../common/utils/SubtreeRetainer").default;
+    'utils/escapeRegExp': typeof import("../common/utils/escapeRegExp").default;
+    'utils/extract': typeof import("../common/utils/extract").default;
+    'utils/ScrollListener': typeof import("../common/utils/ScrollListener").default;
+    'utils/stringToColor': typeof import("../common/utils/stringToColor").default;
+    'utils/Stream': typeof import("mithril/stream");
+    'utils/subclassOf': typeof import("../common/utils/subclassOf").default;
+    'utils/setRouteWithForcedRefresh': typeof import("../common/utils/setRouteWithForcedRefresh").default;
+    'utils/patchMithril': typeof import("../common/utils/patchMithril").default;
+    'utils/proxifyCompat': (compat: {
+        [key: string]: any;
+    }, namespace: string) => {
+        [key: string]: any;
+    };
+    'utils/classList': (...classes: import("clsx").ClassValue[]) => string;
+    'utils/extractText': typeof import("../common/utils/extractText").default;
+    'utils/formatNumber': typeof import("../common/utils/formatNumber").default;
+    'utils/mapRoutes': typeof import("../common/utils/mapRoutes").default;
+    'utils/withAttr': (key: string, cb: Function) => (this: Element) => void;
+    'utils/throttleDebounce': typeof import("../common/utils/throttleDebounce");
+    'models/Notification': typeof import("../common/models/Notification").default;
+    'models/User': typeof import("../common/models/User").default;
+    'models/Post': typeof import("../common/models/Post").default;
+    'models/Discussion': typeof import("../common/models/Discussion").default;
+    'models/Group': typeof import("../common/models/Group").default;
+    'models/Forum': typeof import("../common/models/Forum").default;
+    Component: typeof import("../common/Component").default;
+    Fragment: typeof import("../common/Fragment").default;
+    Translator: typeof import("../common/Translator").default;
+    'components/AlertManager': typeof import("../common/components/AlertManager").default;
+    'components/Page': typeof import("../common/components/Page").default;
+    'components/Switch': typeof import("../common/components/Switch").default;
+    'components/Badge': typeof import("../common/components/Badge").default;
+    'components/LoadingIndicator': typeof import("../common/components/LoadingIndicator").default;
+    'components/Placeholder': typeof import("../common/components/Placeholder").default;
+    'components/Separator': typeof import("../common/components/Separator").default;
+    'components/Dropdown': typeof import("../common/components/Dropdown").default;
+    'components/SplitDropdown': typeof import("../common/components/SplitDropdown").default;
+    'components/RequestErrorModal': typeof import("../common/components/RequestErrorModal").default;
+    'components/FieldSet': typeof import("../common/components/FieldSet").default;
+    'components/Select': typeof import("../common/components/Select").default;
+    'components/Navigation': typeof import("../common/components/Navigation").default;
+    'components/Alert': typeof import("../common/components/Alert").default;
+    'components/Link': typeof import("../common/components/Link").default;
+    'components/LinkButton': typeof import("../common/components/LinkButton").default;
+    'components/Checkbox': typeof import("../common/components/Checkbox").default;
+    'components/SelectDropdown': typeof import("../common/components/SelectDropdown").default;
+    'components/ModalManager': typeof import("../common/components/ModalManager").default;
+    'components/Button': typeof import("../common/components/Button").default;
+    'components/Modal': typeof import("../common/components/Modal").default;
+    'components/GroupBadge': typeof import("../common/components/GroupBadge").default;
+    'components/TextEditor': typeof import("../common/components/TextEditor").default;
+    'components/TextEditorButton': typeof import("../common/components/TextEditorButton").default;
+    'components/Tooltip': typeof import("../common/components/Tooltip").default;
+    'components/EditUserModal': typeof import("../common/components/EditUserModal").default;
+    Model: typeof import("../common/Model").default;
+    Application: typeof import("../common/Application").default;
+    'helpers/fullTime': typeof import("../common/helpers/fullTime").default;
+    'helpers/avatar': typeof import("../common/helpers/avatar").default;
+    'helpers/icon': typeof import("../common/helpers/icon").default;
+    'helpers/humanTime': typeof import("../common/helpers/humanTime").default;
+    'helpers/punctuateSeries': typeof import("../common/helpers/punctuateSeries").default;
+    'helpers/highlight': typeof import("../common/helpers/highlight").default;
+    'helpers/username': typeof import("../common/helpers/username").default;
+    'helpers/userOnline': typeof import("../common/helpers/userOnline").default;
+    'helpers/listItems': typeof import("../common/helpers/listItems").default;
+    'resolvers/DefaultResolver': typeof import("../common/resolvers/DefaultResolver").default;
+    'states/PaginatedListState': typeof import("../common/states/PaginatedListState").default;
+} & {
+    'utils/saveSettings': typeof saveSettings;
+    'utils/ExtensionData': typeof ExtensionData;
+    'utils/isExtensionEnabled': typeof isExtensionEnabled;
+    'utils/getCategorizedExtensions': typeof getCategorizedExtensions;
+    'components/SettingDropdown': typeof SettingDropdown;
+    'components/EditCustomFooterModal': typeof EditCustomFooterModal;
+    'components/SessionDropdown': typeof SessionDropdown;
+    'components/HeaderPrimary': typeof HeaderPrimary;
+    'components/AdminPage': typeof AdminPage;
+    'components/AppearancePage': typeof AppearancePage;
+    'components/StatusWidget': typeof StatusWidget;
+    'components/ExtensionsWidget': typeof ExtensionsWidget;
+    'components/HeaderSecondary': typeof HeaderSecondary;
+    'components/SettingsModal': typeof SettingsModal;
+    'components/DashboardWidget': typeof DashboardWidget;
+    'components/ExtensionPage': typeof ExtensionPage;
+    'components/ExtensionLinkButton': typeof ExtensionLinkButton;
+    'components/PermissionGrid': typeof PermissionGrid;
+    'components/ExtensionPermissionGrid': typeof ExtensionPermissionGrid;
+    'components/MailPage': typeof MailPage;
+    'components/UploadImageButton': typeof UploadImageButton;
+    'components/LoadingModal': typeof LoadingModal;
+    'components/DashboardPage': typeof DashboardPage;
+    'components/BasicsPage': typeof BasicsPage;
+    'components/UserListPage': typeof UserListPage;
+    'components/EditCustomHeaderModal': typeof EditCustomHeaderModal;
+    'components/PermissionsPage': typeof PermissionsPage;
+    'components/PermissionDropdown': typeof PermissionDropdown;
+    'components/AdminNav': typeof AdminNav;
+    'components/AdminHeader': typeof AdminHeader;
+    'components/EditCustomCssModal': typeof EditCustomCssModal;
+    'components/EditGroupModal': typeof EditGroupModal;
+    routes: typeof routes;
+    AdminApplication: typeof AdminApplication;
+};
+export default _default;
+import saveSettings from "./utils/saveSettings";
+import ExtensionData from "./utils/ExtensionData";
+import isExtensionEnabled from "./utils/isExtensionEnabled";
+import getCategorizedExtensions from "./utils/getCategorizedExtensions";
+import SettingDropdown from "./components/SettingDropdown";
+import EditCustomFooterModal from "./components/EditCustomFooterModal";
+import SessionDropdown from "./components/SessionDropdown";
+import HeaderPrimary from "./components/HeaderPrimary";
+import AdminPage from "./components/AdminPage";
+import AppearancePage from "./components/AppearancePage";
+import StatusWidget from "./components/StatusWidget";
+import ExtensionsWidget from "./components/ExtensionsWidget";
+import HeaderSecondary from "./components/HeaderSecondary";
+import SettingsModal from "./components/SettingsModal";
+import DashboardWidget from "./components/DashboardWidget";
+import ExtensionPage from "./components/ExtensionPage";
+import ExtensionLinkButton from "./components/ExtensionLinkButton";
+import PermissionGrid from "./components/PermissionGrid";
+import ExtensionPermissionGrid from "./components/ExtensionPermissionGrid";
+import MailPage from "./components/MailPage";
+import UploadImageButton from "./components/UploadImageButton";
+import LoadingModal from "./components/LoadingModal";
+import DashboardPage from "./components/DashboardPage";
+import BasicsPage from "./components/BasicsPage";
+import UserListPage from "./components/UserListPage";
+import EditCustomHeaderModal from "./components/EditCustomHeaderModal";
+import PermissionsPage from "./components/PermissionsPage";
+import PermissionDropdown from "./components/PermissionDropdown";
+import AdminNav from "./components/AdminNav";
+import AdminHeader from "./components/AdminHeader";
+import EditCustomCssModal from "./components/EditCustomCssModal";
+import EditGroupModal from "./components/EditGroupModal";
+import routes from "./routes";
+import AdminApplication from "./AdminApplication";

js/dist-typings/admin/components/AdminHeader.d.ts

@@ -0,0 +1,4 @@
+export default class AdminHeader extends Component<import("../../common/Component").ComponentAttrs> {
+    constructor();
+}
+import Component from "../../common/Component";

js/dist-typings/admin/components/AdminNav.d.ts

@@ -0,0 +1,15 @@
+export default class AdminNav extends Component<import("../../common/Component").ComponentAttrs> {
+    constructor();
+    query: Stream<string> | undefined;
+    scrollToActive(): void;
+    /**
+     * Build an item list of main links to show in the admin navigation.
+     *
+     * @return {ItemList}
+     */
+    items(): ItemList;
+    extensionItems(): ItemList;
+}
+import Component from "../../common/Component";
+import Stream from "../../common/utils/Stream";
+import ItemList from "../../common/utils/ItemList";

js/dist-typings/admin/components/AdminPage.d.ts

@@ -0,0 +1,55 @@
+export default class AdminPage extends Page {
+    settings: {} | undefined;
+    loading: boolean | undefined;
+    content(): string;
+    submitButton(): JSX.Element;
+    header(): JSX.Element;
+    headerInfo(): {
+        className: string;
+        icon: string;
+        title: string;
+        description: string;
+    };
+    /**
+     * buildSettingComponent takes a settings object and turns it into a component.
+     * Depending on the type of input, you can set the type to 'bool', 'select', or
+     * any standard <input> type. Any values inside the 'extra' object will be added
+     * to the component as an attribute.
+     *
+     * Alternatively, you can pass a callback that will be executed in ExtensionPage's
+     * context to include custom JSX elements.
+     *
+     * @example
+     *
+     * {
+     *    setting: 'acme.checkbox',
+     *    label: app.translator.trans('acme.admin.setting_label'),
+     *    type: 'bool',
+     *    help: app.translator.trans('acme.admin.setting_help'),
+     *    className: 'Setting-item'
+     * }
+     *
+     * @example
+     *
+     * {
+     *    setting: 'acme.select',
+     *    label: app.translator.trans('acme.admin.setting_label'),
+     *    type: 'select',
+     *    options: {
+     *      'option1': 'Option 1 label',
+     *      'option2': 'Option 2 label',
+     *    },
+     *    default: 'option1',
+     * }
+     *
+     * @param setting
+     * @returns {JSX.Element}
+     */
+    buildSettingComponent(entry: any): JSX.Element;
+    onsaved(): void;
+    setting(key: any, fallback?: string): any;
+    dirty(): {};
+    isChanged(): number;
+    saveSettings(e: any): Promise<void>;
+}
+import Page from "../../common/components/Page";

js/dist-typings/admin/components/AppearancePage.d.ts

@@ -0,0 +1,3 @@
+export default class AppearancePage extends AdminPage {
+}
+import AdminPage from "./AdminPage";

js/dist-typings/admin/components/BasicsPage.d.ts

@@ -0,0 +1,15 @@
+export default class BasicsPage extends AdminPage {
+    localeOptions: {} | undefined;
+    displayNameOptions: {} | undefined;
+    slugDriverOptions: {} | undefined;
+    /**
+     * Build a list of options for the default homepage. Each option must be an
+     * object with `path` and `label` properties.
+     *
+     * @return {ItemList}
+     * @public
+     */
+    public homePageItems(): ItemList;
+}
+import AdminPage from "./AdminPage";
+import ItemList from "../../common/utils/ItemList";

js/dist-typings/admin/components/DashboardPage.d.ts

@@ -0,0 +1,5 @@
+export default class DashboardPage extends AdminPage {
+    availableWidgets(): ItemList;
+}
+import AdminPage from "./AdminPage";
+import ItemList from "../../common/utils/ItemList";

js/dist-typings/admin/components/DashboardWidget.d.ts

@@ -0,0 +1,16 @@
+export default class DashboardWidget extends Component<import("../../common/Component").ComponentAttrs> {
+    constructor();
+    /**
+     * Get the class name to apply to the widget.
+     *
+     * @return {String}
+     */
+    className(): string;
+    /**
+     * Get the content of the widget.
+     *
+     * @return {VirtualElement}
+     */
+    content(): any;
+}
+import Component from "../../common/Component";

js/dist-typings/admin/components/EditCustomCssModal.d.ts

@@ -0,0 +1,3 @@
+export default class EditCustomCssModal extends SettingsModal {
+}
+import SettingsModal from "./SettingsModal";

js/dist-typings/admin/components/EditCustomFooterModal.d.ts

@@ -0,0 +1,3 @@
+export default class EditCustomFooterModal extends SettingsModal {
+}
+import SettingsModal from "./SettingsModal";

js/dist-typings/admin/components/EditCustomHeaderModal.d.ts

@@ -0,0 +1,3 @@
+export default class EditCustomHeaderModal extends SettingsModal {
+}
+import SettingsModal from "./SettingsModal";

js/dist-typings/admin/components/EditGroupModal.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The `EditGroupModal` component shows a modal dialog which allows the user
+ * to create or edit a group.
+ */
+export default class EditGroupModal extends Modal {
+    group: any;
+    nameSingular: Stream<any> | undefined;
+    namePlural: Stream<any> | undefined;
+    icon: Stream<any> | undefined;
+    color: Stream<any> | undefined;
+    isHidden: Stream<any> | undefined;
+    fields(): ItemList;
+    submitData(): {
+        nameSingular: any;
+        namePlural: any;
+        color: any;
+        icon: any;
+        isHidden: any;
+    };
+    deleteGroup(): void;
+}
+import Modal from "../../common/components/Modal";
+import Stream from "../../common/utils/Stream";
+import ItemList from "../../common/utils/ItemList";

js/dist-typings/admin/components/ExtensionLinkButton.d.ts

@@ -0,0 +1,5 @@
+export default class ExtensionLinkButton extends LinkButton {
+    statusItems(name: any): ItemList;
+}
+import LinkButton from "../../common/components/LinkButton";
+import ItemList from "../../common/utils/ItemList";

js/dist-typings/admin/components/ExtensionPage.d.ts

@@ -0,0 +1,21 @@
+export default class ExtensionPage extends AdminPage {
+    extension: any;
+    changingState: boolean | undefined;
+    infoFields: {
+        discuss: string;
+        documentation: string;
+        support: string;
+        website: string;
+        donate: string;
+        source: string;
+    } | undefined;
+    className(): string;
+    sections(): ItemList;
+    topItems(): ItemList;
+    infoItems(): ItemList;
+    toggle(): void;
+    isEnabled(): any;
+    onerror(e: any): void;
+}
+import AdminPage from "./AdminPage";
+import ItemList from "../../common/utils/ItemList";

js/dist-typings/admin/components/ExtensionPermissionGrid.d.ts

@@ -0,0 +1,4 @@
+export default class ExtensionPermissionGrid extends PermissionGrid {
+    extensionId: any;
+}
+import PermissionGrid from "./PermissionGrid";

js/dist-typings/admin/components/ExtensionsWidget.d.ts

@@ -0,0 +1,6 @@
+export default class ExtensionsWidget extends DashboardWidget {
+    categorizedExtensions: {} | undefined;
+    extensionCategory(category: any): JSX.Element;
+    extensionWidget(extension: any): JSX.Element;
+}
+import DashboardWidget from "./DashboardWidget";

js/dist-typings/admin/components/HeaderPrimary.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The `HeaderPrimary` component displays primary header controls. On the
+ * default skin, these are shown just to the right of the forum title.
+ */
+export default class HeaderPrimary extends Component<import("../../common/Component").ComponentAttrs> {
+    constructor();
+    config(isInitialized: any, context: any): void;
+    /**
+     * Build an item list for the controls.
+     *
+     * @return {ItemList}
+     */
+    items(): ItemList;
+}
+import Component from "../../common/Component";
+import ItemList from "../../common/utils/ItemList";

js/dist-typings/admin/components/HeaderSecondary.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The `HeaderSecondary` component displays secondary header controls.
+ */
+export default class HeaderSecondary extends Component<import("../../common/Component").ComponentAttrs> {
+    constructor();
+    /**
+     * Build an item list for the controls.
+     *
+     * @return {ItemList}
+     */
+    items(): ItemList;
+}
+import Component from "../../common/Component";
+import ItemList from "../../common/utils/ItemList";

js/dist-typings/admin/components/LoadingModal.d.ts

@@ -0,0 +1,3 @@
+export default class LoadingModal extends Modal {
+}
+import Modal from "../../common/components/Modal";

js/dist-typings/admin/components/MailPage.d.ts

@@ -0,0 +1,12 @@
+export default class MailPage extends AdminPage {
+    sendingTest: boolean | undefined;
+    refresh(): void;
+    status: {
+        sending: boolean;
+        errors: {};
+    } | undefined;
+    driverFields: any;
+    sendTestEmail(): void;
+    testEmailSuccessAlert: number | undefined;
+}
+import AdminPage from "./AdminPage";

js/dist-typings/admin/components/PermissionDropdown.d.ts

@@ -0,0 +1,6 @@
+export default class PermissionDropdown extends Dropdown {
+    save(groupIds: any): void;
+    toggle(groupId: any): void;
+    isGroupDisabled(id: any): boolean;
+}
+import Dropdown from "../../common/components/Dropdown";

js/dist-typings/admin/components/PermissionGrid.d.ts

@@ -0,0 +1,12 @@
+export default class PermissionGrid extends Component<import("../../common/Component").ComponentAttrs> {
+    constructor();
+    permissionItems(): ItemList;
+    viewItems(): ItemList;
+    startItems(): ItemList;
+    replyItems(): ItemList;
+    moderateItems(): ItemList;
+    scopeItems(): ItemList;
+    scopeControlItems(): ItemList;
+}
+import Component from "../../common/Component";
+import ItemList from "../../common/utils/ItemList";

js/dist-typings/admin/components/PermissionsPage.d.ts

@@ -0,0 +1,3 @@
+export default class PermissionsPage extends AdminPage {
+}
+import AdminPage from "./AdminPage";

js/dist-typings/admin/components/SessionDropdown.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The `SessionDropdown` component shows a button with the current user's
+ * avatar/name, with a dropdown of session controls.
+ */
+export default class SessionDropdown extends Dropdown {
+    /**
+     * Build an item list for the contents of the dropdown menu.
+     *
+     * @return {ItemList}
+     */
+    items(): ItemList;
+}
+import Dropdown from "../../common/components/Dropdown";
+import ItemList from "../../common/utils/ItemList";

js/dist-typings/admin/components/SettingDropdown.d.ts

@@ -0,0 +1,3 @@
+export default class SettingDropdown extends SelectDropdown {
+}
+import SelectDropdown from "../../common/components/SelectDropdown";

js/dist-typings/admin/components/SettingsModal.d.ts

@@ -0,0 +1,10 @@
+export default class SettingsModal extends Modal {
+    settings: {} | undefined;
+    form(): string;
+    submitButton(): JSX.Element;
+    setting(key: any, fallback?: string): any;
+    dirty(): {};
+    changed(): number;
+    onsaved(): void;
+}
+import Modal from "../../common/components/Modal";

js/dist-typings/admin/components/StatusWidget.d.ts

@@ -0,0 +1,6 @@
+export default class StatusWidget extends DashboardWidget {
+    items(): ItemList;
+    handleClearCache(e: any): void;
+}
+import DashboardWidget from "./DashboardWidget";
+import ItemList from "../../common/utils/ItemList";

js/dist-typings/admin/components/UploadImageButton.d.ts

@@ -0,0 +1,27 @@
+export default class UploadImageButton extends Button {
+    loading: boolean;
+    /**
+     * Prompt the user to upload an image.
+     */
+    upload(): void;
+    /**
+     * Remove the logo.
+     */
+    remove(): void;
+    resourceUrl(): string;
+    /**
+     * After a successful upload/removal, reload the page.
+     *
+     * @param {Object} response
+     * @protected
+     */
+    protected success(response: Object): void;
+    /**
+     * If upload/removal fails, stop loading.
+     *
+     * @param {Object} response
+     * @protected
+     */
+    protected failure(response: Object): void;
+}
+import Button from "../../common/components/Button";

js/dist-typings/admin/components/UserListPage.d.ts

@@ -0,0 +1,72 @@
+/// <reference types="mithril" />
+import ItemList from '../../common/utils/ItemList';
+import AdminPage from './AdminPage';
+/**
+ * Admin page which displays a paginated list of all users on the forum.
+ */
+export default class UserListPage extends AdminPage {
+    /**
+     * Number of users to load per page.
+     */
+    private numPerPage;
+    /**
+     * Current page number. Zero-indexed.
+     */
+    private pageNumber;
+    /**
+     * Total number of forum users.
+     *
+     * Fetched from the active `AdminApplication` (`app`), with
+     * data provided by `AdminPayload.php`, or `flarum/statistics`
+     * if installed.
+     */
+    readonly userCount: number;
+    /**
+     * Get total number of user pages.
+     */
+    private getTotalPageCount;
+    /**
+     * This page's array of users.
+     *
+     * `undefined` when page loads as no data has been fetched.
+     */
+    private pageData;
+    /**
+     * Are there more users available?
+     */
+    private moreData;
+    private isLoadingPage;
+    /**
+     * Component to render.
+     */
+    content(): JSX.Element[];
+    /**
+     * Build an item list of columns to show for each user.
+     *
+     * Each column in the list should be an object with keys `name` and `content`.
+     *
+     * `name` is a string that will be used as the column name.
+     * `content` is a function with the User model passed as the first and only argument.
+     *
+     * See `UserListPage.tsx` for examples.
+     */
+    columns(): ItemList;
+    headerInfo(): {
+        className: string;
+        icon: string;
+        title: any;
+        description: any;
+    };
+    /**
+     * Asynchronously fetch the next set of users to be rendered.
+     *
+     * Returns an array of Users, plus the raw API payload.
+     *
+     * Uses the `this.numPerPage` as the response limit, and automatically calculates the offset required from `pageNumber`.
+     *
+     * @param pageNumber The page number to load and display
+     */
+    loadPage(pageNumber: number): Promise<void>;
+    nextPage(): void;
+    previousPage(): void;
+}

js/dist-typings/admin/index.d.ts

@@ -0,0 +1,5 @@
+import app from './app';
+export { app };
+export declare const compat: {
+    [key: string]: any;
+};

js/dist-typings/admin/resolvers/ExtensionPageResolver.d.ts

@@ -0,0 +1,9 @@
+import DefaultResolver from '../../common/resolvers/DefaultResolver';
+/**
+ * A custom route resolver for ExtensionPage that generates handles routes
+ * to default extension pages or a page provided by an extension.
+ */
+export default class ExtensionPageResolver extends DefaultResolver {
+    static extension: string | null;
+    onmatch(args: any, requestedPath: any, route: any): any;
+}

js/dist-typings/admin/routes.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The `routes` initializer defines the forum app's routes.
+ *
+ * @param {App} app
+ */
+export default function _default(app: any): void;

js/dist-typings/admin/utils/ExtensionData.d.ts

@@ -0,0 +1,98 @@
+export default class ExtensionData {
+    data: {};
+    currentExtension: any;
+    /**
+     * This function simply takes the extension id
+     *
+     * @example
+     * app.extensionData.load('flarum-tags')
+     *
+     * flarum/flags -> flarum-flags | acme/extension -> acme-extension
+     *
+     * @param extension
+     */
+    for(extension: any): ExtensionData;
+    /**
+     * This function registers your settings with Flarum
+     *
+     * It takes either a settings object or a callback.
+     *
+     * @example
+     *
+     * .registerSetting({
+     *   setting: 'flarum-flags.guidelines_url',
+     *   type: 'text', // This will be inputted into the input tag for the setting (text/number/etc)
+     *   label: app.translator.trans('flarum-flags.admin.settings.guidelines_url_label')
+     * }, 15) // priority is optional (ItemList)
+     *
+     *
+     * @param content
+     * @param priority
+     * @returns {ExtensionData}
+     */
+    registerSetting(content: any, priority?: number): ExtensionData;
+    /**
+     * This function registers your permission with Flarum
+     *
+     * @example
+     *
+     * .registerPermission('permissions', {
+     *     icon: 'fas fa-flag',
+     *     label: app.translator.trans('flarum-flags.admin.permissions.view_flags_label'),
+     *     permission: 'discussion.viewFlags'
+     * }, 'moderate', 65)
+     *
+     * @param content
+     * @param permissionType
+     * @param priority
+     * @returns {ExtensionData}
+     */
+    registerPermission(content: any, permissionType?: any, priority?: number): ExtensionData;
+    /**
+     * Replace the default extension page with a custom component.
+     * This component would typically extend ExtensionPage
+     *
+     * @param component
+     * @returns {ExtensionData}
+     */
+    registerPage(component: any): ExtensionData;
+    /**
+     * Get an extension's registered settings
+     *
+     * @param extensionId
+     * @returns {boolean|*}
+     */
+    getSettings(extensionId: any): boolean | any;
+    /**
+     *
+     * Get an ItemList of all extensions' registered permissions
+     *
+     * @param extension
+     * @param type
+     * @returns {ItemList}
+     */
+    getAllExtensionPermissions(type: any): ItemList;
+    /**
+     * Get a singular extension's registered permissions
+     *
+     * @param extension
+     * @param type
+     * @returns {boolean|*}
+     */
+    getExtensionPermissions(extension: any, type: any): boolean | any;
+    /**
+     * Checks whether a given extension has registered permissions.
+     *
+     * @param extension
+     * @returns {boolean}
+     */
+    extensionHasPermissions(extension: any): boolean;
+    /**
+     * Returns an extension's custom page component if it exists.
+     *
+     * @param extension
+     * @returns {boolean|*}
+     */
+    getPage(extension: any): boolean | any;
+}
+import ItemList from "../../common/utils/ItemList";

js/dist-typings/admin/utils/getCategorizedExtensions.d.ts

@@ -0,0 +1 @@
+export default function getCategorizedExtensions(): {};

js/dist-typings/admin/utils/isExtensionEnabled.d.ts

@@ -0,0 +1 @@
+export default function isExtensionEnabled(name: any): any;

js/dist-typings/admin/utils/saveSettings.d.ts

@@ -0,0 +1 @@
+export default function saveSettings(settings: any): Promise<any>;

js/dist-typings/common/Application.d.ts

@@ -0,0 +1,174 @@
+/**
+ * The `App` class provides a container for an application, as well as various
+ * utilities for the rest of the app to use.
+ */
+export default class Application {
+    /**
+     * The forum model for this application.
+     *
+     * @type {Forum}
+     * @public
+     */
+    public forum: Forum;
+    /**
+     * A map of routes, keyed by a unique route name. Each route is an object
+     * containing the following properties:
+     *
+     * - `path` The path that the route is accessed at.
+     * - `component` The Mithril component to render when this route is active.
+     *
+     * @example
+     * app.routes.discussion = {path: '/d/:id', component: DiscussionPage.component()};
+     *
+     * @type {Object}
+     * @public
+     */
+    public routes: Object;
+    /**
+     * An ordered list of initializers to bootstrap the application.
+     *
+     * @type {ItemList}
+     * @public
+     */
+    public initializers: ItemList;
+    /**
+     * The app's session.
+     *
+     * @type {Session}
+     * @public
+     */
+    public session: Session;
+    /**
+     * The app's translator.
+     *
+     * @type {Translator}
+     * @public
+     */
+    public translator: Translator;
+    /**
+     * The app's data store.
+     *
+     * @type {Store}
+     * @public
+     */
+    public store: Store;
+    /**
+     * A local cache that can be used to store data at the application level, so
+     * that is persists between different routes.
+     *
+     * @type {Object}
+     * @public
+     */
+    public cache: Object;
+    /**
+     * Whether or not the app has been booted.
+     *
+     * @type {Boolean}
+     * @public
+     */
+    public booted: boolean;
+    /**
+     * The key for an Alert that was shown as a result of an AJAX request error.
+     * If present, it will be dismissed on the next successful request.
+     *
+     * @type {int}
+     * @private
+     */
+    private requestErrorAlert;
+    /**
+     * The page the app is currently on.
+     *
+     * This object holds information about the type of page we are currently
+     * visiting, and sometimes additional arbitrary page state that may be
+     * relevant to lower-level components.
+     *
+     * @type {PageState}
+     */
+    current: PageState;
+    /**
+     * The page the app was on before the current page.
+     *
+     * Once the application navigates to another page, the object previously
+     * assigned to this.current will be moved to this.previous, while this.current
+     * is re-initialized.
+     *
+     * @type {PageState}
+     */
+    previous: PageState;
+    modal: ModalManagerState;
+    /**
+     * An object that manages the state of active alerts.
+     *
+     * @type {AlertManagerState}
+     */
+    alerts: AlertManagerState;
+    data: any;
+    title: string;
+    titleCount: number;
+    initialRoute: any;
+    load(payload: any): void;
+    boot(): void;
+    bootExtensions(extensions: any): void;
+    mount(basePath?: string): void;
+    drawer: Drawer | undefined;
+    /**
+     * Get the API response document that has been preloaded into the application.
+     *
+     * @return {Object|null}
+     * @public
+     */
+    public preloadedApiDocument(): Object | null;
+    /**
+     * Determine the current screen mode, based on our media queries.
+     *
+     * @returns {String} - one of "phone", "tablet", "desktop" or "desktop-hd"
+     */
+    screen(): string;
+    /**
+     * Set the <title> of the page.
+     *
+     * @param {String} title
+     * @public
+     */
+    public setTitle(title: string): void;
+    /**
+     * Set a number to display in the <title> of the page.
+     *
+     * @param {Integer} count
+     */
+    setTitleCount(count: any): void;
+    updateTitle(): void;
+    /**
+     * Make an AJAX request, handling any low-level errors that may occur.
+     *
+     * @see https://mithril.js.org/request.html
+     * @param {Object} options
+     * @return {Promise}
+     * @public
+     */
+    public request(originalOptions: any): Promise<any>;
+    /**
+     * @param {RequestError} error
+     * @param {string[]} [formattedError]
+     * @private
+     */
+    private showDebug;
+    /**
+     * Construct a URL to the route with the given name.
+     *
+     * @param {String} name
+     * @param {Object} params
+     * @return {String}
+     * @public
+     */
+    public route(name: string, params?: Object): string;
+}
+import Forum from "./models/Forum";
+import ItemList from "./utils/ItemList";
+import Session from "./Session";
+import Translator from "./Translator";
+import Store from "./Store";
+import PageState from "./states/PageState";
+import ModalManagerState from "./states/ModalManagerState";
+import AlertManagerState from "./states/AlertManagerState";
+import Drawer from "./utils/Drawer";

js/dist-typings/common/Component.d.ts

@@ -0,0 +1,102 @@
+import * as Mithril from 'mithril';
+export interface ComponentAttrs extends Mithril.Attributes {
+}
+/**
+ * The `Component` class defines a user interface 'building block'. A component
+ * generates a virtual DOM to be rendered on each redraw.
+ *
+ * Essentially, this is a wrapper for Mithril's components that adds several useful features:
+ *
+ *  - In the `oninit` and `onbeforeupdate` lifecycle hooks, we store vnode attrs in `this.attrs.
+ *    This allows us to use attrs across components without having to pass the vnode to every single
+ *    method.
+ *  - The static `initAttrs` method allows a convenient way to provide defaults (or to otherwise modify)
+ *    the attrs that have been passed into a component.
+ *  - When the component is created in the DOM, we store its DOM element under `this.element`; this lets
+ *    us use jQuery to modify child DOM state from internal methods via the `this.$()` method.
+ *  - A convenience `component` method, which serves as an alternative to hyperscript and JSX.
+ *
+ * As with other Mithril components, components extending Component can be initialized
+ * and nested using JSX, hyperscript, or a combination of both. The `component` method can also
+ * be used.
+ *
+ * @example
+ * return m('div', <MyComponent foo="bar"><p>Hello World</p></MyComponent>);
+ *
+ * @example
+ * return m('div', MyComponent.component({foo: 'bar'), m('p', 'Hello World!'));
+ *
+ * @see https://mithril.js.org/components.html
+ */
+export default abstract class Component<T extends ComponentAttrs = ComponentAttrs> implements Mithril.ClassComponent<T> {
+    /**
+     * The root DOM element for the component.
+     */
+    protected element: Element;
+    /**
+     * The attributes passed into the component.
+     *
+     * @see https://mithril.js.org/components.html#passing-data-to-components
+     */
+    protected attrs: T;
+    /**
+     * @inheritdoc
+     */
+    abstract view(vnode: Mithril.Vnode<T, this>): Mithril.Children;
+    /**
+     * @inheritdoc
+     */
+    oninit(vnode: Mithril.Vnode<T, this>): void;
+    /**
+     * @inheritdoc
+     */
+    oncreate(vnode: Mithril.VnodeDOM<T, this>): void;
+    /**
+     * @inheritdoc
+     */
+    onbeforeupdate(vnode: Mithril.VnodeDOM<T, this>): void;
+    /**
+     * @inheritdoc
+     */
+    onupdate(vnode: Mithril.VnodeDOM<T, this>): void;
+    /**
+     * @inheritdoc
+     */
+    onbeforeremove(vnode: Mithril.VnodeDOM<T, this>): void;
+    /**
+     * @inheritdoc
+     */
+    onremove(vnode: Mithril.VnodeDOM<T, this>): void;
+    /**
+     * Returns a jQuery object for this component's element. If you pass in a
+     * selector string, this method will return a jQuery object, using the current
+     * element as its buffer.
+     *
+     * For example, calling `component.$('li')` will return a jQuery object
+     * containing all of the `li` elements inside the DOM element of this
+     * component.
+     *
+     * @param [selector] a jQuery-compatible selector string
+     * @returns the jQuery object for the DOM node
+     * @final
+     */
+    protected $(selector?: string): JQuery;
+    /**
+     * Convenience method to attach a component without JSX.
+     * Has the same effect as calling `m(THIS_CLASS, attrs, children)`.
+     *
+     * @see https://mithril.js.org/hyperscript.html#mselector,-attributes,-children
+     */
+    static component(attrs?: {}, children?: null): Mithril.Vnode;
+    /**
+     * Saves a reference to the vnode attrs after running them through initAttrs,
+     * and checking for common issues.
+     */
+    private setAttrs;
+    /**
+     * Initialize the component's attrs.
+     *
+     * This can be used to assign default values for missing, optional attrs.
+     */
+    protected static initAttrs<T>(attrs: T): void;
+}

js/dist-typings/common/Fragment.d.ts

@@ -0,0 +1,53 @@
+import * as Mithril from 'mithril';
+/**
+ * The `Fragment` class represents a chunk of DOM that is rendered once with Mithril and then takes
+ * over control of its own DOM and lifecycle.
+ *
+ * This is very similar to the `Component` wrapper class, but is used for more fine-grained control over
+ * the rendering and display of some significant chunks of the DOM. In contrast to components, fragments
+ * do not offer Mithril's lifecycle hooks.
+ *
+ * Use this when you want to enjoy the benefits of JSX / VDOM for initial rendering, combined with
+ * small helper methods that then make updates to that DOM directly, instead of fully redrawing
+ * everything through Mithril.
+ *
+ * This should only be used when necessary, and only with `m.render`. If you are unsure whether you need
+ * this or `Component, you probably need `Component`.
+ */
+export default abstract class Fragment {
+    /**
+     * The root DOM element for the fragment.
+     */
+    protected element: Element;
+    /**
+     * Returns a jQuery object for this fragment's element. If you pass in a
+     * selector string, this method will return a jQuery object, using the current
+     * element as its buffer.
+     *
+     * For example, calling `fragment.$('li')` will return a jQuery object
+     * containing all of the `li` elements inside the DOM element of this
+     * fragment.
+     *
+     * @param {String} [selector] a jQuery-compatible selector string
+     * @returns {jQuery} the jQuery object for the DOM node
+     * @final
+     */
+    $(selector: any): JQuery<any>;
+    /**
+     * Get the renderable virtual DOM that represents the fragment's view.
+     *
+     * This should NOT be overridden by subclasses. Subclasses wishing to define
+     * their virtual DOM should override Fragment#view instead.
+     *
+     * @example
+     * const fragment = new MyFragment();
+     * m.render(document.body, fragment.render());
+     *
+     * @final
+     */
+    render(): Mithril.Vnode<Mithril.Attributes, this>;
+    /**
+     * Creates a view out of virtual elements.
+     */
+    abstract view(): Mithril.Vnode<Mithril.Attributes, this>;
+}

js/dist-typings/common/Model.d.ts

@@ -0,0 +1,149 @@
+/**
+ * The `Model` class represents a local data resource. It provides methods to
+ * persist changes via the API.
+ *
+ * @abstract
+ */
+export default class Model {
+    /**
+     * Generate a function which returns the value of the given attribute.
+     *
+     * @param {String} name
+     * @param {function} [transform] A function to transform the attribute value
+     * @return {*}
+     * @public
+     */
+    public static attribute(name: string, transform?: Function | undefined): any;
+    /**
+     * Generate a function which returns the value of the given has-one
+     * relationship.
+     *
+     * @param {String} name
+     * @return {Model|Boolean|undefined} false if no information about the
+     *     relationship exists; undefined if the relationship exists but the model
+     *     has not been loaded; or the model if it has been loaded.
+     * @public
+     */
+    public static hasOne(name: string): Model | boolean | undefined;
+    /**
+     * Generate a function which returns the value of the given has-many
+     * relationship.
+     *
+     * @param {String} name
+     * @return {Array|Boolean} false if no information about the relationship
+     *     exists; an array if it does, containing models if they have been
+     *     loaded, and undefined for those that have not.
+     * @public
+     */
+    public static hasMany(name: string): any[] | boolean;
+    /**
+     * Transform the given value into a Date object.
+     *
+     * @param {String} value
+     * @return {Date|null}
+     * @public
+     */
+    public static transformDate(value: string): Date | null;
+    /**
+     * Get a resource identifier object for the given model.
+     *
+     * @param {Model} model
+     * @return {Object}
+     * @protected
+     */
+    protected static getIdentifier(model: Model): Object;
+    /**
+     * @param {Object} data A resource object from the API.
+     * @param {Store} store The data store that this model should be persisted to.
+     * @public
+     */
+    constructor(data?: Object, store?: any);
+    /**
+     * The resource object from the API.
+     *
+     * @type {Object}
+     * @public
+     */
+    public data: Object;
+    /**
+     * The time at which the model's data was last updated. Watching the value
+     * of this property is a fast way to retain/cache a subtree if data hasn't
+     * changed.
+     *
+     * @type {Date}
+     * @public
+     */
+    public freshness: Date;
+    /**
+     * Whether or not the resource exists on the server.
+     *
+     * @type {Boolean}
+     * @public
+     */
+    public exists: boolean;
+    /**
+     * The data store that this resource should be persisted to.
+     *
+     * @type {Store}
+     * @protected
+     */
+    protected store: any;
+    /**
+     * Get the model's ID.
+     *
+     * @return {Integer}
+     * @public
+     * @final
+     */
+    public id(): any;
+    /**
+     * Get one of the model's attributes.
+     *
+     * @param {String} attribute
+     * @return {*}
+     * @public
+     * @final
+     */
+    public attribute(attribute: string): any;
+    /**
+     * Merge new data into this model locally.
+     *
+     * @param {Object} data A resource object to merge into this model
+     * @public
+     */
+    public pushData(data: Object): void;
+    /**
+     * Merge new attributes into this model locally.
+     *
+     * @param {Object} attributes The attributes to merge.
+     * @public
+     */
+    public pushAttributes(attributes: Object): void;
+    /**
+     * Merge new attributes into this model, both locally and with persistence.
+     *
+     * @param {Object} attributes The attributes to save. If a 'relationships' key
+     *     exists, it will be extracted and relationships will also be saved.
+     * @param {Object} [options]
+     * @return {Promise}
+     * @public
+     */
+    public save(attributes: Object, options?: Object | undefined): Promise<any>;
+    /**
+     * Send a request to delete the resource.
+     *
+     * @param {Object} body Data to send along with the DELETE request.
+     * @param {Object} [options]
+     * @return {Promise}
+     * @public
+     */
+    public delete(body: Object, options?: Object | undefined): Promise<any>;
+    /**
+     * Construct a path to the API endpoint for this resource.
+     *
+     * @return {String}
+     * @protected
+     */
+    protected apiEndpoint(): string;
+    copyData(): any;
+}

js/dist-typings/common/Session.d.ts

@@ -0,0 +1,37 @@
+/**
+ * The `Session` class defines the current user session. It stores a reference
+ * to the current authenticated user, and provides methods to log in/out.
+ */
+export default class Session {
+    constructor(user: any, csrfToken: any);
+    /**
+     * The current authenticated user.
+     *
+     * @type {User|null}
+     * @public
+     */
+    public user: any | null;
+    /**
+     * The CSRF token.
+     *
+     * @type {String|null}
+     * @public
+     */
+    public csrfToken: string | null;
+    /**
+     * Attempt to log in a user.
+     *
+     * @param {String} identification The username/email.
+     * @param {String} password
+     * @param {Object} [options]
+     * @return {Promise}
+     * @public
+     */
+    public login(body: any, options?: Object | undefined): Promise<any>;
+    /**
+     * Log the user out.
+     *
+     * @public
+     */
+    public logout(): void;
+}