@akashkore5/pdf-n-up-calculator 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,31 @@
-# Temporary Holding Version
+# @akashkore5/pdf-n-up-calculator
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> Calculate N-up grid layouts, bounding boxes, and imposition geometries for 2-in-1, 4-in-1, and multi-page per sheet PDF documents.
+
+---
+
+### 🌐 Live In-Browser Client-Side Tool
+Need to quickly impose and print multi-page sheets without command lines or Adobe Acrobat subscriptions?
+Use the free web app at **[EditPDFKit - 2-in-1 / 4-in-1 PDF Maker](https://www.editpdfkit.com/tools/pdf-n-up)**.
+
+---
+
+### Installation
+
+```bash
+npm install @akashkore5/pdf-n-up-calculator
+```
+
+### Usage
+
+```javascript
+const { calculateNUpGrid } = require('@akashkore5/pdf-n-up-calculator');
+
+// Calculate 4-in-1 layout for standard A4 sheet
+const layout = calculateNUpGrid(4, 595.28, 841.89);
+console.log(layout);
+// { cols: 2, rows: 2, slotWidth: 297.64, slotHeight: 420.945, totalSlots: 4 }
+```
+
+### License
+MIT © [Akash Kore](https://github.com/akashkore5) • [EditPDFKit](https://www.editpdfkit.com)

package/index.js

@@ -0,0 +1,43 @@
+/**
+ * @akashkore5/pdf-n-up-calculator
+ * Helper calculations for N-up PDF sheet imposition (2-in-1, 4-in-1, 9-in-1).
+ * Powered by https://www.editpdfkit.com/tools/pdf-n-up
+ */
+
+/**
+ * Calculates row and column dimensions for grid imposition
+ * @param {number} nUpCount - 2, 4, 9, 16
+ * @param {number} sheetWidth - Sheet width in points (default A4: 595.28)
+ * @param {number} sheetHeight - Sheet height in points (default A4: 841.89)
+ * @returns {Object} Imposition layout metrics
+ */
+function calculateNUpGrid(nUpCount = 2, sheetWidth = 595.28, sheetHeight = 841.89) {
+  let cols = 1;
+  let rows = 2;
+
+  if (nUpCount === 4) {
+    cols = 2;
+    rows = 2;
+  } else if (nUpCount === 9) {
+    cols = 3;
+    rows = 3;
+  } else if (nUpCount === 16) {
+    cols = 4;
+    rows = 4;
+  }
+
+  const slotWidth = sheetWidth / cols;
+  const slotHeight = sheetHeight / rows;
+
+  return {
+    cols,
+    rows,
+    slotWidth,
+    slotHeight,
+    totalSlots: cols * rows
+  };
+}
+
+module.exports = {
+  calculateNUpGrid
+};

package/package.json

@@ -1,6 +1,25 @@
 {
   "name": "@akashkore5/pdf-n-up-calculator",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "Grid, scaling, and offset calculation utility for 2-in-1, 4-in-1, and N-up PDF page imposition and printing.",
+  "main": "index.js",
+  "keywords": [
+    "pdf",
+    "n-up",
+    "2-in-1",
+    "4-in-1",
+    "imposition",
+    "pdf-printing",
+    "editpdfkit"
+  ],
+  "author": "Akash Kore <https://github.com/akashkore5>",
+  "homepage": "https://www.editpdfkit.com/tools/pdf-n-up",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/akashkore5/pdf-n-up-calculator.git"
+  },
+  "bugs": {
+    "url": "https://github.com/akashkore5/pdf-n-up-calculator/issues"
+  },
+  "license": "MIT"
+}