Compare commits
79
Commits
e08b4ec22e
...
9b3956d85f
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
9b3956d85f | ||
|
|
f81461c044 | ||
|
|
96d0d27549 | ||
|
|
33ae13e514 | ||
|
|
17d1eef572 | ||
|
|
3db9b499af | ||
|
|
fea879497c | ||
|
|
b85a2b9290 | ||
|
|
9d17b14a9e | ||
|
|
6c8a085ae1 | ||
|
|
b36335cde9 | ||
|
|
8d6aaa619f | ||
|
|
1e3d630b1a | ||
|
|
45f38f2ac8 | ||
|
|
48db806dd7 | ||
|
|
634d1e0a0f | ||
|
|
027dbee1f1 | ||
|
|
3781b05f6f | ||
|
|
eaa9ac00dd | ||
|
|
664b7eb739 | ||
|
|
5477242661 | ||
|
|
593dd3bdf3 | ||
|
|
9bc8679fb7 | ||
|
|
6805762834 | ||
|
|
2db4fe4734 | ||
|
|
73554ecf7f | ||
|
|
bb85cd9778 | ||
|
|
29aaba56f0 | ||
|
|
24cde1447d | ||
|
|
8a53006ead | ||
|
|
230ca4fcf0 | ||
|
|
9591d8d01b | ||
|
|
831ce01150 | ||
|
|
2d3bebdc23 | ||
|
|
c46d4d367e | ||
|
|
d6fe94ff48 | ||
|
|
0f60822cec | ||
|
|
b158648fc4 | ||
|
|
205860c168 | ||
|
|
3be37c5d09 | ||
|
|
a6ad8651b3 | ||
|
|
3cd159a63e | ||
|
|
0688075542 | ||
|
|
7edf179ec9 | ||
|
|
c0aa7fa8f5 | ||
|
|
a77f72f5d6 | ||
|
|
7689433376 | ||
|
|
6e6d4322c5 | ||
|
|
bb27305b70 | ||
|
|
fcbd9b4b66 | ||
|
|
14f31f57c1 | ||
|
|
b294bb0c06 | ||
|
|
a6fac786b3 | ||
|
|
a4e96dd01f | ||
|
|
f0495cccca | ||
|
|
76e5f960d1 | ||
|
|
bd649d4e16 | ||
|
|
2639982d5b | ||
|
|
95d1cb9630 | ||
|
|
fabbbc40af | ||
|
|
72c71bc789 | ||
|
|
9b657e3ab4 | ||
|
|
f2caef5592 | ||
|
|
47979718eb | ||
|
|
862307ee7d | ||
|
|
b16263b481 | ||
|
|
c34cfaf33f | ||
|
|
87c9f59826 | ||
|
|
d59945eb4c | ||
|
|
0cbc5d9a1c | ||
|
|
6cb1e14632 | ||
|
|
7d866404b3 | ||
|
|
c264de53b5 | ||
|
|
b6f3f5c0aa | ||
|
|
25be638c5e | ||
|
|
a20c871726 | ||
|
|
e65a516350 | ||
|
|
9887903f49 | ||
|
|
898d217451 |
@@ -1,72 +0,0 @@
|
||||
module.exports = {
|
||||
env: {
|
||||
browser: true,
|
||||
es2021: true,
|
||||
},
|
||||
extends: [
|
||||
"eslint:recommended",
|
||||
"plugin:react/recommended",
|
||||
"plugin:react-hooks/recommended",
|
||||
"plugin:@typescript-eslint/eslint-recommended",
|
||||
"plugin:@typescript-eslint/recommended",
|
||||
'airbnb',
|
||||
'prettier',
|
||||
],
|
||||
parser: "@typescript-eslint/parser",
|
||||
parserOptions: {
|
||||
ecmaFeatures: {
|
||||
jsx: true,
|
||||
},
|
||||
ecmaVersion: 'latest',
|
||||
sourceType: 'module',
|
||||
},
|
||||
"globals": {
|
||||
JSX: "readonly"
|
||||
},
|
||||
plugins: [
|
||||
'react',
|
||||
'@typescript-eslint'
|
||||
],
|
||||
rules: {
|
||||
'linebreak-style': 0,
|
||||
'no-underscore-dangle': 0,
|
||||
"no-shadow": "off",
|
||||
|
||||
"import/prefer-default-export": "off",
|
||||
"import/extensions": "off",
|
||||
"import/no-unresolved": "off",
|
||||
"import/no-extraneous-dependencies": [
|
||||
"error",
|
||||
{
|
||||
devDependencies: true,
|
||||
},
|
||||
],
|
||||
|
||||
'react/no-unstable-nested-components': [
|
||||
'error',
|
||||
{ allowAsProps: true },
|
||||
],
|
||||
"react/jsx-filename-extension": [
|
||||
"error",
|
||||
{
|
||||
extensions: [".tsx", ".jsx"],
|
||||
},
|
||||
],
|
||||
|
||||
"react/require-default-props": "off",
|
||||
"react/jsx-props-no-spreading": "off",
|
||||
"react-hooks/rules-of-hooks": "error",
|
||||
"react-hooks/exhaustive-deps": "error",
|
||||
|
||||
"@typescript-eslint/no-unused-vars": "error",
|
||||
"@typescript-eslint/no-shadow": "error"
|
||||
},
|
||||
overrides: [
|
||||
{
|
||||
files: ['*.ts'],
|
||||
rules: {
|
||||
'no-undef': 'off',
|
||||
},
|
||||
},
|
||||
],
|
||||
};
|
||||
@@ -0,0 +1,45 @@
|
||||
name: Checks
|
||||
|
||||
on:
|
||||
push:
|
||||
branches:
|
||||
- main
|
||||
|
||||
jobs:
|
||||
checks:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- name: Checkout repository
|
||||
uses: actions/checkout@v4
|
||||
with:
|
||||
fetch-depth: 1
|
||||
|
||||
- name: Setup Node.js
|
||||
uses: actions/setup-node@v4
|
||||
with:
|
||||
node-version: '22'
|
||||
cache: 'npm'
|
||||
|
||||
- name: Install dependencies
|
||||
run: npm ci --prefer-offline
|
||||
|
||||
# ci-checks.sh always exits 0: findings become issues, not failed builds.
|
||||
- name: Run checks
|
||||
env:
|
||||
API_BASE: ${{ github.server_url }}/api/v1
|
||||
# github.server_url is the internal runner host, so the commit link needs the public one.
|
||||
WEB_BASE: https://git.ruv.wtf
|
||||
REPO: ${{ github.repository }}
|
||||
SHA: ${{ github.sha }}
|
||||
# Prefer a PAT with issue write scope (secret: GITEA_TOKEN).
|
||||
# Default GITHUB_TOKEN is usually scoped to this repo only.
|
||||
GITEA_TOKEN: ${{ secrets.GITEA_TOKEN }}
|
||||
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
|
||||
run: |
|
||||
TOKEN="${GITEA_TOKEN:-${GITHUB_TOKEN:-}}"
|
||||
if [ -z "$TOKEN" ]; then
|
||||
echo "No GITEA_TOKEN/GITHUB_TOKEN available to file issues"
|
||||
exit 0
|
||||
fi
|
||||
export TOKEN
|
||||
bash scripts/ci-checks.sh
|
||||
@@ -6,3 +6,6 @@ devAssets
|
||||
.DS_Store
|
||||
.idea
|
||||
.cache
|
||||
|
||||
# Vite build artifacts
|
||||
vite.config.js.timestamp-*
|
||||
|
||||
+11
-11
@@ -17,23 +17,23 @@ diverse, inclusive, and healthy community.
|
||||
Examples of behavior that contributes to a positive environment for our
|
||||
community include:
|
||||
|
||||
* Demonstrating empathy and kindness toward other people
|
||||
* Being respectful of differing opinions, viewpoints, and experiences
|
||||
* Giving and gracefully accepting constructive feedback
|
||||
* Accepting responsibility and apologizing to those affected by our mistakes,
|
||||
- Demonstrating empathy and kindness toward other people
|
||||
- Being respectful of differing opinions, viewpoints, and experiences
|
||||
- Giving and gracefully accepting constructive feedback
|
||||
- Accepting responsibility and apologizing to those affected by our mistakes,
|
||||
and learning from the experience
|
||||
* Focusing on what is best not just for us as individuals, but for the
|
||||
- Focusing on what is best not just for us as individuals, but for the
|
||||
overall community
|
||||
|
||||
Examples of unacceptable behavior include:
|
||||
|
||||
* The use of sexualized language or imagery, and sexual attention or
|
||||
- The use of sexualized language or imagery, and sexual attention or
|
||||
advances of any kind
|
||||
* Trolling, insulting or derogatory comments, and personal or political attacks
|
||||
* Public or private harassment
|
||||
* Publishing others' private information, such as a physical or email
|
||||
- Trolling, insulting or derogatory comments, and personal or political attacks
|
||||
- Public or private harassment
|
||||
- Publishing others' private information, such as a physical or email
|
||||
address, without their explicit permission
|
||||
* Other conduct which could reasonably be considered inappropriate in a
|
||||
- Other conduct which could reasonably be considered inappropriate in a
|
||||
professional setting
|
||||
|
||||
## Enforcement Responsibilities
|
||||
@@ -106,7 +106,7 @@ Violating these terms may lead to a permanent ban.
|
||||
### 4. Permanent Ban
|
||||
|
||||
**Community Impact**: Demonstrating a pattern of violation of community
|
||||
standards, including sustained inappropriate behavior, harassment of an
|
||||
standards, including sustained inappropriate behavior, harassment of an
|
||||
individual, or aggression toward or disparagement of classes of individuals.
|
||||
|
||||
**Consequence**: A permanent ban from any sort of public interaction within
|
||||
|
||||
@@ -7,6 +7,9 @@
|
||||
"LocalNotifications": {
|
||||
"smallIcon": "ic_stat_paarrot",
|
||||
"iconColor": "#FF8A00"
|
||||
},
|
||||
"CapacitorHttp": {
|
||||
"enabled": true
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
+2
-4
@@ -11,10 +11,8 @@
|
||||
"allowCustomHomeservers": true,
|
||||
"featuredCommunities": {
|
||||
"openAsDefault": false,
|
||||
"spaces": [
|
||||
],
|
||||
"rooms": [
|
||||
],
|
||||
"spaces": [],
|
||||
"rooms": [],
|
||||
"servers": []
|
||||
},
|
||||
|
||||
|
||||
+30
-17
@@ -11,6 +11,7 @@ The API server starts automatically when you run Paarrot. It listens on `http://
|
||||
**Option 1: Using Postman**
|
||||
|
||||
Import the Postman collection for easy testing:
|
||||
|
||||
1. Open Postman
|
||||
2. Click **Import** → **File**
|
||||
3. Select `paarrot-api.postman_collection.json`
|
||||
@@ -19,16 +20,19 @@ Import the Postman collection for easy testing:
|
||||
The collection is automatically updated on git push.
|
||||
|
||||
**Option 2: Using the test script**
|
||||
|
||||
```bash
|
||||
node test-api.js
|
||||
```
|
||||
|
||||
**Option 3: Using curl**
|
||||
|
||||
```bash
|
||||
./test-api.sh
|
||||
```
|
||||
|
||||
**Option 4: Manual curl commands**
|
||||
|
||||
```bash
|
||||
# Health check
|
||||
curl http://127.0.0.1:33384/health
|
||||
@@ -46,22 +50,22 @@ curl -X POST http://127.0.0.1:33384/message/current \
|
||||
|
||||
### Common Endpoints
|
||||
|
||||
| Endpoint | Method | Description |
|
||||
|----------|--------|-------------|
|
||||
| `/health` | GET | Check if API is running |
|
||||
| `/status` | GET | Get app status (mute, deafen, etc.) |
|
||||
| `/mute/toggle` | POST | Toggle microphone mute |
|
||||
| `/deafen/toggle` | POST | Toggle deafen |
|
||||
| `/channels` | GET | Get list of rooms |
|
||||
| `/channel` | POST | Switch to a room |
|
||||
| `/message/current` | POST | Send message to current room |
|
||||
| `/room/current` | GET | Get current room info |
|
||||
| `/messages/groups` | GET | Last N messages across groups (`?limit=10`) |
|
||||
| `/messages/dms` | GET | Last N messages across DMs (`?limit=10`) |
|
||||
| `/messages/combined` | GET | Last N messages across groups + DMs (`?limit=10`) |
|
||||
| `/unreads/groups` | GET | Unread group conversations |
|
||||
| `/unreads/dms` | GET | Unread DM conversations |
|
||||
| `/unreads/combined` | GET | Unread groups + DMs |
|
||||
| Endpoint | Method | Description |
|
||||
| -------------------- | ------ | ------------------------------------------------- |
|
||||
| `/health` | GET | Check if API is running |
|
||||
| `/status` | GET | Get app status (mute, deafen, etc.) |
|
||||
| `/mute/toggle` | POST | Toggle microphone mute |
|
||||
| `/deafen/toggle` | POST | Toggle deafen |
|
||||
| `/channels` | GET | Get list of rooms |
|
||||
| `/channel` | POST | Switch to a room |
|
||||
| `/message/current` | POST | Send message to current room |
|
||||
| `/room/current` | GET | Get current room info |
|
||||
| `/messages/groups` | GET | Last N messages across groups (`?limit=10`) |
|
||||
| `/messages/dms` | GET | Last N messages across DMs (`?limit=10`) |
|
||||
| `/messages/combined` | GET | Last N messages across groups + DMs (`?limit=10`) |
|
||||
| `/unreads/groups` | GET | Unread group conversations |
|
||||
| `/unreads/dms` | GET | Unread DM conversations |
|
||||
| `/unreads/combined` | GET | Unread groups + DMs |
|
||||
|
||||
## 🎮 Stream Deck Integration
|
||||
|
||||
@@ -69,10 +73,12 @@ curl -X POST http://127.0.0.1:33384/message/current \
|
||||
2. Create buttons with these settings:
|
||||
|
||||
**Mute Toggle Button:**
|
||||
|
||||
- URL: `http://127.0.0.1:33384/mute/toggle`
|
||||
- Method: POST
|
||||
|
||||
**Quick Message Button:**
|
||||
|
||||
- URL: `http://127.0.0.1:33384/message/current`
|
||||
- Method: POST
|
||||
- Body: `{"message": "BRB!"}`
|
||||
@@ -82,6 +88,7 @@ curl -X POST http://127.0.0.1:33384/message/current \
|
||||
To enable full functionality, you need to implement the action handlers in the Cinny frontend:
|
||||
|
||||
1. Import the API handler in your app initialization:
|
||||
|
||||
```typescript
|
||||
import { initPaarrotAPI } from './app/paarrot-api';
|
||||
|
||||
@@ -98,6 +105,7 @@ initPaarrotAPI(matrixClient);
|
||||
## 📖 Full Documentation
|
||||
|
||||
See [API.md](API.md) for complete API documentation including:
|
||||
|
||||
- All available endpoints
|
||||
- Request/response formats
|
||||
- Error handling
|
||||
@@ -107,6 +115,7 @@ See [API.md](API.md) for complete API documentation including:
|
||||
## 🛠️ Configuration
|
||||
|
||||
Edit `electron/api-server.js` to customize:
|
||||
|
||||
- Port number (default: 33384)
|
||||
- Timeout duration (default: 10s)
|
||||
- CORS settings
|
||||
@@ -114,11 +123,13 @@ Edit `electron/api-server.js` to customize:
|
||||
## 🐛 Troubleshooting
|
||||
|
||||
**API not responding:**
|
||||
|
||||
1. Check if Paarrot is running
|
||||
2. Look for "Paarrot API server listening" in console logs
|
||||
3. Verify port 33384 is not in use: `lsof -i :33384`
|
||||
|
||||
**Actions not working:**
|
||||
|
||||
1. Check browser console for errors
|
||||
2. Ensure `initPaarrotAPI()` is called in your app
|
||||
3. Implement the TODO items in `paarrot-api.ts`
|
||||
@@ -144,6 +155,7 @@ Edit `electron/api-server.js` and change the port number in the constructor.
|
||||
## 💡 Examples
|
||||
|
||||
**Python Script:**
|
||||
|
||||
```python
|
||||
import requests
|
||||
|
||||
@@ -155,12 +167,13 @@ toggle_mute()
|
||||
```
|
||||
|
||||
**JavaScript:**
|
||||
|
||||
```javascript
|
||||
async function sendQuickMessage(msg) {
|
||||
const res = await fetch('http://127.0.0.1:33384/message/current', {
|
||||
method: 'POST',
|
||||
headers: { 'Content-Type': 'application/json' },
|
||||
body: JSON.stringify({ message: msg })
|
||||
body: JSON.stringify({ message: msg }),
|
||||
});
|
||||
return res.json();
|
||||
}
|
||||
|
||||
+105
-78
@@ -22,6 +22,7 @@ Check if the API server is running.
|
||||
**Endpoint**: `GET /health`
|
||||
|
||||
**Response**:
|
||||
|
||||
```json
|
||||
{
|
||||
"status": "ok",
|
||||
@@ -39,6 +40,7 @@ Get the current status of the app (mute, deafen, current room, etc.).
|
||||
**Endpoint**: `GET /status`
|
||||
|
||||
**Response**:
|
||||
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
@@ -60,6 +62,7 @@ Set the mute status.
|
||||
**Endpoint**: `POST /mute`
|
||||
|
||||
**Request Body**:
|
||||
|
||||
```json
|
||||
{
|
||||
"muted": true
|
||||
@@ -67,6 +70,7 @@ Set the mute status.
|
||||
```
|
||||
|
||||
**Response**:
|
||||
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
@@ -85,6 +89,7 @@ Toggle the current mute status.
|
||||
**Endpoint**: `POST /mute/toggle`
|
||||
|
||||
**Response**:
|
||||
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
@@ -103,6 +108,7 @@ Set the deafen status (deafening also mutes).
|
||||
**Endpoint**: `POST /deafen`
|
||||
|
||||
**Request Body**:
|
||||
|
||||
```json
|
||||
{
|
||||
"deafened": true
|
||||
@@ -110,6 +116,7 @@ Set the deafen status (deafening also mutes).
|
||||
```
|
||||
|
||||
**Response**:
|
||||
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
@@ -128,6 +135,7 @@ Toggle the current deafen status.
|
||||
**Endpoint**: `POST /deafen/toggle`
|
||||
|
||||
**Response**:
|
||||
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
@@ -146,6 +154,7 @@ Switch to a different Matrix room.
|
||||
**Endpoint**: `POST /channel`
|
||||
|
||||
**Request Body**:
|
||||
|
||||
```json
|
||||
{
|
||||
"roomId": "!abc123:matrix.org"
|
||||
@@ -153,6 +162,7 @@ Switch to a different Matrix room.
|
||||
```
|
||||
|
||||
**Response**:
|
||||
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
@@ -172,6 +182,7 @@ Get a list of available rooms/channels.
|
||||
**Endpoint**: `GET /channels`
|
||||
|
||||
**Response**:
|
||||
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
@@ -212,6 +223,7 @@ Send a message to a specific room.
|
||||
**Endpoint**: `POST /message`
|
||||
|
||||
**Request Body**:
|
||||
|
||||
```json
|
||||
{
|
||||
"roomId": "!abc123:matrix.org",
|
||||
@@ -220,6 +232,7 @@ Send a message to a specific room.
|
||||
```
|
||||
|
||||
**Response**:
|
||||
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
@@ -239,6 +252,7 @@ Send a message to the currently active room.
|
||||
**Endpoint**: `POST /message/current`
|
||||
|
||||
**Request Body**:
|
||||
|
||||
```json
|
||||
{
|
||||
"message": "Hello from the API!"
|
||||
@@ -246,6 +260,7 @@ Send a message to the currently active room.
|
||||
```
|
||||
|
||||
**Response**:
|
||||
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
@@ -265,6 +280,7 @@ Get information about the currently active room.
|
||||
**Endpoint**: `GET /room/current`
|
||||
|
||||
**Response**:
|
||||
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
@@ -287,9 +303,11 @@ Get the most recent messages across joined group channels (non-DMs).
|
||||
**Endpoint**: `GET /messages/groups`
|
||||
|
||||
**Query Parameters**:
|
||||
|
||||
- `limit` (optional) — number of messages to return (1–100, default `10`)
|
||||
|
||||
**Response**:
|
||||
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
@@ -323,6 +341,7 @@ Get the most recent messages across joined direct messages.
|
||||
**Endpoint**: `GET /messages/dms`
|
||||
|
||||
**Query Parameters**:
|
||||
|
||||
- `limit` (optional) — number of messages to return (1–100, default `10`)
|
||||
|
||||
**Response**: same shape as groups, with `"scope": "dms"`.
|
||||
@@ -336,6 +355,7 @@ Get the most recent messages across groups and DMs together.
|
||||
**Endpoint**: `GET /messages/combined`
|
||||
|
||||
**Query Parameters**:
|
||||
|
||||
- `limit` (optional) — number of messages to return (1–100, default `10`)
|
||||
|
||||
**Response**: same shape as groups, with `"scope": "combined"`.
|
||||
@@ -349,6 +369,7 @@ List joined group channels that currently have unread activity.
|
||||
**Endpoint**: `GET /unreads/groups`
|
||||
|
||||
**Response**:
|
||||
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
@@ -409,6 +430,7 @@ All endpoints return error responses in the following format:
|
||||
```
|
||||
|
||||
Common HTTP status codes:
|
||||
|
||||
- `200 OK` - Request successful
|
||||
- `400 Bad Request` - Missing or invalid parameters
|
||||
- `404 Not Found` - Endpoint not found
|
||||
@@ -443,7 +465,7 @@ const fetch = require('node-fetch');
|
||||
// Toggle mute
|
||||
async function toggleMute() {
|
||||
const response = await fetch('http://127.0.0.1:33384/mute/toggle', {
|
||||
method: 'POST'
|
||||
method: 'POST',
|
||||
});
|
||||
const data = await response.json();
|
||||
console.log('Muted:', data.data.muted);
|
||||
@@ -454,9 +476,9 @@ async function sendMessage(roomId, message) {
|
||||
const response = await fetch('http://127.0.0.1:33384/message', {
|
||||
method: 'POST',
|
||||
headers: {
|
||||
'Content-Type': 'application/json'
|
||||
'Content-Type': 'application/json',
|
||||
},
|
||||
body: JSON.stringify({ roomId, message })
|
||||
body: JSON.stringify({ roomId, message }),
|
||||
});
|
||||
const data = await response.json();
|
||||
console.log('Message sent:', data.data.eventId);
|
||||
@@ -499,14 +521,17 @@ To integrate with Stream Deck:
|
||||
Example configurations:
|
||||
|
||||
**Mute Toggle Button**:
|
||||
|
||||
- URL: `http://127.0.0.1:33384/mute/toggle`
|
||||
- Method: POST
|
||||
|
||||
**Deafen Toggle Button**:
|
||||
|
||||
- URL: `http://127.0.0.1:33384/deafen/toggle`
|
||||
- Method: POST
|
||||
|
||||
**Send Quick Message**:
|
||||
|
||||
- URL: `http://127.0.0.1:33384/message/current`
|
||||
- Method: POST
|
||||
- Body: `{"message": "BRB!"}`
|
||||
@@ -524,82 +549,80 @@ Add this to your app initialization:
|
||||
```typescript
|
||||
// Listen for API actions from the Electron API server
|
||||
if (window.electron?.api?.onAction) {
|
||||
window.electron.api.onAction(async (action: {
|
||||
action: string;
|
||||
params: any;
|
||||
responseChannel: string;
|
||||
}) => {
|
||||
try {
|
||||
let result;
|
||||
|
||||
switch (action.action) {
|
||||
case 'toggle-mute':
|
||||
// Toggle microphone mute
|
||||
result = await toggleMicrophone();
|
||||
break;
|
||||
|
||||
case 'set-mute':
|
||||
// Set microphone mute state
|
||||
result = await setMicrophone(action.params.muted);
|
||||
break;
|
||||
|
||||
case 'toggle-deafen':
|
||||
// Toggle deafen (mute speakers)
|
||||
result = await toggleDeafen();
|
||||
break;
|
||||
|
||||
case 'set-deafen':
|
||||
// Set deafen state
|
||||
result = await setDeafen(action.params.deafened);
|
||||
break;
|
||||
|
||||
case 'change-channel':
|
||||
// Navigate to a different room
|
||||
result = await changeRoom(action.params.roomId);
|
||||
break;
|
||||
|
||||
case 'get-channels':
|
||||
// Get list of rooms
|
||||
result = await getRoomList();
|
||||
break;
|
||||
|
||||
case 'send-message':
|
||||
// Send message to specific room
|
||||
result = await sendMessage(action.params.roomId, action.params.message);
|
||||
break;
|
||||
|
||||
case 'send-message-current':
|
||||
// Send message to current room
|
||||
result = await sendMessageToCurrent(action.params.message);
|
||||
break;
|
||||
|
||||
case 'get-current-room':
|
||||
// Get current room info
|
||||
result = await getCurrentRoomInfo();
|
||||
break;
|
||||
|
||||
case 'get-status':
|
||||
// Get current app status
|
||||
result = await getAppStatus();
|
||||
break;
|
||||
|
||||
default:
|
||||
throw new Error(`Unknown action: ${action.action}`);
|
||||
window.electron.api.onAction(
|
||||
async (action: { action: string; params: any; responseChannel: string }) => {
|
||||
try {
|
||||
let result;
|
||||
|
||||
switch (action.action) {
|
||||
case 'toggle-mute':
|
||||
// Toggle microphone mute
|
||||
result = await toggleMicrophone();
|
||||
break;
|
||||
|
||||
case 'set-mute':
|
||||
// Set microphone mute state
|
||||
result = await setMicrophone(action.params.muted);
|
||||
break;
|
||||
|
||||
case 'toggle-deafen':
|
||||
// Toggle deafen (mute speakers)
|
||||
result = await toggleDeafen();
|
||||
break;
|
||||
|
||||
case 'set-deafen':
|
||||
// Set deafen state
|
||||
result = await setDeafen(action.params.deafened);
|
||||
break;
|
||||
|
||||
case 'change-channel':
|
||||
// Navigate to a different room
|
||||
result = await changeRoom(action.params.roomId);
|
||||
break;
|
||||
|
||||
case 'get-channels':
|
||||
// Get list of rooms
|
||||
result = await getRoomList();
|
||||
break;
|
||||
|
||||
case 'send-message':
|
||||
// Send message to specific room
|
||||
result = await sendMessage(action.params.roomId, action.params.message);
|
||||
break;
|
||||
|
||||
case 'send-message-current':
|
||||
// Send message to current room
|
||||
result = await sendMessageToCurrent(action.params.message);
|
||||
break;
|
||||
|
||||
case 'get-current-room':
|
||||
// Get current room info
|
||||
result = await getCurrentRoomInfo();
|
||||
break;
|
||||
|
||||
case 'get-status':
|
||||
// Get current app status
|
||||
result = await getAppStatus();
|
||||
break;
|
||||
|
||||
default:
|
||||
throw new Error(`Unknown action: ${action.action}`);
|
||||
}
|
||||
|
||||
// Send success response back
|
||||
window.electron.api.sendResponse(action.responseChannel, {
|
||||
success: true,
|
||||
data: result,
|
||||
});
|
||||
} catch (error) {
|
||||
// Send error response back
|
||||
window.electron.api.sendResponse(action.responseChannel, {
|
||||
success: false,
|
||||
error: error.message,
|
||||
});
|
||||
}
|
||||
|
||||
// Send success response back
|
||||
window.electron.api.sendResponse(action.responseChannel, {
|
||||
success: true,
|
||||
data: result
|
||||
});
|
||||
} catch (error) {
|
||||
// Send error response back
|
||||
window.electron.api.sendResponse(action.responseChannel, {
|
||||
success: false,
|
||||
error: error.message
|
||||
});
|
||||
}
|
||||
});
|
||||
},
|
||||
);
|
||||
}
|
||||
```
|
||||
|
||||
@@ -627,16 +650,19 @@ The API server can be configured by modifying `electron/api-server.js`:
|
||||
## Troubleshooting
|
||||
|
||||
**API server not starting**:
|
||||
|
||||
- Check if port 33384 is already in use
|
||||
- Check console logs for errors
|
||||
- Verify Express is installed: `npm install express cors body-parser`
|
||||
|
||||
**Actions not working**:
|
||||
|
||||
- Ensure the client-side handler is implemented
|
||||
- Check browser console for errors
|
||||
- Verify the action names match between API server and client
|
||||
|
||||
**Timeout errors**:
|
||||
|
||||
- Actions must respond within 10 seconds
|
||||
- Check if the Matrix client is initialized
|
||||
- Verify the action handler is registered
|
||||
@@ -646,6 +672,7 @@ The API server can be configured by modifying `electron/api-server.js`:
|
||||
## Future Enhancements
|
||||
|
||||
Potential features to add:
|
||||
|
||||
- WebSocket support for real-time events
|
||||
- Authentication with API keys
|
||||
- Voice channel controls (join/leave)
|
||||
|
||||
+6
-1
@@ -5,6 +5,7 @@ The Paarrot desktop client includes a powerful plugin system that allows you to
|
||||
## What are Plugins?
|
||||
|
||||
Plugins are small JavaScript modules that run inside Paarrot and can:
|
||||
|
||||
- Add custom commands
|
||||
- Modify the UI
|
||||
- React to Matrix events
|
||||
@@ -53,6 +54,7 @@ Use the search bar to filter plugins by name, description, author, or tags.
|
||||
⚠️ **Important Security Information**
|
||||
|
||||
Plugins run with access to your Matrix client and can:
|
||||
|
||||
- Read your messages
|
||||
- Send messages on your behalf
|
||||
- Access your room list
|
||||
@@ -79,6 +81,7 @@ Want to create your own plugin? Check out the [Plugin API Reference](docs/PLUGIN
|
||||
- `plugin-metadata.json` - Plugin information
|
||||
|
||||
2. Implement the plugin interface:
|
||||
|
||||
```javascript
|
||||
module.exports = {
|
||||
onLoad: async (context) => {
|
||||
@@ -87,7 +90,7 @@ module.exports = {
|
||||
},
|
||||
onUnload: async () => {
|
||||
// Cleanup when disabled
|
||||
}
|
||||
},
|
||||
};
|
||||
```
|
||||
|
||||
@@ -98,6 +101,7 @@ module.exports = {
|
||||
## Plugin API
|
||||
|
||||
Plugins have access to:
|
||||
|
||||
- **Matrix Client**: Full matrix-js-sdk client instance
|
||||
- **React**: For building UI components
|
||||
- **Commands**: Register custom slash commands
|
||||
@@ -134,6 +138,7 @@ Check out the `example-plugin/` directory for a simple example, or the `plugins/
|
||||
### Performance Issues
|
||||
|
||||
If Paarrot becomes slow:
|
||||
|
||||
1. Disable plugins one by one to identify the culprit
|
||||
2. Check for memory leaks in the console
|
||||
3. Contact the plugin author with details
|
||||
|
||||
+231
-210
@@ -27,6 +27,7 @@ Complete reference for developing plugins for Paarrot/Cinny Desktop.
|
||||
### Plugin Location
|
||||
|
||||
Plugins are installed in:
|
||||
|
||||
- **Windows**: `%APPDATA%\paarrot\plugins\<plugin-name>\`
|
||||
- **Linux**: `~/.config/Paarrot/plugins/<plugin-name>/`
|
||||
- **macOS**: `~/Library/Application Support/Paarrot/plugins/<plugin-name>/`
|
||||
@@ -59,38 +60,38 @@ Plugins are installed in:
|
||||
|
||||
```javascript
|
||||
module.exports = {
|
||||
name: "My Plugin",
|
||||
version: "1.0.0",
|
||||
name: 'My Plugin',
|
||||
version: '1.0.0',
|
||||
dependencies: {
|
||||
// "other-plugin": "^1.0.0"
|
||||
},
|
||||
|
||||
|
||||
/**
|
||||
* Called when plugin loads
|
||||
* @param {PluginContext} ctx - Plugin context
|
||||
*/
|
||||
onLoad: async (ctx) => {
|
||||
ctx.log('Plugin loaded!');
|
||||
|
||||
|
||||
// Initialize your plugin here
|
||||
ctx.commands.register({
|
||||
name: "hello",
|
||||
description: "Say hello",
|
||||
run: () => "Hello, world!"
|
||||
name: 'hello',
|
||||
description: 'Say hello',
|
||||
run: () => 'Hello, world!',
|
||||
});
|
||||
},
|
||||
|
||||
|
||||
/**
|
||||
* Called when plugin unloads
|
||||
*/
|
||||
onUnload: async () => {
|
||||
console.log('Plugin unloaded');
|
||||
},
|
||||
|
||||
|
||||
/**
|
||||
* API for other plugins
|
||||
*/
|
||||
exports: null
|
||||
exports: null,
|
||||
};
|
||||
```
|
||||
|
||||
@@ -106,7 +107,7 @@ interface PluginContext {
|
||||
matrixClient: MatrixClient;
|
||||
React: typeof import('react');
|
||||
lucide: typeof import('lucide-react');
|
||||
|
||||
|
||||
commands: CommandsAPI;
|
||||
messages: MessagesAPI;
|
||||
ui: UIAPI;
|
||||
@@ -129,54 +130,57 @@ Register slash commands that users can type in chat.
|
||||
|
||||
```javascript
|
||||
ctx.commands.register({
|
||||
name: "mycommand",
|
||||
description: "Does something cool",
|
||||
args: ["arg1", "arg2"], // Optional
|
||||
name: 'mycommand',
|
||||
description: 'Does something cool',
|
||||
args: ['arg1', 'arg2'], // Optional
|
||||
run: (args) => {
|
||||
// Return string to send as message
|
||||
return `Got args: ${args.arg1}, ${args.arg2}`;
|
||||
}
|
||||
},
|
||||
});
|
||||
```
|
||||
|
||||
#### Examples
|
||||
|
||||
**Simple command:**
|
||||
|
||||
```javascript
|
||||
ctx.commands.register({
|
||||
name: "shrug",
|
||||
description: "Send a shrug emoji",
|
||||
run: () => "¯\\_(ツ)_/¯"
|
||||
name: 'shrug',
|
||||
description: 'Send a shrug emoji',
|
||||
run: () => '¯\\_(ツ)_/¯',
|
||||
});
|
||||
// Usage: /shrug
|
||||
```
|
||||
|
||||
**Command with arguments:**
|
||||
|
||||
```javascript
|
||||
ctx.commands.register({
|
||||
name: "greet",
|
||||
description: "Greet someone",
|
||||
args: ["name"],
|
||||
run: ({ name }) => `Hello, ${name || 'stranger'}!`
|
||||
name: 'greet',
|
||||
description: 'Greet someone',
|
||||
args: ['name'],
|
||||
run: ({ name }) => `Hello, ${name || 'stranger'}!`,
|
||||
});
|
||||
// Usage: /greet Alice
|
||||
```
|
||||
|
||||
**Advanced command:**
|
||||
|
||||
```javascript
|
||||
ctx.commands.register({
|
||||
name: "calc",
|
||||
description: "Simple calculator",
|
||||
args: ["expression"],
|
||||
name: 'calc',
|
||||
description: 'Simple calculator',
|
||||
args: ['expression'],
|
||||
run: ({ expression }) => {
|
||||
try {
|
||||
const sanitized = expression.replace(/[^0-9+\-*/().\s]/g, '');
|
||||
const result = Function(`'use strict'; return (${sanitized})`)();
|
||||
return `${expression} = ${result}`;
|
||||
} catch (err) {
|
||||
return "Invalid expression";
|
||||
return 'Invalid expression';
|
||||
}
|
||||
}
|
||||
},
|
||||
});
|
||||
// Usage: /calc 2 + 2 * 3
|
||||
```
|
||||
@@ -214,7 +218,7 @@ ctx.messages.onBeforeSend((msg) => {
|
||||
if (msg.content.includes('secret')) {
|
||||
msg.content = msg.content.replace(/secret/g, '█████');
|
||||
}
|
||||
|
||||
|
||||
// Add prefix
|
||||
msg.content = `[Bot] ${msg.content}`;
|
||||
});
|
||||
@@ -231,7 +235,7 @@ ctx.messages.onReceive((msg) => {
|
||||
ctx.notify({
|
||||
title: 'Important Message',
|
||||
body: msg.content,
|
||||
type: 'info'
|
||||
type: 'info',
|
||||
});
|
||||
}
|
||||
});
|
||||
@@ -240,15 +244,16 @@ ctx.messages.onReceive((msg) => {
|
||||
#### Real-World Examples
|
||||
|
||||
**Auto-expand abbreviations:**
|
||||
|
||||
```javascript
|
||||
ctx.messages.onBeforeSend((msg) => {
|
||||
const expansions = {
|
||||
'brb': 'be right back',
|
||||
'omw': 'on my way',
|
||||
'gtg': 'got to go',
|
||||
'afk': 'away from keyboard'
|
||||
brb: 'be right back',
|
||||
omw: 'on my way',
|
||||
gtg: 'got to go',
|
||||
afk: 'away from keyboard',
|
||||
};
|
||||
|
||||
|
||||
Object.entries(expansions).forEach(([abbr, full]) => {
|
||||
const regex = new RegExp(`\\b${abbr}\\b`, 'gi');
|
||||
msg.content = msg.content.replace(regex, full);
|
||||
@@ -257,6 +262,7 @@ ctx.messages.onBeforeSend((msg) => {
|
||||
```
|
||||
|
||||
**Add auto-shrug to questions:**
|
||||
|
||||
```javascript
|
||||
ctx.messages.onBeforeSend((msg) => {
|
||||
if (msg.content.trim().endsWith('?')) {
|
||||
@@ -266,6 +272,7 @@ ctx.messages.onBeforeSend((msg) => {
|
||||
```
|
||||
|
||||
**Track mentions:**
|
||||
|
||||
```javascript
|
||||
ctx.messages.onReceive((msg) => {
|
||||
const userId = ctx.matrixClient.getUserId();
|
||||
@@ -300,21 +307,25 @@ Register custom UI renderers for messages, images, and other content types.
|
||||
|
||||
```javascript
|
||||
// Custom message renderer
|
||||
ctx.ui.registerRenderer("message", (msg, defaultRenderer) => {
|
||||
ctx.ui.registerRenderer('message', (msg, defaultRenderer) => {
|
||||
// Custom logic
|
||||
if (msg.sender?.includes('bot')) {
|
||||
// Return custom React component
|
||||
return ctx.React.createElement('div', {
|
||||
style: { background: 'yellow' }
|
||||
}, msg.content);
|
||||
return ctx.React.createElement(
|
||||
'div',
|
||||
{
|
||||
style: { background: 'yellow' },
|
||||
},
|
||||
msg.content,
|
||||
);
|
||||
}
|
||||
|
||||
|
||||
// Fall back to default
|
||||
return defaultRenderer?.();
|
||||
});
|
||||
|
||||
// Custom image renderer
|
||||
ctx.ui.registerRenderer("image", (data, defaultRenderer) => {
|
||||
ctx.ui.registerRenderer('image', (data, defaultRenderer) => {
|
||||
// Add custom effects, borders, etc.
|
||||
return defaultRenderer?.();
|
||||
});
|
||||
@@ -328,14 +339,11 @@ interface UIAPI {
|
||||
unregisterButton(id: string): void;
|
||||
registerRenderer(
|
||||
type: string,
|
||||
renderer: (data: any, defaultRenderer?: () => ReactNode) => ReactNode
|
||||
renderer: (data: any, defaultRenderer?: () => ReactNode) => ReactNode,
|
||||
): void;
|
||||
}
|
||||
|
||||
type CustomRenderer = (
|
||||
data: any,
|
||||
defaultRenderer?: () => ReactNode
|
||||
) => ReactNode;
|
||||
type CustomRenderer = (data: any, defaultRenderer?: () => ReactNode) => ReactNode;
|
||||
```
|
||||
|
||||
---
|
||||
@@ -354,30 +362,30 @@ ctx.ui.registerButton({
|
||||
location: 'text-composer-toolbar',
|
||||
label: 'My Tool',
|
||||
icon: '🔧',
|
||||
onClick: () => ctx.log('clicked!')
|
||||
onClick: () => ctx.log('clicked!'),
|
||||
});
|
||||
```
|
||||
|
||||
#### UI Locations — Nav List Rows
|
||||
|
||||
| Location | Where it appears |
|
||||
|---|---|
|
||||
| `channel-list` | Space channel list, below Lobby and Message Search |
|
||||
| `home-section` | Home panel, inside the Rooms category above the room list |
|
||||
| Location | Where it appears |
|
||||
| ----------------- | ----------------------------------------------------------- |
|
||||
| `channel-list` | Space channel list, below Lobby and Message Search |
|
||||
| `home-section` | Home panel, inside the Rooms category above the room list |
|
||||
| `direct-messages` | DMs panel, below "Create Chat" and above the CHATS dropdown |
|
||||
|
||||
#### UI Locations — Icon Buttons
|
||||
|
||||
| Location | Where it appears |
|
||||
|---|---|
|
||||
| `text-composer-toolbar` | Message composer toolbar (alongside emoji, sticker buttons) |
|
||||
| `composer-actions` | Left side of the composer, beside the `+` attach button |
|
||||
| `room-header` | Top room header bar, before the ⋮ menu |
|
||||
| `room-menu` | Room ⋮ dropdown menu |
|
||||
| `message-actions` | Message hover action bar |
|
||||
| `user-menu` | Right-click popup on the user avatar |
|
||||
| `search-notification-section` | Notifications page header (right side) |
|
||||
| `sidebar-actions` | Left sidebar — above Explore Servers icon, and above Search icon in the sticky bottom section |
|
||||
| Location | Where it appears |
|
||||
| ----------------------------- | --------------------------------------------------------------------------------------------- |
|
||||
| `text-composer-toolbar` | Message composer toolbar (alongside emoji, sticker buttons) |
|
||||
| `composer-actions` | Left side of the composer, beside the `+` attach button |
|
||||
| `room-header` | Top room header bar, before the ⋮ menu |
|
||||
| `room-menu` | Room ⋮ dropdown menu |
|
||||
| `message-actions` | Message hover action bar |
|
||||
| `user-menu` | Right-click popup on the user avatar |
|
||||
| `search-notification-section` | Notifications page header (right side) |
|
||||
| `sidebar-actions` | Left sidebar — above Explore Servers icon, and above Search icon in the sticky bottom section |
|
||||
|
||||
#### Positioning
|
||||
|
||||
@@ -390,9 +398,9 @@ ctx.ui.registerButton({
|
||||
position: {
|
||||
after: 'emoji-picker-button',
|
||||
group: 'my-tools',
|
||||
order: 1
|
||||
order: 1,
|
||||
},
|
||||
onClick: () => ctx.log('clicked!')
|
||||
onClick: () => ctx.log('clicked!'),
|
||||
});
|
||||
```
|
||||
|
||||
@@ -407,10 +415,17 @@ ctx.ui.unregisterButton('my-button');
|
||||
|
||||
```typescript
|
||||
type UILocation =
|
||||
| 'channel-list' | 'direct-messages' | 'home-section'
|
||||
| 'text-composer-toolbar' | 'composer-actions'
|
||||
| 'room-header' | 'room-menu' | 'message-actions'
|
||||
| 'user-menu' | 'search-notification-section' | 'sidebar-actions';
|
||||
| 'channel-list'
|
||||
| 'direct-messages'
|
||||
| 'home-section'
|
||||
| 'text-composer-toolbar'
|
||||
| 'composer-actions'
|
||||
| 'room-header'
|
||||
| 'room-menu'
|
||||
| 'message-actions'
|
||||
| 'user-menu'
|
||||
| 'search-notification-section'
|
||||
| 'sidebar-actions';
|
||||
|
||||
interface UIButtonDefinition {
|
||||
id: string;
|
||||
@@ -443,47 +458,47 @@ Define settings that users can configure in the UI.
|
||||
ctx.settings.define({
|
||||
// Boolean toggle
|
||||
enableFeature: {
|
||||
type: "boolean",
|
||||
label: "Enable Feature",
|
||||
description: "Toggle this feature on/off",
|
||||
default: true
|
||||
type: 'boolean',
|
||||
label: 'Enable Feature',
|
||||
description: 'Toggle this feature on/off',
|
||||
default: true,
|
||||
},
|
||||
|
||||
|
||||
// String input
|
||||
apiKey: {
|
||||
type: "string",
|
||||
label: "API Key",
|
||||
description: "Your API key",
|
||||
default: ""
|
||||
type: 'string',
|
||||
label: 'API Key',
|
||||
description: 'Your API key',
|
||||
default: '',
|
||||
},
|
||||
|
||||
|
||||
// Number input
|
||||
maxRetries: {
|
||||
type: "number",
|
||||
label: "Max Retries",
|
||||
description: "Maximum retry attempts",
|
||||
default: 3
|
||||
type: 'number',
|
||||
label: 'Max Retries',
|
||||
description: 'Maximum retry attempts',
|
||||
default: 3,
|
||||
},
|
||||
|
||||
|
||||
// Select dropdown
|
||||
theme: {
|
||||
type: "select",
|
||||
label: "Theme",
|
||||
description: "Choose a theme",
|
||||
type: 'select',
|
||||
label: 'Theme',
|
||||
description: 'Choose a theme',
|
||||
options: [
|
||||
{ value: "dark", label: "Dark Mode" },
|
||||
{ value: "light", label: "Light Mode" }
|
||||
{ value: 'dark', label: 'Dark Mode' },
|
||||
{ value: 'light', label: 'Light Mode' },
|
||||
],
|
||||
default: "dark"
|
||||
default: 'dark',
|
||||
},
|
||||
|
||||
|
||||
// Color picker
|
||||
accentColor: {
|
||||
type: "color",
|
||||
label: "Accent Color",
|
||||
description: "Choose your accent color",
|
||||
default: "#6366f1"
|
||||
}
|
||||
type: 'color',
|
||||
label: 'Accent Color',
|
||||
description: 'Choose your accent color',
|
||||
default: '#6366f1',
|
||||
},
|
||||
});
|
||||
```
|
||||
|
||||
@@ -528,9 +543,9 @@ Register custom themes that appear in the theme selector dropdown. Themes use CS
|
||||
|
||||
```javascript
|
||||
ctx.themes.register({
|
||||
id: "my-theme",
|
||||
name: "My Custom Theme",
|
||||
kind: "dark", // "light" or "dark"
|
||||
id: 'my-theme',
|
||||
name: 'My Custom Theme',
|
||||
kind: 'dark', // "light" or "dark"
|
||||
css: `
|
||||
body.plugin-my-plugin-my-theme {
|
||||
background: linear-gradient(135deg, #1a1a2e 0%, #16213e 50%, #0f3460 100%);
|
||||
@@ -543,7 +558,7 @@ ctx.themes.register({
|
||||
.plugin-my-plugin-my-theme {
|
||||
--tc-link: hsl(213, 100%, 80%);
|
||||
}
|
||||
`
|
||||
`,
|
||||
});
|
||||
```
|
||||
|
||||
@@ -563,6 +578,7 @@ Example: plugin ID `my-plugin` + theme ID `dark-blue` = `.plugin-my-plugin-dark-
|
||||
#### CSS Custom Properties
|
||||
|
||||
Available CSS variables you can override:
|
||||
|
||||
- `--tc-link` - Link color
|
||||
- `--mx-uc-1` through `--mx-uc-8` - Matrix user ID colors (for different users)
|
||||
- `--font-emoji` - Emoji font family
|
||||
@@ -571,6 +587,7 @@ Available CSS variables you can override:
|
||||
#### Styling Elements
|
||||
|
||||
Common selectors to style:
|
||||
|
||||
- `body.plugin-{pluginId}-{themeId}` - Body background
|
||||
- `.plugin-{pluginId}-{themeId} #root` - Main app container
|
||||
- `.plugin-{pluginId}-{themeId} [role="navigation"]` - Navigation sidebar
|
||||
@@ -582,11 +599,12 @@ Common selectors to style:
|
||||
#### Examples
|
||||
|
||||
**Dark Theme with Gradients:**
|
||||
|
||||
```javascript
|
||||
ctx.themes.register({
|
||||
id: "midnight",
|
||||
name: "Midnight Blue 🌙",
|
||||
kind: "dark",
|
||||
id: 'midnight',
|
||||
name: 'Midnight Blue 🌙',
|
||||
kind: 'dark',
|
||||
css: `
|
||||
body.plugin-my-plugin-midnight {
|
||||
background: linear-gradient(135deg, #0a192f 0%, #112240 50%, #1a365d 100%);
|
||||
@@ -613,16 +631,17 @@ ctx.themes.register({
|
||||
.plugin-my-plugin-midnight {
|
||||
--tc-link: hsl(213, 100%, 80%);
|
||||
}
|
||||
`
|
||||
`,
|
||||
});
|
||||
```
|
||||
|
||||
**Light Theme:**
|
||||
|
||||
```javascript
|
||||
ctx.themes.register({
|
||||
id: "sunrise",
|
||||
name: "Sunrise ☀️",
|
||||
kind: "light",
|
||||
id: 'sunrise',
|
||||
name: 'Sunrise ☀️',
|
||||
kind: 'light',
|
||||
css: `
|
||||
body.plugin-my-plugin-sunrise {
|
||||
background: linear-gradient(135deg, #fff4e6 0%, #ffe0b2 50%, #ffcc80 100%);
|
||||
@@ -645,16 +664,17 @@ ctx.themes.register({
|
||||
.plugin-my-plugin-sunrise {
|
||||
--tc-link: hsl(30, 100%, 40%);
|
||||
}
|
||||
`
|
||||
`,
|
||||
});
|
||||
```
|
||||
|
||||
**Minimal Theme:**
|
||||
|
||||
```javascript
|
||||
ctx.themes.register({
|
||||
id: "forest",
|
||||
name: "Forest Green 🌲",
|
||||
kind: "dark",
|
||||
id: 'forest',
|
||||
name: 'Forest Green 🌲',
|
||||
kind: 'dark',
|
||||
css: `
|
||||
body.plugin-my-plugin-forest {
|
||||
background: #1a2f23;
|
||||
@@ -671,14 +691,14 @@ ctx.themes.register({
|
||||
--mx-uc-7: hsl(135, 60%, 70%);
|
||||
--mx-uc-8: hsl(155, 60%, 70%);
|
||||
}
|
||||
`
|
||||
`,
|
||||
});
|
||||
```
|
||||
|
||||
#### Unregister Theme
|
||||
|
||||
```javascript
|
||||
ctx.themes.unregister("my-theme");
|
||||
ctx.themes.unregister('my-theme');
|
||||
```
|
||||
|
||||
#### API Reference
|
||||
@@ -699,6 +719,7 @@ interface PluginTheme {
|
||||
```
|
||||
|
||||
**Notes:**
|
||||
|
||||
- CSS is injected once when the plugin loads (not per theme change)
|
||||
- Theme IDs are automatically prefixed with `plugin-{pluginId}-` to avoid conflicts
|
||||
- Theme class names follow the pattern: `.plugin-{pluginId}-{themeId}`
|
||||
@@ -717,19 +738,19 @@ Hook into raw Matrix events for advanced functionality.
|
||||
|
||||
```javascript
|
||||
// Room messages
|
||||
ctx.matrix.on("m.room.message", (event) => {
|
||||
ctx.matrix.on('m.room.message', (event) => {
|
||||
const content = event.getContent();
|
||||
ctx.log('Message:', content.body);
|
||||
});
|
||||
|
||||
// Membership changes
|
||||
ctx.matrix.on("m.room.member", (event) => {
|
||||
ctx.matrix.on('m.room.member', (event) => {
|
||||
const content = event.getContent();
|
||||
ctx.log('Membership:', content.membership);
|
||||
});
|
||||
|
||||
// Timeline events
|
||||
ctx.matrix.on("Room.timeline", (event) => {
|
||||
ctx.matrix.on('Room.timeline', (event) => {
|
||||
if (event.getType() === 'm.room.message') {
|
||||
const sender = event.getSender();
|
||||
ctx.log('Timeline event from:', sender);
|
||||
@@ -737,7 +758,7 @@ ctx.matrix.on("Room.timeline", (event) => {
|
||||
});
|
||||
|
||||
// Sync state
|
||||
ctx.matrix.on("sync", (state, prevState) => {
|
||||
ctx.matrix.on('sync', (state, prevState) => {
|
||||
ctx.log('Sync state:', state);
|
||||
});
|
||||
```
|
||||
@@ -749,10 +770,10 @@ const handler = (event) => {
|
||||
ctx.log('Event received');
|
||||
};
|
||||
|
||||
ctx.matrix.on("m.room.message", handler);
|
||||
ctx.matrix.on('m.room.message', handler);
|
||||
|
||||
// Later...
|
||||
ctx.matrix.off("m.room.message", handler);
|
||||
ctx.matrix.off('m.room.message', handler);
|
||||
```
|
||||
|
||||
#### API Reference
|
||||
@@ -765,6 +786,7 @@ interface MatrixEventsAPI {
|
||||
```
|
||||
|
||||
**Common Event Types:**
|
||||
|
||||
- `m.room.message` - Room messages
|
||||
- `m.room.member` - Membership changes
|
||||
- `m.room.name` - Room name changes
|
||||
@@ -784,11 +806,11 @@ Run periodic tasks or delayed actions.
|
||||
// Run every 30 seconds
|
||||
const intervalId = ctx.timers.setInterval(() => {
|
||||
ctx.log('Periodic task running');
|
||||
|
||||
|
||||
// Do something periodically
|
||||
const stats = {
|
||||
timestamp: Date.now(),
|
||||
setting: ctx.settings.get('theme')
|
||||
setting: ctx.settings.get('theme'),
|
||||
};
|
||||
ctx.log('Stats:', stats);
|
||||
}, 30000);
|
||||
@@ -805,9 +827,9 @@ const timeoutId = ctx.timers.setTimeout(() => {
|
||||
ctx.notify({
|
||||
title: 'Reminder',
|
||||
body: 'This is a delayed notification',
|
||||
type: 'info'
|
||||
type: 'info',
|
||||
});
|
||||
}, 10000); // 10 seconds
|
||||
}, 10000); // 10 seconds
|
||||
|
||||
// Clear timeout
|
||||
ctx.timers.clearTimeout(timeoutId);
|
||||
@@ -844,8 +866,8 @@ ctx.notify('Hello, world!');
|
||||
ctx.notify({
|
||||
title: 'Plugin Alert',
|
||||
body: 'Something important happened!',
|
||||
type: 'info', // 'info' | 'success' | 'error' | 'warning'
|
||||
duration: 5000 // milliseconds (optional)
|
||||
type: 'info', // 'info' | 'success' | 'error' | 'warning'
|
||||
duration: 5000, // milliseconds (optional)
|
||||
});
|
||||
```
|
||||
|
||||
@@ -856,30 +878,28 @@ ctx.notify({
|
||||
ctx.notify({
|
||||
title: 'Success',
|
||||
body: 'Operation completed successfully!',
|
||||
type: 'success'
|
||||
type: 'success',
|
||||
});
|
||||
|
||||
// Error notification
|
||||
ctx.notify({
|
||||
title: 'Error',
|
||||
body: 'Something went wrong',
|
||||
type: 'error'
|
||||
type: 'error',
|
||||
});
|
||||
|
||||
// Warning
|
||||
ctx.notify({
|
||||
title: 'Warning',
|
||||
body: 'This action cannot be undone',
|
||||
type: 'warning'
|
||||
type: 'warning',
|
||||
});
|
||||
```
|
||||
|
||||
#### API Reference
|
||||
|
||||
```typescript
|
||||
type NotificationFunction = (
|
||||
options: NotificationOptions | string
|
||||
) => void;
|
||||
type NotificationFunction = (options: NotificationOptions | string) => void;
|
||||
|
||||
interface NotificationOptions {
|
||||
title: string;
|
||||
@@ -916,13 +936,14 @@ ctx.error('Error details:', errorObject);
|
||||
type LogFunction = (...args: any[]) => void;
|
||||
|
||||
interface PluginContext {
|
||||
log: LogFunction; // Info level
|
||||
warn: LogFunction; // Warning level
|
||||
error: LogFunction; // Error level
|
||||
log: LogFunction; // Info level
|
||||
warn: LogFunction; // Warning level
|
||||
error: LogFunction; // Error level
|
||||
}
|
||||
```
|
||||
|
||||
**Note:** All logs are visible in:
|
||||
|
||||
- Browser console (F12)
|
||||
- Plugin logs panel (Settings → Plugins → Logs) - coming soon
|
||||
|
||||
@@ -937,21 +958,21 @@ Export functions and data for other plugins to use.
|
||||
```javascript
|
||||
module.exports = {
|
||||
// ... onLoad, onUnload ...
|
||||
|
||||
|
||||
exports: {
|
||||
version: "1.0.0",
|
||||
|
||||
version: '1.0.0',
|
||||
|
||||
utils: {
|
||||
greet: (name) => `Hello, ${name}!`,
|
||||
|
||||
|
||||
processText: (text) => text.toUpperCase(),
|
||||
|
||||
|
||||
getStats: () => ({
|
||||
version: "1.0.0",
|
||||
features: ['commands', 'settings']
|
||||
})
|
||||
}
|
||||
}
|
||||
version: '1.0.0',
|
||||
features: ['commands', 'settings'],
|
||||
}),
|
||||
},
|
||||
},
|
||||
};
|
||||
```
|
||||
|
||||
@@ -963,11 +984,11 @@ const otherPlugin = ctx.require('other-plugin-id');
|
||||
|
||||
if (otherPlugin) {
|
||||
const greeting = otherPlugin.utils.greet('World');
|
||||
ctx.log(greeting); // "Hello, World!"
|
||||
|
||||
ctx.log(greeting); // "Hello, World!"
|
||||
|
||||
const processed = otherPlugin.utils.processText('hello');
|
||||
ctx.log(processed); // "HELLO"
|
||||
|
||||
ctx.log(processed); // "HELLO"
|
||||
|
||||
const stats = otherPlugin.utils.getStats();
|
||||
ctx.log('Stats:', stats);
|
||||
}
|
||||
@@ -1018,7 +1039,7 @@ ctx.log('Sync state:', syncState);
|
||||
// Send custom event
|
||||
await ctx.matrixClient.sendEvent(roomId, 'm.room.message', {
|
||||
msgtype: 'm.text',
|
||||
body: 'Hello from plugin!'
|
||||
body: 'Hello from plugin!',
|
||||
});
|
||||
```
|
||||
|
||||
@@ -1026,7 +1047,7 @@ await ctx.matrixClient.sendEvent(roomId, 'm.room.message', {
|
||||
|
||||
```typescript
|
||||
interface PluginContext {
|
||||
matrixClient: MatrixClient; // Full Matrix.js SDK client
|
||||
matrixClient: MatrixClient; // Full Matrix.js SDK client
|
||||
}
|
||||
```
|
||||
|
||||
@@ -1043,122 +1064,122 @@ Here's a complete plugin that demonstrates all features:
|
||||
* Example Plugin - All Features
|
||||
*/
|
||||
module.exports = {
|
||||
name: "Example Plugin",
|
||||
version: "1.0.0",
|
||||
name: 'Example Plugin',
|
||||
version: '1.0.0',
|
||||
dependencies: {},
|
||||
|
||||
|
||||
onLoad: async (ctx) => {
|
||||
ctx.log('🚀 Plugin loading...');
|
||||
|
||||
|
||||
// === COMMANDS ===
|
||||
ctx.commands.register({
|
||||
name: "hello",
|
||||
description: "Say hello",
|
||||
run: () => "Hello, world!"
|
||||
name: 'hello',
|
||||
description: 'Say hello',
|
||||
run: () => 'Hello, world!',
|
||||
});
|
||||
|
||||
|
||||
ctx.commands.register({
|
||||
name: "greet",
|
||||
description: "Greet someone",
|
||||
args: ["name"],
|
||||
run: ({ name }) => `Hello, ${name}!`
|
||||
name: 'greet',
|
||||
description: 'Greet someone',
|
||||
args: ['name'],
|
||||
run: ({ name }) => `Hello, ${name}!`,
|
||||
});
|
||||
|
||||
|
||||
// === INTERCEPTORS ===
|
||||
ctx.messages.onBeforeSend((msg) => {
|
||||
// Auto-expand abbreviations
|
||||
msg.content = msg.content.replace(/\bbrb\b/gi, 'be right back');
|
||||
|
||||
|
||||
// Add emoji if enabled
|
||||
if (ctx.settings.get('addEmoji')) {
|
||||
msg.content += ' ✨';
|
||||
}
|
||||
});
|
||||
|
||||
|
||||
ctx.messages.onReceive((msg) => {
|
||||
// Track keywords
|
||||
const keywords = ctx.settings.get('keywords') || '';
|
||||
keywords.split(',').forEach(keyword => {
|
||||
keywords.split(',').forEach((keyword) => {
|
||||
if (msg.content.includes(keyword.trim())) {
|
||||
ctx.notify(`Keyword detected: ${keyword}`);
|
||||
}
|
||||
});
|
||||
});
|
||||
|
||||
|
||||
// === SETTINGS ===
|
||||
ctx.settings.define({
|
||||
addEmoji: {
|
||||
type: "boolean",
|
||||
label: "Add Emoji",
|
||||
description: "Add sparkles to messages",
|
||||
default: false
|
||||
type: 'boolean',
|
||||
label: 'Add Emoji',
|
||||
description: 'Add sparkles to messages',
|
||||
default: false,
|
||||
},
|
||||
keywords: {
|
||||
type: "string",
|
||||
label: "Track Keywords",
|
||||
description: "Comma-separated keywords to track",
|
||||
default: "important,urgent"
|
||||
type: 'string',
|
||||
label: 'Track Keywords',
|
||||
description: 'Comma-separated keywords to track',
|
||||
default: 'important,urgent',
|
||||
},
|
||||
theme: {
|
||||
type: "select",
|
||||
label: "Theme",
|
||||
type: 'select',
|
||||
label: 'Theme',
|
||||
options: [
|
||||
{ value: "light", label: "Light" },
|
||||
{ value: "dark", label: "Dark" }
|
||||
{ value: 'light', label: 'Light' },
|
||||
{ value: 'dark', label: 'Dark' },
|
||||
],
|
||||
default: "dark"
|
||||
}
|
||||
default: 'dark',
|
||||
},
|
||||
});
|
||||
|
||||
|
||||
// === THEMES ===
|
||||
ctx.themes.register({
|
||||
id: "example-theme",
|
||||
name: "Example Theme",
|
||||
kind: "dark",
|
||||
id: 'example-theme',
|
||||
name: 'Example Theme',
|
||||
kind: 'dark',
|
||||
colors: {
|
||||
background: "#1a1a2e",
|
||||
surface: "#16213e",
|
||||
primary: "#0f3460",
|
||||
secondary: "#533483",
|
||||
onBackground: "#ffffff",
|
||||
onSurface: "#e0e0e0"
|
||||
}
|
||||
background: '#1a1a2e',
|
||||
surface: '#16213e',
|
||||
primary: '#0f3460',
|
||||
secondary: '#533483',
|
||||
onBackground: '#ffffff',
|
||||
onSurface: '#e0e0e0',
|
||||
},
|
||||
});
|
||||
|
||||
|
||||
// === MATRIX EVENTS ===
|
||||
ctx.matrix.on("m.room.message", (event) => {
|
||||
ctx.matrix.on('m.room.message', (event) => {
|
||||
const content = event.getContent();
|
||||
if (content.body?.includes('example')) {
|
||||
ctx.log('Keyword found in message');
|
||||
}
|
||||
});
|
||||
|
||||
|
||||
// === BACKGROUND TASKS ===
|
||||
ctx.timers.setInterval(() => {
|
||||
ctx.log('Periodic check');
|
||||
}, 60000); // Every minute
|
||||
|
||||
}, 60000); // Every minute
|
||||
|
||||
// === NOTIFICATIONS ===
|
||||
ctx.notify({
|
||||
title: 'Example Plugin',
|
||||
body: 'Plugin loaded successfully!',
|
||||
type: 'success'
|
||||
type: 'success',
|
||||
});
|
||||
|
||||
|
||||
// === EXPORTS ===
|
||||
this.exports = {
|
||||
version: "1.0.0",
|
||||
greet: (name) => `Hello, ${name}!`
|
||||
version: '1.0.0',
|
||||
greet: (name) => `Hello, ${name}!`,
|
||||
};
|
||||
|
||||
|
||||
ctx.log('✅ Plugin loaded');
|
||||
},
|
||||
|
||||
|
||||
onUnload: async () => {
|
||||
console.log('Plugin unloaded');
|
||||
},
|
||||
|
||||
exports: null
|
||||
|
||||
exports: null,
|
||||
};
|
||||
```
|
||||
|
||||
@@ -1179,10 +1200,10 @@ onLoad: async (ctx) => {
|
||||
ctx.notify({
|
||||
title: 'Plugin Error',
|
||||
body: error.message,
|
||||
type: 'error'
|
||||
type: 'error',
|
||||
});
|
||||
}
|
||||
}
|
||||
};
|
||||
```
|
||||
|
||||
### Cleanup
|
||||
@@ -1194,9 +1215,9 @@ onUnload: async () => {
|
||||
// Timers are auto-cleared
|
||||
// Event handlers are auto-removed
|
||||
// Settings are persisted automatically
|
||||
|
||||
|
||||
console.log('Plugin unloaded');
|
||||
}
|
||||
};
|
||||
```
|
||||
|
||||
### Settings Validation
|
||||
@@ -1205,7 +1226,7 @@ Validate settings before use:
|
||||
|
||||
```javascript
|
||||
const maxRetries = ctx.settings.get('maxRetries') || 3;
|
||||
const keywords = (ctx.settings.get('keywords') || '').split(',').filter(k => k.trim());
|
||||
const keywords = (ctx.settings.get('keywords') || '').split(',').filter((k) => k.trim());
|
||||
```
|
||||
|
||||
### Logging
|
||||
@@ -1213,9 +1234,9 @@ const keywords = (ctx.settings.get('keywords') || '').split(',').filter(k => k.t
|
||||
Use appropriate log levels:
|
||||
|
||||
```javascript
|
||||
ctx.log('Info message'); // Normal operation
|
||||
ctx.warn('Warning message'); // Potential issues
|
||||
ctx.error('Error message'); // Actual errors
|
||||
ctx.log('Info message'); // Normal operation
|
||||
ctx.warn('Warning message'); // Potential issues
|
||||
ctx.error('Error message'); // Actual errors
|
||||
```
|
||||
|
||||
### Performance
|
||||
|
||||
+64
-65
@@ -15,26 +15,26 @@ Buttons render in two visual styles depending on location — **nav list rows**
|
||||
|
||||
These render as full-width list entries matching the style of built-in items like "Create Room" and "Message Search":
|
||||
|
||||
| Location | Where it appears |
|
||||
|---|---|
|
||||
| `channel-list` | Space channel list, below Lobby and Message Search |
|
||||
| `home-section` | Home panel, inside the Rooms category above the room list |
|
||||
| Location | Where it appears |
|
||||
| ----------------- | ----------------------------------------------------------------------- |
|
||||
| `channel-list` | Space channel list, below Lobby and Message Search |
|
||||
| `home-section` | Home panel, inside the Rooms category above the room list |
|
||||
| `direct-messages` | Direct Messages panel, below "Create Chat" and above the CHATS dropdown |
|
||||
|
||||
### Icon Buttons
|
||||
|
||||
These render as compact icon buttons inline with other toolbar/header controls:
|
||||
|
||||
| Location | Where it appears |
|
||||
|---|---|
|
||||
| `text-composer-toolbar` | Message composer toolbar (alongside emoji, sticker buttons) |
|
||||
| `composer-actions` | Left side of the composer, beside the `+` attach button |
|
||||
| `room-header` | Top room header bar, before the ⋮ menu button |
|
||||
| `room-menu` | Room ⋮ dropdown menu |
|
||||
| `message-actions` | Message hover action bar |
|
||||
| `user-menu` | Right-click popup on the user avatar |
|
||||
| `search-notification-section` | Notifications page header (right side) |
|
||||
| `sidebar-actions` | Left sidebar — appears in **two** places: above the Explore Servers icon, and above the Search icon in the sticky bottom section |
|
||||
| Location | Where it appears |
|
||||
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `text-composer-toolbar` | Message composer toolbar (alongside emoji, sticker buttons) |
|
||||
| `composer-actions` | Left side of the composer, beside the `+` attach button |
|
||||
| `room-header` | Top room header bar, before the ⋮ menu button |
|
||||
| `room-menu` | Room ⋮ dropdown menu |
|
||||
| `message-actions` | Message hover action bar |
|
||||
| `user-menu` | Right-click popup on the user avatar |
|
||||
| `search-notification-section` | Notifications page header (right side) |
|
||||
| `sidebar-actions` | Left sidebar — appears in **two** places: above the Explore Servers icon, and above the Search icon in the sticky bottom section |
|
||||
|
||||
> 💡 **Tip:** Install the [example-showcase-plugin](example-showcase-plugin/) to see exactly where each location appears in the UI!
|
||||
|
||||
@@ -46,7 +46,7 @@ These render as compact icon buttons inline with other toolbar/header controls:
|
||||
module.exports = {
|
||||
name: 'my-plugin',
|
||||
version: '1.0.0',
|
||||
|
||||
|
||||
onLoad: (context) => {
|
||||
context.ui.registerButton({
|
||||
id: 'my-button',
|
||||
@@ -55,13 +55,13 @@ module.exports = {
|
||||
icon: '🎨',
|
||||
onClick: () => {
|
||||
context.log('Button clicked!');
|
||||
}
|
||||
},
|
||||
});
|
||||
},
|
||||
|
||||
|
||||
onUnload: () => {
|
||||
// Buttons are automatically cleaned up on plugin unload
|
||||
}
|
||||
},
|
||||
};
|
||||
```
|
||||
|
||||
@@ -80,8 +80,8 @@ context.ui.registerButton({
|
||||
position: {
|
||||
before: 'emoji-picker-button', // Place before emoji picker
|
||||
// OR
|
||||
after: 'sticker-button' // Place after sticker button
|
||||
}
|
||||
after: 'sticker-button', // Place after sticker button
|
||||
},
|
||||
});
|
||||
```
|
||||
|
||||
@@ -97,8 +97,8 @@ context.ui.registerButton({
|
||||
icon: '1️⃣',
|
||||
position: {
|
||||
group: 'my-plugin-tools',
|
||||
order: 1 // Lower numbers appear first
|
||||
}
|
||||
order: 1, // Lower numbers appear first
|
||||
},
|
||||
});
|
||||
|
||||
context.ui.registerButton({
|
||||
@@ -108,8 +108,8 @@ context.ui.registerButton({
|
||||
icon: '2️⃣',
|
||||
position: {
|
||||
group: 'my-plugin-tools',
|
||||
order: 2
|
||||
}
|
||||
order: 2,
|
||||
},
|
||||
});
|
||||
```
|
||||
|
||||
@@ -126,8 +126,8 @@ context.ui.registerButton({
|
||||
position: {
|
||||
group: 'my-tools',
|
||||
after: 'emoji-picker-button',
|
||||
order: 1
|
||||
}
|
||||
order: 1,
|
||||
},
|
||||
});
|
||||
|
||||
context.ui.registerButton({
|
||||
@@ -137,8 +137,8 @@ context.ui.registerButton({
|
||||
icon: '🔨',
|
||||
position: {
|
||||
group: 'my-tools',
|
||||
order: 2
|
||||
}
|
||||
order: 2,
|
||||
},
|
||||
});
|
||||
```
|
||||
|
||||
@@ -148,7 +148,7 @@ context.ui.registerButton({
|
||||
module.exports = {
|
||||
name: 'custom-tools',
|
||||
version: '1.0.0',
|
||||
|
||||
|
||||
onLoad: (context) => {
|
||||
// Nav list row — appears below "Create Chat" in the DMs panel
|
||||
context.ui.registerButton({
|
||||
@@ -156,7 +156,7 @@ module.exports = {
|
||||
location: 'direct-messages',
|
||||
label: 'Favourites',
|
||||
icon: '⭐',
|
||||
onClick: () => context.log('Favourites clicked!')
|
||||
onClick: () => context.log('Favourites clicked!'),
|
||||
});
|
||||
|
||||
// Nav list row — appears in the space channel list
|
||||
@@ -165,7 +165,7 @@ module.exports = {
|
||||
location: 'channel-list',
|
||||
label: 'Quick Access',
|
||||
icon: '⚡',
|
||||
onClick: () => context.log('Quick access clicked!')
|
||||
onClick: () => context.log('Quick access clicked!'),
|
||||
});
|
||||
|
||||
// Icon button — appears in the message composer toolbar
|
||||
@@ -176,9 +176,9 @@ module.exports = {
|
||||
icon: '𝐁',
|
||||
position: {
|
||||
group: 'custom-formatting',
|
||||
order: 1
|
||||
order: 1,
|
||||
},
|
||||
onClick: () => context.log('Bold clicked!')
|
||||
onClick: () => context.log('Bold clicked!'),
|
||||
});
|
||||
|
||||
// Icon button — appears in the room header
|
||||
@@ -188,7 +188,7 @@ module.exports = {
|
||||
label: 'Special Search',
|
||||
icon: '🔍',
|
||||
position: { after: 'search-button' },
|
||||
onClick: () => context.log('Special search clicked!')
|
||||
onClick: () => context.log('Special search clicked!'),
|
||||
});
|
||||
|
||||
// Sidebar icon — appears above Explore and above Search
|
||||
@@ -197,13 +197,13 @@ module.exports = {
|
||||
location: 'sidebar-actions',
|
||||
label: 'Plugin Panel',
|
||||
icon: '🧩',
|
||||
onClick: () => context.log('Plugin panel clicked!')
|
||||
onClick: () => context.log('Plugin panel clicked!'),
|
||||
});
|
||||
},
|
||||
|
||||
|
||||
onUnload: () => {
|
||||
// All registered buttons are automatically cleaned up
|
||||
}
|
||||
},
|
||||
};
|
||||
```
|
||||
|
||||
@@ -228,13 +228,12 @@ const button: UIButtonDefinition = {
|
||||
position: {
|
||||
group: 'my-tools',
|
||||
after: 'emoji-picker',
|
||||
order: 1
|
||||
order: 1,
|
||||
},
|
||||
onClick: () => console.log('Clicked!')
|
||||
onClick: () => console.log('Clicked!'),
|
||||
};
|
||||
```
|
||||
|
||||
|
||||
## Basic Usage
|
||||
|
||||
### Simple Button
|
||||
@@ -243,7 +242,7 @@ const button: UIButtonDefinition = {
|
||||
module.exports = {
|
||||
name: 'my-plugin',
|
||||
version: '1.0.0',
|
||||
|
||||
|
||||
onLoad: (context) => {
|
||||
context.ui.registerButton({
|
||||
id: 'my-button',
|
||||
@@ -252,13 +251,13 @@ module.exports = {
|
||||
icon: '🎨',
|
||||
onClick: () => {
|
||||
context.log('Button clicked!');
|
||||
}
|
||||
},
|
||||
});
|
||||
},
|
||||
|
||||
|
||||
onUnload: () => {
|
||||
// Buttons are automatically cleaned up on plugin unload
|
||||
}
|
||||
},
|
||||
};
|
||||
```
|
||||
|
||||
@@ -277,8 +276,8 @@ context.ui.registerButton({
|
||||
position: {
|
||||
before: 'emoji-picker-button', // Place before emoji picker
|
||||
// OR
|
||||
after: 'sticker-button' // Place after sticker button
|
||||
}
|
||||
after: 'sticker-button', // Place after sticker button
|
||||
},
|
||||
});
|
||||
```
|
||||
|
||||
@@ -294,8 +293,8 @@ context.ui.registerButton({
|
||||
icon: '1️⃣',
|
||||
position: {
|
||||
group: 'my-plugin-tools',
|
||||
order: 1 // Lower numbers appear first
|
||||
}
|
||||
order: 1, // Lower numbers appear first
|
||||
},
|
||||
});
|
||||
|
||||
context.ui.registerButton({
|
||||
@@ -305,8 +304,8 @@ context.ui.registerButton({
|
||||
icon: '2️⃣',
|
||||
position: {
|
||||
group: 'my-plugin-tools',
|
||||
order: 2
|
||||
}
|
||||
order: 2,
|
||||
},
|
||||
});
|
||||
```
|
||||
|
||||
@@ -323,8 +322,8 @@ context.ui.registerButton({
|
||||
position: {
|
||||
group: 'my-tools',
|
||||
after: 'emoji-picker-button',
|
||||
order: 1
|
||||
}
|
||||
order: 1,
|
||||
},
|
||||
});
|
||||
|
||||
context.ui.registerButton({
|
||||
@@ -334,8 +333,8 @@ context.ui.registerButton({
|
||||
icon: '🔨',
|
||||
position: {
|
||||
group: 'my-tools',
|
||||
order: 2
|
||||
}
|
||||
order: 2,
|
||||
},
|
||||
});
|
||||
```
|
||||
|
||||
@@ -345,7 +344,7 @@ context.ui.registerButton({
|
||||
module.exports = {
|
||||
name: 'custom-tools',
|
||||
version: '1.0.0',
|
||||
|
||||
|
||||
onLoad: (context) => {
|
||||
// Nav list row — appears below "Create Chat" in the DMs panel
|
||||
context.ui.registerButton({
|
||||
@@ -353,7 +352,7 @@ module.exports = {
|
||||
location: 'direct-messages',
|
||||
label: 'Favourites',
|
||||
icon: '⭐',
|
||||
onClick: () => context.log('Favourites clicked!')
|
||||
onClick: () => context.log('Favourites clicked!'),
|
||||
});
|
||||
|
||||
// Nav list row — appears in the space channel list
|
||||
@@ -362,7 +361,7 @@ module.exports = {
|
||||
location: 'channel-list',
|
||||
label: 'Quick Access',
|
||||
icon: '⚡',
|
||||
onClick: () => context.log('Quick access clicked!')
|
||||
onClick: () => context.log('Quick access clicked!'),
|
||||
});
|
||||
|
||||
// Icon button — appears in the message composer toolbar
|
||||
@@ -373,9 +372,9 @@ module.exports = {
|
||||
icon: '𝐁',
|
||||
position: {
|
||||
group: 'custom-formatting',
|
||||
order: 1
|
||||
order: 1,
|
||||
},
|
||||
onClick: () => context.log('Bold clicked!')
|
||||
onClick: () => context.log('Bold clicked!'),
|
||||
});
|
||||
|
||||
// Icon button — appears in the room header
|
||||
@@ -385,7 +384,7 @@ module.exports = {
|
||||
label: 'Special Search',
|
||||
icon: '🔍',
|
||||
position: { after: 'search-button' },
|
||||
onClick: () => context.log('Special search clicked!')
|
||||
onClick: () => context.log('Special search clicked!'),
|
||||
});
|
||||
|
||||
// Sidebar icon — appears above Explore and above Search
|
||||
@@ -394,13 +393,13 @@ module.exports = {
|
||||
location: 'sidebar-actions',
|
||||
label: 'Plugin Panel',
|
||||
icon: '🧩',
|
||||
onClick: () => context.log('Plugin panel clicked!')
|
||||
onClick: () => context.log('Plugin panel clicked!'),
|
||||
});
|
||||
},
|
||||
|
||||
|
||||
onUnload: () => {
|
||||
// All registered buttons are automatically cleaned up
|
||||
}
|
||||
},
|
||||
};
|
||||
```
|
||||
|
||||
@@ -425,8 +424,8 @@ const button: UIButtonDefinition = {
|
||||
position: {
|
||||
group: 'my-tools',
|
||||
after: 'emoji-picker',
|
||||
order: 1
|
||||
order: 1,
|
||||
},
|
||||
onClick: () => console.log('Clicked!')
|
||||
onClick: () => console.log('Clicked!'),
|
||||
};
|
||||
```
|
||||
|
||||
@@ -5,18 +5,21 @@ All requested features have been implemented! 🎉
|
||||
## ✅ Implemented Features
|
||||
|
||||
### 1. ✅ Enhanced Slash Commands
|
||||
|
||||
- **Simple commands**: `ctx.commands.register({ name: "shrug", run: () => "¯\\_(ツ)_/¯" })`
|
||||
- **Commands with args**: `ctx.commands.register({ name: "echo", args: ["text"], run: ({ text }) => text })`
|
||||
- Automatic argument parsing
|
||||
- Execution API: `ctx.commands.execute(name, args)`
|
||||
|
||||
### 2. ✅ Message Interceptors
|
||||
|
||||
- **Before send**: `ctx.messages.onBeforeSend((msg) => { msg.content = "modified" })`
|
||||
- **On receive**: `ctx.messages.onReceive((msg) => { /* process */ })`
|
||||
- Full MessageContext with content, roomId, metadata
|
||||
- Async support for interceptors
|
||||
|
||||
### 3. ✅ Custom Renderers & Button Registration
|
||||
|
||||
- **Register renderer**: `ctx.ui.registerRenderer("message", (msg, defaultRenderer) => { /* render */ })`
|
||||
- **Unregister renderer**: `ctx.ui.unregisterRenderer("message")`
|
||||
- **Register button**: `ctx.ui.registerButton({ id, location, label, icon, onClick })`
|
||||
@@ -29,6 +32,7 @@ All requested features have been implemented! 🎉
|
||||
- See [PLUGIN_BUTTON_API.md](PLUGIN_BUTTON_API.md) for full reference
|
||||
|
||||
### 4. ✅ Settings UI Per Plugin
|
||||
|
||||
- **Define schema**: `ctx.settings.define({ theme: { type: "select", options: [...] } })`
|
||||
- **Supported types**: string, number, boolean, select, color
|
||||
- **Get/Set**: `ctx.settings.get(key)` / `ctx.settings.set(key, value)`
|
||||
@@ -36,24 +40,28 @@ All requested features have been implemented! 🎉
|
||||
- No JSON editing needed!
|
||||
|
||||
### 5. ✅ Hot Reload
|
||||
|
||||
- **API**: `pluginRegistry.reloadPlugin(pluginId, newPlugin, newContext)`
|
||||
- Auto-cleanup of old plugin resources
|
||||
- Maintains enabled/disabled state
|
||||
- Dev-friendly workflow
|
||||
|
||||
### 6. ✅ Dependency System
|
||||
|
||||
- **Declare**: `dependencies: { "paarrot.core-utils": "^1.0.0" }`
|
||||
- **Require**: `const utils = ctx.require("paarrot.utils")`
|
||||
- Error handling for missing dependencies
|
||||
- Plugin exports system
|
||||
|
||||
### 7. ✅ Raw Matrix Events Hook
|
||||
|
||||
- **Full SDK access**: `ctx.matrix.on("m.room.message", (ev) => { })`
|
||||
- **Any event type**: Room.timeline, sync, RoomState.events, etc.
|
||||
- Direct Matrix.js SDK integration
|
||||
- Power users will go nuts!
|
||||
|
||||
### 8. ✅ Background Tasks / Intervals
|
||||
|
||||
- **Interval**: `ctx.timers.setInterval(() => { /* cursed shit */ }, 10000)`
|
||||
- **Timeout**: `ctx.timers.setTimeout(() => { }, 5000)`
|
||||
- **Clear**: `ctx.timers.clearInterval(id)` / `ctx.timers.clearTimeout(id)`
|
||||
@@ -61,12 +69,14 @@ All requested features have been implemented! 🎉
|
||||
- Perfect for bots, reminders, auto-cleanup
|
||||
|
||||
### 9. ✅ Notifications API
|
||||
|
||||
- **Simple**: `ctx.notify("Oi")`
|
||||
- **Advanced**: `ctx.notify({ title: "Oi", body: "New message from Steve", type: "info" })`
|
||||
- Action buttons support
|
||||
- Custom duration
|
||||
|
||||
### 10. ✅ Plugin Logs Panel
|
||||
|
||||
- **Logging**: `ctx.log()`, `ctx.warn()`, `ctx.error()`
|
||||
- Per-plugin log storage
|
||||
- Visible in `pluginRegistry.getLogs(pluginId)`
|
||||
@@ -85,16 +95,19 @@ All requested features have been implemented! 🎉
|
||||
## 📁 Files Changed
|
||||
|
||||
### Core System
|
||||
|
||||
- [`PluginAPI.ts`](cinny/src/app/features/settings/plugins/PluginAPI.ts) - Enhanced with all APIs
|
||||
- [`PluginLoader.tsx`](cinny/src/app/features/settings/plugins/PluginLoader.tsx) - Complete rewrite with context creation
|
||||
- [`index.ts`](cinny/src/app/features/settings/plugins/index.ts) - Exports updated
|
||||
|
||||
### Documentation
|
||||
|
||||
- [`PLUGIN_DEVELOPMENT.md`](cinny/src/app/features/settings/plugins/PLUGIN_DEVELOPMENT.md) - Comprehensive guide
|
||||
- [`PLUGINS.md`](PLUGINS.md) - User guide
|
||||
- [`example-plugin/index.js`](example-plugin/index.js) - Full-featured example
|
||||
|
||||
### Integration
|
||||
|
||||
- [`ClientRoot.tsx`](cinny/src/app/pages/client/ClientRoot.tsx) - PluginLoader integrated
|
||||
- [`main.js`](electron/main.js) - IPC handler for reading plugin code
|
||||
- [`preload.js`](electron/preload.js) - readPluginCode API exposed
|
||||
@@ -103,32 +116,36 @@ All requested features have been implemented! 🎉
|
||||
## 🚀 Usage Examples
|
||||
|
||||
### Command with Args
|
||||
|
||||
```javascript
|
||||
ctx.commands.register({
|
||||
name: "echo",
|
||||
args: ["text"],
|
||||
run: ({ text }) => text
|
||||
name: 'echo',
|
||||
args: ['text'],
|
||||
run: ({ text }) => text,
|
||||
});
|
||||
```
|
||||
|
||||
### Message Interceptor
|
||||
|
||||
```javascript
|
||||
ctx.messages.onBeforeSend((msg) => {
|
||||
if (msg.content === "brb") {
|
||||
msg.content = "be right back ya legend";
|
||||
if (msg.content === 'brb') {
|
||||
msg.content = 'be right back ya legend';
|
||||
}
|
||||
});
|
||||
```
|
||||
|
||||
### Custom Settings
|
||||
|
||||
```javascript
|
||||
ctx.settings.define({
|
||||
theme: { type: "select", options: ["dark", "light"] },
|
||||
spamFilter: { type: "boolean", default: true }
|
||||
theme: { type: 'select', options: ['dark', 'light'] },
|
||||
spamFilter: { type: 'boolean', default: true },
|
||||
});
|
||||
```
|
||||
|
||||
### Background Tasks
|
||||
|
||||
```javascript
|
||||
ctx.timers.setInterval(() => {
|
||||
// do cursed shit every 10s
|
||||
@@ -136,15 +153,17 @@ ctx.timers.setInterval(() => {
|
||||
```
|
||||
|
||||
### Raw Matrix Events
|
||||
|
||||
```javascript
|
||||
ctx.matrix.on("m.room.message", (ev) => {
|
||||
ctx.matrix.on('m.room.message', (ev) => {
|
||||
ctx.log('Message:', ev.getContent().body);
|
||||
});
|
||||
```
|
||||
|
||||
### Plugin Dependencies
|
||||
|
||||
```javascript
|
||||
const utils = ctx.require("paarrot.utils");
|
||||
const utils = ctx.require('paarrot.utils');
|
||||
utils.doSomething();
|
||||
```
|
||||
|
||||
@@ -155,43 +174,43 @@ interface PluginContext {
|
||||
pluginId: string;
|
||||
matrixClient: MatrixClient;
|
||||
React: typeof import('react');
|
||||
|
||||
|
||||
commands: {
|
||||
register: (command: PluginCommand) => void;
|
||||
unregister: (name: string) => void;
|
||||
execute: (name: string, args: Record<string, any>) => Promise<string | void>;
|
||||
};
|
||||
|
||||
|
||||
messages: {
|
||||
onBeforeSend: (interceptor: MessageInterceptor) => void;
|
||||
onReceive: (interceptor: MessageInterceptor) => void;
|
||||
};
|
||||
|
||||
|
||||
ui: {
|
||||
registerButton: (button: UIButtonDefinition) => void;
|
||||
unregisterButton: (id: string) => void;
|
||||
registerRenderer: (type: string, renderer: CustomRenderer) => void;
|
||||
unregisterRenderer: (type: string) => void;
|
||||
};
|
||||
|
||||
|
||||
settings: {
|
||||
define: (schema: SettingsSchema) => void;
|
||||
get: <T = any>(key: string) => T | undefined;
|
||||
set: (key: string, value: any) => void;
|
||||
};
|
||||
|
||||
|
||||
matrix: {
|
||||
on: (eventType: string, handler: (event: MatrixEvent) => void) => void;
|
||||
off: (eventType: string, handler: (event: MatrixEvent) => void) => void;
|
||||
};
|
||||
|
||||
|
||||
timers: {
|
||||
setInterval: (callback: () => void, ms: number) => number;
|
||||
setTimeout: (callback: () => void, ms: number) => number;
|
||||
clearInterval: (id: number) => void;
|
||||
clearTimeout: (id: number) => void;
|
||||
};
|
||||
|
||||
|
||||
notify: (options: NotificationOptions | string) => void;
|
||||
log: (...args: any[]) => void;
|
||||
warn: (...args: any[]) => void;
|
||||
|
||||
@@ -20,8 +20,8 @@
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| Path | Role |
|
||||
| -------------- | --------------------- |
|
||||
| `path/to/file` | <!-- what it does --> |
|
||||
|
||||
## Data model
|
||||
@@ -29,8 +29,8 @@
|
||||
<!-- Matrix state events, account data types, local storage keys. -->
|
||||
|
||||
| Key / event | Scope | Shape |
|
||||
|-------------|-------|-------|
|
||||
| | | |
|
||||
| ----------- | ----- | ----- |
|
||||
| | | |
|
||||
|
||||
## Dependencies
|
||||
|
||||
|
||||
@@ -25,14 +25,14 @@ tauri.ts → native notification APIs
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/capacitor.config.json` | Capacitor app id, web dir |
|
||||
| `src-tauri/src/main.rs` | Tauri Android entry |
|
||||
| `cinny/src/app/utils/tauri.ts` | Platform detection, notifications |
|
||||
| `cinny/src/app/utils/backgroundSync.ts` | UnifiedPush registration |
|
||||
| `cinny/src/app/utils/androidShare.ts` | Share target handling |
|
||||
| `cinny/src/app/pages/client/ClientNonUIFeatures.tsx` | Share listener wiring |
|
||||
| Path | Role |
|
||||
| ---------------------------------------------------- | --------------------------------- |
|
||||
| `cinny/capacitor.config.json` | Capacitor app id, web dir |
|
||||
| `src-tauri/src/main.rs` | Tauri Android entry |
|
||||
| `cinny/src/app/utils/tauri.ts` | Platform detection, notifications |
|
||||
| `cinny/src/app/utils/backgroundSync.ts` | UnifiedPush registration |
|
||||
| `cinny/src/app/utils/androidShare.ts` | Share target handling |
|
||||
| `cinny/src/app/pages/client/ClientNonUIFeatures.tsx` | Share listener wiring |
|
||||
|
||||
## Data model
|
||||
|
||||
|
||||
@@ -25,29 +25,29 @@ ClientRoot (authenticated)
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/app/pages/auth/login/Login.tsx` | Login hub |
|
||||
| `cinny/src/app/pages/auth/login/PasswordLoginForm.tsx` | Password login |
|
||||
| `cinny/src/app/pages/auth/login/TokenLogin.tsx` | Access token login |
|
||||
| `cinny/src/app/pages/auth/SSOLogin.tsx` | SSO redirect |
|
||||
| `cinny/src/app/pages/auth/register/Register.tsx` | Registration |
|
||||
| `cinny/src/app/pages/auth/register/PasswordRegisterForm.tsx` | Password register |
|
||||
| `cinny/src/app/pages/auth/reset-password/ResetPassword.tsx` | Password reset |
|
||||
| `cinny/src/app/pages/auth/ServerPicker.tsx` | Homeserver selection |
|
||||
| `cinny/src/app/pages/auth/AuthLayout.tsx` | Auth chrome + logo |
|
||||
| `cinny/src/app/pages/auth/login/loginUtil.ts` | Login helpers |
|
||||
| `cinny/src/app/pages/auth/register/registerUtil.ts` | Register helpers |
|
||||
| `cinny/src/app/state/sessions.ts` | Session storage |
|
||||
| `cinny/src/client/initMatrix.ts` | Client init from session |
|
||||
| `cinny/src/app/pages/afterLoginRedirectPath.ts` | Post-login redirect |
|
||||
| Path | Role |
|
||||
| ------------------------------------------------------------ | ------------------------ |
|
||||
| `cinny/src/app/pages/auth/login/Login.tsx` | Login hub |
|
||||
| `cinny/src/app/pages/auth/login/PasswordLoginForm.tsx` | Password login |
|
||||
| `cinny/src/app/pages/auth/login/TokenLogin.tsx` | Access token login |
|
||||
| `cinny/src/app/pages/auth/SSOLogin.tsx` | SSO redirect |
|
||||
| `cinny/src/app/pages/auth/register/Register.tsx` | Registration |
|
||||
| `cinny/src/app/pages/auth/register/PasswordRegisterForm.tsx` | Password register |
|
||||
| `cinny/src/app/pages/auth/reset-password/ResetPassword.tsx` | Password reset |
|
||||
| `cinny/src/app/pages/auth/ServerPicker.tsx` | Homeserver selection |
|
||||
| `cinny/src/app/pages/auth/AuthLayout.tsx` | Auth chrome + logo |
|
||||
| `cinny/src/app/pages/auth/login/loginUtil.ts` | Login helpers |
|
||||
| `cinny/src/app/pages/auth/register/registerUtil.ts` | Register helpers |
|
||||
| `cinny/src/app/state/sessions.ts` | Session storage |
|
||||
| `cinny/src/client/initMatrix.ts` | Client init from session |
|
||||
| `cinny/src/app/pages/afterLoginRedirectPath.ts` | Post-login redirect |
|
||||
|
||||
## Data model
|
||||
|
||||
| Key | Storage | Content |
|
||||
|-----|---------|---------|
|
||||
| Session store | localStorage | access token, user id, device id, hs url |
|
||||
| `setAfterLoginRedirectPath` | sessionStorage/memory | deep link target after login |
|
||||
| Key | Storage | Content |
|
||||
| --------------------------- | --------------------- | ---------------------------------------- |
|
||||
| Session store | localStorage | access token, user id, device id, hs url |
|
||||
| `setAfterLoginRedirectPath` | sessionStorage/memory | deep link target after login |
|
||||
|
||||
## Dependencies
|
||||
|
||||
|
||||
@@ -24,25 +24,25 @@ Other clients / Profile.tsx
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/app/utils/imageMetadata.ts` | Unified embed/extract API |
|
||||
| `cinny/src/app/utils/pngMetadata.ts` | PNG tEXt chunks |
|
||||
| `cinny/src/app/utils/jpegMetadata.ts` | JPEG XMP APP1 |
|
||||
| `cinny/src/app/utils/webpMetadata.ts` | WebP XMP |
|
||||
| `cinny/src/app/utils/gifMetadata.ts` | GIF application extension |
|
||||
| Path | Role |
|
||||
| ----------------------------------------------------- | ----------------------------- |
|
||||
| `cinny/src/app/utils/imageMetadata.ts` | Unified embed/extract API |
|
||||
| `cinny/src/app/utils/pngMetadata.ts` | PNG tEXt chunks |
|
||||
| `cinny/src/app/utils/jpegMetadata.ts` | JPEG XMP APP1 |
|
||||
| `cinny/src/app/utils/webpMetadata.ts` | WebP XMP |
|
||||
| `cinny/src/app/utils/gifMetadata.ts` | GIF application extension |
|
||||
| `cinny/src/app/features/settings/account/Profile.tsx` | Settings UI + upload pipeline |
|
||||
|
||||
## Data model
|
||||
|
||||
Metadata keys (embedded in binary image, not Matrix):
|
||||
|
||||
| Key | Format | Notes |
|
||||
|-----|--------|-------|
|
||||
| `paarrot:color` | All | Accent color hex |
|
||||
| `paarrot:banner` | PNG (+ unified API) | Banner image URL |
|
||||
| `paarrot:borderColor` | PNG | Border accent |
|
||||
| `paarrot:gradient` | PNG | Gradient spec |
|
||||
| Key | Format | Notes |
|
||||
| --------------------- | ------------------- | ---------------- |
|
||||
| `paarrot:color` | All | Accent color hex |
|
||||
| `paarrot:banner` | PNG (+ unified API) | Banner image URL |
|
||||
| `paarrot:borderColor` | PNG | Border accent |
|
||||
| `paarrot:gradient` | PNG | Gradient spec |
|
||||
|
||||
XMP namespace: `http://paarrot.app/ns/1.0/`
|
||||
|
||||
|
||||
@@ -27,22 +27,22 @@ tauri.ts / electron main
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/app/pages/client/ClientNonUIFeatures.tsx` | Favicon, notifications, API init, background sync hooks |
|
||||
| `cinny/src/app/utils/backgroundSync.ts` | Pushers, UnifiedPush, foreground state |
|
||||
| `cinny/src/app/utils/tauri.ts` | Tauri/Capacitor notification helpers |
|
||||
| `cinny/src/app/features/settings/notifications/SystemNotification.tsx` | Permission UX |
|
||||
| `electron/main.js` | Tray, notification IPC (if applicable) |
|
||||
| `src-tauri/src/main.rs` | Tauri Android shell |
|
||||
| Path | Role |
|
||||
| ---------------------------------------------------------------------- | ------------------------------------------------------- |
|
||||
| `cinny/src/app/pages/client/ClientNonUIFeatures.tsx` | Favicon, notifications, API init, background sync hooks |
|
||||
| `cinny/src/app/utils/backgroundSync.ts` | Pushers, UnifiedPush, foreground state |
|
||||
| `cinny/src/app/utils/tauri.ts` | Tauri/Capacitor notification helpers |
|
||||
| `cinny/src/app/features/settings/notifications/SystemNotification.tsx` | Permission UX |
|
||||
| `electron/main.js` | Tray, notification IPC (if applicable) |
|
||||
| `src-tauri/src/main.rs` | Tauri Android shell |
|
||||
|
||||
## Data model
|
||||
|
||||
| Key | Storage | Purpose |
|
||||
|-----|---------|---------|
|
||||
| `paarrot.unifiedpush.*` | localStorage prefix | UP endpoint state |
|
||||
| `com.paarrot.app.android` | Pusher app id base | Android pushers |
|
||||
| Matrix pusher | Homeserver | HTTP push gateway |
|
||||
| Key | Storage | Purpose |
|
||||
| ------------------------- | ------------------- | ----------------- |
|
||||
| `paarrot.unifiedpush.*` | localStorage prefix | UP endpoint state |
|
||||
| `com.paarrot.app.android` | Pusher app id base | Android pushers |
|
||||
| Matrix pusher | Homeserver | HTTP push gateway |
|
||||
|
||||
## Dependencies
|
||||
|
||||
|
||||
@@ -27,24 +27,24 @@ SpecVersions in ClientRoot
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/app/components/title-bar/TitleBar.tsx` | Desktop title bar |
|
||||
| `cinny/src/app/components/splash-screen/SplashScreen.tsx` | Splash |
|
||||
| `cinny/src/app/pages/client/WelcomePage.tsx` | Welcome / download links |
|
||||
| `cinny/src/app/components/account-switcher/AccountSwitcher.tsx` | Multi-account |
|
||||
| `cinny/src/app/components/update-notification/UpdateNotification.tsx` | Auto-update UI |
|
||||
| `cinny/src/app/pages/FeatureCheck.tsx` | Browser capability gate |
|
||||
| `cinny/src/app/pages/client/SpecVersions.tsx` | HS version warning |
|
||||
| `cinny/src/app/pages/client/SyncStatus.tsx` | Sync indicator |
|
||||
| `cinny/src/app/pages/ConfigConfig.tsx` | Config load error UI |
|
||||
| `cinny/src/app/components/ClientConfigLoader.tsx` | Load config.json |
|
||||
| Path | Role |
|
||||
| --------------------------------------------------------------------- | ------------------------ |
|
||||
| `cinny/src/app/components/title-bar/TitleBar.tsx` | Desktop title bar |
|
||||
| `cinny/src/app/components/splash-screen/SplashScreen.tsx` | Splash |
|
||||
| `cinny/src/app/pages/client/WelcomePage.tsx` | Welcome / download links |
|
||||
| `cinny/src/app/components/account-switcher/AccountSwitcher.tsx` | Multi-account |
|
||||
| `cinny/src/app/components/update-notification/UpdateNotification.tsx` | Auto-update UI |
|
||||
| `cinny/src/app/pages/FeatureCheck.tsx` | Browser capability gate |
|
||||
| `cinny/src/app/pages/client/SpecVersions.tsx` | HS version warning |
|
||||
| `cinny/src/app/pages/client/SyncStatus.tsx` | Sync indicator |
|
||||
| `cinny/src/app/pages/ConfigConfig.tsx` | Config load error UI |
|
||||
| `cinny/src/app/components/ClientConfigLoader.tsx` | Load config.json |
|
||||
|
||||
## Data model
|
||||
|
||||
| Key | Storage |
|
||||
|-----|---------|
|
||||
| Sessions | multi-account in sessions.ts |
|
||||
| Key | Storage |
|
||||
| -------------- | ---------------------------- |
|
||||
| Sessions | multi-account in sessions.ts |
|
||||
| electron-store | window bounds (main process) |
|
||||
|
||||
## Dependencies
|
||||
|
||||
@@ -26,15 +26,15 @@ Imported by room-settings and space-settings shells
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/app/features/common-settings/general/RoomProfile.tsx` | Name/topic/avatar |
|
||||
| `cinny/src/app/features/common-settings/general/RoomJoinRules.tsx` | Join rules |
|
||||
| `cinny/src/app/features/common-settings/general/RoomEncryption.tsx` | E2E toggle |
|
||||
| `cinny/src/app/features/common-settings/general/EmbedFilters.tsx` | Room-wide embed filters |
|
||||
| `cinny/src/app/features/common-settings/members/Members.tsx` | Member management |
|
||||
| `cinny/src/app/features/common-settings/permissions/PowersEditor.tsx` | Power levels |
|
||||
| `cinny/src/app/features/common-settings/developer-tools/` | Dev event tools |
|
||||
| Path | Role |
|
||||
| --------------------------------------------------------------------- | ----------------------- |
|
||||
| `cinny/src/app/features/common-settings/general/RoomProfile.tsx` | Name/topic/avatar |
|
||||
| `cinny/src/app/features/common-settings/general/RoomJoinRules.tsx` | Join rules |
|
||||
| `cinny/src/app/features/common-settings/general/RoomEncryption.tsx` | E2E toggle |
|
||||
| `cinny/src/app/features/common-settings/general/EmbedFilters.tsx` | Room-wide embed filters |
|
||||
| `cinny/src/app/features/common-settings/members/Members.tsx` | Member management |
|
||||
| `cinny/src/app/features/common-settings/permissions/PowersEditor.tsx` | Power levels |
|
||||
| `cinny/src/app/features/common-settings/developer-tools/` | Dev event tools |
|
||||
|
||||
## Data model
|
||||
|
||||
|
||||
@@ -26,18 +26,18 @@ State: createRoomModal.ts, createSpaceModal.ts
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/app/features/create-room/CreateRoomModal.tsx` | Room create + sub-room parent update |
|
||||
| `cinny/src/app/features/create-space/CreateSpaceModal.tsx` | Space create |
|
||||
| `cinny/src/app/features/create-chat/` | DM flows |
|
||||
| `cinny/src/app/features/add-existing/AddExisting.tsx` | Add to space |
|
||||
| `cinny/src/app/features/create-room/CreateRoom.tsx` | Standalone create page |
|
||||
| `cinny/src/app/features/create-space/CreateSpace.tsx` | Standalone space create |
|
||||
| `cinny/src/app/state/createRoomModal.ts` | Modal state + parent room id |
|
||||
| `cinny/src/app/state/createSpaceModal.ts` | Space modal state |
|
||||
| `cinny/src/app/pages/client/create/Create.tsx` | Create hub route |
|
||||
| `cinny/src/app/pages/client/home/CreateRoom.tsx` | Home create entry |
|
||||
| Path | Role |
|
||||
| ---------------------------------------------------------- | ------------------------------------ |
|
||||
| `cinny/src/app/features/create-room/CreateRoomModal.tsx` | Room create + sub-room parent update |
|
||||
| `cinny/src/app/features/create-space/CreateSpaceModal.tsx` | Space create |
|
||||
| `cinny/src/app/features/create-chat/` | DM flows |
|
||||
| `cinny/src/app/features/add-existing/AddExisting.tsx` | Add to space |
|
||||
| `cinny/src/app/features/create-room/CreateRoom.tsx` | Standalone create page |
|
||||
| `cinny/src/app/features/create-space/CreateSpace.tsx` | Standalone space create |
|
||||
| `cinny/src/app/state/createRoomModal.ts` | Modal state + parent room id |
|
||||
| `cinny/src/app/state/createSpaceModal.ts` | Space modal state |
|
||||
| `cinny/src/app/pages/client/create/Create.tsx` | Create hub route |
|
||||
| `cinny/src/app/pages/client/home/CreateRoom.tsx` | Home create entry |
|
||||
|
||||
## Data model
|
||||
|
||||
|
||||
@@ -23,23 +23,23 @@ settings emojis-stickers + common-settings emojis
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/app/plugins/custom-emoji/PackMetaReader.ts` | Read pack metadata |
|
||||
| `cinny/src/app/plugins/custom-emoji/PackImageReader.ts` | Single image |
|
||||
| `cinny/src/app/plugins/custom-emoji/PackImagesReader.ts` | Bulk images |
|
||||
| `cinny/src/app/plugins/custom-emoji/ImagePack.ts` | Pack model |
|
||||
| `cinny/src/app/plugins/custom-emoji/types.ts` | Types |
|
||||
| `cinny/src/app/plugins/emoji.ts` | Shortcode rendering |
|
||||
| `cinny/src/app/plugins/recent-emoji.ts` | Recent emoji helper |
|
||||
| `cinny/src/app/components/image-pack-view/ImagePackView.tsx` | Pack browser UI |
|
||||
| `cinny/src/app/hooks/useImagePackRooms.ts` | Rooms with packs |
|
||||
| Path | Role |
|
||||
| ------------------------------------------------------------ | ------------------- |
|
||||
| `cinny/src/app/plugins/custom-emoji/PackMetaReader.ts` | Read pack metadata |
|
||||
| `cinny/src/app/plugins/custom-emoji/PackImageReader.ts` | Single image |
|
||||
| `cinny/src/app/plugins/custom-emoji/PackImagesReader.ts` | Bulk images |
|
||||
| `cinny/src/app/plugins/custom-emoji/ImagePack.ts` | Pack model |
|
||||
| `cinny/src/app/plugins/custom-emoji/types.ts` | Types |
|
||||
| `cinny/src/app/plugins/emoji.ts` | Shortcode rendering |
|
||||
| `cinny/src/app/plugins/recent-emoji.ts` | Recent emoji helper |
|
||||
| `cinny/src/app/components/image-pack-view/ImagePackView.tsx` | Pack browser UI |
|
||||
| `cinny/src/app/hooks/useImagePackRooms.ts` | Rooms with packs |
|
||||
|
||||
## Data model
|
||||
|
||||
| Event | Purpose |
|
||||
|-------|---------|
|
||||
| `im.ponies.room_emotes` | Room emoji pack definition |
|
||||
| Event | Purpose |
|
||||
| ----------------------- | -------------------------------------- |
|
||||
| `im.ponies.room_emotes` | Room emoji pack definition |
|
||||
| Image pack account data | User/global packs (see emoji-stickers) |
|
||||
|
||||
## Dependencies
|
||||
|
||||
@@ -21,13 +21,13 @@ common-settings/developer-tools/
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/app/features/settings/developer-tools/DevelopTools.tsx` | User-level dev tools |
|
||||
| `cinny/src/app/features/settings/developer-tools/AccountData.tsx` | Account data viewer |
|
||||
| `cinny/src/app/features/common-settings/developer-tools/DevelopTools.tsx` | Room dev tools entry |
|
||||
| `cinny/src/app/features/common-settings/developer-tools/StateEventEditor.tsx` | Edit state events |
|
||||
| `cinny/src/app/features/common-settings/developer-tools/SendRoomEvent.tsx` | Send events |
|
||||
| Path | Role |
|
||||
| ----------------------------------------------------------------------------- | -------------------- |
|
||||
| `cinny/src/app/features/settings/developer-tools/DevelopTools.tsx` | User-level dev tools |
|
||||
| `cinny/src/app/features/settings/developer-tools/AccountData.tsx` | Account data viewer |
|
||||
| `cinny/src/app/features/common-settings/developer-tools/DevelopTools.tsx` | Room dev tools entry |
|
||||
| `cinny/src/app/features/common-settings/developer-tools/StateEventEditor.tsx` | Edit state events |
|
||||
| `cinny/src/app/features/common-settings/developer-tools/SendRoomEvent.tsx` | Send events |
|
||||
|
||||
## Data model
|
||||
|
||||
|
||||
@@ -24,19 +24,19 @@ mDirectAtom — direct room index
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/app/pages/client/direct/Direct.tsx` | DM list |
|
||||
| `cinny/src/app/pages/client/direct/DirectCreate.tsx` | Create DM |
|
||||
| `cinny/src/app/pages/client/direct/useDirectRooms.ts` | List logic |
|
||||
| `cinny/src/app/pages/client/sidebar/DirectTab.tsx` | Sidebar tab |
|
||||
| `cinny/src/app/state/mDirectList.ts` | `mDirectAtom` |
|
||||
| `cinny/src/app/hooks/useDirectUsers.ts` | DM user helpers |
|
||||
| Path | Role |
|
||||
| ----------------------------------------------------- | --------------- |
|
||||
| `cinny/src/app/pages/client/direct/Direct.tsx` | DM list |
|
||||
| `cinny/src/app/pages/client/direct/DirectCreate.tsx` | Create DM |
|
||||
| `cinny/src/app/pages/client/direct/useDirectRooms.ts` | List logic |
|
||||
| `cinny/src/app/pages/client/sidebar/DirectTab.tsx` | Sidebar tab |
|
||||
| `cinny/src/app/state/mDirectList.ts` | `mDirectAtom` |
|
||||
| `cinny/src/app/hooks/useDirectUsers.ts` | DM user helpers |
|
||||
|
||||
## Data model
|
||||
|
||||
| Key | Scope |
|
||||
|-----|-------|
|
||||
| Key | Scope |
|
||||
| ---------- | ------------------------------------------ |
|
||||
| `m.direct` | User account data — map userId → roomIds[] |
|
||||
|
||||
## Dependencies
|
||||
|
||||
@@ -24,26 +24,26 @@ useSecretStorage, useKeyBackup, useVerificationRequest hooks
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/client/secretStorageKeys.ts` | SSSS key handling |
|
||||
| `cinny/src/app/features/settings/devices/Devices.tsx` | Device list |
|
||||
| `cinny/src/app/features/settings/devices/Verification.tsx` | Verification UI |
|
||||
| `cinny/src/app/features/settings/devices/LocalBackup.tsx` | Key export |
|
||||
| `cinny/src/app/features/settings/devices/OtherDevices.tsx` | Remote sessions |
|
||||
| `cinny/src/app/components/DeviceVerification.tsx` | Incoming verify modal |
|
||||
| `cinny/src/app/components/BackupRestore.tsx` | Auto restore |
|
||||
| `cinny/src/app/components/SecretStorage.tsx` | Passphrase setup |
|
||||
| `cinny/src/app/hooks/useSecretStorage.ts` | Secret storage API |
|
||||
| `cinny/src/app/hooks/useKeyBackup.ts` | Backup API |
|
||||
| `cinny/src/app/pages/client/sidebar/UnverifiedTab.tsx` | Unverified badge |
|
||||
| Path | Role |
|
||||
| ---------------------------------------------------------- | --------------------- |
|
||||
| `cinny/src/client/secretStorageKeys.ts` | SSSS key handling |
|
||||
| `cinny/src/app/features/settings/devices/Devices.tsx` | Device list |
|
||||
| `cinny/src/app/features/settings/devices/Verification.tsx` | Verification UI |
|
||||
| `cinny/src/app/features/settings/devices/LocalBackup.tsx` | Key export |
|
||||
| `cinny/src/app/features/settings/devices/OtherDevices.tsx` | Remote sessions |
|
||||
| `cinny/src/app/components/DeviceVerification.tsx` | Incoming verify modal |
|
||||
| `cinny/src/app/components/BackupRestore.tsx` | Auto restore |
|
||||
| `cinny/src/app/components/SecretStorage.tsx` | Passphrase setup |
|
||||
| `cinny/src/app/hooks/useSecretStorage.ts` | Secret storage API |
|
||||
| `cinny/src/app/hooks/useKeyBackup.ts` | Backup API |
|
||||
| `cinny/src/app/pages/client/sidebar/UnverifiedTab.tsx` | Unverified badge |
|
||||
|
||||
## Data model
|
||||
|
||||
| Store | Purpose |
|
||||
|-------|---------|
|
||||
| IndexedDB crypto | Olm account, Megolm sessions |
|
||||
| SSSS | Cross-signing keys, backup key |
|
||||
| Store | Purpose |
|
||||
| ------------------- | ----------------------------------------- |
|
||||
| IndexedDB crypto | Olm account, Megolm sessions |
|
||||
| SSSS | Cross-signing keys, backup key |
|
||||
| Matrix account data | `m.cross_signing.*`, `m.secret_storage.*` |
|
||||
|
||||
## Dependencies
|
||||
|
||||
@@ -25,25 +25,25 @@ text-area plugin (legacy/plain areas in some UI)
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/app/components/editor/Editor.tsx` | Main Slate editor |
|
||||
| `cinny/src/app/components/editor/Toolbar.tsx` | Formatting toolbar |
|
||||
| `cinny/src/app/components/editor/input.ts` | Parse into editor |
|
||||
| `cinny/src/app/components/editor/output.ts` | Serialize to Matrix |
|
||||
| `cinny/src/app/components/editor/autocomplete/` | Mention/emoji menus |
|
||||
| `cinny/src/app/features/room/RoomInput.tsx` | Room composer wrapper |
|
||||
| `cinny/src/app/plugins/text-area/` | Plain text area utilities |
|
||||
| `cinny/src/app/hooks/useFilePasteHandler.ts` | Paste files |
|
||||
| `cinny/src/app/hooks/useFileDrop.ts` | Drag-drop files |
|
||||
| `cinny/src/app/state/room/roomInputDrafts.ts` | Draft persistence |
|
||||
| Path | Role |
|
||||
| ----------------------------------------------- | ------------------------- |
|
||||
| `cinny/src/app/components/editor/Editor.tsx` | Main Slate editor |
|
||||
| `cinny/src/app/components/editor/Toolbar.tsx` | Formatting toolbar |
|
||||
| `cinny/src/app/components/editor/input.ts` | Parse into editor |
|
||||
| `cinny/src/app/components/editor/output.ts` | Serialize to Matrix |
|
||||
| `cinny/src/app/components/editor/autocomplete/` | Mention/emoji menus |
|
||||
| `cinny/src/app/features/room/RoomInput.tsx` | Room composer wrapper |
|
||||
| `cinny/src/app/plugins/text-area/` | Plain text area utilities |
|
||||
| `cinny/src/app/hooks/useFilePasteHandler.ts` | Paste files |
|
||||
| `cinny/src/app/hooks/useFileDrop.ts` | Drag-drop files |
|
||||
| `cinny/src/app/state/room/roomInputDrafts.ts` | Draft persistence |
|
||||
|
||||
## Data model
|
||||
|
||||
| Key | Storage |
|
||||
|-----|---------|
|
||||
| `roomIdToMsgDraftAtomFamily` | localStorage per room |
|
||||
| `roomIdToUploadItemsAtomFamily` | pending uploads |
|
||||
| Key | Storage |
|
||||
| ------------------------------- | --------------------- |
|
||||
| `roomIdToMsgDraftAtomFamily` | localStorage per room |
|
||||
| `roomIdToUploadItemsAtomFamily` | pending uploads |
|
||||
|
||||
## Dependencies
|
||||
|
||||
|
||||
@@ -25,23 +25,23 @@ preload / contextBridge → window.electron in renderer
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `electron/main.js` | Main process entry |
|
||||
| `electron/api-server.js` | Local HTTP API |
|
||||
| `electron/preload.js` (if exists) | IPC bridge |
|
||||
| `electron-builder.json5` | Packaging config |
|
||||
| `package.json` (root) | `npm run dev`, build scripts |
|
||||
| `dev-app-update.yml` | Update channel config |
|
||||
| `cinny/src/app/components/title-bar/TitleBar.tsx` | Custom title bar UI |
|
||||
| `build-resources/` | Linux after-install, icons |
|
||||
| Path | Role |
|
||||
| ------------------------------------------------- | ---------------------------- |
|
||||
| `electron/main.js` | Main process entry |
|
||||
| `electron/api-server.js` | Local HTTP API |
|
||||
| `electron/preload.js` (if exists) | IPC bridge |
|
||||
| `electron-builder.json5` | Packaging config |
|
||||
| `package.json` (root) | `npm run dev`, build scripts |
|
||||
| `dev-app-update.yml` | Update channel config |
|
||||
| `cinny/src/app/components/title-bar/TitleBar.tsx` | Custom title bar UI |
|
||||
| `build-resources/` | Linux after-install, icons |
|
||||
|
||||
## Data model
|
||||
|
||||
| Store | Tool | Contents |
|
||||
|-------|------|----------|
|
||||
| `electron-store` | main.js | Window bounds, user prefs |
|
||||
| UserData | Electron | plugins, caches |
|
||||
| Store | Tool | Contents |
|
||||
| ---------------- | -------- | ------------------------- |
|
||||
| `electron-store` | main.js | Window bounds, user prefs |
|
||||
| UserData | Electron | plugins, caches |
|
||||
|
||||
Protocol: `PROTOCOL_SCHEME = 'paarrot'` in main.js
|
||||
|
||||
|
||||
@@ -21,22 +21,22 @@ useRoomWideEmbedFilters (room state)
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/app/hooks/useRoomEmbedFilters.ts` | Hooks, types, combine logic |
|
||||
| `cinny/src/types/matrix/room.ts` | `StateEvent.RoomEmbedFilters` |
|
||||
| `cinny/src/app/features/room/ThreadView.tsx` | Consumer |
|
||||
| `cinny/src/app/features/room/RoomTimeline.tsx` | Consumer |
|
||||
| `cinny/src/app/features/common-settings/general/EmbedFilters.tsx` | Room-wide settings UI |
|
||||
| `cinny/src/app/components/RenderMessageContent.tsx` | Embed render gating |
|
||||
| `cinny/src/app/features/forum/useForumMessageRenderOptions.ts` | Forum post embed options |
|
||||
| Path | Role |
|
||||
| ----------------------------------------------------------------- | ----------------------------- |
|
||||
| `cinny/src/app/hooks/useRoomEmbedFilters.ts` | Hooks, types, combine logic |
|
||||
| `cinny/src/types/matrix/room.ts` | `StateEvent.RoomEmbedFilters` |
|
||||
| `cinny/src/app/features/room/ThreadView.tsx` | Consumer |
|
||||
| `cinny/src/app/features/room/RoomTimeline.tsx` | Consumer |
|
||||
| `cinny/src/app/features/common-settings/general/EmbedFilters.tsx` | Room-wide settings UI |
|
||||
| `cinny/src/app/components/RenderMessageContent.tsx` | Embed render gating |
|
||||
| `cinny/src/app/features/forum/useForumMessageRenderOptions.ts` | Forum post embed options |
|
||||
|
||||
## Data model
|
||||
|
||||
| Key | Scope | Content |
|
||||
|-----|-------|---------|
|
||||
| `im.paarrot.embed_filters` | Room account data (per user) | `{ disabledPatterns: string[] }` |
|
||||
| `im.paarrot.room.embed_filters` | Room state | `{ disabledPatterns: string[] }` |
|
||||
| Key | Scope | Content |
|
||||
| ------------------------------- | ---------------------------- | -------------------------------- |
|
||||
| `im.paarrot.embed_filters` | Room account data (per user) | `{ disabledPatterns: string[] }` |
|
||||
| `im.paarrot.room.embed_filters` | Room state | `{ disabledPatterns: string[] }` |
|
||||
|
||||
Patterns are JavaScript `RegExp` strings — invalid regex can throw; handle at input time.
|
||||
|
||||
|
||||
@@ -24,25 +24,25 @@ Settings / common-settings EmojisStickers pages
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/app/hooks/useEmojiUsage.ts` | Usage stats in account data |
|
||||
| `cinny/src/app/utils/telegramStickerImport.ts` | Telegram Bot API import |
|
||||
| `cinny/src/app/features/settings/emojis-stickers/TelegramImport.tsx` | Import UI |
|
||||
| `cinny/src/app/features/settings/emojis-stickers/EmojisStickers.tsx` | Settings hub |
|
||||
| `cinny/src/app/features/settings/emojis-stickers/UserPack.tsx` | User pack editor |
|
||||
| `cinny/src/app/features/settings/emojis-stickers/GlobalPacks.tsx` | Global packs |
|
||||
| `cinny/src/app/plugins/custom-emoji/` | Custom emoji pack reader |
|
||||
| `cinny/src/app/pages/client/ClientNonUIFeatures.tsx` | `EmojiStyleFeature` |
|
||||
| `cinny/src/app/state/settings.ts` | `EmojiStyle` enum |
|
||||
| Path | Role |
|
||||
| -------------------------------------------------------------------- | --------------------------- |
|
||||
| `cinny/src/app/hooks/useEmojiUsage.ts` | Usage stats in account data |
|
||||
| `cinny/src/app/utils/telegramStickerImport.ts` | Telegram Bot API import |
|
||||
| `cinny/src/app/features/settings/emojis-stickers/TelegramImport.tsx` | Import UI |
|
||||
| `cinny/src/app/features/settings/emojis-stickers/EmojisStickers.tsx` | Settings hub |
|
||||
| `cinny/src/app/features/settings/emojis-stickers/UserPack.tsx` | User pack editor |
|
||||
| `cinny/src/app/features/settings/emojis-stickers/GlobalPacks.tsx` | Global packs |
|
||||
| `cinny/src/app/plugins/custom-emoji/` | Custom emoji pack reader |
|
||||
| `cinny/src/app/pages/client/ClientNonUIFeatures.tsx` | `EmojiStyleFeature` |
|
||||
| `cinny/src/app/state/settings.ts` | `EmojiStyle` enum |
|
||||
|
||||
## Data model
|
||||
|
||||
| Key | Scope | Content |
|
||||
|-----|-------|---------|
|
||||
| `paarrot.favemojis` | User account data | Emoji usage counts |
|
||||
| `cinny_telegram_bot_token` | localStorage | Telegram bot token (TelegramImport) |
|
||||
| `im.ponies.room_emotes` | Room state | Standard Matrix emoji packs |
|
||||
| Key | Scope | Content |
|
||||
| -------------------------- | ----------------- | ----------------------------------- |
|
||||
| `paarrot.favemojis` | User account data | Emoji usage counts |
|
||||
| `cinny_telegram_bot_token` | localStorage | Telegram bot token (TelegramImport) |
|
||||
| `im.ponies.room_emotes` | Room state | Standard Matrix emoji packs |
|
||||
|
||||
## Dependencies
|
||||
|
||||
|
||||
@@ -24,12 +24,12 @@ client/explore/
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/app/pages/client/explore/Explore.tsx` | Explore hub |
|
||||
| `cinny/src/app/pages/client/explore/Server.tsx` | Server directory |
|
||||
| `cinny/src/app/pages/client/explore/Featured.tsx` | Featured list |
|
||||
| `cinny/src/app/pages/client/sidebar/ExploreTab.tsx` | Sidebar entry |
|
||||
| Path | Role |
|
||||
| --------------------------------------------------- | -------------------- |
|
||||
| `cinny/src/app/pages/client/explore/Explore.tsx` | Explore hub |
|
||||
| `cinny/src/app/pages/client/explore/Server.tsx` | Server directory |
|
||||
| `cinny/src/app/pages/client/explore/Featured.tsx` | Featured list |
|
||||
| `cinny/src/app/pages/client/sidebar/ExploreTab.tsx` | Sidebar entry |
|
||||
| `cinny/src/app/hooks/useRoomDirectoryVisibility.ts` | Directory visibility |
|
||||
|
||||
## Data model
|
||||
|
||||
@@ -27,31 +27,31 @@ Routing: `getSpaceDefaultPath` + `shouldShowForumLobby` in path utils / room uti
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/app/features/forum/ForumFeedPage.tsx` | Main feed page |
|
||||
| `cinny/src/app/features/forum/ForumSpaceLayout.tsx` | Layout shell |
|
||||
| `cinny/src/app/features/forum/ForumAwareSpaceLayout.tsx` | Forum vs non-forum switch |
|
||||
| `cinny/src/app/features/forum/forumFeed.ts` | Post aggregation, root detection |
|
||||
| `cinny/src/app/features/forum/types.ts` | ForumTopic, ForumPost, etc. |
|
||||
| `cinny/src/app/features/forum/ForumBoardView.tsx` | Board listing |
|
||||
| `cinny/src/app/features/forum/ForumThreadDetail.tsx` | Thread view |
|
||||
| `cinny/src/app/features/forum/ForumNewPostModal.tsx` | Create post |
|
||||
| `cinny/src/app/features/forum/ForumReplyComposer.tsx` | Replies |
|
||||
| `cinny/src/app/features/forum/useForumBoard.ts` | Board data hook |
|
||||
| `cinny/src/app/features/forum/useForumRoomLiveUpdates.ts` | Live timeline sync |
|
||||
| `cinny/src/app/pages/pathUtils.ts` | Forum routing |
|
||||
| Path | Role |
|
||||
| --------------------------------------------------------- | -------------------------------- |
|
||||
| `cinny/src/app/features/forum/ForumFeedPage.tsx` | Main feed page |
|
||||
| `cinny/src/app/features/forum/ForumSpaceLayout.tsx` | Layout shell |
|
||||
| `cinny/src/app/features/forum/ForumAwareSpaceLayout.tsx` | Forum vs non-forum switch |
|
||||
| `cinny/src/app/features/forum/forumFeed.ts` | Post aggregation, root detection |
|
||||
| `cinny/src/app/features/forum/types.ts` | ForumTopic, ForumPost, etc. |
|
||||
| `cinny/src/app/features/forum/ForumBoardView.tsx` | Board listing |
|
||||
| `cinny/src/app/features/forum/ForumThreadDetail.tsx` | Thread view |
|
||||
| `cinny/src/app/features/forum/ForumNewPostModal.tsx` | Create post |
|
||||
| `cinny/src/app/features/forum/ForumReplyComposer.tsx` | Replies |
|
||||
| `cinny/src/app/features/forum/useForumBoard.ts` | Board data hook |
|
||||
| `cinny/src/app/features/forum/useForumRoomLiveUpdates.ts` | Live timeline sync |
|
||||
| `cinny/src/app/pages/pathUtils.ts` | Forum routing |
|
||||
|
||||
## Data model
|
||||
|
||||
| Signal | Purpose |
|
||||
|--------|---------|
|
||||
| `m.room.create` `type: m.forum` | Matrix forum room type |
|
||||
| `im.paarrot.room.kind: forum_space` | Paarrot forum classification |
|
||||
| `com.matrixsso.title` on messages | Forum post title (legacy/custom) |
|
||||
| `formatted_body` with `<h1>` | Root post detection |
|
||||
| `m.relates_to` threads | Replies and edits |
|
||||
| `im.paarrot.sub_rooms` | Topic room hierarchy (see sub-rooms) |
|
||||
| Signal | Purpose |
|
||||
| ----------------------------------- | ------------------------------------ |
|
||||
| `m.room.create` `type: m.forum` | Matrix forum room type |
|
||||
| `im.paarrot.room.kind: forum_space` | Paarrot forum classification |
|
||||
| `com.matrixsso.title` on messages | Forum post title (legacy/custom) |
|
||||
| `formatted_body` with `<h1>` | Root post detection |
|
||||
| `m.relates_to` threads | Replies and edits |
|
||||
| `im.paarrot.sub_rooms` | Topic room hierarchy (see sub-rooms) |
|
||||
|
||||
## Dependencies
|
||||
|
||||
|
||||
@@ -21,17 +21,17 @@ useAsyncSearch or similar for filtering
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/app/features/search/Search.tsx` | Modal UI |
|
||||
| `cinny/src/app/state/searchModal.ts` | Open/close state |
|
||||
| `cinny/src/app/pages/client/sidebar/SearchTab.tsx` | Sidebar entry |
|
||||
| Path | Role |
|
||||
| -------------------------------------------------- | ---------------- |
|
||||
| `cinny/src/app/features/search/Search.tsx` | Modal UI |
|
||||
| `cinny/src/app/state/searchModal.ts` | Open/close state |
|
||||
| `cinny/src/app/pages/client/sidebar/SearchTab.tsx` | Sidebar entry |
|
||||
|
||||
## Data model
|
||||
|
||||
| Key | Storage |
|
||||
|-----|---------|
|
||||
| `searchModal` atom | memory |
|
||||
| Key | Storage |
|
||||
| ------------------ | ------- |
|
||||
| `searchModal` atom | memory |
|
||||
|
||||
## Dependencies
|
||||
|
||||
|
||||
@@ -24,32 +24,32 @@ DirectTab.tsx → useDirectRooms.ts
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/app/pages/client/home/Home.tsx` | Home room list UI |
|
||||
| `cinny/src/app/pages/client/home/useHomeRooms.ts` | Room list logic + Paarrot room kind |
|
||||
| `cinny/src/app/pages/client/SidebarNav.tsx` | Sidebar tab bar |
|
||||
| `cinny/src/app/pages/client/sidebar/HomeTab.tsx` | Home tab |
|
||||
| `cinny/src/app/pages/client/sidebar/DirectTab.tsx` | DMs tab + favicon logos |
|
||||
| `cinny/src/app/pages/client/sidebar/InboxTab.tsx` | Inbox tab |
|
||||
| `cinny/src/app/pages/client/sidebar/ExploreTab.tsx` | Explore tab |
|
||||
| `cinny/src/app/pages/client/sidebar/SearchTab.tsx` | Search tab |
|
||||
| `cinny/src/app/pages/client/sidebar/SettingsTab.tsx` | Settings tab |
|
||||
| `cinny/src/app/pages/client/sidebar/SpaceTabs.tsx` | Space context tabs |
|
||||
| `cinny/src/app/pages/client/home/HomeThreadsCategory.tsx` | Threads grouping |
|
||||
| `cinny/src/app/hooks/useRoomListReorder.ts` | DnD reorder |
|
||||
| `cinny/src/app/hooks/useSidebarItems.ts` | Sidebar item model |
|
||||
| Path | Role |
|
||||
| --------------------------------------------------------- | ----------------------------------- |
|
||||
| `cinny/src/app/pages/client/home/Home.tsx` | Home room list UI |
|
||||
| `cinny/src/app/pages/client/home/useHomeRooms.ts` | Room list logic + Paarrot room kind |
|
||||
| `cinny/src/app/pages/client/SidebarNav.tsx` | Sidebar tab bar |
|
||||
| `cinny/src/app/pages/client/sidebar/HomeTab.tsx` | Home tab |
|
||||
| `cinny/src/app/pages/client/sidebar/DirectTab.tsx` | DMs tab + favicon logos |
|
||||
| `cinny/src/app/pages/client/sidebar/InboxTab.tsx` | Inbox tab |
|
||||
| `cinny/src/app/pages/client/sidebar/ExploreTab.tsx` | Explore tab |
|
||||
| `cinny/src/app/pages/client/sidebar/SearchTab.tsx` | Search tab |
|
||||
| `cinny/src/app/pages/client/sidebar/SettingsTab.tsx` | Settings tab |
|
||||
| `cinny/src/app/pages/client/sidebar/SpaceTabs.tsx` | Space context tabs |
|
||||
| `cinny/src/app/pages/client/home/HomeThreadsCategory.tsx` | Threads grouping |
|
||||
| `cinny/src/app/hooks/useRoomListReorder.ts` | DnD reorder |
|
||||
| `cinny/src/app/hooks/useSidebarItems.ts` | Sidebar item model |
|
||||
|
||||
## Data model
|
||||
|
||||
| Source | Data |
|
||||
|--------|------|
|
||||
| `allRoomsAtom` | Joined rooms |
|
||||
| `roomToUnreadAtom` | Badge state |
|
||||
| `mDirectAtom` | DM room mapping |
|
||||
| Source | Data |
|
||||
| ---------------------- | ------------------------------- |
|
||||
| `allRoomsAtom` | Joined rooms |
|
||||
| `roomToUnreadAtom` | Badge state |
|
||||
| `mDirectAtom` | DM room mapping |
|
||||
| `im.paarrot.sub_rooms` | Nested children (see sub-rooms) |
|
||||
| `im.paarrot.room.kind` | Room classification |
|
||||
| localStorage | Category collapse, room order |
|
||||
| `im.paarrot.room.kind` | Room classification |
|
||||
| localStorage | Category collapse, room order |
|
||||
|
||||
## Dependencies
|
||||
|
||||
|
||||
@@ -22,21 +22,21 @@ ClientRoomsNotificationPreferences.tsx — bulk prefs
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/app/pages/client/inbox/Inbox.tsx` | Inbox layout |
|
||||
| `cinny/src/app/pages/client/inbox/Invites.tsx` | Invites UI |
|
||||
| `cinny/src/app/pages/client/inbox/Notifications.tsx` | Notifications list |
|
||||
| `cinny/src/app/state/room-list/inviteList.ts` | `allInvitesAtom` |
|
||||
| `cinny/src/app/pages/client/ClientRoomsNotificationPreferences.tsx` | Room notif prefs |
|
||||
| `cinny/src/app/pages/client/sidebar/InboxTab.tsx` | Sidebar entry |
|
||||
| `cinny/src/app/hooks/useRoomsNotificationPreferences.ts` | Prefs hook |
|
||||
| Path | Role |
|
||||
| ------------------------------------------------------------------- | ------------------ |
|
||||
| `cinny/src/app/pages/client/inbox/Inbox.tsx` | Inbox layout |
|
||||
| `cinny/src/app/pages/client/inbox/Invites.tsx` | Invites UI |
|
||||
| `cinny/src/app/pages/client/inbox/Notifications.tsx` | Notifications list |
|
||||
| `cinny/src/app/state/room-list/inviteList.ts` | `allInvitesAtom` |
|
||||
| `cinny/src/app/pages/client/ClientRoomsNotificationPreferences.tsx` | Room notif prefs |
|
||||
| `cinny/src/app/pages/client/sidebar/InboxTab.tsx` | Sidebar entry |
|
||||
| `cinny/src/app/hooks/useRoomsNotificationPreferences.ts` | Prefs hook |
|
||||
|
||||
## Data model
|
||||
|
||||
| Source | Data |
|
||||
|--------|------|
|
||||
| Sync | `m.room.member` invite membership |
|
||||
| Source | Data |
|
||||
| ------------ | --------------------------------------- |
|
||||
| Sync | `m.room.member` invite membership |
|
||||
| Account data | push rules, per-room notification prefs |
|
||||
|
||||
## Dependencies
|
||||
|
||||
@@ -22,12 +22,12 @@ Route: _JOIN_PATH in Router.tsx
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/app/features/join-before-navigate/JoinBeforeNavigate.tsx` | Preview + join UI |
|
||||
| `cinny/src/app/components/RoomSummaryLoader.tsx` | Fetch room preview |
|
||||
| `cinny/src/app/hooks/useRoomNavigate.ts` | Post-join navigation |
|
||||
| `cinny/src/app/state/joiningProgress.ts` | Join in progress UX |
|
||||
| Path | Role |
|
||||
| -------------------------------------------------------------------- | -------------------- |
|
||||
| `cinny/src/app/features/join-before-navigate/JoinBeforeNavigate.tsx` | Preview + join UI |
|
||||
| `cinny/src/app/components/RoomSummaryLoader.tsx` | Fetch room preview |
|
||||
| `cinny/src/app/hooks/useRoomNavigate.ts` | Post-join navigation |
|
||||
| `cinny/src/app/state/joiningProgress.ts` | Join in progress UX |
|
||||
|
||||
## Data model
|
||||
|
||||
|
||||
@@ -23,29 +23,29 @@ Space route → Lobby.tsx (SpaceCardLobby)
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/app/features/lobby/Lobby.tsx` | Main lobby view |
|
||||
| `cinny/src/app/features/lobby/LobbyHeader.tsx` | Space header |
|
||||
| `cinny/src/app/features/lobby/LobbyHero.tsx` | Hero banner area |
|
||||
| `cinny/src/app/features/lobby/SpaceHierarchy.tsx` | Room tree/cards |
|
||||
| `cinny/src/app/features/lobby/DnD.tsx` | Drag and drop |
|
||||
| `cinny/src/app/features/lobby/RoomItem.tsx` | Room card |
|
||||
| `cinny/src/app/state/closedLobbyCategories.ts` | Collapsed categories |
|
||||
| `cinny/src/app/state/hooks/closedLobbyCategories.ts` | Jotai hook |
|
||||
| `cinny/src/app/pages/pathUtils.ts` | `getSpaceLobbyPath`, forum routing |
|
||||
| `cinny/src/app/utils/room.ts` | `shouldShowForumLobby`, `getStateEvent` |
|
||||
| `cinny/src/types/matrix/room.ts` | `RoomType.Forum`, `PaarrotRoomKind` |
|
||||
| Path | Role |
|
||||
| ---------------------------------------------------- | --------------------------------------- |
|
||||
| `cinny/src/app/features/lobby/Lobby.tsx` | Main lobby view |
|
||||
| `cinny/src/app/features/lobby/LobbyHeader.tsx` | Space header |
|
||||
| `cinny/src/app/features/lobby/LobbyHero.tsx` | Hero banner area |
|
||||
| `cinny/src/app/features/lobby/SpaceHierarchy.tsx` | Room tree/cards |
|
||||
| `cinny/src/app/features/lobby/DnD.tsx` | Drag and drop |
|
||||
| `cinny/src/app/features/lobby/RoomItem.tsx` | Room card |
|
||||
| `cinny/src/app/state/closedLobbyCategories.ts` | Collapsed categories |
|
||||
| `cinny/src/app/state/hooks/closedLobbyCategories.ts` | Jotai hook |
|
||||
| `cinny/src/app/pages/pathUtils.ts` | `getSpaceLobbyPath`, forum routing |
|
||||
| `cinny/src/app/utils/room.ts` | `shouldShowForumLobby`, `getStateEvent` |
|
||||
| `cinny/src/types/matrix/room.ts` | `RoomType.Forum`, `PaarrotRoomKind` |
|
||||
|
||||
## Data model
|
||||
|
||||
| Event / field | Purpose |
|
||||
|---------------|---------|
|
||||
| `m.space.child` | Child room membership + `order` |
|
||||
| `im.paarrot.sub_rooms` | Paarrot nested children (see sub-rooms handoff) |
|
||||
| `im.paarrot.room.kind` | e.g. `forum_space` for forum behavior |
|
||||
| `m.room.create` `type` | `m.forum` for forum rooms |
|
||||
| Local: `closedLobbyCategories` | UI collapse state (not Matrix) |
|
||||
| Event / field | Purpose |
|
||||
| ------------------------------ | ----------------------------------------------- |
|
||||
| `m.space.child` | Child room membership + `order` |
|
||||
| `im.paarrot.sub_rooms` | Paarrot nested children (see sub-rooms handoff) |
|
||||
| `im.paarrot.room.kind` | e.g. `forum_space` for forum behavior |
|
||||
| `m.room.create` `type` | `m.forum` for forum rooms |
|
||||
| Local: `closedLobbyCategories` | UI collapse state (not Matrix) |
|
||||
|
||||
## Dependencies
|
||||
|
||||
|
||||
@@ -25,14 +25,14 @@ Navigation for room changes uses `setPaarrotNavigate()` registered from the Reac
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `electron/api-server.js` | Express routes, IPC bridge to renderer |
|
||||
| `electron/main.js` | Starts `PaarrotAPIServer` with the main window |
|
||||
| `cinny/src/app/paarrot-api.ts` | Action handlers (mute, deafen, channel, message, status) |
|
||||
| `cinny/src/app/pages/client/ClientNonUIFeatures.tsx` | Calls `initPaarrotAPI()` and `setPaarrotNavigate()` |
|
||||
| `test-api.js` / `test-api.sh` | Smoke tests for endpoints |
|
||||
| `paarrot-api.postman_collection.json` | Postman collection (generated) |
|
||||
| Path | Role |
|
||||
| ---------------------------------------------------- | -------------------------------------------------------- |
|
||||
| `electron/api-server.js` | Express routes, IPC bridge to renderer |
|
||||
| `electron/main.js` | Starts `PaarrotAPIServer` with the main window |
|
||||
| `cinny/src/app/paarrot-api.ts` | Action handlers (mute, deafen, channel, message, status) |
|
||||
| `cinny/src/app/pages/client/ClientNonUIFeatures.tsx` | Calls `initPaarrotAPI()` and `setPaarrotNavigate()` |
|
||||
| `test-api.js` / `test-api.sh` | Smoke tests for endpoints |
|
||||
| `paarrot-api.postman_collection.json` | Postman collection (generated) |
|
||||
|
||||
## Data model
|
||||
|
||||
@@ -40,22 +40,22 @@ No persistent storage. Actions read/write ephemeral app state (current room, cal
|
||||
|
||||
### IPC actions (renderer)
|
||||
|
||||
| Action | Params | Returns |
|
||||
|--------|--------|---------|
|
||||
| `get-status` | — | mute, deafen, currentRoom, connected, userId |
|
||||
| `toggle-mute` / `set-mute` | `{ muted? }` | `{ muted }` |
|
||||
| `toggle-deafen` / `set-deafen` | `{ deafened? }` | `{ deafened }` |
|
||||
| `change-channel` | `{ roomId }` | navigation result |
|
||||
| `get-channels` | — | room list |
|
||||
| `send-message` | `{ roomId, message }` | send result |
|
||||
| `send-message-current` | `{ message }` | send to active room |
|
||||
| `get-current-room` | — | current room id |
|
||||
| `get-messages-groups` | `{ limit? }` | recent messages across group channels |
|
||||
| `get-messages-dms` | `{ limit? }` | recent messages across DMs |
|
||||
| `get-messages-combined` | `{ limit? }` | recent messages across groups + DMs |
|
||||
| `get-unreads-groups` | — | unread group conversations |
|
||||
| `get-unreads-dms` | — | unread DM conversations |
|
||||
| `get-unreads-combined` | — | unread groups + DMs |
|
||||
| Action | Params | Returns |
|
||||
| ------------------------------ | --------------------- | -------------------------------------------- |
|
||||
| `get-status` | — | mute, deafen, currentRoom, connected, userId |
|
||||
| `toggle-mute` / `set-mute` | `{ muted? }` | `{ muted }` |
|
||||
| `toggle-deafen` / `set-deafen` | `{ deafened? }` | `{ deafened }` |
|
||||
| `change-channel` | `{ roomId }` | navigation result |
|
||||
| `get-channels` | — | room list |
|
||||
| `send-message` | `{ roomId, message }` | send result |
|
||||
| `send-message-current` | `{ message }` | send to active room |
|
||||
| `get-current-room` | — | current room id |
|
||||
| `get-messages-groups` | `{ limit? }` | recent messages across group channels |
|
||||
| `get-messages-dms` | `{ limit? }` | recent messages across DMs |
|
||||
| `get-messages-combined` | `{ limit? }` | recent messages across groups + DMs |
|
||||
| `get-unreads-groups` | — | unread group conversations |
|
||||
| `get-unreads-dms` | — | unread DM conversations |
|
||||
| `get-unreads-combined` | — | unread groups + DMs |
|
||||
|
||||
## Dependencies
|
||||
|
||||
|
||||
@@ -25,23 +25,23 @@ initMatrix.ts
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/client/initMatrix.ts` | createClient, start/stop, logout, cache clear |
|
||||
| `cinny/src/client/secretStorageKeys.ts` | SSSS / secret storage callbacks |
|
||||
| `cinny/src/app/pages/client/ClientRoot.tsx` | Bootstrap, providers, title bar |
|
||||
| `cinny/src/app/hooks/useMatrixClient.ts` | React context for `MatrixClient` |
|
||||
| `cinny/src/app/hooks/useSyncState.ts` | Sync state subscription |
|
||||
| `cinny/src/app/pages/client/SyncStatus.tsx` | Sync indicator UI |
|
||||
| `cinny/src/app/components/splash-screen/SplashScreen.tsx` | Loading shell |
|
||||
| Path | Role |
|
||||
| --------------------------------------------------------- | --------------------------------------------- |
|
||||
| `cinny/src/client/initMatrix.ts` | createClient, start/stop, logout, cache clear |
|
||||
| `cinny/src/client/secretStorageKeys.ts` | SSSS / secret storage callbacks |
|
||||
| `cinny/src/app/pages/client/ClientRoot.tsx` | Bootstrap, providers, title bar |
|
||||
| `cinny/src/app/hooks/useMatrixClient.ts` | React context for `MatrixClient` |
|
||||
| `cinny/src/app/hooks/useSyncState.ts` | Sync state subscription |
|
||||
| `cinny/src/app/pages/client/SyncStatus.tsx` | Sync indicator UI |
|
||||
| `cinny/src/app/components/splash-screen/SplashScreen.tsx` | Loading shell |
|
||||
|
||||
## Data model
|
||||
|
||||
| Store | Backend | Purpose |
|
||||
|-------|---------|---------|
|
||||
| IndexedDB sync store | matrix-js-sdk | Room timeline cache |
|
||||
| IndexedDB crypto store | matrix-js-sdk | Olm/Megolm keys |
|
||||
| Session | localStorage | Auth credentials |
|
||||
| Store | Backend | Purpose |
|
||||
| ---------------------- | ------------- | ------------------- |
|
||||
| IndexedDB sync store | matrix-js-sdk | Room timeline cache |
|
||||
| IndexedDB crypto store | matrix-js-sdk | Olm/Megolm keys |
|
||||
| Session | localStorage | Auth credentials |
|
||||
|
||||
## Dependencies
|
||||
|
||||
|
||||
@@ -26,18 +26,18 @@ image-viewer/, video-viewer/ — fullscreen media
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/app/components/upload-card/UploadCardRenderer.tsx` | Upload UI |
|
||||
| `cinny/src/app/state/upload.ts` | Upload state |
|
||||
| `cinny/src/app/state/room/roomInputDrafts.ts` | `TUploadItem` |
|
||||
| `cinny/src/app/utils/matrix.ts` | `encryptFile`, upload helpers |
|
||||
| `cinny/src/app/components/url-preview/` | Link embed cards |
|
||||
| `cinny/src/app/components/image-viewer/` | Image lightbox |
|
||||
| `cinny/src/app/components/video-viewer/` | Video player |
|
||||
| `cinny/src/app/hooks/useMediaAuthentication.ts` | Authenticated media URLs |
|
||||
| `cinny/src/app/hooks/useAuthenticatedMediaUrl.ts` | MXC → HTTP with auth |
|
||||
| `cinny/src/app/components/message/content/` | Image/video/thumbnail content |
|
||||
| Path | Role |
|
||||
| ------------------------------------------------------------- | ----------------------------- |
|
||||
| `cinny/src/app/components/upload-card/UploadCardRenderer.tsx` | Upload UI |
|
||||
| `cinny/src/app/state/upload.ts` | Upload state |
|
||||
| `cinny/src/app/state/room/roomInputDrafts.ts` | `TUploadItem` |
|
||||
| `cinny/src/app/utils/matrix.ts` | `encryptFile`, upload helpers |
|
||||
| `cinny/src/app/components/url-preview/` | Link embed cards |
|
||||
| `cinny/src/app/components/image-viewer/` | Image lightbox |
|
||||
| `cinny/src/app/components/video-viewer/` | Video player |
|
||||
| `cinny/src/app/hooks/useMediaAuthentication.ts` | Authenticated media URLs |
|
||||
| `cinny/src/app/hooks/useAuthenticatedMediaUrl.ts` | MXC → HTTP with auth |
|
||||
| `cinny/src/app/components/message/content/` | Image/video/thumbnail content |
|
||||
|
||||
## Data model
|
||||
|
||||
|
||||
@@ -24,18 +24,18 @@ msgContent.ts — content type detection
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/app/components/RenderMessageContent.tsx` | Main render entry |
|
||||
| `cinny/src/app/plugins/react-custom-html-parser.tsx` | HTML → React |
|
||||
| `cinny/src/app/plugins/markdown/` | Markdown rules + parsers |
|
||||
| `cinny/src/app/plugins/react-prism/ReactPrism.tsx` | Code highlighting |
|
||||
| `cinny/src/app/plugins/emoji.ts` | Emoji shortcodes |
|
||||
| `cinny/src/app/plugins/matrix-to.ts` | matrix.to link handling |
|
||||
| `cinny/src/app/plugins/bad-words.ts` | Content filter hook |
|
||||
| `cinny/src/app/plugins/color.ts` | Text color |
|
||||
| `cinny/src/app/utils/sanitize.ts` | HTML sanitization |
|
||||
| `cinny/src/app/features/room/msgContent.ts` | Message content helpers |
|
||||
| Path | Role |
|
||||
| ---------------------------------------------------- | ------------------------ |
|
||||
| `cinny/src/app/components/RenderMessageContent.tsx` | Main render entry |
|
||||
| `cinny/src/app/plugins/react-custom-html-parser.tsx` | HTML → React |
|
||||
| `cinny/src/app/plugins/markdown/` | Markdown rules + parsers |
|
||||
| `cinny/src/app/plugins/react-prism/ReactPrism.tsx` | Code highlighting |
|
||||
| `cinny/src/app/plugins/emoji.ts` | Emoji shortcodes |
|
||||
| `cinny/src/app/plugins/matrix-to.ts` | matrix.to link handling |
|
||||
| `cinny/src/app/plugins/bad-words.ts` | Content filter hook |
|
||||
| `cinny/src/app/plugins/color.ts` | Text color |
|
||||
| `cinny/src/app/utils/sanitize.ts` | HTML sanitization |
|
||||
| `cinny/src/app/features/room/msgContent.ts` | Message content helpers |
|
||||
|
||||
## Data model
|
||||
|
||||
|
||||
@@ -22,13 +22,13 @@ Router may mount search under client routes
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/app/features/message-search/MessageSearch.tsx` | Main UI |
|
||||
| `cinny/src/app/features/message-search/useMessageSearch.ts` | Search logic |
|
||||
| `cinny/src/app/features/message-search/SearchInput.tsx` | Query field |
|
||||
| `cinny/src/app/features/message-search/SearchFilters.tsx` | Filters |
|
||||
| `cinny/src/app/features/message-search/SearchResultGroup.tsx` | Result list |
|
||||
| Path | Role |
|
||||
| ------------------------------------------------------------- | ------------ |
|
||||
| `cinny/src/app/features/message-search/MessageSearch.tsx` | Main UI |
|
||||
| `cinny/src/app/features/message-search/useMessageSearch.ts` | Search logic |
|
||||
| `cinny/src/app/features/message-search/SearchInput.tsx` | Query field |
|
||||
| `cinny/src/app/features/message-search/SearchFilters.tsx` | Filters |
|
||||
| `cinny/src/app/features/message-search/SearchResultGroup.tsx` | Result list |
|
||||
|
||||
## Data model
|
||||
|
||||
|
||||
@@ -22,18 +22,18 @@ Plugin folder (index.js + plugin-metadata.json)
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/app/features/settings/plugins/PluginLoader.tsx` | Load/enable/disable plugins |
|
||||
| `cinny/src/app/features/settings/plugins/PluginAPI.ts` | Re-exports plugin-manager + app hooks |
|
||||
| `cinny/src/app/features/settings/plugins/Plugins.tsx` | Settings UI (installed + marketplace) |
|
||||
| `cinny/src/app/features/settings/plugins/PluginButtonSlot.tsx` | Icon button injection |
|
||||
| `cinny/src/app/features/settings/plugins/PluginNavSlot.tsx` | Nav row injection |
|
||||
| `cinny/src/app/features/settings/plugins/PluginSidebarSlot.tsx` | Sidebar icon injection |
|
||||
| `cinny/src/app/features/settings/plugins/types.ts` | Local types |
|
||||
| `cinny/src/app/features/settings/plugins/PLUGIN_DEVELOPMENT.md` | Author-facing dev guide |
|
||||
| `example-plugin/` | Reference plugin at repo root |
|
||||
| `cinny/docs/PLUGIN_*.md` | API reference docs |
|
||||
| Path | Role |
|
||||
| --------------------------------------------------------------- | ------------------------------------- |
|
||||
| `cinny/src/app/features/settings/plugins/PluginLoader.tsx` | Load/enable/disable plugins |
|
||||
| `cinny/src/app/features/settings/plugins/PluginAPI.ts` | Re-exports plugin-manager + app hooks |
|
||||
| `cinny/src/app/features/settings/plugins/Plugins.tsx` | Settings UI (installed + marketplace) |
|
||||
| `cinny/src/app/features/settings/plugins/PluginButtonSlot.tsx` | Icon button injection |
|
||||
| `cinny/src/app/features/settings/plugins/PluginNavSlot.tsx` | Nav row injection |
|
||||
| `cinny/src/app/features/settings/plugins/PluginSidebarSlot.tsx` | Sidebar icon injection |
|
||||
| `cinny/src/app/features/settings/plugins/types.ts` | Local types |
|
||||
| `cinny/src/app/features/settings/plugins/PLUGIN_DEVELOPMENT.md` | Author-facing dev guide |
|
||||
| `example-plugin/` | Reference plugin at repo root |
|
||||
| `cinny/docs/PLUGIN_*.md` | API reference docs |
|
||||
|
||||
## Data model
|
||||
|
||||
|
||||
@@ -23,21 +23,21 @@ Bot → state im.paarrot.ui
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/types/matrix/room.ts` | `StateEvent.PaarrotUi`, `MessageEvent.PaarrotUiAction`, node types |
|
||||
| `cinny/src/app/utils/room.ts` | `getPaarrotUiContent`, `hasRoomAppUi` |
|
||||
| `cinny/src/app/features/room/Room.tsx` | Takeover branch + Show chat / Show app |
|
||||
| `cinny/src/app/features/room-app/` | `RoomAppView`, schema renderer, CSS sanitize/scope |
|
||||
| `cinny/src/app/features/room/RoomTimeline.tsx` | Hides `im.paarrot.ui.action` |
|
||||
| `cinny/src/app/features/room-settings/permissions/usePermissionItems.ts` | Permission labels |
|
||||
| Path | Role |
|
||||
| ------------------------------------------------------------------------ | ------------------------------------------------------------------ |
|
||||
| `cinny/src/types/matrix/room.ts` | `StateEvent.PaarrotUi`, `MessageEvent.PaarrotUiAction`, node types |
|
||||
| `cinny/src/app/utils/room.ts` | `getPaarrotUiContent`, `hasRoomAppUi` |
|
||||
| `cinny/src/app/features/room/Room.tsx` | Takeover branch + Show chat / Show app |
|
||||
| `cinny/src/app/features/room-app/` | `RoomAppView`, schema renderer, CSS sanitize/scope |
|
||||
| `cinny/src/app/features/room/RoomTimeline.tsx` | Hides `im.paarrot.ui.action` |
|
||||
| `cinny/src/app/features/room-settings/permissions/usePermissionItems.ts` | Permission labels |
|
||||
|
||||
## Data model
|
||||
|
||||
| Event | Kind | Content |
|
||||
|-------|------|---------|
|
||||
| `im.paarrot.ui` | state (`""`) | `{ version, title?, css?, root }` |
|
||||
| `im.paarrot.ui.action` | timeline | `{ action, component_id, value?, values?, ui_event_id? }` |
|
||||
| Event | Kind | Content |
|
||||
| ---------------------- | ------------ | --------------------------------------------------------- |
|
||||
| `im.paarrot.ui` | state (`""`) | `{ version, title?, css?, root }` |
|
||||
| `im.paarrot.ui.action` | timeline | `{ action, component_id, value?, values?, ui_event_id? }` |
|
||||
|
||||
See [samples/](./samples/) for pasteable Developer Tools payloads.
|
||||
|
||||
|
||||
@@ -25,13 +25,13 @@ Used by Home.tsx, space sidebars, forum sidebars
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/app/features/room-nav/RoomNavItem.tsx` | Main room row |
|
||||
| `cinny/src/app/features/room-nav/RoomNavCategoryButton.tsx` | Category header |
|
||||
| `cinny/src/app/features/room-nav/UnjoinedSubRoomItem.tsx` | Unjoined sub-room |
|
||||
| Path | Role |
|
||||
| --------------------------------------------------------------- | ----------------- |
|
||||
| `cinny/src/app/features/room-nav/RoomNavItem.tsx` | Main room row |
|
||||
| `cinny/src/app/features/room-nav/RoomNavCategoryButton.tsx` | Category header |
|
||||
| `cinny/src/app/features/room-nav/UnjoinedSubRoomItem.tsx` | Unjoined sub-room |
|
||||
| `cinny/src/app/features/room-nav/CallParticipantsIndicator.tsx` | In-call indicator |
|
||||
| `cinny/src/app/features/room-nav/styles.css.ts` | Nav styles |
|
||||
| `cinny/src/app/features/room-nav/styles.css.ts` | Nav styles |
|
||||
|
||||
## Data model
|
||||
|
||||
|
||||
@@ -23,15 +23,15 @@ roomSettings.ts atom — which page open
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/app/features/room-settings/RoomSettings.tsx` | Settings shell |
|
||||
| `cinny/src/app/features/room-settings/general/` | General tab |
|
||||
| `cinny/src/app/features/room-settings/permissions/` | Permissions |
|
||||
| `cinny/src/app/features/room-settings/sub-rooms/SubRooms.tsx` | Sub-rooms (Paarrot) |
|
||||
| `cinny/src/app/state/roomSettings.ts` | Modal/page state |
|
||||
| `cinny/src/app/state/hooks/roomSettings.ts` | Open/close hooks |
|
||||
| `cinny/src/app/features/common-settings/` | Shared setting pages |
|
||||
| Path | Role |
|
||||
| ------------------------------------------------------------- | -------------------- |
|
||||
| `cinny/src/app/features/room-settings/RoomSettings.tsx` | Settings shell |
|
||||
| `cinny/src/app/features/room-settings/general/` | General tab |
|
||||
| `cinny/src/app/features/room-settings/permissions/` | Permissions |
|
||||
| `cinny/src/app/features/room-settings/sub-rooms/SubRooms.tsx` | Sub-rooms (Paarrot) |
|
||||
| `cinny/src/app/state/roomSettings.ts` | Modal/page state |
|
||||
| `cinny/src/app/state/hooks/roomSettings.ts` | Open/close hooks |
|
||||
| `cinny/src/app/features/common-settings/` | Shared setting pages |
|
||||
|
||||
## Data model
|
||||
|
||||
|
||||
@@ -27,32 +27,32 @@ Hooks: useVirtualPaginator, useRoomLatestRenderedEvent, useMarkAsRead
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/app/features/room/Room.tsx` | Room entry |
|
||||
| `cinny/src/app/features/room/RoomView.tsx` | Main layout |
|
||||
| `cinny/src/app/features/room/RoomTimeline.tsx` | Timeline |
|
||||
| `cinny/src/app/features/room/RoomInput.tsx` | Composer |
|
||||
| `cinny/src/app/features/room/ThreadView.tsx` | Thread panel |
|
||||
| `cinny/src/app/features/room/RoomViewHeader.tsx` | Header bar |
|
||||
| `cinny/src/app/features/room/message/Message.tsx` | Single message |
|
||||
| `cinny/src/app/features/room/message/Reactions.tsx` | Reaction row |
|
||||
| `cinny/src/app/features/room/message/MessageEditor.tsx` | Edit message |
|
||||
| `cinny/src/app/features/room/CommandAutocomplete.tsx` | Slash commands |
|
||||
| `cinny/src/app/features/room/reaction-viewer/ReactionViewer.tsx` | Who reacted |
|
||||
| `cinny/src/app/features/room/jump-to-time/JumpToTime.tsx` | Time jump UI |
|
||||
| `cinny/src/app/features/room/room-pin-menu/RoomPinMenu.tsx` | Pinned messages |
|
||||
| `cinny/src/app/components/RenderMessageContent.tsx` | Content render + embeds |
|
||||
| `cinny/src/app/hooks/useVirtualPaginator.ts` | Timeline pagination |
|
||||
| Path | Role |
|
||||
| ---------------------------------------------------------------- | ----------------------- |
|
||||
| `cinny/src/app/features/room/Room.tsx` | Room entry |
|
||||
| `cinny/src/app/features/room/RoomView.tsx` | Main layout |
|
||||
| `cinny/src/app/features/room/RoomTimeline.tsx` | Timeline |
|
||||
| `cinny/src/app/features/room/RoomInput.tsx` | Composer |
|
||||
| `cinny/src/app/features/room/ThreadView.tsx` | Thread panel |
|
||||
| `cinny/src/app/features/room/RoomViewHeader.tsx` | Header bar |
|
||||
| `cinny/src/app/features/room/message/Message.tsx` | Single message |
|
||||
| `cinny/src/app/features/room/message/Reactions.tsx` | Reaction row |
|
||||
| `cinny/src/app/features/room/message/MessageEditor.tsx` | Edit message |
|
||||
| `cinny/src/app/features/room/CommandAutocomplete.tsx` | Slash commands |
|
||||
| `cinny/src/app/features/room/reaction-viewer/ReactionViewer.tsx` | Who reacted |
|
||||
| `cinny/src/app/features/room/jump-to-time/JumpToTime.tsx` | Time jump UI |
|
||||
| `cinny/src/app/features/room/room-pin-menu/RoomPinMenu.tsx` | Pinned messages |
|
||||
| `cinny/src/app/components/RenderMessageContent.tsx` | Content render + embeds |
|
||||
| `cinny/src/app/hooks/useVirtualPaginator.ts` | Timeline pagination |
|
||||
|
||||
## Data model
|
||||
|
||||
| Source | Data |
|
||||
|--------|------|
|
||||
| Matrix sync | `m.room.message`, edits, reactions, pins |
|
||||
| Room account data | drafts (`roomInputDrafts`) |
|
||||
| `im.paarrot.embed_filters` | Personal embed blocks |
|
||||
| `im.paarrot.room.embed_filters` | Room-wide embed blocks |
|
||||
| Source | Data |
|
||||
| ------------------------------- | ---------------------------------------- |
|
||||
| Matrix sync | `m.room.message`, edits, reactions, pins |
|
||||
| Room account data | drafts (`roomInputDrafts`) |
|
||||
| `im.paarrot.embed_filters` | Personal embed blocks |
|
||||
| `im.paarrot.room.embed_filters` | Room-wide embed blocks |
|
||||
|
||||
## Dependencies
|
||||
|
||||
|
||||
@@ -24,26 +24,26 @@ Router.tsx — route tree + loaders/guards
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/app/pages/Router.tsx` | Full route tree |
|
||||
| `cinny/src/app/pages/paths.ts` | Path constants |
|
||||
| `cinny/src/app/pages/pathUtils.ts` | Path builder utilities |
|
||||
| `cinny/src/app/pages/App.tsx` | RouterProvider setup |
|
||||
| `cinny/src/app/pages/client/ClientLayout.tsx` | Authenticated layout shell |
|
||||
| `cinny/src/app/pages/client/SidebarNav.tsx` | Left sidebar tabs |
|
||||
| `cinny/src/app/pages/MobileFriendly.tsx` | Mobile nav adapters |
|
||||
| `cinny/src/app/hooks/useRoomNavigate.ts` | Imperative room navigation |
|
||||
| `cinny/src/app/hooks/useNavToActivePathMapper.ts` | Restore last path |
|
||||
| `cinny/src/app/pages/afterLoginRedirectPath.ts` | Login redirect |
|
||||
| `cinny/src/app/components/AnimatedOutlet.tsx` | Route transitions |
|
||||
| Path | Role |
|
||||
| ------------------------------------------------- | -------------------------- |
|
||||
| `cinny/src/app/pages/Router.tsx` | Full route tree |
|
||||
| `cinny/src/app/pages/paths.ts` | Path constants |
|
||||
| `cinny/src/app/pages/pathUtils.ts` | Path builder utilities |
|
||||
| `cinny/src/app/pages/App.tsx` | RouterProvider setup |
|
||||
| `cinny/src/app/pages/client/ClientLayout.tsx` | Authenticated layout shell |
|
||||
| `cinny/src/app/pages/client/SidebarNav.tsx` | Left sidebar tabs |
|
||||
| `cinny/src/app/pages/MobileFriendly.tsx` | Mobile nav adapters |
|
||||
| `cinny/src/app/hooks/useRoomNavigate.ts` | Imperative room navigation |
|
||||
| `cinny/src/app/hooks/useNavToActivePathMapper.ts` | Restore last path |
|
||||
| `cinny/src/app/pages/afterLoginRedirectPath.ts` | Login redirect |
|
||||
| `cinny/src/app/components/AnimatedOutlet.tsx` | Route transitions |
|
||||
|
||||
## Data model
|
||||
|
||||
| Key | Purpose |
|
||||
|-----|---------|
|
||||
| `navToActivePath` atom | Per-context last URL |
|
||||
| URL path params | roomId, spaceId, eventId |
|
||||
| Key | Purpose |
|
||||
| ---------------------- | ------------------------ |
|
||||
| `navToActivePath` atom | Per-context last URL |
|
||||
| URL path params | roomId, spaceId, eventId |
|
||||
|
||||
## Dependencies
|
||||
|
||||
|
||||
@@ -21,13 +21,13 @@ spaceSettings.ts atom
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| Path | Role |
|
||||
| --------------------------------------------------------- | -------------- |
|
||||
| `cinny/src/app/features/space-settings/SpaceSettings.tsx` | Settings shell |
|
||||
| `cinny/src/app/features/space-settings/general/` | General tab |
|
||||
| `cinny/src/app/features/space-settings/permissions/` | Permissions |
|
||||
| `cinny/src/app/state/spaceSettings.ts` | Open state |
|
||||
| `cinny/src/app/state/hooks/spaceSettings.ts` | Hooks |
|
||||
| `cinny/src/app/features/space-settings/general/` | General tab |
|
||||
| `cinny/src/app/features/space-settings/permissions/` | Permissions |
|
||||
| `cinny/src/app/state/spaceSettings.ts` | Open state |
|
||||
| `cinny/src/app/state/hooks/spaceSettings.ts` | Hooks |
|
||||
|
||||
## Data model
|
||||
|
||||
|
||||
@@ -22,35 +22,35 @@ ClientBindAtoms.tsx binds Matrix events → atom updates
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/app/state/settings.ts` | User settings atom |
|
||||
| `cinny/src/app/state/sessions.ts` | Auth sessions |
|
||||
| `cinny/src/app/state/room-list/roomList.ts` | `allRoomsAtom`, ordering |
|
||||
| `cinny/src/app/state/room/roomToUnread.ts` | Unread counts |
|
||||
| `cinny/src/app/state/room/roomInputDrafts.ts` | Composer drafts + uploads |
|
||||
| `cinny/src/app/state/room/roomToParents.ts` | Space parent mapping |
|
||||
| `cinny/src/app/state/mDirectList.ts` | Direct message index |
|
||||
| `cinny/src/app/state/navToActivePath.ts` | Last active path per context |
|
||||
| `cinny/src/app/state/closedNavCategories.ts` | Collapsed nav sections |
|
||||
| `cinny/src/app/state/closedLobbyCategories.ts` | Collapsed lobby categories |
|
||||
| `cinny/src/app/state/createRoomModal.ts` | Create room modal state |
|
||||
| `cinny/src/app/state/createSpaceModal.ts` | Create space modal state |
|
||||
| `cinny/src/app/state/searchModal.ts` | Global search modal |
|
||||
| `cinny/src/app/state/utils/atomWithLocalStorage.ts` | Persistence helper |
|
||||
| `cinny/src/app/pages/client/ClientBindAtoms.ts` | Matrix → atom bindings |
|
||||
| Path | Role |
|
||||
| --------------------------------------------------- | ---------------------------- |
|
||||
| `cinny/src/app/state/settings.ts` | User settings atom |
|
||||
| `cinny/src/app/state/sessions.ts` | Auth sessions |
|
||||
| `cinny/src/app/state/room-list/roomList.ts` | `allRoomsAtom`, ordering |
|
||||
| `cinny/src/app/state/room/roomToUnread.ts` | Unread counts |
|
||||
| `cinny/src/app/state/room/roomInputDrafts.ts` | Composer drafts + uploads |
|
||||
| `cinny/src/app/state/room/roomToParents.ts` | Space parent mapping |
|
||||
| `cinny/src/app/state/mDirectList.ts` | Direct message index |
|
||||
| `cinny/src/app/state/navToActivePath.ts` | Last active path per context |
|
||||
| `cinny/src/app/state/closedNavCategories.ts` | Collapsed nav sections |
|
||||
| `cinny/src/app/state/closedLobbyCategories.ts` | Collapsed lobby categories |
|
||||
| `cinny/src/app/state/createRoomModal.ts` | Create room modal state |
|
||||
| `cinny/src/app/state/createSpaceModal.ts` | Create space modal state |
|
||||
| `cinny/src/app/state/searchModal.ts` | Global search modal |
|
||||
| `cinny/src/app/state/utils/atomWithLocalStorage.ts` | Persistence helper |
|
||||
| `cinny/src/app/pages/client/ClientBindAtoms.ts` | Matrix → atom bindings |
|
||||
|
||||
## Data model
|
||||
|
||||
Most state is **local only** (not Matrix). Exceptions: settings that also write account data (notification prefs via separate hooks).
|
||||
|
||||
| Atom area | Persists? |
|
||||
|-----------|-----------|
|
||||
| settings | localStorage |
|
||||
| room list order | localStorage |
|
||||
| drafts | localStorage |
|
||||
| unread | memory (derived from sync) |
|
||||
| modals | memory |
|
||||
| Atom area | Persists? |
|
||||
| --------------- | -------------------------- |
|
||||
| settings | localStorage |
|
||||
| room list order | localStorage |
|
||||
| drafts | localStorage |
|
||||
| unread | memory (derived from sync) |
|
||||
| modals | memory |
|
||||
|
||||
## Dependencies
|
||||
|
||||
|
||||
@@ -21,15 +21,15 @@ Stream Deck button press
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `streamdeck-plugin/com.paarrot.streamdeck.sdPlugin/manifest.json` | Plugin manifest |
|
||||
| `streamdeck-plugin/com.paarrot.streamdeck.sdPlugin/plugin/index.js` | Action implementations |
|
||||
| `streamdeck-plugin/com.paarrot.streamdeck.sdPlugin/plugin/index.html` | Property inspector UI |
|
||||
| `streamdeck-plugin/build.js` | Build `.streamDeckPlugin` bundle |
|
||||
| `streamdeck-plugin/validate.js` | Manifest validation |
|
||||
| `streamdeck-plugin/README.md` | User install guide |
|
||||
| `streamdeck-plugin/QUICKSTART.md` | Dev quickstart |
|
||||
| Path | Role |
|
||||
| --------------------------------------------------------------------- | -------------------------------- |
|
||||
| `streamdeck-plugin/com.paarrot.streamdeck.sdPlugin/manifest.json` | Plugin manifest |
|
||||
| `streamdeck-plugin/com.paarrot.streamdeck.sdPlugin/plugin/index.js` | Action implementations |
|
||||
| `streamdeck-plugin/com.paarrot.streamdeck.sdPlugin/plugin/index.html` | Property inspector UI |
|
||||
| `streamdeck-plugin/build.js` | Build `.streamDeckPlugin` bundle |
|
||||
| `streamdeck-plugin/validate.js` | Manifest validation |
|
||||
| `streamdeck-plugin/README.md` | User install guide |
|
||||
| `streamdeck-plugin/QUICKSTART.md` | Dev quickstart |
|
||||
|
||||
## Data model
|
||||
|
||||
|
||||
@@ -25,21 +25,21 @@ Room state: im.paarrot.sub_rooms { children: string[] }
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/app/hooks/useRoomSubRooms.ts` | Hook + `PaarrotSubRoomsContent` type |
|
||||
| `cinny/src/types/matrix/room.ts` | `StateEvent.PaarrotSubRooms` |
|
||||
| `cinny/src/app/pages/client/home/Home.tsx` | Renders nested list |
|
||||
| `cinny/src/app/features/room-nav/RoomNavItem.tsx` | Add sub-room action |
|
||||
| `cinny/src/app/features/room-nav/UnjoinedSubRoomItem.tsx` | Unjoined child UI |
|
||||
| `cinny/src/app/features/room-settings/sub-rooms/SubRooms.tsx` | Settings page |
|
||||
| `cinny/src/app/features/create-room/CreateRoomModal.tsx` | Appends new room to parent state |
|
||||
| `cinny/src/app/features/lobby/SpaceHierarchy.tsx` | Lobby hierarchy integration |
|
||||
| Path | Role |
|
||||
| ------------------------------------------------------------- | ------------------------------------ |
|
||||
| `cinny/src/app/hooks/useRoomSubRooms.ts` | Hook + `PaarrotSubRoomsContent` type |
|
||||
| `cinny/src/types/matrix/room.ts` | `StateEvent.PaarrotSubRooms` |
|
||||
| `cinny/src/app/pages/client/home/Home.tsx` | Renders nested list |
|
||||
| `cinny/src/app/features/room-nav/RoomNavItem.tsx` | Add sub-room action |
|
||||
| `cinny/src/app/features/room-nav/UnjoinedSubRoomItem.tsx` | Unjoined child UI |
|
||||
| `cinny/src/app/features/room-settings/sub-rooms/SubRooms.tsx` | Settings page |
|
||||
| `cinny/src/app/features/create-room/CreateRoomModal.tsx` | Appends new room to parent state |
|
||||
| `cinny/src/app/features/lobby/SpaceHierarchy.tsx` | Lobby hierarchy integration |
|
||||
|
||||
## Data model
|
||||
|
||||
| Event | State key | Content |
|
||||
|-------|-----------|---------|
|
||||
| Event | State key | Content |
|
||||
| ---------------------- | ------------ | ---------------------------------------------------- |
|
||||
| `im.paarrot.sub_rooms` | `""` (empty) | `{ children: string[] }` — room IDs in display order |
|
||||
|
||||
Power levels: treat like other state events; editors need `state_default` or explicit level for `im.paarrot.sub_rooms`.
|
||||
|
||||
@@ -24,21 +24,21 @@ vanilla-extract / folds tokens in colors.css.ts
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/app/pages/ThemeManager.tsx` | Route-level theme |
|
||||
| `cinny/src/app/state/settings.ts` | Settings including theme |
|
||||
| `cinny/src/app/hooks/useTheme.ts` | Theme hook |
|
||||
| `cinny/src/colors.css.ts` | Color tokens |
|
||||
| `cinny/src/app/pages/client/ClientNonUIFeatures.tsx` | Page zoom CSS |
|
||||
| `cinny/src/app/hooks/useViewTransitions.ts` | View transitions |
|
||||
| `cinny/src/app/hooks/useMessageSpacing.ts` | Message density |
|
||||
| `cinny/public/themes/` | Bundled theme files (if present) |
|
||||
| Path | Role |
|
||||
| ---------------------------------------------------- | -------------------------------- |
|
||||
| `cinny/src/app/pages/ThemeManager.tsx` | Route-level theme |
|
||||
| `cinny/src/app/state/settings.ts` | Settings including theme |
|
||||
| `cinny/src/app/hooks/useTheme.ts` | Theme hook |
|
||||
| `cinny/src/colors.css.ts` | Color tokens |
|
||||
| `cinny/src/app/pages/client/ClientNonUIFeatures.tsx` | Page zoom CSS |
|
||||
| `cinny/src/app/hooks/useViewTransitions.ts` | View transitions |
|
||||
| `cinny/src/app/hooks/useMessageSpacing.ts` | Message density |
|
||||
| `cinny/public/themes/` | Bundled theme files (if present) |
|
||||
|
||||
## Data model
|
||||
|
||||
| Key | Storage |
|
||||
|-----|---------|
|
||||
| Key | Storage |
|
||||
| -------------- | ------------------------------------------- |
|
||||
| `settingsAtom` | theme, pageZoom, messageSpacing, emojiStyle |
|
||||
|
||||
## Dependencies
|
||||
|
||||
@@ -24,25 +24,25 @@ SettingsPages enum
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/app/features/settings/Settings.tsx` | Settings modal shell |
|
||||
| `cinny/src/app/features/settings/general/General.tsx` | General prefs |
|
||||
| Path | Role |
|
||||
| ----------------------------------------------------- | ------------------------- |
|
||||
| `cinny/src/app/features/settings/Settings.tsx` | Settings modal shell |
|
||||
| `cinny/src/app/features/settings/general/General.tsx` | General prefs |
|
||||
| `cinny/src/app/features/settings/account/Profile.tsx` | Profile + avatar metadata |
|
||||
| `cinny/src/app/features/settings/notifications/` | Notification rules |
|
||||
| `cinny/src/app/features/settings/audio/Audio.tsx` | Call audio devices |
|
||||
| `cinny/src/app/features/settings/devices/` | Sessions & verification |
|
||||
| `cinny/src/app/features/settings/about/About.tsx` | About page |
|
||||
| `cinny/src/app/state/settings.ts` | Settings atom |
|
||||
| `cinny/src/app/pages/client/sidebar/SettingsTab.tsx` | Entry point |
|
||||
| `cinny/src/app/features/settings/notifications/` | Notification rules |
|
||||
| `cinny/src/app/features/settings/audio/Audio.tsx` | Call audio devices |
|
||||
| `cinny/src/app/features/settings/devices/` | Sessions & verification |
|
||||
| `cinny/src/app/features/settings/about/About.tsx` | About page |
|
||||
| `cinny/src/app/state/settings.ts` | Settings atom |
|
||||
| `cinny/src/app/pages/client/sidebar/SettingsTab.tsx` | Entry point |
|
||||
|
||||
## Data model
|
||||
|
||||
| Key | Storage |
|
||||
|-----|---------|
|
||||
| Key | Storage |
|
||||
| -------------- | --------------------------------------------- |
|
||||
| `settingsAtom` | localStorage (theme, zoom, emoji style, etc.) |
|
||||
| Profile | Matrix account data + avatar MXC |
|
||||
| Push rules | Homeserver account data |
|
||||
| Profile | Matrix account data + avatar MXC |
|
||||
| Push rules | Homeserver account data |
|
||||
|
||||
## Dependencies
|
||||
|
||||
|
||||
@@ -23,26 +23,26 @@ useCallService (CallProvider)
|
||||
|
||||
## Key files
|
||||
|
||||
| Path | Role |
|
||||
|------|------|
|
||||
| `cinny/src/app/features/call/useCall.ts` | React context, global CallService ref |
|
||||
| `cinny/src/app/features/call/CallService.ts` | Core call logic |
|
||||
| `cinny/src/app/features/call/types.ts` | CallState, ActiveCall, events |
|
||||
| `cinny/src/app/features/call/useRtcConfig.ts` | Homeserver RTC / LiveKit discovery |
|
||||
| `cinny/src/app/features/call/CallOverlay.tsx` | Full-screen call UI |
|
||||
| `cinny/src/app/features/call/DockedCallPanel.tsx` | Docked UI |
|
||||
| `cinny/src/app/features/call/SidebarDockedCallPanel.tsx` | Sidebar variant |
|
||||
| `cinny/src/app/features/call/useRemoteCursor.ts` | Screen-share cursor sync |
|
||||
| `cinny/src/app/features/call/CallSounds.ts` | Join/leave sounds |
|
||||
| `cinny/src/app/features/room-nav/CallParticipantsIndicator.tsx` | Nav badge |
|
||||
| `cinny/src/types/matrix/room.ts` | `StateEvent.CallMember` |
|
||||
| Path | Role |
|
||||
| --------------------------------------------------------------- | ------------------------------------- |
|
||||
| `cinny/src/app/features/call/useCall.ts` | React context, global CallService ref |
|
||||
| `cinny/src/app/features/call/CallService.ts` | Core call logic |
|
||||
| `cinny/src/app/features/call/types.ts` | CallState, ActiveCall, events |
|
||||
| `cinny/src/app/features/call/useRtcConfig.ts` | Homeserver RTC / LiveKit discovery |
|
||||
| `cinny/src/app/features/call/CallOverlay.tsx` | Full-screen call UI |
|
||||
| `cinny/src/app/features/call/DockedCallPanel.tsx` | Docked UI |
|
||||
| `cinny/src/app/features/call/SidebarDockedCallPanel.tsx` | Sidebar variant |
|
||||
| `cinny/src/app/features/call/useRemoteCursor.ts` | Screen-share cursor sync |
|
||||
| `cinny/src/app/features/call/CallSounds.ts` | Join/leave sounds |
|
||||
| `cinny/src/app/features/room-nav/CallParticipantsIndicator.tsx` | Nav badge |
|
||||
| `cinny/src/types/matrix/room.ts` | `StateEvent.CallMember` |
|
||||
|
||||
## Data model
|
||||
|
||||
| Key | Scope | Notes |
|
||||
|-----|-------|-------|
|
||||
| `org.matrix.msc3401.call.member` | Room state | Call membership |
|
||||
| LiveKit JWT / room | Ephemeral | From homeserver RTC focus |
|
||||
| Key | Scope | Notes |
|
||||
| -------------------------------- | ---------- | ------------------------- |
|
||||
| `org.matrix.msc3401.call.member` | Room state | Call membership |
|
||||
| LiveKit JWT / room | Ephemeral | From homeserver RTC focus |
|
||||
|
||||
Call mute/deafen/video state lives in `CallService` memory, not Matrix account data.
|
||||
|
||||
|
||||
@@ -0,0 +1,139 @@
|
||||
import { createRequire } from 'node:module';
|
||||
import { fixupConfigRules } from '@eslint/compat';
|
||||
import globals from 'globals';
|
||||
import js from '@eslint/js';
|
||||
import airbnb from 'eslint-config-airbnb';
|
||||
import prettier from 'eslint-config-prettier';
|
||||
import tsParser from '@typescript-eslint/parser';
|
||||
import tsPlugin from '@typescript-eslint/eslint-plugin';
|
||||
import importPlugin from 'eslint-plugin-import';
|
||||
import jsxAllyPlugin from 'eslint-plugin-jsx-a11y';
|
||||
import reactPlugin from 'eslint-plugin-react';
|
||||
import reactHooksPlugin from 'eslint-plugin-react-hooks';
|
||||
|
||||
const require = createRequire(import.meta.url);
|
||||
|
||||
// Config entries without `files` only match .js/.mjs, so every entry needs the same file set.
|
||||
const files = ['**/*.js', '**/*.mjs', '**/*.cjs', '**/*.ts', '**/*.tsx'];
|
||||
|
||||
// eslint-config-airbnb 19 is legacy-only: `extends` are paths to rule modules and flat config
|
||||
// rejects `extends`/`env`/`parserOptions`, so take their rules and set the env here instead.
|
||||
const airbnbRules = (config) =>
|
||||
(config.extends || []).flatMap((p) => airbnbRules(require(p))).concat(config);
|
||||
|
||||
// Plugins are registered once (redefining a plugin is an error) and fixed up so the legacy
|
||||
// rules that call context.getFilename still work.
|
||||
export default [
|
||||
...fixupConfigRules([
|
||||
{
|
||||
files,
|
||||
plugins: {
|
||||
react: reactPlugin,
|
||||
'react-hooks': reactHooksPlugin,
|
||||
'@typescript-eslint': tsPlugin,
|
||||
import: importPlugin,
|
||||
'jsx-a11y': jsxAllyPlugin,
|
||||
},
|
||||
languageOptions: {
|
||||
parser: tsParser,
|
||||
ecmaVersion: 'latest',
|
||||
sourceType: 'module',
|
||||
globals: { ...globals.browser, ...globals.es2021, JSX: 'readonly' },
|
||||
},
|
||||
},
|
||||
]),
|
||||
...[
|
||||
js.configs.recommended,
|
||||
reactPlugin.configs.flat.recommended,
|
||||
reactHooksPlugin.configs.flat.recommended,
|
||||
tsPlugin.configs['flat/eslint-recommended'],
|
||||
tsPlugin.configs['flat/recommended'],
|
||||
...airbnbRules(airbnb),
|
||||
prettier,
|
||||
{
|
||||
rules: {
|
||||
'linebreak-style': 0,
|
||||
'no-underscore-dangle': 0,
|
||||
'no-shadow': 'off',
|
||||
'no-console': 'off',
|
||||
|
||||
// The build uses the automatic JSX runtime, so this rule asks for imports the code never needs.
|
||||
'react/react-in-jsx-scope': 'off',
|
||||
|
||||
'import/prefer-default-export': 'off',
|
||||
'import/extensions': 'off',
|
||||
'import/no-unresolved': 'off',
|
||||
'import/no-extraneous-dependencies': [
|
||||
'error',
|
||||
{
|
||||
devDependencies: true,
|
||||
},
|
||||
],
|
||||
|
||||
'react/no-unstable-nested-components': ['error', { allowAsProps: true }],
|
||||
'react/jsx-filename-extension': [
|
||||
'error',
|
||||
{
|
||||
extensions: ['.tsx', '.jsx'],
|
||||
},
|
||||
],
|
||||
|
||||
'react/require-default-props': 'off',
|
||||
'react/jsx-props-no-spreading': 'off',
|
||||
'react-hooks/rules-of-hooks': 'error',
|
||||
|
||||
// The 9 findings were restructured to a reactive source where one exists. The 3 left have
|
||||
// none: a 1s poll counter in useTheme.ts and a mount-only effect in RoomTimeline.tsx.
|
||||
'react-hooks/exhaustive-deps': 'off',
|
||||
|
||||
// The build does not run React Compiler, so these rules report advice about a compiler
|
||||
// that never runs. Keep the two rules above, which catch real bugs.
|
||||
'react-hooks/set-state-in-effect': 'off',
|
||||
'react-hooks/set-state-in-render': 'off',
|
||||
'react-hooks/refs': 'off',
|
||||
'react-hooks/immutability': 'off',
|
||||
'react-hooks/incompatible-library': 'off',
|
||||
'react-hooks/preserve-manual-memoization': 'off',
|
||||
'react-hooks/purity': 'off',
|
||||
'react-hooks/use-memo': 'off',
|
||||
|
||||
// Genuine shift and mask work in discordCollectibles.ts and cryptE2ERoomKeys.js.
|
||||
'no-bitwise': 'off',
|
||||
|
||||
// 60 of the 61 findings are property mutations on objects the caller passes in, and the
|
||||
// callers depend on the mutation. Reassigning the parameter itself is still a finding.
|
||||
'no-param-reassign': ['error', { props: false }],
|
||||
|
||||
// The sequential awaits here are deliberate: the rate-limit delays in Permissions.tsx and
|
||||
// the endpoint poll loop in backgroundSync.ts break if the awaits are parallelised.
|
||||
'no-await-in-loop': 'off',
|
||||
|
||||
'@typescript-eslint/no-unused-vars': 'error',
|
||||
'@typescript-eslint/no-shadow': 'error',
|
||||
|
||||
// The 14 findings left are vendored plugin API types that declare any, event keys chosen at
|
||||
// runtime, and msgContent builders that cannot produce RoomMessageEventContent.
|
||||
'@typescript-eslint/no-explicit-any': 'off',
|
||||
|
||||
// Matrix video events carry no caption field, so there is no caption source to read.
|
||||
'jsx-a11y/media-has-caption': 'off',
|
||||
|
||||
// Prism tokens are not unique within a line, so the array index is the only key available.
|
||||
'react/no-array-index-key': 'off',
|
||||
},
|
||||
},
|
||||
].flatMap((config) =>
|
||||
(Array.isArray(config) ? config : [config]).map((config) => ({
|
||||
files,
|
||||
rules: config.rules || {},
|
||||
...(config.settings ? { settings: config.settings } : {}),
|
||||
})),
|
||||
),
|
||||
// Type-only references (React.DragEvent, PermissionState) are not runtime globals, so no-undef
|
||||
// has to be off for the TS files too, not just *.ts. The base no-unused-vars also double-fires on
|
||||
// type-signature params and enum members, which @typescript-eslint/no-unused-vars handles instead.
|
||||
{
|
||||
files: ['**/*.ts', '**/*.tsx'],
|
||||
rules: { 'no-undef': 'off', 'no-unused-vars': 'off' },
|
||||
},
|
||||
];
|
||||
+7
-7
@@ -1,10 +1,13 @@
|
||||
<!DOCTYPE html>
|
||||
<!doctype html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="UTF-8" />
|
||||
<base href="./" />
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, viewport-fit=cover" />
|
||||
<meta
|
||||
name="viewport"
|
||||
content="width=device-width, initial-scale=1.0, maximum-scale=1.0, viewport-fit=cover"
|
||||
/>
|
||||
<title>Paarrot</title>
|
||||
<meta name="name" content="Paarrot" />
|
||||
<meta name="author" content="Ajay Bura" />
|
||||
@@ -12,10 +15,7 @@
|
||||
name="description"
|
||||
content="A Matrix client where you can enjoy the conversation using simple, elegant and secure interface protected by e2ee with the power of open source."
|
||||
/>
|
||||
<meta
|
||||
name="keywords"
|
||||
content="paarrot, matrix, matrix client, matrix.org, element"
|
||||
/>
|
||||
<meta name="keywords" content="paarrot, matrix, matrix client, matrix.org, element" />
|
||||
|
||||
<meta property="og:title" content="Paarrot" />
|
||||
<meta property="og:url" content="https://github.com/Paarrot/Paarrot-Desktop" />
|
||||
@@ -90,7 +90,7 @@
|
||||
href="./public/res/apple/apple-touch-icon-180x180.png"
|
||||
/>
|
||||
</head>
|
||||
<body id="appBody" style="background-color: #262626;">
|
||||
<body id="appBody" style="background-color: #262626">
|
||||
<script>
|
||||
window.global ||= window;
|
||||
</script>
|
||||
|
||||
Generated
+1521
-71
File diff suppressed because it is too large
Load Diff
+7
-10
@@ -9,13 +9,12 @@
|
||||
},
|
||||
"scripts": {
|
||||
"start": "vite",
|
||||
"build": "vite build",
|
||||
"build": "node scripts/generate-update-manifest.mjs && vite build",
|
||||
"lint": "yarn check:eslint && yarn check:prettier",
|
||||
"check:eslint": "eslint src/*",
|
||||
"check:prettier": "prettier --check .",
|
||||
"fix:prettier": "prettier --write .",
|
||||
"typecheck": "tsc --noEmit",
|
||||
"playground": "vite"
|
||||
"typecheck": "tsc --noEmit"
|
||||
},
|
||||
"keywords": [],
|
||||
"author": "Ajay Bura",
|
||||
@@ -32,13 +31,6 @@
|
||||
"@tanstack/react-query-devtools": "5.101.2",
|
||||
"@tanstack/react-virtual": "3.14.5",
|
||||
"@tauri-apps/api": "2.11.1",
|
||||
"@tauri-apps/plugin-dialog": "2.7.1",
|
||||
"@tauri-apps/plugin-fs": "2.5.1",
|
||||
"@tauri-apps/plugin-http": "2.5.9",
|
||||
"@tauri-apps/plugin-notification": "2.3.3",
|
||||
"@tauri-apps/plugin-opener": "2",
|
||||
"@tauri-apps/plugin-process": "2.3.1",
|
||||
"@tauri-apps/plugin-updater": "2.10.1",
|
||||
"@types/pako": "2.0.4",
|
||||
"@vanilla-extract/css": "1.21.1",
|
||||
"@vanilla-extract/recipes": "0.5.7",
|
||||
@@ -84,8 +76,10 @@
|
||||
"react-error-boundary": "6.1.2",
|
||||
"react-google-recaptcha": "3.1.0",
|
||||
"react-i18next": "17.0.8",
|
||||
"react-markdown": "10.1.0",
|
||||
"react-range": "1.10.0",
|
||||
"react-router-dom": "7.18.1",
|
||||
"remark-gfm": "4.0.1",
|
||||
"sanitize-html": "2.17.5",
|
||||
"slate": "0.124.1",
|
||||
"slate-dom": "0.124.1",
|
||||
@@ -95,6 +89,8 @@
|
||||
},
|
||||
"devDependencies": {
|
||||
"@esbuild-plugins/node-globals-polyfill": "0.2.3",
|
||||
"@eslint/compat": "2.1.1",
|
||||
"@eslint/js": "10.0.1",
|
||||
"@monaco-editor/react": "4.7.0",
|
||||
"@rollup/plugin-inject": "5.0.5",
|
||||
"@rollup/plugin-wasm": "6.2.2",
|
||||
@@ -119,6 +115,7 @@
|
||||
"eslint-plugin-jsx-a11y": "6.10.2",
|
||||
"eslint-plugin-react": "7.37.5",
|
||||
"eslint-plugin-react-hooks": "7.1.1",
|
||||
"globals": "17.13.0",
|
||||
"monaco-editor": "0.52.2",
|
||||
"prettier": "3.9.4",
|
||||
"typescript": "6.0.3",
|
||||
|
||||
@@ -1,149 +0,0 @@
|
||||
import path from 'node:path';
|
||||
import fs from 'node:fs';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
import type { Plugin, ViteDevServer } from 'vite';
|
||||
|
||||
export type LiveTsxApi = {
|
||||
getSource: () => string;
|
||||
setSource: (source: string) => void;
|
||||
};
|
||||
|
||||
const ALLOWED_PREFIXES = ['src/app/components/', 'src/app/features/'];
|
||||
|
||||
function resolveAppSourceFile(projectRoot: string, relPath: string): string | null {
|
||||
const normalized = relPath.replace(/\\/g, '/').replace(/^\/+/, '');
|
||||
if (normalized.includes('..') || path.isAbsolute(normalized)) return null;
|
||||
if (!ALLOWED_PREFIXES.some((p) => normalized.startsWith(p))) return null;
|
||||
if (!/\.(tsx|ts)$/.test(normalized)) return null;
|
||||
const abs = path.resolve(projectRoot, normalized);
|
||||
const root = path.resolve(projectRoot);
|
||||
if (!abs.startsWith(root + path.sep) && abs !== root) return null;
|
||||
return abs;
|
||||
}
|
||||
|
||||
function readBody(req: NodeJS.ReadableStream): Promise<string> {
|
||||
return new Promise((resolve, reject) => {
|
||||
const chunks: Buffer[] = [];
|
||||
req.on('data', (c) => chunks.push(c));
|
||||
req.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')));
|
||||
req.on('error', reject);
|
||||
});
|
||||
}
|
||||
|
||||
function bumpLivePreview(server: ViteDevServer | undefined) {
|
||||
if (!server) return;
|
||||
server.ws.send({
|
||||
type: 'custom',
|
||||
event: 'playground:live-updated',
|
||||
data: { revision: Date.now() },
|
||||
});
|
||||
}
|
||||
|
||||
export function liveTsxPlugin(projectRoot: string, initialSource: string): Plugin {
|
||||
const liveFile = path.resolve(projectRoot, '.cache/playground-live.tsx');
|
||||
|
||||
fs.mkdirSync(path.dirname(liveFile), { recursive: true });
|
||||
fs.writeFileSync(liveFile, initialSource, 'utf8');
|
||||
|
||||
let source = initialSource;
|
||||
let server: ViteDevServer | undefined;
|
||||
|
||||
const api: LiveTsxApi = {
|
||||
getSource: () => source,
|
||||
setSource: (next) => {
|
||||
source = next;
|
||||
fs.writeFileSync(liveFile, next, 'utf8');
|
||||
if (!server) return;
|
||||
for (const m of server.moduleGraph.urlToModuleMap.values()) {
|
||||
if (m.file === liveFile) server.moduleGraph.invalidateModule(m);
|
||||
}
|
||||
const byId = server.moduleGraph.getModuleById(liveFile);
|
||||
if (byId) server.moduleGraph.invalidateModule(byId);
|
||||
bumpLivePreview(server);
|
||||
},
|
||||
};
|
||||
|
||||
return {
|
||||
name: 'playground-live-tsx',
|
||||
configureServer(devServer) {
|
||||
server = devServer;
|
||||
(devServer as ViteDevServer & { playgroundLive?: LiveTsxApi }).playgroundLive = api;
|
||||
|
||||
devServer.middlewares.use('/__playground/live', (req, res, next) => {
|
||||
if (req.method === 'GET') {
|
||||
res.setHeader('Content-Type', 'text/plain; charset=utf-8');
|
||||
res.end(source);
|
||||
return;
|
||||
}
|
||||
if (req.method === 'POST') {
|
||||
void readBody(req).then((body) => {
|
||||
api.setSource(body);
|
||||
res.statusCode = 204;
|
||||
res.end();
|
||||
});
|
||||
return;
|
||||
}
|
||||
next();
|
||||
});
|
||||
|
||||
// Read/write real Cinny component sources (strings, markup, etc.).
|
||||
devServer.middlewares.use('/__playground/source', (req, res, next) => {
|
||||
const url = new URL(req.url ?? '', 'http://playground.local');
|
||||
const rel = url.searchParams.get('path') ?? '';
|
||||
const abs = resolveAppSourceFile(projectRoot, rel);
|
||||
if (!abs) {
|
||||
res.statusCode = 400;
|
||||
res.end('Invalid or disallowed path');
|
||||
return;
|
||||
}
|
||||
|
||||
if (req.method === 'GET') {
|
||||
if (!fs.existsSync(abs)) {
|
||||
res.statusCode = 404;
|
||||
res.end('Not found');
|
||||
return;
|
||||
}
|
||||
res.setHeader('Content-Type', 'text/plain; charset=utf-8');
|
||||
res.end(fs.readFileSync(abs, 'utf8'));
|
||||
return;
|
||||
}
|
||||
|
||||
if (req.method === 'POST') {
|
||||
void readBody(req).then((body) => {
|
||||
fs.mkdirSync(path.dirname(abs), { recursive: true });
|
||||
fs.writeFileSync(abs, body, 'utf8');
|
||||
const mod =
|
||||
server?.moduleGraph.getModuleById(abs) ??
|
||||
[...(server?.moduleGraph.urlToModuleMap.values() ?? [])].find((m) => m.file === abs);
|
||||
if (mod && server) server.moduleGraph.invalidateModule(mod);
|
||||
bumpLivePreview(server);
|
||||
res.statusCode = 204;
|
||||
res.end();
|
||||
});
|
||||
return;
|
||||
}
|
||||
|
||||
next();
|
||||
});
|
||||
},
|
||||
resolveId(id) {
|
||||
const clean = id.split('?')[0];
|
||||
if (
|
||||
clean === '/@playground/live.tsx' ||
|
||||
clean === 'virtual:playground-live' ||
|
||||
clean.endsWith('/.cache/playground-live.tsx')
|
||||
) {
|
||||
return liveFile;
|
||||
}
|
||||
return undefined;
|
||||
},
|
||||
};
|
||||
}
|
||||
|
||||
export function readDefaultLiveSource(projectRoot: string): string {
|
||||
return fs.readFileSync(path.join(projectRoot, 'src/playground/defaultLive.tsx'), 'utf8');
|
||||
}
|
||||
|
||||
export function projectRootDir(): string {
|
||||
return path.dirname(fileURLToPath(import.meta.url));
|
||||
}
|
||||
@@ -1,12 +0,0 @@
|
||||
<!doctype html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="UTF-8" />
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||||
<title>Component Playground</title>
|
||||
</head>
|
||||
<body style="margin:0;background:#0f1115;color:#e8eaed">
|
||||
<div id="root"></div>
|
||||
<script type="module" src="./src/playground/main.tsx?v=react-dedupe-1"></script>
|
||||
</body>
|
||||
</html>
|
||||
+857
-1
File diff suppressed because one or more lines are too long
@@ -0,0 +1,16 @@
|
||||
---
|
||||
version: 4.11.175
|
||||
title: Stability & polish
|
||||
date: 2026-08-10
|
||||
summary: Desktop update flow improvements and UI refinements.
|
||||
---
|
||||
|
||||
## Desktop updates
|
||||
|
||||
- Smoother download and install flow in the title bar updater.
|
||||
- Better handling when an update is already downloading.
|
||||
|
||||
## UI polish
|
||||
|
||||
- Refined spacing and contrast in settings panels.
|
||||
- Improved mobile layout for room headers and notifications.
|
||||
@@ -0,0 +1,22 @@
|
||||
---
|
||||
version: 4.11.177
|
||||
title: Profile colors & banners
|
||||
date: 2026-08-23
|
||||
summary: Username colors now follow MSC4522 with separate dark and light theme pickers.
|
||||
---
|
||||
|
||||
## Profile colors (MSC4522)
|
||||
|
||||
Username colors are now stored on your Matrix profile instead of inside avatar images. In turn **will need to be updated in your Account settings**, this is now cross compatible with Element + Cinny
|
||||
|
||||
- Set **separate colors for dark and light themes** in Settings → Account → Profile.
|
||||
- Per-room username overrides are read from member profile data when available.
|
||||
|
||||

|
||||
|
||||
## Profile banners (MSC4133)
|
||||
|
||||
Profile banners now live on your Matrix profile via `m.banner_url` (MSC4133), not embedded in avatar metadata.
|
||||
|
||||
- Upload or remove a banner independently from your avatar.
|
||||
- Other clients that support MSC4133 can read your banner directly.
|
||||
@@ -0,0 +1,21 @@
|
||||
---
|
||||
version: 4.11.185
|
||||
title: Discord collectibles
|
||||
date: 2026-08-24
|
||||
summary: Add Discord-style profile effects, nameplates, and avatar decorations to Paarrot profiles.
|
||||
---
|
||||
|
||||
## Discord collectibles
|
||||
|
||||
- Browse and apply profile effects, animated nameplates, and avatar decorations in Settings → Account → Profile.
|
||||
- Collectible assets are uploaded to your Matrix profile, so other Paarrot users can see them without Discord.
|
||||
- The catalog now comes from a public git, and no Discord token is required in Paarrot for the cosmetics.
|
||||
- Profile-effect previews play their intro and loop animations, with a mini profile preview for each effect.
|
||||
|
||||
 
|
||||
|
||||
## Profile presentation
|
||||
|
||||
- Avatar decorations render in messages, profile cards, and the bottom sidebar avatar.
|
||||
- Nameplates to the right of messages, beneath timestamps and can be displayed behind the bottom sidebar avatar with opacity settings.
|
||||
- Customize the sidebar nameplate opacity in Settings → General → Collectibles.
|
||||
@@ -0,0 +1,14 @@
|
||||
---
|
||||
version: 4.11.193
|
||||
title: Profile caching
|
||||
date: 2026-10-06
|
||||
summary: Profile colour, banner, and collectibles now share one cache, so opening a profile makes one request instead of three.
|
||||
---
|
||||
|
||||
## Profile caching
|
||||
|
||||
- Colour, banner, and collectibles all come from the same profile endpoint, and they now read through one shared cache with a single TTL instead of keeping three separate caches with different expiries.
|
||||
- Opening a profile view costs one request, and concurrent viewers of the same user share it instead of each firing their own.
|
||||
- Banner and collectible images are kept as cached blob URLs and reused across views, instead of being re-downloaded and discarded every time a profile opens.
|
||||
- Profile cards read the sync-cached user when it is available and only fetch when both the SDK cache and the shared cache are cold.
|
||||
- A redundant database scan was removed from the crypto startup path, which shaves a little off launch.
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 15 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 105 KiB |
File diff suppressed because one or more lines are too long
|
After Width: | Height: | Size: 889 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 58 KiB |
@@ -0,0 +1,23 @@
|
||||
{
|
||||
"current": "currentupdate.md",
|
||||
"older": [
|
||||
{
|
||||
"file": "4.11.185.md",
|
||||
"version": "4.11.185",
|
||||
"title": "Discord collectibles",
|
||||
"date": "2026-08-24"
|
||||
},
|
||||
{
|
||||
"file": "4.11.177.md",
|
||||
"version": "4.11.177",
|
||||
"title": "Profile colors & banners",
|
||||
"date": "2026-08-23"
|
||||
},
|
||||
{
|
||||
"file": "4.11.175.md",
|
||||
"version": "4.11.175",
|
||||
"title": "Stability & polish",
|
||||
"date": "2026-08-10"
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,90 @@
|
||||
#!/usr/bin/env bash
|
||||
# Files one open Gitea issue per rule key, deduped by the marker line in the issue body.
|
||||
# Never exits non-zero: findings are reported, not enforced.
|
||||
set -u
|
||||
|
||||
API_BASE="${API_BASE:?API_BASE is required}"
|
||||
REPO="${REPO:?REPO is required}"
|
||||
TOKEN="${TOKEN:?TOKEN is required}"
|
||||
SHA="${SHA:-}"
|
||||
BASE="${WEB_BASE:-${API_BASE%/api/v1}}"
|
||||
LABEL="ci-checks"
|
||||
SHOW="${SHOW:-50}"
|
||||
|
||||
cd "$(dirname "$0")/.."
|
||||
WORK=$(mktemp -d)
|
||||
trap 'rm -rf "$WORK"' EXIT
|
||||
FINDINGS="$WORK/findings.tsv"
|
||||
: > "$FINDINGS"
|
||||
|
||||
# key<TAB>violation, one line per finding.
|
||||
npx eslint src --format json > "$WORK/eslint.json" || true
|
||||
jq -r --arg root "$PWD" '.[] | .filePath as $f | .messages[] | select(.ruleId) | "eslint/" + .ruleId + "\t" + (($f | ltrimstr($root + "/")) + ":" + (.line | tostring))' "$WORK/eslint.json" >> "$FINDINGS"
|
||||
|
||||
npx prettier --check . > "$WORK/prettier.log" 2>&1 || true
|
||||
# Prettier forces colour in CI, so strip the ANSI codes before matching.
|
||||
sed -E 's/\x1b\[[0-9;]*m//g' "$WORK/prettier.log" | sed -nE 's/^\[warn\] (.*)$/prettier\t\1/p' >> "$FINDINGS"
|
||||
|
||||
npx tsc --noEmit > "$WORK/tsc.log" 2>&1 || true
|
||||
sed -E 's/\x1b\[[0-9;]*m//g' "$WORK/tsc.log" | sed -nE 's/^(.*)\(([0-9]+),([0-9]+)\): error (TS[0-9]+):.*/tsc\/\4\t\1(\2,\3)/p' >> "$FINDINGS"
|
||||
|
||||
api() { # api METHOD PATH [JSON] -> response body on stdout, non-zero on HTTP failure
|
||||
local method=$1 path=$2 data=${3-} code
|
||||
code=$(curl -sS -o "$WORK/resp" -w '%{http_code}' -X "$method" \
|
||||
-H "Authorization: token $TOKEN" -H 'Content-Type: application/json' \
|
||||
${data:+-d "$data"} "$API_BASE/repos/$REPO$path") || return 1
|
||||
case "$code" in
|
||||
200 | 201) cat "$WORK/resp" ;;
|
||||
*) echo "HTTP $code $method $path: $(cat "$WORK/resp")" >&2; return 1 ;;
|
||||
esac
|
||||
}
|
||||
|
||||
body() { # body KEY HASH VIOLATIONS_FILE
|
||||
printf '<!-- ci-check: %s -->\n<!-- ci-check-hash: %s -->\n\n`%s`: %d violations.\n\n```text\n' \
|
||||
"$1" "$2" "$1" "$(wc -l < "$3")"
|
||||
head -n "$SHOW" "$3"
|
||||
printf '```\n'
|
||||
}
|
||||
|
||||
LABEL_ID=$(api GET "/labels?limit=100" | jq -r --arg n "$LABEL" '[.[] | select(.name == $n) | .id] | first // empty')
|
||||
if [ -z "$LABEL_ID" ]; then
|
||||
LABEL_ID=$(api POST "/labels" "$(jq -n --arg n "$LABEL" '{name: $n, color: "006060"}')" | jq -r '.id')
|
||||
fi
|
||||
|
||||
# Gitea caps per_page at 50, so paging is required or dedupe misses issues past the first page.
|
||||
# Accumulate as JSONL: passing the accumulated set as a jq program argument overflows argv.
|
||||
OPEN="$WORK/open.jsonl"
|
||||
: > "$OPEN"
|
||||
for page in 1 2 3 4 5 6 7 8; do
|
||||
api GET "/issues?state=open&limit=50&page=$page" | jq -c --arg l "$LABEL" '[.[] | select((.labels // []) | any(.name == $l))]' > "$WORK/page.json"
|
||||
n=$(jq -r 'length' "$WORK/page.json")
|
||||
[ -z "$n" ] && break
|
||||
jq -c '.[]' "$WORK/page.json" >> "$OPEN"
|
||||
[ "$n" -lt 50 ] && break
|
||||
done
|
||||
|
||||
for key in $(cut -f1 "$FINDINGS" | sort -u); do
|
||||
vf="$WORK/violations.tsv"
|
||||
awk -F'\t' -v k="$key" '$1 == k' "$FINDINGS" | sort > "$vf"
|
||||
hash=$(sha256sum < "$vf" | cut -d' ' -f1)
|
||||
row=$(jq -c --arg k "$key" 'select((.body // "") | contains("<!-- ci-check: " + $k + " -->"))' "$OPEN" | head -1)
|
||||
|
||||
if [ -z "$row" ]; then
|
||||
api POST "/issues" "$(jq -n --arg t "ci-check: $key" --arg b "$(body "$key" "$hash" "$vf")" --argjson l "$LABEL_ID" '{title: $t, body: $b, labels: [$l]}')" > /dev/null
|
||||
elif ! echo "$row" | jq -e --arg h "$hash" '(.body // "") | contains("<!-- ci-check-hash: " + $h + " -->")' > /dev/null; then
|
||||
api PATCH "/issues/$(jq -r '.number' <<< "$row")" "$(jq -n --arg b "$(body "$key" "$hash" "$vf")" '{body: $b}')" > /dev/null
|
||||
fi
|
||||
done
|
||||
|
||||
jq -r '[((.body // "") | capture("<!-- ci-check: (?<k>[^ ]+) -->").k), .number] | @tsv' "$OPEN" > "$WORK/keys.tsv"
|
||||
|
||||
while IFS=$'\t' read -r key number; do
|
||||
if ! grep -qF -- "$key"$'\t' "$FINDINGS"; then
|
||||
if [ -n "$SHA" ]; then
|
||||
api POST "/issues/$number/comments" "$(jq -n --arg b "Fixed in [$(printf '%s' "$SHA" | cut -c1-7)]($BASE/$REPO/commit/$SHA)." '{body: $b}')" > /dev/null
|
||||
fi
|
||||
api PATCH "/issues/$number" '{"state": "closed"}' > /dev/null
|
||||
fi
|
||||
done < "$WORK/keys.tsv"
|
||||
|
||||
exit 0
|
||||
@@ -0,0 +1,112 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* Regenerates public/update/manifest.json from markdown files.
|
||||
*
|
||||
* - currentupdate.md is always the "current" entry
|
||||
* - Other *.md files matching X.Y.Z.md become "older" (sorted newest first)
|
||||
* - title, date, version come from YAML frontmatter when present
|
||||
*/
|
||||
|
||||
import fs from 'fs';
|
||||
import path from 'path';
|
||||
import { fileURLToPath } from 'url';
|
||||
|
||||
const __dirname = path.dirname(fileURLToPath(import.meta.url));
|
||||
const ROOT = path.resolve(__dirname, '..');
|
||||
const UPDATE_DIR = path.join(ROOT, 'public', 'update');
|
||||
const MANIFEST_PATH = path.join(UPDATE_DIR, 'manifest.json');
|
||||
const CURRENT_FILE = 'currentupdate.md';
|
||||
const VERSION_FILE_RE = /^(\d+\.\d+\.\d+)\.md$/;
|
||||
|
||||
const FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/;
|
||||
|
||||
function parseFrontmatter(source) {
|
||||
const match = FRONTMATTER_RE.exec(source.trimStart());
|
||||
if (!match) return {};
|
||||
|
||||
const frontmatter = {};
|
||||
match[1].split('\n').forEach((line) => {
|
||||
const colon = line.indexOf(':');
|
||||
if (colon <= 0) return;
|
||||
const key = line.slice(0, colon).trim();
|
||||
const raw = line.slice(colon + 1).trim();
|
||||
frontmatter[key] = raw.replace(/^['"]|['"]$/g, '');
|
||||
});
|
||||
return frontmatter;
|
||||
}
|
||||
|
||||
function compareVersions(a, b) {
|
||||
const pa = a.split('.').map((part) => Number.parseInt(part, 10));
|
||||
const pb = b.split('.').map((part) => Number.parseInt(part, 10));
|
||||
const len = Math.max(pa.length, pb.length);
|
||||
|
||||
for (let i = 0; i < len; i += 1) {
|
||||
const na = pa[i] ?? 0;
|
||||
const nb = pb[i] ?? 0;
|
||||
if (na !== nb) return nb - na;
|
||||
}
|
||||
return 0;
|
||||
}
|
||||
|
||||
function readMarkdownMeta(fileName) {
|
||||
const filePath = path.join(UPDATE_DIR, fileName);
|
||||
const source = fs.readFileSync(filePath, 'utf8');
|
||||
const frontmatter = parseFrontmatter(source);
|
||||
const versionFromName = VERSION_FILE_RE.exec(fileName)?.[1];
|
||||
|
||||
return {
|
||||
file: fileName,
|
||||
version: frontmatter.version ?? versionFromName,
|
||||
title: frontmatter.title,
|
||||
date: frontmatter.date,
|
||||
};
|
||||
}
|
||||
|
||||
function buildManifest() {
|
||||
if (!fs.existsSync(UPDATE_DIR)) {
|
||||
throw new Error(`Update directory not found: ${UPDATE_DIR}`);
|
||||
}
|
||||
|
||||
const currentPath = path.join(UPDATE_DIR, CURRENT_FILE);
|
||||
if (!fs.existsSync(currentPath)) {
|
||||
throw new Error(`Missing ${CURRENT_FILE} in ${UPDATE_DIR}`);
|
||||
}
|
||||
|
||||
const older = fs
|
||||
.readdirSync(UPDATE_DIR, { withFileTypes: true })
|
||||
.filter((entry) => entry.isFile() && VERSION_FILE_RE.test(entry.name))
|
||||
.map((entry) => readMarkdownMeta(entry.name))
|
||||
.filter((entry) => entry.version)
|
||||
.sort((a, b) => compareVersions(a.version, b.version));
|
||||
|
||||
return {
|
||||
current: CURRENT_FILE,
|
||||
older: older.map(({ file, version, title, date }) => {
|
||||
const item = { file };
|
||||
if (version) item.version = version;
|
||||
if (title) item.title = title;
|
||||
if (date) item.date = date;
|
||||
return item;
|
||||
}),
|
||||
};
|
||||
}
|
||||
|
||||
function main() {
|
||||
const manifest = buildManifest();
|
||||
const json = `${JSON.stringify(manifest, null, 2)}\n`;
|
||||
|
||||
let previous = null;
|
||||
if (fs.existsSync(MANIFEST_PATH)) {
|
||||
previous = fs.readFileSync(MANIFEST_PATH, 'utf8');
|
||||
}
|
||||
|
||||
if (previous === json) {
|
||||
console.log('[update-manifest] manifest.json is already up to date');
|
||||
return;
|
||||
}
|
||||
|
||||
fs.writeFileSync(MANIFEST_PATH, json, 'utf8');
|
||||
console.log(`[update-manifest] wrote manifest.json (${manifest.older.length} older version(s))`);
|
||||
}
|
||||
|
||||
main();
|
||||
@@ -1,7 +1,19 @@
|
||||
import React, { FormEventHandler, useCallback, useEffect, useMemo, useRef, useState } from 'react';
|
||||
import { Box, Text, IconButton, Input, Button, TextArea, color, Spinner, Chip, Scroll, config } from 'folds';
|
||||
import { Icon, Icons } from './icons';
|
||||
import {
|
||||
Box,
|
||||
Text,
|
||||
IconButton,
|
||||
Input,
|
||||
Button,
|
||||
TextArea,
|
||||
color,
|
||||
Spinner,
|
||||
Chip,
|
||||
Scroll,
|
||||
config,
|
||||
} from 'folds';
|
||||
import { MatrixError } from 'matrix-js-sdk';
|
||||
import { Icon, Icons } from './icons';
|
||||
import { Cursor } from '../plugins/text-area';
|
||||
import { syntaxErrorPosition } from '../utils/dom';
|
||||
import { AsyncStatus, useAsyncCallback } from '../hooks/useAsyncCallback';
|
||||
@@ -41,7 +53,7 @@ function AccountDataEdit({
|
||||
|
||||
const { handleKeyDown, operations, getTarget } = useTextAreaCodeEditor(
|
||||
textAreaRef,
|
||||
EDITOR_INTENT_SPACE_COUNT
|
||||
EDITOR_INTENT_SPACE_COUNT,
|
||||
);
|
||||
|
||||
const [submitState, submit] = useAsyncCallback<void, MatrixError, [string, object]>(submitChange);
|
||||
@@ -263,7 +275,7 @@ export function AccountDataEditor({
|
||||
|
||||
const contentJSONStr = useMemo(
|
||||
() => JSON.stringify(data.content, null, EDITOR_INTENT_SPACE_COUNT),
|
||||
[data.content]
|
||||
[data.content],
|
||||
);
|
||||
|
||||
return (
|
||||
|
||||
@@ -24,7 +24,7 @@ export function AngleSelector({
|
||||
onChange,
|
||||
size = 80,
|
||||
disabled = false,
|
||||
}: AngleSelectorProps): JSX.Element {
|
||||
}: AngleSelectorProps): React.JSX.Element {
|
||||
const containerRef = useRef<HTMLDivElement>(null);
|
||||
const [isDragging, setIsDragging] = useState(false);
|
||||
|
||||
@@ -52,7 +52,7 @@ export function AngleSelector({
|
||||
|
||||
return Math.round(angle);
|
||||
},
|
||||
[value]
|
||||
[value],
|
||||
);
|
||||
|
||||
/**
|
||||
@@ -67,7 +67,7 @@ export function AngleSelector({
|
||||
const newAngle = calculateAngle(e.clientX, e.clientY);
|
||||
onChange(newAngle);
|
||||
},
|
||||
[disabled, calculateAngle, onChange]
|
||||
[disabled, calculateAngle, onChange],
|
||||
);
|
||||
|
||||
/**
|
||||
@@ -79,7 +79,7 @@ export function AngleSelector({
|
||||
const newAngle = calculateAngle(e.clientX, e.clientY);
|
||||
onChange(newAngle);
|
||||
},
|
||||
[isDragging, disabled, calculateAngle, onChange]
|
||||
[isDragging, disabled, calculateAngle, onChange],
|
||||
);
|
||||
|
||||
/**
|
||||
@@ -90,7 +90,7 @@ export function AngleSelector({
|
||||
}, []);
|
||||
|
||||
// Calculate line endpoint position
|
||||
const lineLength = (size / 2) - 8;
|
||||
const lineLength = size / 2 - 8;
|
||||
const radians = ((value - 90) * Math.PI) / 180;
|
||||
const lineX = Math.cos(radians) * lineLength;
|
||||
const lineY = Math.sin(radians) * lineLength;
|
||||
@@ -160,7 +160,7 @@ export function AngleSelector({
|
||||
{/* Cardinal direction markers */}
|
||||
{[0, 90, 180, 270].map((deg) => {
|
||||
const markerRadians = ((deg - 90) * Math.PI) / 180;
|
||||
const markerDist = (size / 2) - 3;
|
||||
const markerDist = size / 2 - 3;
|
||||
const markerX = Math.cos(markerRadians) * markerDist;
|
||||
const markerY = Math.sin(markerRadians) * markerDist;
|
||||
return (
|
||||
|
||||
@@ -42,7 +42,7 @@ export function AnimatedOutlet() {
|
||||
const location = useLocation();
|
||||
const transitionKey = useMemo(
|
||||
() => getOutletTransitionKey(location.pathname),
|
||||
[location.pathname]
|
||||
[location.pathname],
|
||||
);
|
||||
|
||||
return (
|
||||
|
||||
@@ -45,7 +45,7 @@ export function AuthFlowsLoader({ fallback, error, children }: AuthFlowsLoaderPr
|
||||
};
|
||||
|
||||
return authFlows;
|
||||
}, [mx])
|
||||
}, [mx]),
|
||||
);
|
||||
|
||||
useEffect(() => {
|
||||
|
||||
@@ -1,9 +1,23 @@
|
||||
import React, { MouseEventHandler, useCallback, useState } from 'react';
|
||||
import { useAtom } from 'jotai';
|
||||
import { CryptoApi, KeyBackupInfo } from 'matrix-js-sdk/lib/crypto-api';
|
||||
import { Badge, Box, Button, color, config, IconButton, Menu, percent, PopOut, ProgressBar, RectCords, Spinner, Text } from 'folds';
|
||||
import { Icon, Icons } from './icons';
|
||||
import {
|
||||
Badge,
|
||||
Box,
|
||||
Button,
|
||||
color,
|
||||
config,
|
||||
IconButton,
|
||||
Menu,
|
||||
percent,
|
||||
PopOut,
|
||||
ProgressBar,
|
||||
RectCords,
|
||||
Spinner,
|
||||
Text,
|
||||
} from 'folds';
|
||||
import FocusTrap from 'focus-trap-react';
|
||||
import { Icon, Icons } from './icons';
|
||||
import { BackupProgressStatus, backupRestoreProgressAtom } from '../state/backupRestore';
|
||||
import { InfoCard } from './info-card';
|
||||
import { AsyncStatus, useAsyncCallback } from '../hooks/useAsyncCallback';
|
||||
@@ -142,7 +156,7 @@ export function BackupRestoreTile({ crypto }: BackupRestoreTileProps) {
|
||||
setRestoreProgress(progress);
|
||||
},
|
||||
});
|
||||
}, [crypto, setRestoreProgress])
|
||||
}, [crypto, setRestoreProgress]),
|
||||
);
|
||||
|
||||
const handleRestore = () => {
|
||||
|
||||
@@ -6,8 +6,8 @@ type ConfirmPasswordMatchProps = {
|
||||
children: (
|
||||
match: boolean,
|
||||
doMatch: () => void,
|
||||
passRef: RefObject<HTMLInputElement>,
|
||||
confPassRef: RefObject<HTMLInputElement>
|
||||
passRef: RefObject<HTMLInputElement | null>,
|
||||
confPassRef: RefObject<HTMLInputElement | null>,
|
||||
) => ReactNode;
|
||||
};
|
||||
export function ConfirmPasswordMatch({ initialValue, children }: ConfirmPasswordMatchProps) {
|
||||
@@ -28,7 +28,7 @@ export function ConfirmPasswordMatch({ initialValue, children }: ConfirmPassword
|
||||
{
|
||||
wait: 500,
|
||||
immediate: false,
|
||||
}
|
||||
},
|
||||
);
|
||||
|
||||
return children(match, doMatch, passRef, confPassRef);
|
||||
|
||||
@@ -6,9 +6,21 @@ import {
|
||||
} from 'matrix-js-sdk/lib/crypto-api';
|
||||
import React, { CSSProperties, useCallback, useEffect, useState } from 'react';
|
||||
import { VerificationMethod } from 'matrix-js-sdk/lib/types';
|
||||
import { Box, Button, config, Dialog, Header, IconButton, Overlay, OverlayBackdrop, OverlayCenter, Spinner, Text } from 'folds';
|
||||
import { Icon, Icons } from './icons';
|
||||
import {
|
||||
Box,
|
||||
Button,
|
||||
config,
|
||||
Dialog,
|
||||
Header,
|
||||
IconButton,
|
||||
Overlay,
|
||||
OverlayBackdrop,
|
||||
OverlayCenter,
|
||||
Spinner,
|
||||
Text,
|
||||
} from 'folds';
|
||||
import FocusTrap from 'focus-trap-react';
|
||||
import { Icon, Icons } from './icons';
|
||||
import {
|
||||
useVerificationRequestPhase,
|
||||
useVerificationRequestReceived,
|
||||
@@ -124,7 +136,6 @@ function CompareEmoji({ sasData }: { sasData: ShowSasCallbacks }) {
|
||||
>
|
||||
{sasData.sas.emoji?.map(([emoji, name], index) => (
|
||||
<Box
|
||||
// eslint-disable-next-line react/no-array-index-key
|
||||
key={`${emoji}${name}${index}`}
|
||||
direction="Column"
|
||||
gap="100"
|
||||
|
||||
@@ -1,9 +1,9 @@
|
||||
import React, { FormEventHandler, forwardRef, useCallback, useState } from 'react';
|
||||
import { Dialog, Header, Box, Text, IconButton, config, Button, Chip, color, Spinner } from 'folds';
|
||||
import { Icon, Icons } from './icons';
|
||||
import FileSaver from 'file-saver';
|
||||
import to from 'await-to-js';
|
||||
import { AuthDict, IAuthData, MatrixError, UIAuthCallback } from 'matrix-js-sdk';
|
||||
import { Icon, Icons } from './icons';
|
||||
import { PasswordInput } from './password-input';
|
||||
import { ContainerColor } from '../styles/ContainerColor.css';
|
||||
import { copyToClipboard } from '../utils/dom';
|
||||
@@ -15,7 +15,7 @@ import { useAlive } from '../hooks/useAlive';
|
||||
import { UseStateProvider } from './UseStateProvider';
|
||||
|
||||
type UIACallback<T> = (
|
||||
authDict: AuthDict | null
|
||||
authDict: AuthDict | null,
|
||||
) => Promise<[IAuthData, undefined] | [undefined, T]>;
|
||||
|
||||
type PerformAction<T> = (authDict: AuthDict | null) => Promise<T>;
|
||||
@@ -30,7 +30,7 @@ function makeUIAAction<T>(
|
||||
authData: IAuthData,
|
||||
performAction: PerformAction<T>,
|
||||
resolve: (data: T) => void,
|
||||
reject: (error?: any) => void
|
||||
reject: (error?: unknown) => void,
|
||||
): UIAAction<T> {
|
||||
const action: UIAAction<T> = {
|
||||
authData,
|
||||
@@ -79,7 +79,7 @@ function SetupVerification({ onComplete }: SetupVerificationProps) {
|
||||
setNextAuthData(authData);
|
||||
}
|
||||
},
|
||||
[uiaAction, alive]
|
||||
[uiaAction, alive],
|
||||
);
|
||||
|
||||
const resetUIA = useCallback(() => {
|
||||
@@ -106,7 +106,7 @@ function SetupVerification({ onComplete }: SetupVerificationProps) {
|
||||
(err) => {
|
||||
resetUIA();
|
||||
reject(err);
|
||||
}
|
||||
},
|
||||
);
|
||||
if (alive()) {
|
||||
setUIAAction(action);
|
||||
@@ -118,7 +118,7 @@ function SetupVerification({ onComplete }: SetupVerificationProps) {
|
||||
reject(error);
|
||||
});
|
||||
}),
|
||||
[alive, resetUIA]
|
||||
[alive, resetUIA],
|
||||
);
|
||||
|
||||
const [setupState, setup] = useAsyncCallback<void, Error, [string | undefined]>(
|
||||
@@ -147,8 +147,8 @@ function SetupVerification({ onComplete }: SetupVerificationProps) {
|
||||
|
||||
onComplete(recoveryKeyData.encodedPrivateKey);
|
||||
},
|
||||
[mx, onComplete, authUploadDeviceSigningKeys]
|
||||
)
|
||||
[mx, onComplete, authUploadDeviceSigningKeys],
|
||||
),
|
||||
);
|
||||
|
||||
const loading = setupState.status === AsyncStatus.Loading;
|
||||
@@ -302,7 +302,7 @@ export const DeviceVerificationSetup = forwardRef<HTMLDivElement, DeviceVerifica
|
||||
</Box>
|
||||
</Dialog>
|
||||
);
|
||||
}
|
||||
},
|
||||
);
|
||||
type DeviceVerificationResetProps = {
|
||||
onCancel: () => void;
|
||||
@@ -359,5 +359,5 @@ export const DeviceVerificationReset = forwardRef<HTMLDivElement, DeviceVerifica
|
||||
)}
|
||||
</Dialog>
|
||||
);
|
||||
}
|
||||
},
|
||||
);
|
||||
|
||||
@@ -0,0 +1,49 @@
|
||||
import FocusTrap from 'focus-trap-react';
|
||||
import { useAtom } from 'jotai';
|
||||
import { Box, Button, Dialog, Overlay, OverlayBackdrop, OverlayCenter, config, Text } from 'folds';
|
||||
import { dialogAtom } from '../state/dialog';
|
||||
import { stopPropagation } from '../utils/keyboard';
|
||||
|
||||
export function DialogHost() {
|
||||
const [dialog, setDialog] = useAtom(dialogAtom);
|
||||
|
||||
if (!dialog) return null;
|
||||
|
||||
const close = (answer: boolean) => {
|
||||
setDialog(null);
|
||||
dialog.resolve(answer);
|
||||
};
|
||||
|
||||
return (
|
||||
<Overlay open backdrop={<OverlayBackdrop />}>
|
||||
<OverlayCenter>
|
||||
<FocusTrap
|
||||
focusTrapOptions={{
|
||||
initialFocus: false,
|
||||
onDeactivate: () => close(false),
|
||||
clickOutsideDeactivates: true,
|
||||
escapeDeactivates: stopPropagation,
|
||||
}}
|
||||
>
|
||||
<Dialog variant="Surface">
|
||||
<Box style={{ padding: config.space.S400 }} direction="Column" gap="400">
|
||||
<Text priority="400" style={{ whiteSpace: 'pre-line' }}>
|
||||
{dialog.message}
|
||||
</Text>
|
||||
<Box direction="Row" gap="200">
|
||||
{dialog.confirm && (
|
||||
<Button variant="Secondary" onClick={() => close(false)} radii="300">
|
||||
<Text size="B300">Cancel</Text>
|
||||
</Button>
|
||||
)}
|
||||
<Button variant="Primary" onClick={() => close(dialog.confirm)} radii="300">
|
||||
<Text size="B300">{dialog.confirm ? 'Confirm' : 'OK'}</Text>
|
||||
</Button>
|
||||
</Box>
|
||||
</Box>
|
||||
</Dialog>
|
||||
</FocusTrap>
|
||||
</OverlayCenter>
|
||||
</Overlay>
|
||||
);
|
||||
}
|
||||
@@ -1,8 +1,8 @@
|
||||
import React, { MouseEventHandler, useCallback, useMemo, useState } from 'react';
|
||||
import { config, Box, MenuItem, Text, RectCords, PopOut, Menu, Button, Spinner } from 'folds';
|
||||
import { Icon, Icons, IconSrc } from './icons';
|
||||
import { JoinRule } from 'matrix-js-sdk';
|
||||
import FocusTrap from 'focus-trap-react';
|
||||
import { Icon, Icons, IconSrc } from './icons';
|
||||
import { stopPropagation } from '../utils/keyboard';
|
||||
|
||||
export type ExtraJoinRules = 'knock_restricted';
|
||||
@@ -19,7 +19,7 @@ export const useRoomJoinRuleIcon = (): JoinRuleIcons =>
|
||||
[JoinRule.Public]: Icons.HashGlobe,
|
||||
[JoinRule.Private]: Icons.HashLock,
|
||||
}),
|
||||
[]
|
||||
[],
|
||||
);
|
||||
export const useSpaceJoinRuleIcon = (): JoinRuleIcons =>
|
||||
useMemo(
|
||||
@@ -31,7 +31,7 @@ export const useSpaceJoinRuleIcon = (): JoinRuleIcons =>
|
||||
[JoinRule.Public]: Icons.SpaceGlobe,
|
||||
[JoinRule.Private]: Icons.SpaceLock,
|
||||
}),
|
||||
[]
|
||||
[],
|
||||
);
|
||||
|
||||
type JoinRuleLabels = Record<ExtendedJoinRules, string>;
|
||||
@@ -45,7 +45,7 @@ export const useRoomJoinRuleLabel = (): JoinRuleLabels =>
|
||||
[JoinRule.Public]: 'Public',
|
||||
[JoinRule.Private]: 'Invite Only',
|
||||
}),
|
||||
[]
|
||||
[],
|
||||
);
|
||||
|
||||
type JoinRulesSwitcherProps<T extends ExtendedJoinRules[]> = {
|
||||
@@ -77,7 +77,7 @@ export function JoinRulesSwitcher<T extends ExtendedJoinRules[]>({
|
||||
setCords(undefined);
|
||||
onChange(selectedRule);
|
||||
},
|
||||
[onChange]
|
||||
[onChange],
|
||||
);
|
||||
|
||||
return (
|
||||
|
||||
@@ -21,13 +21,13 @@ export const LogoutDialog = forwardRef<HTMLDivElement, LogoutDialogProps>(
|
||||
const verificationStatus = useDeviceVerificationStatus(
|
||||
mx.getCrypto(),
|
||||
mx.getSafeUserId(),
|
||||
mx.getDeviceId() ?? undefined
|
||||
mx.getDeviceId() ?? undefined,
|
||||
);
|
||||
|
||||
const [logoutState, logout] = useAsyncCallback<void, Error, []>(
|
||||
useCallback(async () => {
|
||||
await logoutClient(mx);
|
||||
}, [mx])
|
||||
}, [mx]),
|
||||
);
|
||||
|
||||
const ongoingLogout = logoutState.status === AsyncStatus.Loading;
|
||||
@@ -85,5 +85,5 @@ export const LogoutDialog = forwardRef<HTMLDivElement, LogoutDialogProps>(
|
||||
</Box>
|
||||
</Dialog>
|
||||
);
|
||||
}
|
||||
},
|
||||
);
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
import React, { MouseEventHandler, ReactNode, useCallback, useState } from 'react';
|
||||
import { Box, Text, Chip, RectCords, PopOut, Menu, config, MenuItem, color } from 'folds';
|
||||
import { Icon, Icons } from './icons';
|
||||
import FocusTrap from 'focus-trap-react';
|
||||
import { Icon, Icons } from './icons';
|
||||
import { stopPropagation } from '../utils/keyboard';
|
||||
import { SettingTile } from './setting-tile';
|
||||
import { SecretStorageKeyContent } from '../../types/matrix/accountData';
|
||||
@@ -115,7 +115,7 @@ export function ManualVerificationTile({
|
||||
const [method, setMethod] = useState(
|
||||
hasPassphrase
|
||||
? ManualVerificationMethod.RecoveryPassphrase
|
||||
: ManualVerificationMethod.RecoveryKey
|
||||
: ManualVerificationMethod.RecoveryKey,
|
||||
);
|
||||
|
||||
const verifyAndRestoreBackup = useCallback(
|
||||
@@ -132,11 +132,11 @@ export function ManualVerificationTile({
|
||||
|
||||
await crypto.loadSessionBackupPrivateKeyFromSecretStorage();
|
||||
},
|
||||
[mx, secretStorageKeyId]
|
||||
[mx, secretStorageKeyId],
|
||||
);
|
||||
|
||||
const [verifyState, handleDecodedRecoveryKey] = useAsyncCallback<void, Error, [Uint8Array]>(
|
||||
verifyAndRestoreBackup
|
||||
verifyAndRestoreBackup,
|
||||
);
|
||||
const verifying = verifyState.status === AsyncStatus.Loading;
|
||||
|
||||
|
||||
@@ -1,7 +1,9 @@
|
||||
import React, { ReactNode, useCallback, useState } from 'react';
|
||||
import FocusTrap from 'focus-trap-react';
|
||||
import { useAtomValue } from 'jotai';
|
||||
import { Modal, Overlay, OverlayBackdrop, OverlayCenter, PopOutContainerProvider } from 'folds';
|
||||
import { stopPropagation } from '../utils/keyboard';
|
||||
import { releaseNotesDialogAtom } from '../state/releaseNotes';
|
||||
|
||||
type Modal500Props = {
|
||||
requestClose: () => void;
|
||||
@@ -10,11 +12,13 @@ type Modal500Props = {
|
||||
export function Modal500({ requestClose, children }: Modal500Props) {
|
||||
const [modalEl, setModalEl] = useState<HTMLDivElement | null>(null);
|
||||
const modalRef = useCallback((el: HTMLDivElement | null) => setModalEl(el), []);
|
||||
const releaseNotesOpen = useAtomValue(releaseNotesDialogAtom).open;
|
||||
|
||||
return (
|
||||
<Overlay open backdrop={<OverlayBackdrop />}>
|
||||
<OverlayCenter>
|
||||
<FocusTrap
|
||||
active={!releaseNotesOpen}
|
||||
focusTrapOptions={{
|
||||
initialFocus: false,
|
||||
clickOutsideDeactivates: true,
|
||||
|
||||
@@ -1,11 +1,24 @@
|
||||
/* eslint-disable no-param-reassign */
|
||||
/* eslint-disable jsx-a11y/no-noninteractive-element-interactions */
|
||||
import React, { FormEventHandler, MouseEventHandler, useEffect, useRef, useState } from 'react';
|
||||
import classNames from 'classnames';
|
||||
import { Box, Button, Chip, Header, IconButton, Input, Menu, PopOut, RectCords, Scroll, Spinner, Text, as, config } from 'folds';
|
||||
import { Icon, Icons } from '../icons';
|
||||
import {
|
||||
Box,
|
||||
Button,
|
||||
Chip,
|
||||
Header,
|
||||
IconButton,
|
||||
Input,
|
||||
Menu,
|
||||
PopOut,
|
||||
RectCords,
|
||||
Scroll,
|
||||
Spinner,
|
||||
Text,
|
||||
as,
|
||||
config,
|
||||
} from 'folds';
|
||||
import FocusTrap from 'focus-trap-react';
|
||||
import FileSaver from 'file-saver';
|
||||
import { Icon, Icons } from '../icons';
|
||||
import { saveMediaBlob } from '../../utils/saveMedia';
|
||||
import * as css from './PdfViewer.css';
|
||||
import { AsyncStatus } from '../../hooks/useAsyncCallback';
|
||||
import { useZoom } from '../../hooks/useZoom';
|
||||
@@ -27,7 +40,7 @@ export const PdfViewer = as<'div', PdfViewerProps>(
|
||||
const [pdfJSState, loadPdfJS] = usePdfJSLoader();
|
||||
const [docState, loadPdfDocument] = usePdfDocumentLoader(
|
||||
pdfJSState.status === AsyncStatus.Success ? pdfJSState.data : undefined,
|
||||
src
|
||||
src,
|
||||
);
|
||||
const isLoading =
|
||||
pdfJSState.status === AsyncStatus.Loading || docState.status === AsyncStatus.Loading;
|
||||
@@ -61,8 +74,14 @@ export const PdfViewer = as<'div', PdfViewerProps>(
|
||||
}
|
||||
}, [docState, pageNo, zoom]);
|
||||
|
||||
const handleDownload = () => {
|
||||
FileSaver.saveAs(src, name);
|
||||
const handleDownload = async () => {
|
||||
try {
|
||||
const res = await fetch(src);
|
||||
if (!res.ok) throw new Error('Failed to fetch PDF');
|
||||
await saveMediaBlob(await res.blob(), name);
|
||||
} catch (error) {
|
||||
console.warn('[PdfViewer] Failed to download:', error);
|
||||
}
|
||||
};
|
||||
|
||||
const handleJumpSubmit: FormEventHandler<HTMLFormElement> = (evt) => {
|
||||
@@ -241,5 +260,5 @@ export const PdfViewer = as<'div', PdfViewerProps>(
|
||||
)}
|
||||
</Box>
|
||||
);
|
||||
}
|
||||
},
|
||||
);
|
||||
|
||||
@@ -25,7 +25,14 @@ import {
|
||||
VideoContent,
|
||||
VideoFrameThumbnail,
|
||||
} from './message';
|
||||
import { UrlPreviewCard, UrlPreviewHolder, YouTubeEmbed, isYouTubeUrl, TikTokEmbed, isTikTokUrl, GiphyEmbed, isGiphyUrl } from './url-preview';
|
||||
import {
|
||||
UrlPreviewCard,
|
||||
UrlPreviewHolder,
|
||||
YouTubeEmbed,
|
||||
isYouTubeUrl,
|
||||
GiphyEmbed,
|
||||
isGiphyUrl,
|
||||
} from './url-preview';
|
||||
import { Image, MediaControl, Video } from './media';
|
||||
import { ImageViewer } from './image-viewer';
|
||||
import { VideoViewer } from './video-viewer';
|
||||
@@ -53,7 +60,7 @@ type RenderMessageContentProps = {
|
||||
onJumboEmojiClick?: (
|
||||
targetEventId: string,
|
||||
body: string,
|
||||
event: MouseEvent<HTMLElement> | KeyboardEvent<HTMLElement>
|
||||
event: MouseEvent<HTMLElement> | KeyboardEvent<HTMLElement>,
|
||||
) => void;
|
||||
};
|
||||
export function RenderMessageContent({
|
||||
@@ -79,9 +86,8 @@ export function RenderMessageContent({
|
||||
|
||||
// Separate special URLs from generic ones
|
||||
const youtubeUrls = filteredUrls.filter(isYouTubeUrl);
|
||||
const tiktokUrls = filteredUrls.filter(isTikTokUrl);
|
||||
const giphyUrls = filteredUrls.filter(isGiphyUrl);
|
||||
const otherUrls = filteredUrls.filter((url) => !isYouTubeUrl(url) && !isTikTokUrl(url) && !isGiphyUrl(url));
|
||||
const otherUrls = filteredUrls.filter((url) => !isYouTubeUrl(url) && !isGiphyUrl(url));
|
||||
|
||||
return (
|
||||
<>
|
||||
@@ -89,10 +95,6 @@ export function RenderMessageContent({
|
||||
{youtubeUrls.map((url) => (
|
||||
<YouTubeEmbed key={url} url={url} />
|
||||
))}
|
||||
{/* Render TikTok embeds */}
|
||||
{tiktokUrls.map((url) => (
|
||||
<TikTokEmbed key={url} url={url} />
|
||||
))}
|
||||
{/* Render Giphy embeds */}
|
||||
{giphyUrls.map((url) => (
|
||||
<GiphyEmbed key={url} url={url} />
|
||||
@@ -177,9 +179,10 @@ export function RenderMessageContent({
|
||||
const customRendererEarly = pluginRegistry.getRenderer('message');
|
||||
if (customRendererEarly) {
|
||||
try {
|
||||
const contentEarly = getContent();
|
||||
const messageDataEarly = {
|
||||
msgtype: msgType,
|
||||
...getContent(),
|
||||
...(typeof contentEarly === 'object' && contentEarly !== null ? contentEarly : {}),
|
||||
};
|
||||
const customContentEarly = customRendererEarly(messageDataEarly, () => null);
|
||||
if (customContentEarly) {
|
||||
@@ -275,8 +278,9 @@ export function RenderMessageContent({
|
||||
content={getContent()}
|
||||
renderAsFile={renderFile}
|
||||
renderVideoContent={({ body, info, mimeType, url, encInfo, ...props }) => {
|
||||
const hasValidThumbnail =
|
||||
(typeof info.thumbnail_file?.url === 'string' || typeof info.thumbnail_url === 'string') &&
|
||||
const hasValidThumbnail =
|
||||
(typeof info.thumbnail_file?.url === 'string' ||
|
||||
typeof info.thumbnail_url === 'string') &&
|
||||
typeof info.thumbnail_info?.mimetype === 'string';
|
||||
|
||||
return (
|
||||
@@ -290,23 +294,24 @@ export function RenderMessageContent({
|
||||
{...props}
|
||||
renderThumbnail={
|
||||
mediaAutoLoad
|
||||
? () => hasValidThumbnail ? (
|
||||
<ThumbnailContent
|
||||
info={info}
|
||||
renderImage={(src) => (
|
||||
<Image alt={body} title={body} src={src} loading="lazy" />
|
||||
)}
|
||||
/>
|
||||
) : (
|
||||
<VideoFrameThumbnail
|
||||
mimeType={mimeType}
|
||||
url={url}
|
||||
encInfo={encInfo}
|
||||
renderImage={(src) => (
|
||||
<Image alt={body} title={body} src={src} loading="lazy" />
|
||||
)}
|
||||
/>
|
||||
)
|
||||
? () =>
|
||||
hasValidThumbnail ? (
|
||||
<ThumbnailContent
|
||||
info={info}
|
||||
renderImage={(src) => (
|
||||
<Image alt={body} title={body} src={src} loading="lazy" />
|
||||
)}
|
||||
/>
|
||||
) : (
|
||||
<VideoFrameThumbnail
|
||||
mimeType={mimeType}
|
||||
url={url}
|
||||
encInfo={encInfo}
|
||||
renderImage={(src) => (
|
||||
<Image alt={body} title={body} src={src} loading="lazy" />
|
||||
)}
|
||||
/>
|
||||
)
|
||||
: undefined
|
||||
}
|
||||
renderViewer={(p) => <VideoViewer {...p} />}
|
||||
@@ -354,19 +359,17 @@ export function RenderMessageContent({
|
||||
console.log('[RenderMessageContent] customRenderer function:', typeof customRenderer);
|
||||
if (customRenderer) {
|
||||
try {
|
||||
const content = getContent();
|
||||
const messageData = {
|
||||
msgtype: msgType,
|
||||
...getContent(),
|
||||
...(typeof content === 'object' && content !== null ? content : {}),
|
||||
};
|
||||
console.log('[RenderMessageContent] Calling customRenderer with msgtype:', msgType);
|
||||
console.log('[RenderMessageContent] messageData:', messageData);
|
||||
const customContent = customRenderer(
|
||||
messageData,
|
||||
() => {
|
||||
console.log('[RenderMessageContent] defaultRenderer called');
|
||||
return null;
|
||||
}
|
||||
);
|
||||
const customContent = customRenderer(messageData, () => {
|
||||
console.log('[RenderMessageContent] defaultRenderer called');
|
||||
return null;
|
||||
});
|
||||
console.log('[RenderMessageContent] customRenderer returned:', customContent);
|
||||
console.log('[RenderMessageContent] customContent type:', typeof customContent);
|
||||
if (customContent) {
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
import { Box, config, Menu, MenuItem, PopOut, RectCords, Text } from 'folds';
|
||||
import { Icon } from './icons';
|
||||
import React, { MouseEventHandler, ReactNode, useMemo, useState } from 'react';
|
||||
import FocusTrap from 'focus-trap-react';
|
||||
import { Icon } from './icons';
|
||||
import { stopPropagation } from '../utils/keyboard';
|
||||
import {
|
||||
getRoomNotificationModeIcon,
|
||||
@@ -18,7 +18,7 @@ const useRoomNotificationModes = (): RoomNotificationMode[] =>
|
||||
RoomNotificationMode.SpecialMessages,
|
||||
RoomNotificationMode.Mute,
|
||||
],
|
||||
[]
|
||||
[],
|
||||
);
|
||||
|
||||
const useRoomNotificationModeStr = (): Record<RoomNotificationMode, string> =>
|
||||
@@ -29,7 +29,7 @@ const useRoomNotificationModeStr = (): Record<RoomNotificationMode, string> =>
|
||||
[RoomNotificationMode.SpecialMessages]: 'Mention & Keywords',
|
||||
[RoomNotificationMode.Mute]: 'Mute',
|
||||
}),
|
||||
[]
|
||||
[],
|
||||
);
|
||||
|
||||
type NotificationModeSwitcherProps = {
|
||||
@@ -38,7 +38,7 @@ type NotificationModeSwitcherProps = {
|
||||
children: (
|
||||
handleOpen: MouseEventHandler<HTMLButtonElement>,
|
||||
opened: boolean,
|
||||
changing: boolean
|
||||
changing: boolean,
|
||||
) => ReactNode;
|
||||
};
|
||||
export function RoomNotificationModeSwitcher({
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
import React, { useEffect, useRef, useState } from 'react';
|
||||
import { useLocation } from 'react-router-dom';
|
||||
import { style } from '@vanilla-extract/css';
|
||||
import { keyframes, style } from '@vanilla-extract/css';
|
||||
|
||||
const transitionContainer = style({
|
||||
position: 'relative',
|
||||
@@ -14,36 +14,34 @@ const transitionContent = style({
|
||||
height: '100%',
|
||||
});
|
||||
|
||||
const routeFadeSlideIn = keyframes({
|
||||
from: {
|
||||
opacity: 0,
|
||||
transform: 'translateX(12px)',
|
||||
},
|
||||
to: {
|
||||
opacity: 1,
|
||||
transform: 'translateX(0)',
|
||||
},
|
||||
});
|
||||
|
||||
const animateIn = style({
|
||||
animation: 'routeFadeSlideIn 0.25s cubic-bezier(0.4, 0, 0.2, 1)',
|
||||
'@keyframes': {
|
||||
routeFadeSlideIn: {
|
||||
from: {
|
||||
opacity: 0,
|
||||
transform: 'translateX(12px)',
|
||||
},
|
||||
to: {
|
||||
opacity: 1,
|
||||
transform: 'translateX(0)',
|
||||
},
|
||||
},
|
||||
animation: `${routeFadeSlideIn} 0.25s cubic-bezier(0.4, 0, 0.2, 1)`,
|
||||
});
|
||||
|
||||
const routeFadeSlideOut = keyframes({
|
||||
from: {
|
||||
opacity: 1,
|
||||
transform: 'translateX(0)',
|
||||
},
|
||||
to: {
|
||||
opacity: 0,
|
||||
transform: 'translateX(-12px)',
|
||||
},
|
||||
});
|
||||
|
||||
const animateOut = style({
|
||||
animation: 'routeFadeSlideOut 0.2s cubic-bezier(0.4, 0, 0.2, 1) forwards',
|
||||
'@keyframes': {
|
||||
routeFadeSlideOut: {
|
||||
from: {
|
||||
opacity: 1,
|
||||
transform: 'translateX(0)',
|
||||
},
|
||||
to: {
|
||||
opacity: 0,
|
||||
transform: 'translateX(-12px)',
|
||||
},
|
||||
},
|
||||
},
|
||||
animation: `${routeFadeSlideOut} 0.2s cubic-bezier(0.4, 0, 0.2, 1) forwards`,
|
||||
});
|
||||
|
||||
interface RouteTransitionProps {
|
||||
@@ -57,7 +55,7 @@ export function RouteTransition({ children }: RouteTransitionProps) {
|
||||
const location = useLocation();
|
||||
const [displayLocation, setDisplayLocation] = useState(location);
|
||||
const [transitionStage, setTransitionStage] = useState<'entering' | 'exiting' | 'idle'>('idle');
|
||||
const timeoutRef = useRef<ReturnType<typeof setTimeout>>();
|
||||
const timeoutRef = useRef<ReturnType<typeof setTimeout>>(undefined);
|
||||
|
||||
useEffect(() => {
|
||||
if (location.pathname !== displayLocation.pathname) {
|
||||
@@ -88,11 +86,12 @@ export function RouteTransition({ children }: RouteTransitionProps) {
|
||||
};
|
||||
}, [location, displayLocation]);
|
||||
|
||||
const className = transitionStage === 'entering'
|
||||
? `${transitionContent} ${animateIn}`
|
||||
: transitionStage === 'exiting'
|
||||
? `${transitionContent} ${animateOut}`
|
||||
: transitionContent;
|
||||
let className = transitionContent;
|
||||
if (transitionStage === 'entering') {
|
||||
className = `${transitionContent} ${animateIn}`;
|
||||
} else if (transitionStage === 'exiting') {
|
||||
className = `${transitionContent} ${animateOut}`;
|
||||
}
|
||||
|
||||
return (
|
||||
<div className={transitionContainer}>
|
||||
|
||||
@@ -1,6 +1,7 @@
|
||||
import React, { FormEventHandler, useCallback } from 'react';
|
||||
import { Box, Text, Button, Spinner, color } from 'folds';
|
||||
import { decodeRecoveryKey, deriveRecoveryKeyFromPassphrase } from 'matrix-js-sdk/lib/crypto-api';
|
||||
import { SecretStorageKeyDescriptionAesV1 } from 'matrix-js-sdk/lib/secret-storage';
|
||||
import { PasswordInput } from './password-input';
|
||||
import {
|
||||
SecretStorageKeyContent,
|
||||
@@ -36,10 +37,13 @@ export function SecretStorageRecoveryPassphrase({
|
||||
passphrase,
|
||||
salt,
|
||||
iterations,
|
||||
bits
|
||||
bits,
|
||||
);
|
||||
|
||||
const match = await mx.secretStorage.checkKey(decodedRecoveryKey, keyContent as any);
|
||||
const match = await mx.secretStorage.checkKey(
|
||||
decodedRecoveryKey,
|
||||
keyContent as SecretStorageKeyDescriptionAesV1,
|
||||
);
|
||||
|
||||
if (!match) {
|
||||
throw new Error('Invalid recovery passphrase.');
|
||||
@@ -47,8 +51,8 @@ export function SecretStorageRecoveryPassphrase({
|
||||
|
||||
return decodedRecoveryKey;
|
||||
},
|
||||
[mx, keyContent]
|
||||
)
|
||||
[mx, keyContent],
|
||||
),
|
||||
);
|
||||
|
||||
const drivingKey = driveKeyState.status === AsyncStatus.Loading;
|
||||
@@ -131,7 +135,10 @@ export function SecretStorageRecoveryKey({
|
||||
async (recoveryKey) => {
|
||||
const decodedRecoveryKey = decodeRecoveryKey(recoveryKey);
|
||||
|
||||
const match = await mx.secretStorage.checkKey(decodedRecoveryKey, keyContent as any);
|
||||
const match = await mx.secretStorage.checkKey(
|
||||
decodedRecoveryKey,
|
||||
keyContent as SecretStorageKeyDescriptionAesV1,
|
||||
);
|
||||
|
||||
if (!match) {
|
||||
throw new Error('Invalid recovery key.');
|
||||
@@ -139,8 +146,8 @@ export function SecretStorageRecoveryKey({
|
||||
|
||||
return decodedRecoveryKey;
|
||||
},
|
||||
[mx, keyContent]
|
||||
)
|
||||
[mx, keyContent],
|
||||
),
|
||||
);
|
||||
|
||||
const drivingKey = driveKeyState.status === AsyncStatus.Loading;
|
||||
|
||||
@@ -34,7 +34,7 @@ export function ServerConfigsLoader({ children }: ServerConfigsLoaderProps) {
|
||||
if (authMetadata) {
|
||||
try {
|
||||
validatedAuthMetadata = validateAuthMetadata(authMetadata);
|
||||
} catch (e) {
|
||||
} catch {
|
||||
// Server returned auth metadata but it failed validation — ignore silently.
|
||||
}
|
||||
}
|
||||
@@ -44,7 +44,7 @@ export function ServerConfigsLoader({ children }: ServerConfigsLoaderProps) {
|
||||
mediaConfig,
|
||||
authMetadata: validatedAuthMetadata,
|
||||
};
|
||||
}, [mx])
|
||||
}, [mx]),
|
||||
);
|
||||
|
||||
const configs: ServerConfigs =
|
||||
|
||||
@@ -21,7 +21,7 @@ export function SpaceChildDirectsProvider({
|
||||
const childDirects = useSpaceChildren(
|
||||
allRoomsAtom,
|
||||
spaceId,
|
||||
useChildDirectScopeFactory(mx, mDirects, roomToParents)
|
||||
useChildDirectScopeFactory(mx, mDirects, roomToParents),
|
||||
);
|
||||
|
||||
return children(childDirects);
|
||||
|
||||
@@ -21,7 +21,7 @@ export function SpaceChildRoomsProvider({
|
||||
const childRooms = useSpaceChildren(
|
||||
allRoomsAtom,
|
||||
spaceId,
|
||||
useChildRoomScopeFactory(mx, mDirects, roomToParents)
|
||||
useChildRoomScopeFactory(mx, mDirects, roomToParents),
|
||||
);
|
||||
|
||||
return children(childRooms);
|
||||
|
||||
@@ -15,7 +15,7 @@ export function SpecVersionsLoader({
|
||||
children,
|
||||
}: SpecVersionsLoaderProps) {
|
||||
const [state, load] = useAsyncCallback(
|
||||
useCallback(() => specVersions(fetch, baseUrl), [baseUrl])
|
||||
useCallback(() => specVersions(fetch, baseUrl), [baseUrl]),
|
||||
);
|
||||
const [ignoreError, setIgnoreError] = useState(false);
|
||||
|
||||
@@ -38,6 +38,6 @@ export function SpecVersionsLoader({
|
||||
? state.data
|
||||
: {
|
||||
versions: [],
|
||||
}
|
||||
},
|
||||
);
|
||||
}
|
||||
|
||||
@@ -1,7 +1,17 @@
|
||||
import React, { ReactNode } from 'react';
|
||||
import { Overlay, OverlayBackdrop, Box, config, Text, TooltipProvider, Tooltip, Chip, IconButton } from 'folds';
|
||||
import { Icons, Icon } from './icons';
|
||||
import {
|
||||
Overlay,
|
||||
OverlayBackdrop,
|
||||
Box,
|
||||
config,
|
||||
Text,
|
||||
TooltipProvider,
|
||||
Tooltip,
|
||||
Chip,
|
||||
IconButton,
|
||||
} from 'folds';
|
||||
import FocusTrap from 'focus-trap-react';
|
||||
import { Icons, Icon } from './icons';
|
||||
|
||||
export type UIAFlowOverlayProps = {
|
||||
currentStep: number;
|
||||
|
||||
@@ -34,7 +34,7 @@ function UserRoomProfileContextMenu({ state }: { state: UserRoomProfileState })
|
||||
escapeDeactivates: stopPropagation,
|
||||
}}
|
||||
>
|
||||
<Menu style={{ width: toRem(340) }}>
|
||||
<Menu style={{ width: toRem(260) }}>
|
||||
<SpaceProvider value={space ?? null}>
|
||||
<RoomProvider value={room}>
|
||||
<UserRoomProfile userId={userId} />
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
import React, { useEffect, useState } from 'react';
|
||||
import { Avatar, Box, MenuItem, Text, config } from 'folds';
|
||||
import { Icon, Icons } from '../icons';
|
||||
import { useAtomValue } from 'jotai';
|
||||
import { Icon, Icons } from '../icons';
|
||||
import { sessionsAtom, Session } from '../../state/sessions';
|
||||
import { setLocalStorageItem } from '../../state/utils/atomWithLocalStorage';
|
||||
import { getMxIdServer, mxcUrlToHttp } from '../../utils/matrix';
|
||||
@@ -26,7 +26,7 @@ function OtherSessionAvatar({ session }: { session: Session }) {
|
||||
try {
|
||||
const res = await fetch(
|
||||
`${session.baseUrl}/_matrix/client/v3/profile/${encodeURIComponent(session.userId)}`,
|
||||
{ headers: { Authorization: `Bearer ${session.accessToken}` } }
|
||||
{ headers: { Authorization: `Bearer ${session.accessToken}` } },
|
||||
);
|
||||
if (!res.ok) return;
|
||||
const data = await res.json();
|
||||
@@ -34,7 +34,7 @@ function OtherSessionAvatar({ session }: { session: Session }) {
|
||||
const match = (data.avatar_url as string).match(/^mxc:\/\/([^/]+)\/(.+)$/);
|
||||
if (match) {
|
||||
setSrc(
|
||||
`${session.baseUrl}/_matrix/media/v3/thumbnail/${match[1]}/${match[2]}?width=32&height=32&method=crop`
|
||||
`${session.baseUrl}/_matrix/media/v3/thumbnail/${match[1]}/${match[2]}?width=32&height=32&method=crop`,
|
||||
);
|
||||
}
|
||||
}
|
||||
@@ -59,25 +59,25 @@ function OtherSessionAvatar({ session }: { session: Session }) {
|
||||
|
||||
const deleteAllMatrixDatabases = async (): Promise<void> => {
|
||||
console.log('[AccountSwitcher] Deleting all Matrix IndexedDB databases...');
|
||||
|
||||
|
||||
// List of known Matrix database names/patterns to delete
|
||||
const dbsToDelete = [
|
||||
'matrix-js-sdk::matrix-sdk-crypto', // Shared crypto store (causes conflicts)
|
||||
'matrix-js-sdk::matrix-sdk-crypto', // Shared crypto store (causes conflicts)
|
||||
];
|
||||
|
||||
|
||||
// Try to get all databases if the API is available
|
||||
try {
|
||||
if ('databases' in indexedDB) {
|
||||
const allDbs = await (indexedDB as any).databases();
|
||||
const allDbs = await indexedDB.databases();
|
||||
const matrixDbs = allDbs
|
||||
.map((db: any) => db.name)
|
||||
.filter((name: string) =>
|
||||
name && (
|
||||
name.startsWith('matrix-js-sdk') ||
|
||||
name.includes('@@') ||
|
||||
name.startsWith('sync@@') ||
|
||||
name.startsWith('crypto@@')
|
||||
)
|
||||
.map((db) => db.name)
|
||||
.filter(
|
||||
(name): name is string =>
|
||||
typeof name === 'string' &&
|
||||
(name.startsWith('matrix-js-sdk') ||
|
||||
name.includes('@@') ||
|
||||
name.startsWith('sync@@') ||
|
||||
name.startsWith('crypto@@')),
|
||||
);
|
||||
dbsToDelete.push(...matrixDbs);
|
||||
console.log('[AccountSwitcher] Found Matrix databases:', matrixDbs);
|
||||
@@ -85,11 +85,11 @@ const deleteAllMatrixDatabases = async (): Promise<void> => {
|
||||
} catch (e) {
|
||||
console.warn('[AccountSwitcher] Could not enumerate databases:', e);
|
||||
}
|
||||
|
||||
|
||||
// Delete each database with timeout
|
||||
const deletePromises = dbsToDelete.map(async (dbName) => {
|
||||
try {
|
||||
const deletePromise = new Promise<void>((resolve, reject) => {
|
||||
const deletePromise = new Promise<void>((resolve) => {
|
||||
const request = indexedDB.deleteDatabase(dbName);
|
||||
request.onsuccess = () => {
|
||||
console.log(`[AccountSwitcher] ✅ Deleted database: ${dbName}`);
|
||||
@@ -104,7 +104,7 @@ const deleteAllMatrixDatabases = async (): Promise<void> => {
|
||||
resolve(); // Don't reject, reload will handle it
|
||||
};
|
||||
});
|
||||
|
||||
|
||||
// Add 1-second timeout per database
|
||||
const timeoutPromise = new Promise<void>((resolve) => {
|
||||
setTimeout(() => {
|
||||
@@ -112,13 +112,13 @@ const deleteAllMatrixDatabases = async (): Promise<void> => {
|
||||
resolve();
|
||||
}, 1000);
|
||||
});
|
||||
|
||||
|
||||
await Promise.race([deletePromise, timeoutPromise]);
|
||||
} catch (error) {
|
||||
console.warn(`[AccountSwitcher] Error deleting ${dbName}:`, error);
|
||||
}
|
||||
});
|
||||
|
||||
|
||||
await Promise.all(deletePromises);
|
||||
console.log('[AccountSwitcher] ✅ Database cleanup complete');
|
||||
};
|
||||
@@ -129,14 +129,14 @@ export function AccountSwitcher({ currentUserId }: AccountSwitcherProps) {
|
||||
const useAuthentication = useMediaAuthentication();
|
||||
const currentProfile = useUserProfile(currentUserId ?? '');
|
||||
const currentAvatarUrl = currentProfile.avatarUrl
|
||||
? mxcUrlToHttp(mx, currentProfile.avatarUrl, useAuthentication, 32, 32, 'crop') ?? undefined
|
||||
? (mxcUrlToHttp(mx, currentProfile.avatarUrl, useAuthentication, 32, 32, 'crop') ?? undefined)
|
||||
: undefined;
|
||||
|
||||
|
||||
const handleSwitchAccount = async (session: Session) => {
|
||||
if (session.userId === currentUserId) return;
|
||||
|
||||
|
||||
console.log('[AccountSwitcher] Switching account from', currentUserId, 'to', session.userId);
|
||||
|
||||
|
||||
// Stop the current client before switching
|
||||
if (mx) {
|
||||
console.log('[AccountSwitcher] Stopping current Matrix client...');
|
||||
@@ -147,16 +147,18 @@ export function AccountSwitcher({ currentUserId }: AccountSwitcherProps) {
|
||||
console.error('[AccountSwitcher] Error stopping client:', error);
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
// Set the new current session
|
||||
setLocalStorageItem('currentSessionUserId', session.userId);
|
||||
|
||||
|
||||
// Delete all Matrix databases to prevent conflicts
|
||||
await deleteAllMatrixDatabases();
|
||||
|
||||
|
||||
// Small delay to ensure cleanup is complete
|
||||
await new Promise(resolve => setTimeout(resolve, 100));
|
||||
|
||||
await new Promise((resolve) => {
|
||||
setTimeout(resolve, 100);
|
||||
});
|
||||
|
||||
// Reload the page to initialize the new session
|
||||
console.log('[AccountSwitcher] Reloading page...');
|
||||
window.location.reload();
|
||||
@@ -168,15 +170,18 @@ export function AccountSwitcher({ currentUserId }: AccountSwitcherProps) {
|
||||
}
|
||||
|
||||
// Filter out other sessions (not current)
|
||||
const otherSessions = sessions.filter(s => s.userId !== currentUserId);
|
||||
const otherSessions = sessions.filter((s) => s.userId !== currentUserId);
|
||||
const hasMultipleAccounts = sessions.length > 1;
|
||||
|
||||
return (
|
||||
<Box direction="Column" gap="200">
|
||||
<Text size="L400" style={{ paddingInline: config.space.S200, paddingBlock: config.space.S100 }}>
|
||||
<Text
|
||||
size="L400"
|
||||
style={{ paddingInline: config.space.S200, paddingBlock: config.space.S100 }}
|
||||
>
|
||||
{hasMultipleAccounts ? 'Switch Account' : 'Accounts'}
|
||||
</Text>
|
||||
|
||||
|
||||
{/* Show current account */}
|
||||
{currentUserId && (
|
||||
<MenuItem
|
||||
@@ -210,11 +215,11 @@ export function AccountSwitcher({ currentUserId }: AccountSwitcherProps) {
|
||||
</Box>
|
||||
</MenuItem>
|
||||
)}
|
||||
|
||||
|
||||
{/* Show other accounts if any */}
|
||||
{otherSessions.map((session) => {
|
||||
const server = getMxIdServer(session.userId);
|
||||
|
||||
|
||||
return (
|
||||
<MenuItem
|
||||
key={session.userId}
|
||||
|
||||
@@ -16,7 +16,7 @@ export const AuthenticatedAvatarImage = forwardRef<HTMLImageElement, Authenticat
|
||||
const authenticatedSrc = useAuthenticatedMediaUrl(src, useAuthentication);
|
||||
|
||||
return <AvatarImage ref={ref} {...props} src={authenticatedSrc} />;
|
||||
}
|
||||
},
|
||||
);
|
||||
|
||||
AuthenticatedAvatarImage.displayName = 'AuthenticatedAvatarImage';
|
||||
|
||||
@@ -1,9 +1,8 @@
|
||||
import React, { ImgHTMLAttributes, forwardRef, useEffect, useState } from 'react';
|
||||
import React, { ImgHTMLAttributes, forwardRef } from 'react';
|
||||
import { useAuthenticatedMediaUrl } from '../../hooks/useAuthenticatedMediaUrl';
|
||||
import { useMediaAuthentication } from '../../hooks/useMediaAuthentication';
|
||||
|
||||
export interface AuthenticatedMediaProps
|
||||
extends Omit<ImgHTMLAttributes<HTMLImageElement>, 'src'> {
|
||||
export interface AuthenticatedMediaProps extends Omit<ImgHTMLAttributes<HTMLImageElement>, 'src'> {
|
||||
/** The source URL of the media (may be an authenticated media URL) */
|
||||
src?: string;
|
||||
/** Override for authentication - if not provided, uses useMediaAuthentication hook */
|
||||
@@ -16,13 +15,13 @@ export interface AuthenticatedMediaProps
|
||||
* and renders them as blob URLs.
|
||||
*/
|
||||
export const AuthenticatedMedia = forwardRef<HTMLImageElement, AuthenticatedMediaProps>(
|
||||
({ src, useAuthentication: useAuthOverride, ...props }, ref) => {
|
||||
({ src, alt, useAuthentication: useAuthOverride, ...props }, ref) => {
|
||||
const useAuthFromServer = useMediaAuthentication();
|
||||
const useAuthentication = useAuthOverride ?? useAuthFromServer;
|
||||
const authenticatedSrc = useAuthenticatedMediaUrl(src, useAuthentication);
|
||||
|
||||
return <img ref={ref} {...props} src={authenticatedSrc} />;
|
||||
}
|
||||
return <img ref={ref} alt={alt} {...props} src={authenticatedSrc} />;
|
||||
},
|
||||
);
|
||||
|
||||
AuthenticatedMedia.displayName = 'AuthenticatedMedia';
|
||||
@@ -31,15 +30,15 @@ AuthenticatedMedia.displayName = 'AuthenticatedMedia';
|
||||
* A simpler authenticated img component for use in places like custom HTML parsers.
|
||||
* This component handles its own authentication state.
|
||||
*/
|
||||
export interface AuthenticatedImgProps extends ImgHTMLAttributes<HTMLImageElement> {}
|
||||
export type AuthenticatedImgProps = ImgHTMLAttributes<HTMLImageElement>;
|
||||
|
||||
export const AuthenticatedImg = forwardRef<HTMLImageElement, AuthenticatedImgProps>(
|
||||
({ src, ...props }, ref) => {
|
||||
({ src, alt, ...props }, ref) => {
|
||||
const useAuthentication = useMediaAuthentication();
|
||||
const authenticatedSrc = useAuthenticatedMediaUrl(src, useAuthentication);
|
||||
|
||||
return <img ref={ref} {...props} src={authenticatedSrc} />;
|
||||
}
|
||||
return <img ref={ref} alt={alt} {...props} src={authenticatedSrc} />;
|
||||
},
|
||||
);
|
||||
|
||||
AuthenticatedImg.displayName = 'AuthenticatedImg';
|
||||
|
||||
@@ -1,5 +1,18 @@
|
||||
import { Box, Button, Chip, config, Input, Line, Menu, MenuItem, PopOut, RectCords, Scroll, Text, toRem } from 'folds';
|
||||
import { Icon, Icons } from '../icons';
|
||||
import {
|
||||
Box,
|
||||
Button,
|
||||
Chip,
|
||||
config,
|
||||
Input,
|
||||
Line,
|
||||
Menu,
|
||||
MenuItem,
|
||||
PopOut,
|
||||
RectCords,
|
||||
Scroll,
|
||||
Text,
|
||||
toRem,
|
||||
} from 'folds';
|
||||
import { isKeyHotkey } from 'is-hotkey';
|
||||
import FocusTrap from 'focus-trap-react';
|
||||
import React, {
|
||||
@@ -9,6 +22,7 @@ import React, {
|
||||
useMemo,
|
||||
useState,
|
||||
} from 'react';
|
||||
import { Icon, Icons } from '../icons';
|
||||
import { getMxIdLocalPart, getMxIdServer, isUserId } from '../../utils/matrix';
|
||||
import { useDirectUsers } from '../../hooks/useDirectUsers';
|
||||
import { SettingTile } from '../setting-tile';
|
||||
@@ -20,7 +34,7 @@ import { highlightText, makeHighlightRegex } from '../../plugins/react-custom-ht
|
||||
export const useAdditionalCreators = (defaultCreators?: string[]) => {
|
||||
const mx = useMatrixClient();
|
||||
const [additionalCreators, setAdditionalCreators] = useState<string[]>(
|
||||
() => defaultCreators?.filter((id) => id !== mx.getSafeUserId()) ?? []
|
||||
() => defaultCreators?.filter((id) => id !== mx.getSafeUserId()) ?? [],
|
||||
);
|
||||
|
||||
const addAdditionalCreator = (userId: string) => {
|
||||
@@ -75,12 +89,12 @@ export function AdditionalCreatorInput({
|
||||
const [validUserId, setValidUserId] = useState<string>();
|
||||
const filteredUsers = useMemo(
|
||||
() => directUsers.filter((userId) => !additionalCreators.includes(userId)),
|
||||
[directUsers, additionalCreators]
|
||||
[directUsers, additionalCreators],
|
||||
);
|
||||
const [result, search, resetSearch] = useAsyncSearch(
|
||||
filteredUsers,
|
||||
getUserIdString,
|
||||
SEARCH_OPTIONS
|
||||
SEARCH_OPTIONS,
|
||||
);
|
||||
const queryHighlighRegex = result?.query ? makeHighlightRegex([result.query]) : undefined;
|
||||
|
||||
|
||||
@@ -8,8 +8,8 @@ import React, {
|
||||
} from 'react';
|
||||
import { MatrixError } from 'matrix-js-sdk';
|
||||
import { Box, color, Input, Spinner, Text, toRem } from 'folds';
|
||||
import { Icon, Icons } from '../icons';
|
||||
import { isKeyHotkey } from 'is-hotkey';
|
||||
import { Icon, Icons } from '../icons';
|
||||
import { getMxIdServer } from '../../utils/matrix';
|
||||
import { useMatrixClient } from '../../hooks/useMatrixClient';
|
||||
import { replaceSpaceWithDash } from '../../utils/common';
|
||||
@@ -43,9 +43,9 @@ export function CreateRoomAliasInput({ disabled }: { disabled?: boolean }) {
|
||||
throw e;
|
||||
}
|
||||
},
|
||||
[mx]
|
||||
[mx],
|
||||
),
|
||||
setAliasAvail
|
||||
setAliasAvail,
|
||||
);
|
||||
const aliasAvailable: boolean | undefined =
|
||||
aliasAvail.status === AsyncStatus.Success ? aliasAvail.data : undefined;
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user