zig-pug 0.3.0 → 0.3.1

package/README.md

@@ -13,6 +13,7 @@ High-performance Pug template engine powered by Zig and mujs.
 - ✅ **Documentation comments** - `//!` for file metadata (ignored by parser)
 - ✅ **Conditionals** - if/else/unless
 - ✅ **Mixins** - Reusable components
+- ✅ **Dual package** - CommonJS (`require`) and ES Modules (`import`)
 - ✅ **Bun.js compatible** - 2-5x faster than Node.js
 - ⚡ **Native performance** - Written in Zig, compiled to native code
 - 🔋 **Zero dependencies** - Only Zig and embedded mujs
@@ -35,6 +36,7 @@ The addon will compile automatically during installation.
 
 ### Simple API
 
+**CommonJS (Node.js):**
 ```javascript
 const zigpug = require('zig-pug');
 
@@ -43,8 +45,18 @@ console.log(html);
 // <p>Hello World!</p>
 ```
 
+**ES Modules (Node.js, Bun):**
+```javascript
+import { compile } from 'zig-pug';
+
+const html = compile('p Hello #{name}!', { name: 'World' });
+console.log(html);
+// <p>Hello World!</p>
+```
+
 ### Object-Oriented API
 
+**CommonJS (Node.js):**
 ```javascript
 const { PugCompiler } = require('zig-pug');
 
@@ -59,6 +71,21 @@ console.log(html);
 // <h1>My Page</h1>
 ```
 
