Skip to content

docs: add JSDoc comments to 5 components#57

Open
clawgreen wants to merge 3 commits intoOpenKnots:mainfrom
clawgreen:docs/add-jsdoc-to-components
Open

docs: add JSDoc comments to 5 components#57
clawgreen wants to merge 3 commits intoOpenKnots:mainfrom
clawgreen:docs/add-jsdoc-to-components

Conversation

@clawgreen
Copy link
Copy Markdown
Contributor

@clawgreen clawgreen commented Mar 1, 2026

What does this PR do?

Part 1: JSDoc Comments

Adds JSDoc documentation comments to 5 components for better IDE autocomplete:

  • TerminalApp - Full terminal application with tabs and split panes
  • TerminalHeader - Tabbed header with traffic lights and theme switcher
  • TerminalPane - Interactive terminal pane with command input
  • TerminalStatusBar - Status bar showing shell info and pane/tab counts
  • terminal-themes - Theme system module

Part 2: Playground Examples

Adds missing component examples to the playground:

  • TerminalTable - Data tables with box-drawing characters, alignment options, and striped rows
  • TerminalTabs - Tab bar with keyboard navigation (←→ arrows)
  • TerminalSelect - Dropdown select component

Type of Change

  • 📚 Documentation
  • 📦 Enhancement (new playground examples)

Checklist

  • Build passes (pnpm run build)
  • No TypeScript errors
  • All examples render correctly

Screenshots

N/A - Documentation and examples only


Related Issues:

- Added JSDoc to TerminalApp
- Added JSDoc to TerminalHeader
- Added JSDoc to TerminalPane
- Added JSDoc to TerminalStatusBar
- Added JSDoc to terminal-themes module

Closes #8
@vercel
Copy link
Copy Markdown

vercel bot commented Mar 1, 2026

@clawgreen is attempting to deploy a commit to the 0xBuns Team on Vercel.

A member of the Team first needs to authorize it.

- Added examples for TerminalTable with striped rows and alignment
- Added TerminalTabs with keyboard navigation demo
- Added TerminalSelect with option list

Closes #11
@BunsDev BunsDev added blocked-infra Blocked by external tooling or integration setup docs Documentation changes labels Mar 9, 2026
@BunsDev
Copy link
Copy Markdown
Contributor

BunsDev commented Mar 9, 2026

Maintainer triage: this is useful work, but it should sit behind the repo-health fixes and the first wave of component decisions. It touches the playground surface that many feature PRs also edit, so it will be easier to land once the queue is narrower.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

blocked-infra Blocked by external tooling or integration setup docs Documentation changes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants