sakusei 0.1.0

data/lib/sakusei/vue_renderer.js

@@ -0,0 +1,226 @@
+#!/usr/bin/env node
+/**
+ * Vue Server-Side Renderer for Sakusei (v2)
+ *
+ * Reads a JSON array of render jobs from stdin.
+ * Writes a JSON array of results to stdout.
+ *
+ * Each job:    { id, componentFile, props, slotHtml }
+ * Each result: { id, html, css }
+ *
+ * Requires: npm install @vue/server-renderer @vue/compiler-sfc vue@3
+ */
+
+'use strict'
+const fs = require('fs')
+const path = require('path')
+const vm = require('vm')
+const Module = require('module')
+const crypto = require('crypto')
+
+// Add CWD node_modules to module resolution (user's project dependencies)
+const cwdNodeModules = path.join(process.cwd(), 'node_modules')
+if (fs.existsSync(cwdNodeModules)) module.paths.unshift(cwdNodeModules)
+
+const { parse, compileScript, compileTemplate, compileStyleAsync } = require('@vue/compiler-sfc')
+const { renderToString } = require('@vue/server-renderer')
+const { createSSRApp } = require('vue')
+
+// Compiled code cache: filePath → { code, css }
+const compiledCache = new Map()
+
+// Transform ESM import/export syntax to CommonJS
+function esmToCjs(code) {
+  // Named imports with optional aliases: import { a as b, c } from 'pkg'
+  code = code.replace(
+    /^import\s*\{([^}]+)\}\s*from\s*["']([^"']+)["']\s*;?$/gm,
+    (_, names, pkg) => {
+      const renamed = names.replace(/(\w+)\s+as\s+(\w+)/g, '$1: $2')
+      return `const {${renamed}} = require('${pkg}');`
+    }
+  )
+  // Default imports: import X from 'pkg'
+  code = code.replace(
+    /^import\s+(\w+)\s+from\s*["']([^"']+)["']\s*;?$/gm,
+    (_, name, pkg) => `const ${name} = require('${pkg}');`
+  )
+  // export function/const → remove export keyword
+  code = code.replace(/^export\s+((?:async\s+)?function|const|let|var)\b/gm, '$1')
+  // Remove bare named exports: export { ssrRender }
+  code = code.replace(/^export\s*\{[^}]*\}\s*;?$/gm, '')
+  return code
+}
+
+// Execute compiled CJS module code and return its exports
+function executeModule(code, filePath) {
+  const patchedRequire = (id) => {
+    if (id.endsWith('.vue')) {
+      // Handle both relative and absolute .vue imports
+      const abs = path.isAbsolute(id) ? id : path.resolve(path.dirname(filePath), id)
+      const compiled = compiledCache.get(abs)
+      if (!compiled) throw new Error(`Component not pre-compiled: ${abs}`)
+      return executeModule(compiled.code, abs)
+    }
+    // Use the renderer's own require so CWD node_modules are on the search path
+    return require(id)
+  }
+  const mod = { exports: {} }
+  const wrapper = `(function(require, module, exports, __filename, __dirname) {\n${code}\n})`
+  const fn = vm.runInThisContext(wrapper, { filename: filePath })
+  fn(patchedRequire, mod, mod.exports, filePath, path.dirname(filePath))
+  return mod.exports
+}
+
+// Compile a .vue file (base form, no slot injection) and store in compiledCache
+async function compileVueFile(filePath) {
+  if (compiledCache.has(filePath)) return compiledCache.get(filePath)
+
+  const source = fs.readFileSync(filePath, 'utf-8')
+  const { descriptor, errors: parseErrors } = parse(source, { filename: filePath })
+  if (parseErrors.length > 0) {
+    throw new Error(`Parse errors in ${path.basename(filePath)}: ${parseErrors.map(e => e.message).join(', ')}`)
+  }
+
+  const id = crypto.createHash('md5').update(filePath).digest('hex').slice(0, 8)
+  const hasScoped = descriptor.styles.some(s => s.scoped)
+
+  // Compile script section
+  let componentCode = 'const __component__ = {};'
+  let bindings
+  if (descriptor.scriptSetup || descriptor.script) {
+    const scriptResult = compileScript(descriptor, { id, genDefaultAs: '__component__' })
+    componentCode = esmToCjs(scriptResult.content)
+    bindings = scriptResult.bindings
+  }
+
+  // Compile template in SSR mode
+  const templateResult = compileTemplate({
+    source: descriptor.template ? descriptor.template.content : '<div></div>',
+    filename: filePath,
+    id,
+    scoped: hasScoped,
+    ssr: true,
+    compilerOptions: { bindingMetadata: bindings }
+  })
+  if (templateResult.errors.length > 0) {
+    throw new Error(`Template errors in ${path.basename(filePath)}: ${templateResult.errors.join(', ')}`)
+  }
+  const renderCode = esmToCjs(templateResult.code)
+
+  // Compile styles
+  let css = ''
+  for (const style of descriptor.styles) {
+    const result = await compileStyleAsync({
+      source: style.content,
+      filename: filePath,
+      id,
+      scoped: style.scoped || false
+    })
+    if (!result.errors.length) css += result.code + '\n'
+  }
+
+  const fullCode = `${componentCode}\n${renderCode}\n__component__.ssrRender = ssrRender;\nmodule.exports = __component__;`
+  const compiled = { code: fullCode, css }
+  compiledCache.set(filePath, compiled)
+  return compiled
+}
+
+// Scan source for .vue imports and pre-compile them recursively
+async function preCompileImports(filePath, visited = new Set()) {
+  if (visited.has(filePath) || !fs.existsSync(filePath)) return
+  visited.add(filePath)
+
+  const source = fs.readFileSync(filePath, 'utf-8')
+  // Match both relative (./foo.vue) and absolute (/path/to/foo.vue) imports
+  const importMatches = [...source.matchAll(/import\s+\w+\s+from\s*['"]([^'"]+\.vue)['"]/g)]
+
+  for (const match of importMatches) {
+    const importPath = match[1]
+    const importedPath = path.isAbsolute(importPath)
+      ? importPath
+      : path.resolve(path.dirname(filePath), importPath)
+    await preCompileImports(importedPath, visited)
+    await compileVueFile(importedPath)
+  }
+}
+
+// Compile and render a single job, injecting slotHtml at the template level
+async function renderJob(job) {
+  const { id, componentFile, props, slotHtml } = job
+
+  if (!componentFile || !fs.existsSync(componentFile)) {
+    return { id, html: `<!-- Vue component not found: ${path.basename(componentFile || 'unknown')} -->`, css: '' }
+  }
+
+  try {
+    // Pre-compile all transitively imported .vue files first
+    await preCompileImports(componentFile)
+
+    // Compile base form (for CSS and script)
+    const base = await compileVueFile(componentFile)
+
+    let finalCode = base.code
+
+    // If slot content provided, recompile template with slot injected
+    if (slotHtml) {
+      const source = fs.readFileSync(componentFile, 'utf-8')
+      const { descriptor } = parse(source, { filename: componentFile })
+      const idHash = crypto.createHash('md5').update(componentFile).digest('hex').slice(0, 8)
+      const hasScoped = descriptor.styles.some(s => s.scoped)
+
+      let scriptCode = 'const __component__ = {};'
+      let bindings
+      if (descriptor.scriptSetup || descriptor.script) {
+        const scriptResult = compileScript(descriptor, { id: idHash, genDefaultAs: '__component__' })
+        scriptCode = esmToCjs(scriptResult.content)
+        bindings = scriptResult.bindings
+      }
+
+      const templateSource = (descriptor.template ? descriptor.template.content : '<div></div>')
+        .replace(/<slot\s*\/>/g, slotHtml)
+        .replace(/<slot>\s*<\/slot>/g, slotHtml)
+
+      const templateResult = compileTemplate({
+        source: templateSource,
+        filename: componentFile,
+        id: idHash,
+        scoped: hasScoped,
+        ssr: true,
+        compilerOptions: { bindingMetadata: bindings }
+      })
+      const renderCode = esmToCjs(templateResult.code)
+      finalCode = `${scriptCode}\n${renderCode}\n__component__.ssrRender = ssrRender;\nmodule.exports = __component__;`
+    }
+
+    const component = executeModule(finalCode, componentFile)
+    const app = createSSRApp(component, props)
+    const html = await renderToString(app)
+
+    return { id, html, css: base.css || '' }
+  } catch (err) {
+    process.stderr.write(`Vue render error (${path.basename(componentFile)}): ${err.message}\n`)
+    return { id, html: `<!-- Vue component error: ${err.message} -->`, css: '' }
+  }
+}
+
+async function main() {
+  let input = ''
+  process.stdin.setEncoding('utf-8')
+  for await (const chunk of process.stdin) input += chunk
+
+  let jobs
+  try {
+    jobs = JSON.parse(input)
+  } catch (e) {
+    process.stderr.write(`Failed to parse input JSON: ${e.message}\n`)
+    process.exit(1)
+  }
+
+  const results = await Promise.all(jobs.map(renderJob))
+  process.stdout.write(JSON.stringify(results) + '\n')
+}
+
+main().catch(e => {
+  process.stderr.write(`Fatal error: ${e.message}\n`)
+  process.exit(1)
+})

