SubMiner/backlog/tasks/task-12 - Add-renderer-module-bundling-for-multi-file-renderer-support.md

id, title, status, assignee, created_date, updated_date, labels, milestone, dependencies, references, priority

id	title	status	assignee	created_date	updated_date	labels	milestone	dependencies	references	priority
TASK-12	Add renderer module bundling for multi-file renderer support	To Do		2026-02-11 08:21	2026-02-14 00:44	infrastructure renderer build	Codebase Clarity & Composability	TASK-5	src/renderer/renderer.ts src/renderer/index.html package.json tsconfig.json	high

Description

Currently renderer.ts is a single file loaded directly by Electron's renderer process via a script tag in index.html. To split it into modules (TASK-6), we need a bundling step since Electron renderer's default context doesn't support bare ES module imports without additional configuration.

Options:

1. esbuild — fast, minimal config, already used in many Electron projects
2. Electron's native ESM support — requires "type": "module" and sandbox configuration
3. TypeScript compiler output — if targeting a single concatenated bundle

The build pipeline already compiles TypeScript and copies renderer assets. Adding a bundling step for the renderer would slot into the existing npm run build script.

Acceptance Criteria

• #1 Renderer code can be split across multiple .ts files with imports
• #2 Build pipeline bundles renderer modules into a single output for Electron
• #3 Existing make build still works end-to-end
• #4 No runtime errors in renderer process

Implementation Notes

Priority promoted from medium to high: this unblocks clean multi-file renderer work and is a prerequisite for upcoming UI features (TASK-26 help modal, TASK-34 episode browser, and any future modal/overlay features).