+**ES Modules (Node.js, Bun):**
+```javascript
+import { PugCompiler } from 'zig-pug';
+
+const compiler = new PugCompiler();
+compiler
+    .set('title', 'My Page')
+    .set('version', 1.5)
+    .setBool('isDev', false);
+
+const html = compiler.compile('h1 #{title}');
+console.log(html);
+// <h1>My Page</h1>
+```
+
 ### Express Integration
 
 ```javascript

package/index.mjs

@@ -0,0 +1,192 @@
+/**
+ * zig-pug - Pug template engine for Node.js (ES Module version)
+ * Powered by Zig and mujs
+ */
+
+import { createRequire } from 'module';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+import { readFileSync } from 'fs';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const require = createRequire(import.meta.url);
+
+const binding = require('./build/Release/zigpug.node');
+
+/**
+ * PugCompiler class - High-level API for compiling Pug templates
+ */
+export class PugCompiler {
+    constructor() {
+        this.context = binding.createContext();
+        if (!this.context) {
+            throw new Error('Failed to create zig-pug context');
+        }
+    }
+
+    /**
+     * Set a string variable in the template context
+     * @param {string} key - Variable name
+     * @param {string} value - String value
+     * @returns {PugCompiler} - Returns this for chaining
+     */
+    setString(key, value) {
+        if (typeof key !== 'string') {
+            throw new TypeError('Key must be a string');
+        }
+        if (typeof value !== 'string') {
+            throw new TypeError('Value must be a string');
+        }
+
+        const success = binding.setString(this.context, key, value);
+        if (!success) {
+            throw new Error(`Failed to set string variable: ${key}`);
+        }
+        return this;
+    }
+
+    /**
+     * Set a number variable in the template context
+     * @param {string} key - Variable name
+     * @param {number} value - Number value
+     * @returns {PugCompiler} - Returns this for chaining
+     */
+    setNumber(key, value) {
+        if (typeof key !== 'string') {
+            throw new TypeError('Key must be a string');
+        }
+        if (typeof value !== 'number') {
+            throw new TypeError('Value must be a number');
+        }
+
+        const success = binding.setNumber(this.context, key, Math.floor(value));
+        if (!success) {
+            throw new Error(`Failed to set number variable: ${key}`);
+        }
+        return this;
+    }
+
+    /**
+     * Set a boolean variable in the template context
+     * @param {string} key - Variable name
+     * @param {boolean} value - Boolean value
+     * @returns {PugCompiler} - Returns this for chaining
+     */
+    setBool(key, value) {
+        if (typeof key !== 'string') {
+            throw new TypeError('Key must be a string');
+        }
+        if (typeof value !== 'boolean') {
+            throw new TypeError('Value must be a boolean');
+        }
+
+        const success = binding.setBool(this.context, key, value);
+        if (!success) {
+            throw new Error(`Failed to set boolean variable: ${key}`);
+        }
+        return this;
+    }
+
+    /**
+     * Set a variable (automatically detects type)
+     * @param {string} key - Variable name
+     * @param {string|number|boolean} value - Value of any supported type
+     * @returns {PugCompiler} - Returns this for chaining
+     */
+    set(key, value) {
+        if (typeof value === 'string') {
+            return this.setString(key, value);
+        } else if (typeof value === 'number') {
+            return this.setNumber(key, value);
+        } else if (typeof value === 'boolean') {
+            return this.setBool(key, value);
+        } else {
+            throw new TypeError(`Unsupported value type for key "${key}": ${typeof value}`);
+        }
+    }
+
+    /**
+     * Set multiple variables from an object
+     * @param {Object} variables - Object with key-value pairs
+     * @returns {PugCompiler} - Returns this for chaining
+     */
+    setVariables(variables) {
+        if (typeof variables !== 'object' || variables === null) {
+            throw new TypeError('Variables must be an object');
+        }
+
+        for (const [key, value] of Object.entries(variables)) {
+            this.set(key, value);
+        }
+
+        return this;
+    }
+
+    /**
+     * Compile a Pug template to HTML
+     * @param {string} template - Pug template string
+     * @returns {string} - Compiled HTML
+     */
+    compile(template) {
+        if (typeof template !== 'string') {
+            throw new TypeError('Template must be a string');
+        }
+
+        const html = binding.compile(this.context, template);
+        if (!html) {
+            throw new Error('Failed to compile template');
+        }
+
+        return html;
+    }
+
+    /**
+     * Compile a template with variables in one call
+     * @param {string} template - Pug template string
+     * @param {Object} variables - Variables to set before compiling
+     * @returns {string} - Compiled HTML
+     */
+    render(template, variables = {}) {
+        this.setVariables(variables);
+        return this.compile(template);
+    }
+}
+
+/**
+ * Convenience function to compile a template with variables
+ * @param {string} template - Pug template string
+ * @param {Object} variables - Variables for the template
+ * @returns {string} - Compiled HTML
+ */
+export function compile(template, variables = {}) {
+    const compiler = new PugCompiler();
+    return compiler.render(template, variables);
+}
+
+/**
+ * Convenience function to compile a template from a file
+ * @param {string} filename - Path to the Pug template file
+ * @param {Object} variables - Variables for the template
+ * @returns {string} - Compiled HTML
+ */
+export function compileFile(filename, variables = {}) {
+    const template = readFileSync(filename, 'utf8');
+    return compile(template, variables);
+}
+
+/**
+ * Get the zig-pug version
+ * @returns {string} - Version string
+ */
+export function version() {
+    return binding.version();
+}
+
+// Default export for compatibility
+export default {
+    PugCompiler,
+    compile,
+    compileFile,
+    version
+};

package/package.json

@@ -1,8 +1,15 @@
 {
   "name": "zig-pug",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "High-performance Pug template engine powered by Zig and mujs. Native N-API addon with ES5.1 JavaScript support, full UTF-8 (emoji, accents), documentation comments (//!), and fast compilation. Compatible with Node.js and Bun.",
+  "type": "commonjs",
   "main": "index.js",
+  "exports": {
+    ".": {
+      "import": "./index.mjs",
+      "require": "./index.js"
+    }
+  },
   "scripts": {
     "install": "node-gyp rebuild",
     "build": "node-gyp configure build",
@@ -76,6 +83,7 @@
   },
   "files": [
     "index.js",
+    "index.mjs",
     "binding.c",
     "binding.gyp",
     "common.gypi",