data/lib/sakusei.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require 'date'
+require 'set'
+require 'fileutils'
+
+require_relative 'sakusei/version'
+require_relative 'sakusei/cli'
+require_relative 'sakusei/builder'
+require_relative 'sakusei/style_pack'
+require_relative 'sakusei/file_resolver'
+require_relative 'sakusei/erb_processor'
+require_relative 'sakusei/md_to_pdf_converter'
+require_relative 'sakusei/pdf_concat'
+require_relative 'sakusei/multi_file_builder'
+require_relative 'sakusei/style_preview'
+require_relative 'sakusei/vue_processor'
+
+module Sakusei
+  class Error < StandardError; end
+
+  # Main entry point for building PDFs
+  def self.build(source_file, options = {})
+    Builder.new(source_file, options).build
+  end
+end

data/lib/templates/base.css

@@ -0,0 +1,243 @@
+/* Sakusei Base Styles - Applied before style pack CSS */
+
+/* CSS Reset and Base Typography */
+* {
+  box-sizing: border-box;
+}
+
+html {
+  font-size: 100%;
+  -webkit-print-color-adjust: exact;
+  print-color-adjust: exact;
+}
+
+body {
+  font-family:
+    -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen, Ubuntu,
+    sans-serif;
+  font-size: 11pt;
+  line-height: 1.6;
+  color: #333;
+  margin: 0;
+  padding: 0;
+}
+
+/* Headings */
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
+  font-weight: 600;
+  line-height: 1.3;
+  margin-top: 1.5em;
+  margin-bottom: 0.5em;
+  color: #222;
+  page-break-after: avoid;
+}
+
+h1 {
+  font-size: 2em;
+}
+h2 {
+  font-size: 1.5em;
+}
+h3 {
+  font-size: 1.25em;
+}
+h4 {
+  font-size: 1.1em;
+}
+h5 {
+  font-size: 1em;
+}
+h6 {
+  font-size: 0.9em;
+}
+
+/* Paragraphs */
+p {
+  margin-top: 0;
+  margin-bottom: 1em;
+  orphans: 3;
+  widows: 3;
+}
+
+/* Links */
+a {
+  color: #0366d6;
+  text-decoration: none;
+}
+
+a:hover {
+  text-decoration: underline;
+}
+
+/* Code */
+code,
+kbd,
+pre,
+samp {
+  font-family: "SFMono-Regular", Consolas, "Liberation Mono", Menlo, monospace;
+}
+
+code {
+  background-color: rgba(175, 184, 193, 0.2);
+  padding: 0.2em 0.4em;
+  border-radius: 3px;
+  font-size: 0.9em;
+}
+
+pre {
+  background-color: #f6f8fa;
+  padding: 1em;
+  border-radius: 6px;
+  overflow-x: auto;
+  page-break-inside: avoid;
+}
+
+pre code {
+  background: none;
+  padding: 0;
+  font-size: 1em;
+}
+
+/* Blockquotes */
+blockquote {
+  border-left: 4px solid #ddd;
+  padding-left: 1em;
+  margin-left: 0;
+  margin-right: 0;
+  color: #666;
+  page-break-inside: avoid;
+}
+
+/* Lists */
+ul,
+ol {
+  padding-left: 2em;
+  margin-top: 0;
+  margin-bottom: 1em;
+}
+
+li {
+  margin-bottom: 0.25em;
+}
+
+li > ul,
+li > ol {
+  margin-top: 0.25em;
+  margin-bottom: 0.25em;
+}
+
+/* Tables */
+table {
+  border-collapse: collapse;
+  width: 100%;
+  margin-bottom: 1em;
+  page-break-inside: avoid;
+}
+
+th,
+td {
+  border: 1px solid #d0d7de;
+  padding: 0.5em;
+  text-align: left;
+}
+
+th {
+  background-color: #f6f8fa;
+  font-weight: 600;
+}
+
+tr {
+  page-break-inside: avoid;
+}
+
+/* Images */
+img {
+  max-width: 100%;
+  height: auto;
+  page-break-inside: avoid;
+}
+
+/* Horizontal rules */
+hr {
+  border: none;
+  border-top: 1px solid #ddd;
+  margin: 1.5em 0;
+}
+
+/* Page breaks */
+.page-break,
+.page-break-after {
+  page-break-after: always;
+}
+
+.page-break-before {
+  page-break-before: always;
+}
+
+/* Keep together - prevent page breaks inside these elements */
+.keep-together,
+figure,
+figcaption,
+dl,
+dt,
+dd,
+details,
+summary,
+.admonition,
+.callout,
+.note,
+.warning,
+.tip,
+.info,
+.card,
+.box,
+.math,
+.katex,
+.katex-display {
+  page-break-inside: avoid;
+}
+
+/* Additional protection for table elements */
+thead,
+tbody,
+tfoot {
+  page-break-inside: avoid;
+}
+
+/* Print-specific */
+@media print {
+  body {
+    font-size: 10pt;
+  }
+
+  h1,
+  h2,
+  h3,
+  h4,
+  h5,
+  h6 {
+    page-break-after: avoid;
+  }
+
+  tr,
+  img,
+  pre,
+  blockquote {
+    page-break-inside: avoid;
+  }
+
+  a {
+    color: #333;
+  }
+
+  a[href]:after {
+    content: " (" attr(href) ")";
+    font-size: 0.8em;
+    color: #666;
+  }
+}

