@rip-lang/print 0.1.0

package/README.md

@@ -0,0 +1,65 @@
+<img src="https://raw.githubusercontent.com/shreeve/rip-lang/main/docs/rip.png" style="width:50px" /> <br>
+
+# Rip Print - @rip-lang/print
+
+> **Syntax-highlighted source code printer**
+
+Highlights source code using highlight.js and serves the result in the browser for viewing and printing. Serves once and exits — no leftover files, no cleanup.
+
+## Quick Start
+
+```bash
+# Install
+bun add -g @rip-lang/print
+
+# Print all source files in a directory
+rip-print src/
+
+# Print specific files
+rip-print src/compiler.js src/lexer.js
+
+# Dark theme
+rip-print -d src/
+
+# Strip leading comment blocks
+rip-print -b src/
+
+# Exclude extensions
+rip-print -x lock,map src/
+```
+
+## Features
+
+- **highlight.js** — 190+ languages, beautiful GitHub-style themes
+- **Auto-detect languages** — 40+ languages supported
+- **Light and dark themes** — GitHub Light (default) and GitHub Dark
+- **Print-optimized CSS** — page breaks between files, clean headers
+- **Table of contents** — auto-generated for multi-file output
+- **Sticky headers** — file names stay visible while scrolling
+- **Serve once** — opens browser, serves the page, exits automatically
+- **No leftover files** — everything is in-memory
+
+## Options
+
+| Flag | Description |
+|------|-------------|
+| `-b`, `--bypass` | Strip leading comment blocks from files |
+| `-d`, `--dark` | Use dark theme (default: light) |
+| `-h`, `--help` | Show help |
+| `-x <exts>` | Comma list of extensions to exclude |
+
+## How It Works
+
+1. Walks the specified paths, discovers source files
+2. Highlights each file using Shiki with the detected language
+3. Builds a single HTML page with table of contents
+4. Starts a Bun server on a random port
+5. Opens the browser
+6. Exits after serving the page
+
+Print from the browser with **Cmd+P** (Mac) or **Ctrl+P** (Windows/Linux).
+
+## Links
+
+- [Rip Language](https://github.com/shreeve/rip-lang)
+- [highlight.js](https://highlightjs.org)

package/bin/rip-print

@@ -0,0 +1,12 @@
+#!/usr/bin/env bun
+
+import { execFileSync } from 'child_process';
+import { dirname, join } from 'path';
+
+const printRip = join(dirname(new URL(import.meta.url).pathname), '..', 'print.rip');
+
+try {
+  execFileSync('rip', [printRip, ...process.argv.slice(2)], { stdio: 'inherit' });
+} catch (e) {
+  process.exit(e.status || 1);
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@rip-lang/print",
+  "version": "0.1.0",
+  "description": "Syntax-highlighted source code printer — Shiki-powered, serves once, auto-opens browser",
+  "type": "module",
+  "main": "print.rip",
+  "bin": {
+    "rip-print": "./bin/rip-print"
+  },
+  "keywords": [
+    "print",
+    "syntax",
+    "highlighting",
+    "highlight.js",
+    "source",
+    "code",
+    "bun",
+    "rip"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shreeve/rip-lang.git",
+    "directory": "packages/print"
+  },
+  "homepage": "https://github.com/shreeve/rip-lang/tree/main/packages/print#readme",
+  "bugs": {
+    "url": "https://github.com/shreeve/rip-lang/issues"
+  },
+  "author": "Steve Shreeve <steve.shreeve@gmail.com>",
+  "license": "MIT",
+  "dependencies": {
+    "rip-lang": "^3.4.4",
+    "highlight.js": "^11.11.1"
+  },
+  "files": [
+    "print.rip",
+    "bin/rip-print",
+    "README.md"
+  ]
+}

package/print.rip

@@ -0,0 +1,365 @@
+# ============================================================================
+# rip-print — Syntax-highlighted source code printer
+#
+# Author: Steve Shreeve (steve.shreeve@gmail.com)
+#   Date: Feb 9, 2026
+#
+# Highlights source code using Shiki (VS Code's syntax engine) and serves
+# the result in the browser for viewing and printing. Serves once and exits.
+# ============================================================================
+
+import hljs from 'highlight.js'
+import { existsSync, readdirSync, readFileSync, statSync } from 'fs'
+import { basename, extname, join, relative } from 'path'
+import { execSync } from 'child_process'
+
+# ============================================================================
+# CLI argument parsing
+# ============================================================================
+
+args = process.argv.slice(2)
+
+if args.includes('-h') or args.includes('--help')
+  console.log """
+    usage: rip-print [options] <paths ...>
+
+    Options:
+      -b, --bypass     Strip leading comment blocks from files
+      -d, --dark       Use dark theme (default: light)
+      -h, --help       Show this help message
+      -x <exts>        Comma list of extensions to exclude
+
+    Examples:
+      rip-print src/              # Print all source files in src/
+      rip-print *.rip             # Print all .rip files
+      rip-print -d src/           # Dark theme
+      rip-print -b src/           # Strip top comments
+      rip-print -x lock,map src/  # Exclude .lock and .map files
+    """
+  process.exit(0)
+
+dark   = args.includes('-d') or args.includes('--dark')
+bypass = args.includes('-b') or args.includes('--bypass')
+
+# Extract -x excludes
+excludeExts = new Set()
+for arg, i in args
+  if arg is '-x' and args[i + 1]
+    for ext in args[i + 1].split(',')
+      excludeExts.add ext.toLowerCase().replace(/^\./, '')
+
+# Filter out flags, get paths
+xIdx = args.indexOf('-x')
+paths = args.filter (a, i) -> not a.startsWith('-') and (xIdx < 0 or i isnt xIdx + 1)
+paths = ['.'] if paths.length is 0
+
+# Default exclusions (binary, generated, etc.)
+defaultExclude = new Set [
+  'css', 'gif', 'ico', 'jpg', 'jpeg', 'png', 'svg', 'pdf', 'webp',
+  'otf', 'ttf', 'eot', 'woff', 'woff2',
+  'o', 'a', 'dylib', 'so', 'dll',
+  'gem', 'gz', 'zip', 'tar', 'br',
+  'lock', 'db', 'sqlite3', 'sqlite',
+  'map', 'min.js', 'min.css',
+  'vsix', 'DS_Store'
+]
+
+for ext in excludeExts
+  defaultExclude.add ext
+
+# ============================================================================
+# File discovery
+# ============================================================================
+
+skipDirs = new Set ['.git', 'node_modules', '.rip-cache', '.zig-cache', 'zig-out', 'dist', 'misc']
+
+def walkDir(dir, base = dir)
+  files = []
+  try
+    entries = readdirSync dir
+  catch
+    return files
+  for entry in entries
+    full = join dir, entry
+    try
+      stat = statSync full
+    catch
+      continue
+    if stat.isDirectory()
+      continue if entry.startsWith('.') or skipDirs.has(entry)
+      files = files.concat walkDir(full, base)
+    else if stat.isFile()
+      ext = entry.split('.').pop()?.toLowerCase() or ''
+      continue if defaultExclude.has(ext)
+      continue if entry.startsWith('.')
+      files.push relative(base, full) or full
+  files.sort()
+
+allFiles = []
+for p in paths
+  if not existsSync(p)
+    console.error "Not found: #{p}"
+    continue
+  stat = statSync p
+  if stat.isDirectory()
+    allFiles = allFiles.concat walkDir(p, p).map (f) -> join(p, f)
+  else if stat.isFile()
+    allFiles.push p
+
+if allFiles.length is 0
+  console.error "No files found"
+  process.exit(1)
+
+console.log "#{allFiles.length} file#{if allFiles.length > 1 then 's' else ''}"
+
+# ============================================================================
+# Language detection
+# ============================================================================
+
+extToLang =
+  rip:    'coffeescript'
+  coffee: 'coffeescript'
+  js:     'javascript'
+  mjs:    'javascript'
+  cjs:    'javascript'
+  ts:     'typescript'
+  mts:    'typescript'
+  cts:    'typescript'
+  jsx:    'jsx'
+  tsx:    'tsx'
+  rb:     'ruby'
+  py:     'python'
+  rs:     'rust'
+  go:     'go'
+  sh:     'bash'
+  bash:   'bash'
+  zsh:    'bash'
+  fish:   'fish'
+  yml:    'yaml'
+  yaml:   'yaml'
+  json:   'json'
+  jsonc:  'jsonc'
+  md:     'markdown'
+  html:   'html'
+  htm:    'html'
+  xml:    'xml'
+  css:    'css'
+  scss:   'scss'
+  sass:   'sass'
+  less:   'less'
+  sql:    'sql'
+  c:      'c'
+  h:      'c'
+  cpp:    'cpp'
+  hpp:    'cpp'
+  zig:    'zig'
+  toml:   'toml'
+  ini:    'ini'
+  dockerfile: 'dockerfile'
+  makefile:   'makefile'
+
+def getLang(file)
+  base = basename(file).toLowerCase()
+  return 'makefile'   if base is 'makefile' or base is 'gnumakefile'
+  return 'dockerfile' if base is 'dockerfile'
+  return 'yaml'       if base is '.prettierrc' or base is '.eslintrc'
+  return 'json'       if base is '.babelrc'
+  return 'bash'       if base is '.bashrc' or base is '.zshrc' or base is '.profile'
+  return 'toml'       if base is 'bunfig.toml'
+
+  ext = extname(file).slice(1).toLowerCase()
+  lang = extToLang[ext]
+  return lang if lang and hljs.getLanguage(lang)
+  return 'plaintext'
+
+# ============================================================================
+# Highlight and build HTML
+# ============================================================================
+
+def stripTopComments(code)
+  lines = code.split('\n')
+  i = 0
+  i++ while i < lines.length and (lines[i].startsWith('#') or lines[i].trim() is '')
+  return code if i is 0
+  lines.slice(i).join('\n')
+
+def escapeHtml(str)
+  str.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;')
+
+def highlightCode(code, lang)
+  highlighted = null
+  try
+    if lang isnt 'plaintext'
+      result = hljs.highlight code, { language: lang }
+      highlighted = result.value
+  catch
+    # fall through
+  highlighted ?= escapeHtml code
+
+  # Add line numbers
+  lines = highlighted.split('\n')
+  width = String(lines.length).length
+  numbered = lines.map (line, i) ->
+    num = String(i + 1).padStart(width)
+    "<span class=\"line-num\">#{num}</span>  #{line}"
+  numbered.join('\n')
+
+sections = []
+for file in allFiles
+  try
+    code = readFileSync file, 'utf-8'
+  catch
+    console.error "  Skipping: #{file} (unreadable)"
+    continue
+  code = code.replace /\t/g, '  '
+  code = code.replace /\r\n?/g, '\n'
+  code = stripTopComments(code) if bypass
+  lang = getLang file
+  lineCount = code.split('\n').length
+  console.log "  #{file} (#{lineCount} lines) [#{lang}]"
+  highlighted = highlightCode code, lang
+  html = "<pre><code class=\"hljs\">#{highlighted}</code></pre>"
+  sections.push { file, lineCount, lang, html }
+
+# ============================================================================
+# HTML template
+# ============================================================================
+
+bgColor    = if dark then '#0d1117' else '#ffffff'
+textColor  = if dark then '#e6edf3' else '#1f2328'
+headerBg   = if dark then '#161b22' else '#f6f8fa'
+borderColor = if dark then '#30363d' else '#d0d7de'
+
+toc = ''
+if sections.length > 1
+  toc = """
+    <div class="toc">
+      <h2>Files (#{sections.length})</h2>
+      <ol>
+    """
+  for section in sections
+    toc += """
+          <li><a href="##{section.file}">#{section.file}</a> <span class="meta">(#{section.lineCount} lines)</span></li>
+      """
+  toc += """
+      </ol>
+    </div>
+    """
+
+fileSections = ''
+count = sections.length
+for section, i in sections
+  prev = sections[(i - 1 + count) % count]
+  next = sections[(i + 1) % count]
+  nav = ""
+  nav += "<a href=\"##{prev.file}\">prev</a> " if count > 1
+  nav += "<a href=\"##{next.file}\">next</a> " if count > 1
+  nav += "<a href=\"#top\">&uarr; top</a>"
+  fileSections += """
+    <div class="file-section">
+      <div class="file-header" id="#{section.file}">
+        <span>#{section.file} <span class="meta">(#{section.lineCount} lines) [#{section.lang}]</span></span>
+        <span class="nav">#{nav}</span>
+      </div>
+      <div class="code-container">
+        #{section.html}
+      </div>
+    </div>
+
+    """
+
+# Read highlight.js CSS theme
+hljsTheme = if dark then 'github-dark' else 'github'
+hljsDir = join import.meta.dir, 'node_modules', 'highlight.js', 'styles'
+hljsCss = readFileSync join(hljsDir, "#{hljsTheme}.css"), 'utf-8'
+
+html = """
+  <!DOCTYPE html>
+  <html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <title>rip-print</title>
+    <link rel="icon" href="data:,">
+    <style>#{hljsCss}</style>
+    <style>
+      * { margin: 0; padding: 0; box-sizing: border-box; }
+      body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; background: #{bgColor}; color: #{textColor}; }
+
+      .toc { padding: 20px 30px; border-bottom: 1px solid #{borderColor}; }
+      .toc h2 { font-size: 18px; margin-bottom: 10px; }
+      .toc ol { padding-left: 24px; columns: 2; column-gap: 40px; }
+      .toc li { font-size: 13px; line-height: 1.8; }
+      .toc a { color: #{textColor}; text-decoration: none; }
+      .toc a:hover { text-decoration: underline; }
+      .meta { color: #888; font-size: 12px; }
+
+      .file-section { margin-bottom: 0; }
+      .file-header {
+        background: #{headerBg}; padding: 8px 16px; font-size: 13px; font-weight: 600;
+        border-top: 1px solid #{borderColor}; border-bottom: 1px solid #{borderColor};
+        display: flex; justify-content: space-between; align-items: center;
+      }
+      .nav { font-weight: normal; font-size: 12px; }
+      .nav a { color: #888; text-decoration: none; margin-left: 12px; }
+      .nav a:hover { color: #{textColor}; }
+
+      .code-container { overflow-x: auto; }
+      .code-container pre { margin: 0; border-radius: 0; }
+      .code-container code { font-size: 13px; line-height: 1.5; padding: 16px !important; display: block; }
+      .line-num { color: #aaa; user-select: none; display: inline-block; min-width: 2em; text-align: right; }
+
+      @media print {
+        .toc { page-break-after: always; }
+        .file-header { background: #f0f0f0 !important; color: #000 !important; }
+        .nav { display: none; }
+        .file-section { page-break-before: always; }
+        .file-section:first-of-type { page-break-before: avoid; }
+        body { background: white !important; color: black !important; }
+        code { font-size: 11px !important; }
+      }
+    </style>
+  </head>
+  <body>
+    <a name="top"></a>
+    #{toc}
+    #{fileSections}
+  </body>
+  </html>
+  """
+
+# ============================================================================
+# Serve once and open browser
+# ============================================================================
+
+served = false
+
+server = Bun.serve
+  port: 0
+  fetch: (req) ->
+    served = true
+    new Response html, headers: { 'Content-Type': 'text/html; charset=utf-8' }
+
+console.log "\nOpening browser..."
+
+# Open browser
+try
+  if process.platform is 'darwin'
+    execSync "open 'http://localhost:#{server.port}/'"
+  else if process.platform is 'linux'
+    execSync "xdg-open 'http://localhost:#{server.port}/'"
+  else
+    execSync "start 'http://localhost:#{server.port}/'"
+catch
+  console.log "Visit: http://localhost:#{server.port}/"
+
+# Exit after serving
+setTimeout ->
+  if served
+    server.stop()
+    process.exit(0)
+  else
+    setTimeout ->
+      server.stop()
+      process.exit(0)
+    , 5000
+, 3000