feat(email): move email templates into their own package

Pull all email HTML out of the backend and into a standalone
`@docs.plus/email-templates` package — one place for every email
the app sends.

What changed:

  Created
  - 5 email template files (.eta) for notifications, digests,
    new-document alerts, and the unsubscribe page
  - Shared styles (colors, spacing, fonts) so every email looks
    consistent without copy-pasting
  - Reusable building blocks (avatars, buttons, footer links)
  - Template engine (eta, 2KB) that compiles once and stays fast

  Moved
  - Supabase auth templates (magic-link, change-email-address) to
    hocuspocus.server/templates/ where they belong

  Cleaned up
  - Removed ~950 lines of scattered HTML from the backend
  - Backend now calls simple render functions from the new package
  - Added 49 tests covering every template and input escaping

Also fixed lint-staged to not warn about ESLint-ignored files
(--no-warn-ignored) which affected all test files.

Author: HMarzban

.lintstagedrc.js

@@ -13,10 +13,16 @@
 
 module.exports = {
   // TypeScript/React files in src directories
-  'packages/**/src/**/*.{ts,tsx}': ['eslint --fix --max-warnings=0', 'prettier --write'],
+  'packages/**/src/**/*.{ts,tsx}': [
+    'eslint --fix --max-warnings=0 --no-warn-ignored',
+    'prettier --write'
+  ],
 
   // JavaScript/React files in src directories
-  'packages/**/src/**/*.{js,jsx}': ['eslint --fix --max-warnings=0', 'prettier --write'],
+  'packages/**/src/**/*.{js,jsx}': [
+    'eslint --fix --max-warnings=0 --no-warn-ignored',
+    'prettier --write'
+  ],
 
   // Public directory files (service workers, etc.) - format only
   'packages/**/public/**/*.{js,ts}': ['prettier --write'],

bun.lock

@@ -0,0 +1,41 @@
+/**
+ * @docs.plus/email-templates
+ *
+ * Extracted, file-based email templates powered by eta (https://eta.js.org).
+ *
+ * Templates are .eta files in /templates/ — compiled to native JS functions
+ * on first use, then cached. Subsequent renders are plain function calls.
+ *
+ * Supabase auth templates (magic-link.html, change-email-address.html) use
+ * Go template syntax and live in packages/hocuspocus.server/templates/ —
+ * they are NOT managed by this engine.
+ *
+ * @example
+ * ```ts
+ * import { renderNotificationEmail, getEmailSubject } from '@docs.plus/email-templates'
+ *
+ * const html = renderNotificationEmail({
+ *   recipientName: 'Jane',
+ *   senderName: 'John',
+ *   notificationType: 'mention',
+ *   messagePreview: 'Hey @Jane, check the API docs',
+ *   actionUrl: 'https://docs.plus/api-docs?chatroom=general',
+ * })
+ * ```
+ */
+
+// Render functions
+export {
+  buildListUnsubscribeHeaders,
+  getEmailSubject,
+  renderDigestEmail,
+  renderNewDocumentEmail,
+  renderNotificationEmail,
+  renderUnsubscribePage,
+} from './src/engine'
+
+// Types & helpers (for consumers that need direct access)
+export type { UnsubscribeLinks } from './src/helpers'
+export { templateHelpers } from './src/helpers'
+export { APP_NAME, APP_URL, COLORS, FONT_STACK,RADIUS, SPACING } from './src/tokens'
+

packages/email-templates/change-email-address.html

@@ -0,0 +1,17 @@
+{
+  "name": "@docs.plus/email-templates",
+  "version": "1.0.0",
+  "private": true,
+  "description": "Email templates and rendering engine for docs.plus",
+  "type": "module",
+  "main": "index.ts",
+  "scripts": {
+    "test": "bun test"
+  },
+  "dependencies": {
+    "eta": "^3.5.0"
+  },
+  "devDependencies": {
+    "bun-types": "latest"
+  }
+}