data/lib/templates/default_style_pack/config.js

@@ -0,0 +1,36 @@
+module.exports = {
+  // PDF options
+  pdf_options: {
+    format: 'A4',
+    printBackground: true,
+    margin: {
+      top: '2cm',
+      right: '2cm',
+      bottom: '2cm',
+      left: '2cm'
+    },
+    displayHeaderFooter: true,
+    headerTemplate: `
+      <div style="font-size: 9px; width: 100%; text-align: center; color: #666;">
+        <span class="title"></span>
+      </div>
+    `,
+    footerTemplate: `
+      <div style="font-size: 9px; width: 100%; text-align: center; color: #666;">
+        Page <span class="pageNumber"></span> of <span class="totalPages"></span>
+      </div>
+    `
+  },
+
+  // Markdown-it options
+  md_options: {
+    html: true,
+    linkify: true,
+    typographer: true
+  },
+
+  // Launch options for Puppeteer
+  launch_options: {
+    headless: true
+  }
+};

data/lib/templates/default_style_pack/footer.html

@@ -0,0 +1,5 @@
+<!-- Custom footer template - used when configured in config.js -->
+<!-- Available classes: date, title, url, pageNumber, totalPages -->
+<div style="font-size: 9px; width: 100%; text-align: center; color: #666;">
+  Page <span class="pageNumber"></span> of <span class="totalPages"></span>
+</div>

