feat: initial release - high-performance bun-native html transcript generator

Author: LuigiColantuono

.github/workflows/ci.yml

@@ -0,0 +1,25 @@
+name: Bun CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - name: Install Dependencies
+        run: bun install
+
+      - name: Type Check
+        run: bunx tsc --noEmit
+
+      - name: Lint
+        run: bun run lint

.gitignore

@@ -0,0 +1,34 @@
+# dependencies (bun install)
+node_modules
+
+# output
+out
+dist
+*.tgz
+
+# code coverage
+coverage
+*.lcov
+
+# logs
+logs
+_.log
+report.[0-9]_.[0-9]_.[0-9]_.[0-9]_.json
+
+# dotenv environment variable files
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# caches
+.eslintcache
+.cache
+*.tsbuildinfo
+
+# IntelliJ based IDEs
+.idea
+
+# Finder (MacOS) folder config
+.DS_Store

.npmignore

@@ -0,0 +1,18 @@
+.github
+.idea
+.vscode
+.gitattributes
+.gitignore
+assets/
+docs/
+tsconfig.json
+tsup-config.json
+package-lock.json
+eslint.config.mjs
+
+# Dev files
+tests/
+scripts/
+test_*.html
+index.ts
+bun.lock

README.md

@@ -0,0 +1,64 @@
+# **𝗧 𝗥 𝗔 𝗡 𝗦 𝗖 𝗥 𝗜 𝗣 𝗧**
+
+<p align="left"><a href="https://github.com/sponsors/LuigiColantuono"><img src="https://img.shields.io/github/sponsors/LuigiColantuono?style=social"></a> <a href="https://paypal.me/l0g4n7"><img src="https://img.shields.io/badge/💖-Support-ff69b4"></a> <img src="https://img.shields.io/npm/v/@ovencord/transcript"> <img src="https://img.shields.io/npm/dm/@ovencord/transcript?label=downloads"> <img src="https://img.shields.io/npm/l/@ovencord/transcript"> <img src="https://img.shields.io/github/repo-size/ovencord/transcript"> <a href="https://github.com/ovencord/transcript"><img src="https://img.shields.io/badge/Bun-Networking-black?logo=bun"></a></p>
+
+<div align="center">
+  <img src="https://github.com/user-attachments/assets/70e8758e-f363-478a-a013-fd46ca3cf3ec" alt="@ovencord/transcript Logo" width="180"/>
+  <p><b>The fastest, lightest, and most faithful Discord HTML transcript generator.</b></p>
+  <p><i>Built exclusively for the Bun ecosystem.</i></p>
+</div>
+
+---
+
+Stop simulating browsers to generate simple text logs. **@ovencord/transcript** purges the bloat of JSDOM and React, replacing them with a high-performance, string-based rendering engine powered by Bun and a specialized fork of Mustache.
+
+## **Blazingly Fast**
+
+*   **Zero Node Dependencies**: No `ws`, no `http` legacy, no `JSDOM`. Pure Bun-native execution.
+*   **Mustache Powered**: Generates complex transcripts in milliseconds using optimized string templates instead of heavy, recursive DOM manipulation.
+*   **Zero Memory Overhead**: While other libraries require hundreds of MBs to "render" a virtual DOM, Buncord processes messages through a stream-like logic that keeps your RAM footprint invisible.
+
+## **Absolute Cinema UI**
+
+*   **Discord v2 Native**: First-class support for modern components: **Buttons**, **Select Menus**, and the new **Containers**.
+*   **1:1 Visual Fidelity**: Unlike libraries with hardcoded styles, Buncord uses a dynamic CSS variable system mirrored directly from the official Discord client.
+*   **Media-First**: Native support for **Multi-image Media Galleries**, high-res avatars, and custom emoji rendering.
+*   **Smart Mentions**: Intelligently resolves user mentions and relative timestamps within the transcript context.
+
+### **📦 Bundle Size Comparison: Transcripts**
+
+| Package | Size (Unpacked) | Total Files | Dependencies | Install Weight (est.) |
+| :--- | :--- | :--- | :--- | :--- |
+| **discord-html-transcripts** | 170 kB | 87 | React, JSDOM, etc. | **~25.000 kB (25MB)** |
+| **@ovencord/transcript** | 33.8 kB | 8 | **NONE** (Native) | **~34 kB** |
+
+> **Result: 99.8% savings on total installation weight!**
+
+## **Installation**
+
+```bash
+bun add @ovencord/transcript
+```
+
+## **Quick Start**
+
+```typescript
+import { createTranscript } from '@ovencord/transcript';
+
+const messages = [...]; // Your Discord.js / Buncord messages
+const channel = { name: 'ticket-001' };
+
+const html = await createTranscript(messages, channel);
+// Output is a high-performance HTML buffer/string ready to be served or saved.
+```
+
+<div align="center">
+<img width="400" height="500" alt="Buncord-Transcript" src="https://github.com/user-attachments/assets/a63256bd-c22e-465a-a667-74d747526dfb" />
+</div>
+
+## **The Philosophy**
+
+Built out of frustration with outdated, bloated libraries that fail to render modern Discord components. Buncord-Transcript is a **"Performance Tier 1"** tool for developers who prioritize speed, code purity, and production stability.
+
+---
+> This project was created using `bun init` in bun v1.3.6. [Bun](https://bun.com) is a fast all-in-one JavaScript runtime.

eslint.config.mjs

@@ -0,0 +1,21 @@
+import tseslint from 'typescript-eslint';
+import globals from 'globals';
+
+export default tseslint.config(
+  ...tseslint.configs.recommended,
+  {
+    languageOptions: {
+      globals: {
+        ...globals.node,
+        ...globals.browser,
+        Bun: 'readonly',
+      },
+    },
+    rules: {
+      '@typescript-eslint/consistent-type-imports': 'error',
+      '@typescript-eslint/no-explicit-any': 'off',
+      '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
+      '@typescript-eslint/no-unsafe-declaration-merging': 'off',
+    },
+  }
+);

index.ts

@@ -0,0 +1 @@
+console.log("Hello via Bun!");

package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@ovencord/transcript",
+  "version": "1.0.0",
+  "description": "Ultrafast, zero-dependency Discord HTML transcript generator exclusively for the Bun ecosystem.",
+  "module": "src/index.ts",
+  "main": "src/index.ts",
+  "type": "module",
+  "author": {
+    "name": "Luigi Colantuono",
+    "url": "https://github.com/LuigiColantuono"
+  },
+  "homepage": "https://github.com/LuigiColantuono",
+  "license": "MIT",
+  "funding": {
+    "type": "individual",
+    "url": "https://paypal.me/l0g4n7"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LuigiColantuono/Buncord-Transcript.git"
+  },
+  "keywords": [
+    "discord",
+    "transcript",
+    "bun",
+    "html",
+    "generator",
+    "performance",
+    "zero-dependency",
+    "discord-v2"
+  ],
+  "scripts": {
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "eslint": "^9.39.2",
+    "globals": "^17.2.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.54.0"
+  },
+  "dependencies": {
+    "@ovencord/mustache": "^1.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}