fix: cyrillic fonts, dev certs, page head, and ru-text typography (#67)
🤖 PR generated for branch `fix/cyrillic-fonts-dev-certs-and-page-head`.
### Changes Summary
- **Fonts**: Add Cyrillic glyph subsets for Lato, EB Garamond, and Fira
Code.
- **Dev**: Support remote Root CA and encrypted dev CA key in
`.env.dev`.
- **UI & Kits**: Add size variant to `Breadcrumbs` component and enlarge
`PageHead` breadcrumbs with tuned collapse scroll threshold.
- **ESLint**: Add `no-hanging-particles` i18n & markdown typography rule
with auto-fixer.
- **Content & i18n**: Apply `ru-text` editorial and typography polish
(em dashes, number ranges, «ё» restoration, non-breaking spaces) across
`services/www` and `services/docs`.
This commit is contained in:
1 parent
c6487dc258
commit
b3638f4d63
111 files changed
+2350
-1512
No files matched your search
@@ -1,15 +1,15 @@
|
||||
---
|
||||
title: The Module System
|
||||
title: The Module System
|
||||
weight: 2
|
||||
---
|
||||
|
||||
**Goal:** Define the vocabulary and mechanics of Quetza's primary abstraction unit.
|
||||
**Goal:** Define the vocabulary and mechanics of Quetza's primary abstraction unit.
|
||||
|
||||
## System Vocabulary
|
||||
|
||||
### Module Declaration
|
||||
|
||||
The `module.ts` file acts as the manifest. It is the entry point for discovery.
|
||||
The `module.ts` file acts as the manifest. It is the entry point for discovery.
|
||||
|
||||
```typescript
|
||||
export const name = 'my-module'; // ID
|
||||
@@ -18,36 +18,36 @@ export const description = '...'; // Doc
|
||||
|
||||
### Command Registration
|
||||
|
||||
Occurs during the `ready` event.
|
||||
Occurs during the `ready` event.
|
||||
|
||||
1. Quetza scans all `commands/` folders.
|
||||
2. Compiles `ApplicationCommandData`.
|
||||
3. PUTs the payload to Discord's API.
|
||||
3. PUTs the payload to Discord's API.
|
||||
|
||||
### Controller Injection
|
||||
|
||||
State is injected, not imported.
|
||||
State is injected, not imported.
|
||||
|
||||
```typescript
|
||||
// The framework calls this:
|
||||
execute(client, interaction, controller);
|
||||
```
|
||||
|
||||
- **Why?** Allows the framework to manage the controller's lifecycle (singleton per module).
|
||||
- **Why?** Allows the framework to manage the controller's lifecycle (singleton per module).
|
||||
|
||||
## State Management Philosophy
|
||||
|
||||
### Ephemeral by Default
|
||||
### Ephemeral by Default
|
||||
|
||||
Quetza provides **no built-in database**.
|
||||
|
||||
- **Memory:** Controllers store state in JS `Map` or `Set` objects.
|
||||
- **Restart:** All state is lost when the process exits.
|
||||
- **Persistence:** Must be implemented manually (e.g., SQLite, Redis) inside the Controller.
|
||||
- **Memory:** Controllers store state in JS `Map` or `Set` objects.
|
||||
- **Restart:** All state is lost when the process exits.
|
||||
- **Persistence:** Must be implemented manually (e.g., SQLite, Redis) inside the Controller.
|
||||
|
||||
### Scope as Key
|
||||
### Scope as Key
|
||||
|
||||
State must be keyed by its boundary.
|
||||
State must be keyed by its boundary.
|
||||
|
||||
- `Map<GuildID, ...>` - Server specific (Most common).
|
||||
- `Map<UserID, ...>` - User specific (DM bots).
|
||||
@@ -58,7 +58,7 @@ State must be keyed by its boundary.
|
||||
|
||||
- **Validation:** Check permissions/inputs immediately.
|
||||
- **User-Facing:** "You don't have permission" (Not "Error: 403").
|
||||
- **Isolation:** A crash in `/ping` catches itself and doesn't kill the bot.
|
||||
- **Isolation:** A crash in `/ping` catches itself and doesn't kill the bot.
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in new issue
Block a user