data/lib/templates/default_style_pack/header.html

@@ -0,0 +1,5 @@
+<!-- Custom header template - used when configured in config.js -->
+<!-- Available classes: date, title, url, pageNumber, totalPages -->
+<div style="font-size: 9px; width: 100%; text-align: center; color: #666;">
+  <span class="title"></span>
+</div>

data/lib/templates/default_style_pack/style.css

@@ -0,0 +1,22 @@
+/* Sakusei Default Style Pack - Override styles applied on top of base */
+
+/* Heading enhancements */
+h1 {
+  border-bottom: 2px solid #eee;
+  padding-bottom: 0.3em;
+}
+
+h2 {
+  border-bottom: 1px solid #eee;
+  padding-bottom: 0.3em;
+}
+
+/* Code block styling */
+code {
+  background-color: #f6f8fa;
+}
+
+/* Link hover enhancement */
+a:hover {
+  text-decoration: underline;
+}

data/sakusei.gemspec

@@ -0,0 +1,29 @@
+require_relative 'lib/sakusei/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'sakusei'
+  spec.version       = Sakusei::VERSION
+  spec.authors       = ['Keith Rowell']
+  spec.email         = ['keith@example.com']
+
+  spec.summary       = 'A PDF building system using Markdown, ERB, and CSS templating'
+  spec.description   = 'Sakusei is a build system for creating PDF documents from Markdown sources with support for ERB templates, VueJS components, and hierarchical styling.'
+  spec.homepage      = 'https://github.com/keithrowell/sakusei'
+  spec.license       = 'MIT'
+
+  spec.required_ruby_version = '>= 3.0.0'
+
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{\A(?:test|spec|features)/}) }
+  end
+  spec.bindir        = 'bin'
+  spec.executables   = ['sakusei']
+  spec.require_paths = ['lib']
+
+  # Dependencies
+  spec.add_dependency 'thor', '~> 1.2'
+  spec.add_dependency 'erb', '~> 4.0'
+
+  spec.add_development_dependency 'minitest', '~> 5.0'
+  spec.add_development_dependency 'rubocop', '~> 1.0'
+end