portapack 0.2.1

package/.eslintrc.json

@@ -0,0 +1,9 @@
+{
+    "singleQuote": true,
+    "semi": true,
+    "tabWidth": 2,
+    "printWidth": 100,
+    "trailingComma": "es5",
+    "arrowParens": "avoid",
+    "endOfLine": "lf"
+  }

package/.github/workflows/ci.yml

@@ -0,0 +1,73 @@
+name: CI
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [18.x, 20.x]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+
+      - run: npm ci
+      # - run: npm run test:ci
+      # - run: npm run lint
+      # - run: npm run format:check
+      - run: npm run build # for now we keep it simple to release
+
+# coverage:
+#   needs: build
+#   runs-on: ubuntu-latest
+#
+#   steps:
+#     - uses: actions/checkout@v4
+#     - uses: actions/setup-node@v4
+#       with:
+#         node-version: 20.x
+#         cache: 'npm'
+#
+#     - run: npm ci
+#     - run: npm run coveralls
+#
+#     - name: Coveralls
+#       uses: coverallsapp/github-action@v2
+
+  release:
+    # needs: [build, coverage]
+    needs: [build]
+    if: github.event_name == 'push' && github.ref == 'refs/heads/master'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      issues: write
+      pull-requests: write
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20.x
+          cache: 'npm'
+
+      - run: npm ci
+      - run: npm run build
+      - run: npx semantic-release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GH_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.github/workflows/deploy-pages.yml

@@ -0,0 +1,56 @@
+name: Deploy to GitHub Pages
+
+on:
+  # Runs on pushes targeting the default branch
+  push:
+    branches: [master]
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment
+concurrency:
+  group: "pages"
+  cancel-in-progress: true
+
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build documentation
+        run: |
+          npm run docs:api
+          npm run docs:build
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: 'docs/.vitepress/dist'
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

package/.prettierrc

@@ -0,0 +1,9 @@
+{
+    "singleQuote": true,
+    "semi": true,
+    "tabWidth": 2,
+    "printWidth": 100,
+    "trailingComma": "es5",
+    "arrowParens": "avoid",
+    "endOfLine": "lf"
+  }

package/.releaserc.js

@@ -0,0 +1,29 @@
+module.exports = {
+    branches: ['main'],
+    plugins: [
+      '@semantic-release/commit-analyzer',
+      '@semantic-release/release-notes-generator',
+      '@semantic-release/npm',
+      [
+        '@semantic-release/github',
+        {
+          assets: [
+            { path: 'dist/**', label: 'Distribution' },
+          ],
+        },
+      ],
+      [
+        '@semantic-release/changelog',
+        {
+          changelogFile: 'CHANGELOG.md',
+        },
+      ],
+      [
+        '@semantic-release/git',
+        {
+          assets: ['package.json', 'CHANGELOG.md'],
+          message: 'chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}',
+        },
+      ],
+    ],
+  };

package/CHANGELOG.md

