@qazuor/claude-code-config 0.1.0

package/templates/skills/utils/pdf-creator-editor.md

@@ -0,0 +1,342 @@
+---
+name: pdf-generator
+category: utils
+description: Generate professional PDF documents from data using templates and styling
+usage: When creating invoices, reports, confirmations, contracts, or converting documentation to PDF
+input: Content data, template requirements, styling specifications
+output: Generated PDF files with proper formatting and metadata
+config_required:
+  - pdf_library: "PDF generation library (PDFKit, Puppeteer, jsPDF)"
+  - default_page_size: "Default page size"
+  - margin_size: "Default margins"
+  - font_family: "Default font family"
+  - brand_colors: "Brand color palette"
+---
+
+# PDF Generator
+
+## ⚙️ Configuration
+
+| Setting | Description | Example |
+|---------|-------------|---------|
+| `pdf_library` | Generation library | `pdfkit`, `puppeteer`, `jspdf` |
+| `page_size` | Default page size | `A4`, `LETTER` |
+| `margin` | Default margins | `50` (points), `20mm` |
+| `orientation` | Page orientation | `portrait`, `landscape` |
+| `font_family` | Default font | `Helvetica`, `Arial` |
+| `brand_primary` | Primary color | `#3B82F6` |
+| `brand_secondary` | Secondary color | `#10B981` |
+
+## Purpose
+
+Generate professional PDF documents for invoices, reports, confirmations, and contracts with proper formatting and styling.
+
+## Capabilities
+
+- Generate invoices with calculations
+- Create booking confirmations
+- Produce business reports
+- Convert HTML to PDF
+- Add headers/footers
+- Embed images and logos
+- Apply consistent styling
+
+## Library Selection
+
+| Library | Use Case | Pros | Cons |
+|---------|----------|------|------|
+| **PDFKit** | Programmatic PDFs | Simple API, good control | No HTML/CSS |
+| **Puppeteer** | HTML/CSS layouts | Full CSS support | Heavier, needs Chrome |
+| **jsPDF** | Client-side | Browser-based | Limited features |
+| **React-PDF** | React apps | Component-based | Learning curve |
+
+## Setup
+
+### PDFKit
+
+```typescript
+import PDFDocument from 'pdfkit';
+
+interface PDFConfig {
+  size?: 'A4' | 'LETTER';
+  margin?: number;
+  layout?: 'portrait' | 'landscape';
+}
+
+function createPDF(config: PDFConfig = {}) {
+  return new PDFDocument({
+    size: config.size || 'A4',
+    margin: config.margin || 50,
+    layout: config.layout || 'portrait',
+  });
+}
+```
+
+### Puppeteer
+
+```typescript
+import puppeteer from 'puppeteer';
+
+async function generatePDFFromHTML(
+  html: string,
+  options = {}
+): Promise<Buffer> {
+  const browser = await puppeteer.launch({ headless: true });
+  const page = await browser.newPage();
+  await page.setContent(html, { waitUntil: 'networkidle0' });
+
+  const pdf = await page.pdf({
+    format: 'A4',
+    margin: { top: '20mm', right: '20mm', bottom: '20mm', left: '20mm' },
+    printBackground: true,
+    ...options
+  });
+
+  await browser.close();
+  return pdf;
+}
+```
+
+## Invoice Template
+
+```typescript
+interface InvoiceData {
+  invoiceNumber: string;
+  date: string;
+  from: { name: string; address: string; email: string };
+  to: { name: string; address: string; email: string };
+  items: Array<{
+    description: string;
+    quantity: number;
+    price: number;
+    total: number;
+  }>;
+  subtotal: number;
+  tax: number;
+  total: number;
+}
+
+function generateInvoice(data: InvoiceData): Promise<Buffer> {
+  return new Promise((resolve, reject) => {
+    const doc = new PDFDocument({ size: 'A4', margin: 50 });
+    const chunks: Buffer[] = [];
+
+    doc.on('data', chunk => chunks.push(chunk));
+    doc.on('end', () => resolve(Buffer.concat(chunks)));
+
+    // Header
+    doc.fontSize(20).text('INVOICE', 50, 50);
+    doc.fontSize(10)
+       .text(`Invoice #: ${data.invoiceNumber}`, 50, 80)
+       .text(`Date: ${data.date}`, 50, 95);
+
+    // From/To sections
+    doc.fontSize(12).text('From:', 50, 140);
+    doc.fontSize(10).text(data.from.name, 50, 160);
+
+    doc.fontSize(12).text('To:', 300, 140);
+    doc.fontSize(10).text(data.to.name, 300, 160);
+
+    // Items table
+    let y = 250;
+    data.items.forEach(item => {
+      doc.text(item.description, 50, y);
+      doc.text(item.quantity.toString(), 300, y);
+      doc.text(`$${item.total.toFixed(2)}`, 450, y);
+      y += 25;
+    });
+
+    // Totals
+    y += 20;
+    doc.text('Total:', 370, y);
+    doc.text(`$${data.total.toFixed(2)}`, 450, y);
+
+    doc.end();
+  });
+}
+```
+
+## HTML Template (Puppeteer)
+
+```html
+<!DOCTYPE html>
+<html>
+<head>
+  <style>
+    body {
+      font-family: Arial, sans-serif;
+      padding: 40px;
+    }
+    .header {
+      background: #3B82F6;
+      color: white;
+      padding: 30px;
+      text-align: center;
+    }
+    .section {
+      margin: 30px 0;
+    }
+    table {
+      width: 100%;
+      border-collapse: collapse;
+    }
+    th {
+      background: #3B82F6;
+      color: white;
+      padding: 12px;
+    }
+    td {
+      padding: 12px;
+      border-bottom: 1px solid #E5E7EB;
+    }
+    .total {
+      font-size: 24px;
+      color: #3B82F6;
+      font-weight: bold;
+    }
+  </style>
+</head>
+<body>
+  <div class="header">
+    <h1>INVOICE</h1>
+    <p>Invoice #{{invoiceNumber}}</p>
+  </div>
+
+  <div class="section">
+    <h2>Bill To</h2>
+    <p>{{customer.name}}</p>
+    <p>{{customer.address}}</p>
+  </div>
+
+  <table>
+    <thead>
+      <tr>
+        <th>Description</th>
+        <th>Quantity</th>
+        <th>Price</th>
+        <th>Total</th>
+      </tr>
+    </thead>
+    <tbody>
+      {{#each items}}
+      <tr>
+        <td>{{description}}</td>
+        <td>{{quantity}}</td>
+        <td>${{price}}</td>
+        <td>${{total}}</td>
+      </tr>
+      {{/each}}
+    </tbody>
+  </table>
+
+  <div class="total">
+    Total: ${{total}}
+  </div>
+</body>
+</html>
+```
+
+## Styling Best Practices
+
+| Element | Recommendation |
+|---------|----------------|
+| **Fonts** | Use web-safe fonts or embed custom |
+| **Images** | Optimize before embedding |
+| **Colors** | Use brand colors consistently |
+| **Layout** | Test print layout before finalizing |
+| **Margins** | Standard: 20mm all sides |
+| **Page breaks** | Set explicitly for long content |
+| **Headers/Footers** | Include page numbers |
+
+## Common Patterns
+
+### Confirmation Document
+
+```typescript
+interface Confirmation {
+  id: string;
+  code: string;
+  customerName: string;
+  details: Record<string, string>;
+  date: string;
+}
+
+async function generateConfirmation(data: Confirmation): Promise<Buffer> {
+  const html = `
+    <div class="header">
+      <h1>Confirmation</h1>
+      <div class="code">${data.code}</div>
+    </div>
+    <div class="details">
+      <p><strong>Name:</strong> ${data.customerName}</p>
+      <p><strong>Date:</strong> ${data.date}</p>
+      ${Object.entries(data.details)
+        .map(([key, value]) => `<p><strong>${key}:</strong> ${value}</p>`)
+        .join('')}
+    </div>
+  `;
+
+  return generatePDFFromHTML(html);
+}
+```
+
+### Report with Charts
+
+```typescript
+async function generateReport(data: ReportData): Promise<Buffer> {
+  const html = `
+    <h1>Monthly Report</h1>
+    <div class="metrics">
+      <div class="metric">
+        <div class="value">${data.totalSales}</div>
+        <div class="label">Total Sales</div>
+      </div>
+    </div>
+    <table>
+      <thead><tr><th>Item</th><th>Value</th></tr></thead>
+      <tbody>
+        ${data.items.map(item => `
+          <tr><td>${item.name}</td><td>${item.value}</td></tr>
+        `).join('')}
+      </tbody>
+    </table>
+  `;
+
+  return generatePDFFromHTML(html);
+}
+```
+
+## Metadata
+
+```typescript
+doc.info = {
+  Title: 'Invoice #12345',
+  Author: 'Company Name',
+  Subject: 'Invoice',
+  Keywords: 'invoice, billing',
+  CreationDate: new Date(),
+};
+```
+
+## Best Practices
+
+| Practice | Description |
+|----------|-------------|
+| **Templates** | Reuse templates for consistency |
+| **Validation** | Test with various data scenarios |
+| **Compression** | Compress for web delivery |
+| **Metadata** | Set title, author, subject |
+| **Accessibility** | Include proper structure tags |
+| **Testing** | Test on multiple PDF viewers |
+| **File Size** | Optimize images and fonts |
+
+## Checklist
+
+- [ ] Library selected appropriately
+- [ ] Template created and tested
+- [ ] Styling matches brand guidelines
+- [ ] All data rendered correctly
+- [ ] Metadata configured
+- [ ] File size optimized
+- [ ] Tested in PDF viewers
+- [ ] Responsive to data variations

package/templates/tools/format-markdown.sh

@@ -0,0 +1,185 @@
+#!/bin/bash
+
+# Markdown Formatter Script - Final working version
+# Fixes markdown formatting issues using reliable shell commands
+
+set -euo pipefail
+
+# Colors for output
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+NC='\033[0m' # No Color
+
+echo -e "${GREEN}🔧 Markdown Formatter v1.0${NC}"
+echo -e "${GREEN}================================${NC}"
+
+# Function to show usage
+show_usage() {
+    echo "Usage: $0 [options] [file_or_directory]"
+    echo ""
+    echo "Options:"
+    echo "  -h, --help          Show this help message"
+    echo "  -v, --validate-only Validate only, don't fix"
+    echo "  -r, --rules RULES   Comma-separated list of rules (e.g., MD040,MD031)"
+    echo "  -q, --quiet         Quiet mode"
+    echo ""
+    echo "Examples:"
+    echo "  $0                                    # Fix all .md files in .claude/"
+    echo "  $0 file.md                          # Fix specific file"
+    echo "  $0 --validate-only                  # Check without fixing"
+    echo "  $0 --rules MD040,MD031,MD022        # Apply specific rules only"
+}
+
+# Default options
+VALIDATE_ONLY=false
+QUIET=false
+RULES=""
+TARGET_PATH=""
+
+# Parse command line arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        -h|--help)
+            show_usage
+            exit 0
+            ;;
+        -v|--validate-only)
+            VALIDATE_ONLY=true
+            shift
+            ;;
+        -r|--rules)
+            RULES="$2"
+            shift 2
+            ;;
+        -q|--quiet)
+            QUIET=true
+            shift
+            ;;
+        -*)
+            echo -e "${RED}Error: Unknown option $1${NC}" >&2
+            show_usage >&2
+            exit 1
+            ;;
+        *)
+            TARGET_PATH="$1"
+            shift
+            ;;
+    esac
+done
+
+# Function to log messages
+log() {
+    if [[ "$QUIET" != "true" ]]; then
+        echo -e "$1"
+    fi
+}
+
+# Function to apply markdown fixes to a file
+fix_markdown_file() {
+    local file="$1"
+    local basename_file=$(basename "$file")
+    
+    log "  📝 Processing: $basename_file"
+    
+    if [[ "$VALIDATE_ONLY" == "true" ]]; then
+        # TODO: Add validation logic here
+        log "    ℹ️  Validation mode - no changes made"
+        return 0
+    fi
+    
+    # Create backup
+    cp "$file" "${file}.bak"
+    
+    # Apply fixes using sed
+    local temp_file="${file}.tmp"
+    
+    # MD040: Add language to bare code fences
+    sed 's/^```$/```text/g' "$file" > "$temp_file"
+    
+    # MD026: Remove trailing punctuation from headings
+    sed 's/^\(#{1,6}[[:space:]].*\)[.!?:]\+$/\1/g' "$temp_file" > "${temp_file}.2"
+    
+    # MD009: Remove trailing spaces
+    sed 's/[[:space:]]\+$//g' "${temp_file}.2" > "${temp_file}.3"
+    
+    # MD012: Remove multiple consecutive blank lines
+    sed '/^$/N;/^\n$/d' "${temp_file}.3" > "${temp_file}.4"
+    
+    # Move final result back
+    mv "${temp_file}.4" "$file"
+    
+    # Clean up temporary files
+    rm -f "$temp_file" "${temp_file}.2" "${temp_file}.3" "${file}.bak"
+    
+    log "    ✅ Fixed"
+}
+
+# Function to find markdown files
+find_markdown_files() {
+    local search_path="$1"
+    
+    if [[ -f "$search_path" ]]; then
+        echo "$search_path"
+    elif [[ -d "$search_path" ]]; then
+        find "$search_path" -name "*.md" -type f
+    else
+        echo -e "${RED}Error: Path not found: $search_path${NC}" >&2
+        exit 1
+    fi
+}
+
+# Main execution
+main() {
+    # Determine target path
+    if [[ -z "$TARGET_PATH" ]]; then
+        TARGET_PATH=".claude"
+    fi
+    
+    log "${GREEN}📋 Finding markdown files...${NC}"
+    
+    # Get list of files to process
+    local files
+    files=$(find_markdown_files "$TARGET_PATH")
+    
+    if [[ -z "$files" ]]; then
+        log "${YELLOW}⚠️  No markdown files found${NC}"
+        exit 0
+    fi
+    
+    local file_count
+    file_count=$(echo "$files" | wc -l)
+    
+    log "${GREEN}📊 Found $file_count markdown file(s)${NC}"
+    log ""
+    
+    # Process each file
+    local processed=0
+    local errors=0
+    
+    while IFS= read -r file; do
+        if [[ -f "$file" ]]; then
+            if fix_markdown_file "$file"; then
+                ((processed++))
+            else
+                log "    ${RED}❌ Error processing $file${NC}"
+                ((errors++))
+            fi
+        fi
+    done <<< "$files"
+    
+    log ""
+    log "${GREEN}📊 Summary:${NC}"
+    log "   Processed: $processed files"
+    if [[ $errors -gt 0 ]]; then
+        log "   ${RED}Errors: $errors files${NC}"
+        exit 1
+    else
+        log "   ${GREEN}✅ All files processed successfully${NC}"
+    fi
+}
+
+# Run main function
+main
+
+echo -e "${GREEN}🎉 Markdown formatting complete!${NC}"