@@ -0,0 +1,21 @@
+## [0.2.1](https://github.com/manicinc/portapack/compare/v0.2.0...v0.2.1) (2025-04-11)
+
+
+### Bug Fixes
+
+* rmv prepublishOnly for debug release ([6469768](https://github.com/manicinc/portapack/commit/6469768d6c14bd2ab243acfd5358115b7771f612))
+
+# [0.2.0](https://github.com/manicinc/portapack/compare/v0.1.0...v0.2.0) (2025-04-11)
+
+
+### Features
+
+* cleanup rerelease ([f8e599b](https://github.com/manicinc/portapack/commit/f8e599b596b18c62941e5bd46740283b013262b1))
+
+# [1.2.0](https://github.com/manicinc/portapack/compare/v1.1.0...v1.2.0) (2025-04-11)
+
+
+### Features
+
+* cleanup rerelease ([f8e599b](https://github.com/manicinc/portapack/commit/f8e599b596b18c62941e5bd46740283b013262b1))
+* fix right version; trigger first release ([96147fc](https://github.com/manicinc/portapack/commit/96147fc61f5dc8e8f39e9d4343e22c79b25f0139))

package/README.md

@@ -0,0 +1,288 @@
+# 📦 PortaPack
+
+<div align="center">
+    <img src="./docs/portapack-transparent.png" alt="PortaPack Logo" style="max-width: 50%; height: auto; margin-bottom: 20px;">
+    
+[![npm version](https://img.shields.io/npm/v/portapack.svg?style=for-the-badge&logo=npm&color=CB3837)](https://www.npmjs.com/package/portapack)
+[![Build Status](https://img.shields.io/github/actions/workflow/status/manicinc/portapack/ci.yml?branch=master&style=for-the-badge&logo=github)](https://github.com/manicinc/portapack/actions)
+[![Coverage Status](https://img.shields.io/coveralls/github/manicinc/portapack?style=for-the-badge&logo=codecov)](https://coveralls.io/github/manicinc/portapack)
+</div>
+
+## 🌟 Introduction
+
+**PortaPack** is a powerful, lightning-fast HTML bundling tool that transforms websites into compact, portable files. Pack entire web experiences into a single, self-contained HTML document with minimal effort.
+
+See our [roadmap]() (coming soon!)
+
+## 📚 Documentation
+
+- [📖 Getting Started](https://manicinc.github.io/portapack/getting-started)
+- [⚙️ CLI Reference](https://manicinc.github.io/portapack/cli)
+- [🛠 Configuration Guide](https://manicinc.github.io/portapack/configuration)
+- [💻 API Reference](https://manicinc.github.io/portapack/api/)
+- [🤝 Contributing Guidelines](https://manicinc.github.io/portapack/contributing)
+
+## ✨ Killer Features
+
+| Feature | Description |
+|---------|-------------|
+| 🧩 **Recursive Packing** | Bundle entire websites into a single, portable file |
+| 🎯 **Total Asset Embedding** | Inline CSS, JS, images, and fonts seamlessly |
+| 🧼 **Smart Minification** | Optimize HTML, CSS, and JS for minimal file size |
+| 🌐 **Universal Compatibility** | Works flawlessly with local and remote sites |
+| 🚀 **Blazing Fast** | Lightweight, efficient processing for quick results |
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+# Global install
+npm install -g portapack
+
+# Project dependency
+npm install --save-dev portapack
+```
+
+### Basic Usage
+
+```bash
+# Bundle a local HTML file
+portapack ./index.html -o portable.html
+
+# Crawl a remote website
+portapack https://example.com --recursive -o site.html
+```
+
+## 💻 CLI Reference
+
+### Command Syntax
+
+```bash
+portapack [options] [input]
+```
+
+### Core Options
+
+| Option | Description |
+|--------|-------------|
+| `-o, --output <file>` | Output file path |
+| `-m, --minify` | Enable all minification (HTML, CSS, JS) |
+| `--no-minify` | Disable all minification |
+| `-e, --embed-assets` | Embed assets as data URIs (default) |
+| `--no-embed-assets` | Keep asset links relative/absolute |
+| `-b, --base-url <url>` | Base URL for resolving relative links |
+| `-d, --dry-run` | Run without writing output file |
+| `-v, --verbose` | Enable verbose (debug) logging |
+
+### Minification Options
+
+| Option | Description |
+|--------|-------------|
+| `--no-minify-html` | Disable HTML minification |
+| `--no-minify-css` | Disable CSS minification |
+| `--no-minify-js` | Disable JavaScript minification |
+
+### Recursive Crawling
+
+| Option | Description |
+|--------|-------------|
+| `-r, --recursive [depth]` | Recursively crawl site (default depth: 1) |
+| `--max-depth <n>` | Set maximum depth for recursive crawl |
+
+### Logging
+
+| Option | Description |
+|--------|-------------|
+| `--log-level <level>` | Set logging level: debug, info, warn, error, silent, none |
+
+## 📋 CLI Examples
+
+### Basic Examples
+
+```bash
+# Bundle a local HTML file with default settings
+portapack ./index.html
+
+# Bundle a remote page
+portapack https://example.com -o example.html
+
+# Bundle with verbose logging
+portapack ./index.html -v
+```
+
+### Advanced Options
+
+```bash
+# Disable all minification
+portapack ./index.html --no-minify
+
+# Disable only CSS minification
+portapack ./index.html --no-minify-css
+
+# Customize base URL for asset resolution
+portapack ./index.html --base-url https://cdn.example.com
+
+# Keep external links instead of embedding assets
+portapack ./index.html --no-embed-assets
+```
+
+### Recursive Website Bundling
+
+```bash
+# Recursively bundle a website (default depth: 1)
+portapack https://example.com --recursive
+
+# Set custom crawl depth (3 levels)
+portapack https://example.com --recursive 3
+
+# Alternative depth syntax
+portapack https://example.com --max-depth 3
+
+# Recursive bundle with all options
+portapack https://example.com \
+  --recursive 2 \
+  --base-url https://example.com \
+  --no-minify-js \
+  --log-level debug \
+  -o example-site.html
+```
+
+### Customized Workflow Examples
+
+```bash
+# Development workflow: no minification + verbose logs
+portapack ./dev/index.html --no-minify -v -o ./dev/bundle.html
+
+# Production workflow: full optimization
+portapack ./src/index.html -o ./dist/index.html
+
+# Test run without writing output
+portapack ./index.html --dry-run -v
+
+# Custom logging level
+portapack ./index.html --log-level warn
+```
+
+## 🛠 Node.js API
+
+PortaPack provides a flexible JavaScript/TypeScript API that can be used in your own projects.
+
+### Main Functions
+
+The library exports these primary functions:
+
+| Function | Description |
+|----------|-------------|
+| `generatePortableHTML()` | Bundle a single HTML file or URL with its assets |
+| `generateRecursivePortableHTML()` | Recursively crawl and bundle a website |
+| `fetchAndPackWebPage()` | Fetch and pack a single web page |
+| `bundleMultiPageHTML()` | Bundle multiple HTML pages into a single file |
+
+### Basic API Usage
+
+```typescript
+import { generatePortableHTML } from 'portapack';
+
+// Simple usage with local file
+const result = await generatePortableHTML('./index.html');
+console.log(`Generated HTML: ${result.html.length} bytes`);
+console.log(`Build time: ${result.metadata.buildTimeMs}ms`);
+
+// Simple usage with remote URL
+const remoteResult = await generatePortableHTML('https://example.com');
+```
+
+### Advanced API Usage
+
+```typescript
+import { 
+  generatePortableHTML, 
+  generateRecursivePortableHTML,
+  LogLevel
+} from 'portapack';
+
+// With full options
+const result = await generatePortableHTML('./index.html', {
+  embedAssets: true,      // Embed assets as data URIs
+  minifyHtml: true,       // Minify HTML
+  minifyCss: true,        // Minify CSS
+  minifyJs: true,         // Minify JavaScript
+  baseUrl: './src',       // Base URL for resolving assets
+  logLevel: LogLevel.INFO // Set logging level
+});
+
+// Save the HTML to a file
+import fs from 'fs';
+fs.writeFileSync('output.html', result.html, 'utf-8');
+
+// Access build metadata
+console.log(`Build Stats:
+  - Input: ${result.metadata.input}
+  - Output Size: ${result.metadata.outputSize} bytes
+  - Assets: ${result.metadata.assetCount}
+  - Build Time: ${result.metadata.buildTimeMs}ms
+`);
+```
+
+### Recursive Website Crawling
+
+```typescript
+import { generateRecursivePortableHTML } from 'portapack';
+
+// Crawl a website with depth 2
+const result = await generateRecursivePortableHTML(
+  'https://example.com',
+  2,
+  { logLevel: LogLevel.DEBUG }
+);
+
+console.log(`Bundled ${result.metadata.pagesBundled} pages`);
+```
+
+### Multi-page Bundling
+
+```typescript
+import { bundleMultiPageHTML } from 'portapack';
+
+// Define multiple pages to bundle
+const pages = [
+  { url: '/home', html: '<h1>Home</h1>' },
+  { url: '/about', html: '<h1>About</h1>' },
+  { url: '/contact', html: '<h1>Contact</h1>' }
+];
+
+// Bundle into a single HTML with client-side router
+const html = bundleMultiPageHTML(pages);
+```
+
+## 🤝 Contribute & Support
+
+[![GitHub Sponsors](https://img.shields.io/badge/Sponsor-Manic_Agency-red?style=for-the-badge&logo=github&logoColor=white)](https://github.com/sponsors/manicinc)
+[![Discord](https://img.shields.io/discord/your-discord-invite?style=for-the-badge&logo=discord&logoColor=white&label=Join%20Community&color=5865F2)](https://discord.gg/DzNgXdYm)
+
+1. Fork the repo
+2. Create a feature branch
+3. Commit with `npm run commit`
+4. Push & open a PR
+
+## 📊 Project Health
+
+<!-- | Aspect | Status |
+|--------|--------|
+| **Tests** | [![Coverage](https://img.shields.io/codecov/c/github/manicinc/portapack?style=flat-square)](https://codecov.io/gh/manicinc/portapack) |
+| **Code Quality** | [![Maintainability](https://img.shields.io/codeclimate/maintainability/manicinc/portapack?style=flat-square)](https://codeclimate.com/github/manicinc/portapack) |
+| **Dependencies** | [![Dependencies](https://img.shields.io/librariesio/github/manicinc/portapack?style=flat-square)](https://libraries.io/github/manicinc/portapack) | -->
+
+## 🌍 Connect
+
+[![Twitter](https://img.shields.io/twitter/follow/manicagency?style=social)](https://x.com/manicagency)
+[![LinkedIn](https://img.shields.io/badge/LinkedIn-Manic_Agency-0A66C2?style=flat-square&logo=linkedin)](https://www.linkedin.com/company/manic-agency-llc/)
+
+## 📄 License
+
+**MIT** — Built by [Manic Agency](https://manicagency.com)
+
+<div align="center">
+    <sub>Open Source Empowering Designers and Developers 🖥️</sub>
+</div>

package/commitlint.config.js

@@ -0,0 +1,36 @@
+module.exports = {
+    extends: ['@commitlint/config-conventional'],
+    rules: {
+      'body-leading-blank': [1, 'always'],
+      'body-max-line-length': [2, 'always', 100],
+      'footer-leading-blank': [1, 'always'],
+      'footer-max-line-length': [2, 'always', 100],
+      'header-max-length': [2, 'always', 100],
+      'subject-case': [
+        2,
+        'never',
+        ['sentence-case', 'start-case', 'pascal-case', 'upper-case'],
+      ],
+      'subject-empty': [2, 'never'],
+      'subject-full-stop': [2, 'never', '.'],
+      'type-case': [2, 'always', 'lower-case'],
+      'type-empty': [2, 'never'],
+      'type-enum': [
+        2,
+        'always',
+        [
+          'build',
+          'chore',
+          'ci',
+          'docs',
+          'feat',
+          'fix',
+          'perf',
+          'refactor',
+          'revert',
+          'style',
+          'test',
+        ],
+      ],
+    },
+  };