@ph-itdev/ph-warehouse-toolkit 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nilo Besingga
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,117 @@
+# @ph-itdev/ph-warehouse-toolkit
+
+Philippine warehousing utilities for Node.js — currency, BIR compliance,
+inventory management, address lookup, validation, barcode support, and more.
+
+[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue.svg)](https://www.typescriptlang.org/)
+
+## Install
+
+```bash
+npm install @ph-itdev/ph-warehouse-toolkit
+```
+
+## Quick Start
+
+```ts
+import { formatPeso, calculateVAT, generateSKU, isWarehouseOpen } from '@ph-itdev/ph-warehouse-toolkit';
+
+// Philippine Peso formatting
+formatPeso(125000);        // ₱125,000.00
+
+// BIR VAT calculations (12%)
+calculateVAT(1000);        // 120
+
+// SKU generation
+generateSKU({ prefix: 'WH', category: 'EL', sequence: 1 });  // WH-EL-000001
+
+// Warehouse scheduling
+isWarehouseOpen(new Date());  // true/false
+```
+
+## Modules
+
+### 💰 Currency
+```ts
+import { formatPeso, parsePeso, formatPesoShort, calculateVAT, addVAT, extractVAT } from '@ph-itdev/ph-warehouse-toolkit/currency';
+
+formatPeso(1234567.89);        // ₱1,234,567.89
+formatPesoShort(2500000);       // ₱2.5M
+calculateVAT(1000);            // 120
+addVAT(1000);                  // 1120
+extractVAT(1120);              // { vatableAmount: 1000, vatAmount: 120, grossAmount: 1120 }
+```
+
+### 📍 Address
+```ts
+import { getRegions, getProvinces, formatAddress } from '@ph-itdev/ph-warehouse-toolkit/address';
+
+getRegions();           // All 17 PH regions
+getProvinces('03');      // ['Aurora', 'Bataan', 'Bulacan', 'Pampanga', ...]
+formatAddress({ street: '123 Rizal Ave', barangay: '123', city: 'Makati City', province: 'Metro Manila', zipCode: '1200' });
+// '123 Rizal Ave, Brgy. 123, Makati City, Metro Manila, 1200'
+```
+
+### ✅ Validation
+```ts
+import { isValidPHPhone, isValidPHMobile, isValidTIN, isValidPHZipCode } from '@ph-itdev/ph-warehouse-toolkit/validation';
+
+isValidPHPhone('09171234567');    // true (Globe mobile)
+isValidPHMobile('09171234567');  // true
+isValidTIN('123-456-789-000');   // true
+isValidPHZipCode('1200');        // true
+```
+
+### 📦 Inventory
+```ts
+import { generateSKU, parseSKU, calculateReorderPoint, calculateEOQ, calculateStockValue } from '@ph-itdev/ph-warehouse-toolkit/inventory';
+
+generateSKU({ prefix: 'WH', category: 'EL', sequence: 1 });  // 'WH-EL-000001'
+parseSKU('WH-EL-000042');  // { prefix: 'WH', category: 'EL', sequence: 42 }
+calculateReorderPoint(50, 7);       // 350
+calculateEOQ(1000, 50, 5);          // ~141
+calculateStockValue([{ quantity: 100, unitCost: 50 }, { quantity: 50, unitCost: 120 }]);  // 11000
+```
+
+### 🏷️ Barcode
+```ts
+import { calculateEAN13CheckDigit, validateEAN13, generateCode128Data } from '@ph-itdev/ph-warehouse-toolkit/barcode';
+
+calculateEAN13CheckDigit('400638133393');  // 1
+validateEAN13('4006381333931');           // true
+```
+
+### 📄 Documents
+```ts
+import { generateGRNNumber, generateDRNumber, generateReferenceNumber } from '@ph-itdev/ph-warehouse-toolkit/documents';
+
+generateGRNNumber({ warehouseCode: 'WH01', date: new Date('2026-06-15'), sequence: 1 });
+// 'GRN-WH01-20260615-0001'
+generateDRNumber({ warehouseCode: 'WH01', date: new Date('2026-06-15'), sequence: 1 });
+// 'DR-WH01-20260615-0001'
+```
+
+### 🎌 Holidays
+```ts
+import { getPhilippineHolidays, isHoliday, isWarehouseOpen } from '@ph-itdev/ph-warehouse-toolkit/holidays';
+
+getPhilippineHolidays(2026);              // Full list of PH holidays
+isHoliday(new Date('2026-01-01'));         // true (New Year's Day)
+isWarehouseOpen(new Date());              // closed on Sundays + holidays
+isWarehouseOpen(new Date(), { closedDays: [] });  // open every day except holidays
+```
+
+## Why This Package?
+
+Warehouse management in the Philippines has unique requirements:
+- **Philippine Peso (₱)** — proper currency formatting with peso sign
+- **BIR Compliance** — 12% VAT calculations, TIN validation
+- **PH Address System** — regions, provinces, cities, barangays
+- **Local Holidays** — regular + special non-working holidays for scheduling
+- **SKU & Inventory** — generate warehouse SKUs, calculate reorder points
+- **Document Numbering** — GRN, DR, and PO reference numbers
+
+## License
+
+MIT © Nilo Besingga

package/dist/address.cjs

@@ -0,0 +1,83 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/address/index.ts
+var address_exports = {};
+__export(address_exports, {
+  REGIONS: () => REGIONS,
+  formatAddress: () => formatAddress,
+  getProvinces: () => getProvinces,
+  getRegionByCode: () => getRegionByCode,
+  getRegions: () => getRegions
+});
+module.exports = __toCommonJS(address_exports);
+
+// src/address/data.ts
+var REGIONS = [
+  { code: "NCR", name: "National Capital Region", provinces: ["Metro Manila"] },
+  { code: "01", name: "Ilocos Region", provinces: ["Ilocos Norte", "Ilocos Sur", "La Union", "Pangasinan"] },
+  { code: "02", name: "Cagayan Valley", provinces: ["Batanes", "Cagayan", "Isabela", "Nueva Vizcaya", "Quirino"] },
+  { code: "03", name: "Central Luzon", provinces: ["Aurora", "Bataan", "Bulacan", "Nueva Ecija", "Pampanga", "Tarlac", "Zambales"] },
+  { code: "04A", name: "CALABARZON", provinces: ["Batangas", "Cavite", "Laguna", "Quezon", "Rizal"] },
+  { code: "04B", name: "MIMAROPA", provinces: ["Marinduque", "Occidental Mindoro", "Oriental Mindoro", "Palawan", "Romblon"] },
+  { code: "05", name: "Bicol Region", provinces: ["Albay", "Camarines Norte", "Camarines Sur", "Catanduanes", "Masbate", "Sorsogon"] },
+  { code: "06", name: "Western Visayas", provinces: ["Aklan", "Antique", "Capiz", "Guimaras", "Iloilo", "Negros Occidental"] },
+  { code: "07", name: "Central Visayas", provinces: ["Bohol", "Cebu", "Negros Oriental", "Siquijor"] },
+  { code: "08", name: "Eastern Visayas", provinces: ["Biliran", "Eastern Samar", "Leyte", "Northern Samar", "Samar", "Southern Leyte"] },
+  { code: "09", name: "Zamboanga Peninsula", provinces: ["Zamboanga del Norte", "Zamboanga del Sur", "Zamboanga Sibugay"] },
+  { code: "10", name: "Northern Mindanao", provinces: ["Bukidnon", "Camiguin", "Lanao del Norte", "Misamis Occidental", "Misamis Oriental"] },
+  { code: "11", name: "Davao Region", provinces: ["Davao de Oro", "Davao del Norte", "Davao del Sur", "Davao Occidental", "Davao Oriental"] },
+  { code: "12", name: "SOCCSKSARGEN", provinces: ["Cotabato", "Sarangani", "South Cotabato", "Sultan Kudarat"] },
+  { code: "13", name: "Caraga", provinces: ["Agusan del Norte", "Agusan del Sur", "Dinagat Islands", "Surigao del Norte", "Surigao del Sur"] },
+  { code: "BARMM", name: "Bangsamoro Autonomous Region in Muslim Mindanao", provinces: ["Basilan", "Lanao del Sur", "Maguindanao", "Sulu", "Tawi-Tawi"] },
+  { code: "CAR", name: "Cordillera Administrative Region", provinces: ["Abra", "Apayao", "Benguet", "Ifugao", "Kalinga", "Mountain Province"] }
+];
+
+// src/address/lookup.ts
+function getRegions() {
+  return [...REGIONS];
+}
+function getRegionByCode(code) {
+  return REGIONS.find((r) => r.code === code);
+}
+function getProvinces(regionCode) {
+  const region = getRegionByCode(regionCode);
+  return region ? [...region.provinces] : [];
+}
+function formatAddress(addr) {
+  const parts = [];
+  if (addr.unit) parts.push(addr.unit);
+  if (addr.floor) parts.push(`Floor ${addr.floor}`);
+  if (addr.building) parts.push(addr.building);
+  if (addr.street) parts.push(addr.street);
+  if (addr.barangay) parts.push(`Brgy. ${addr.barangay}`);
+  if (addr.city) parts.push(addr.city);
+  if (addr.province) parts.push(addr.province);
+  if (addr.zipCode) parts.push(addr.zipCode);
+  return parts.join(", ");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  REGIONS,
+  formatAddress,
+  getProvinces,
+  getRegionByCode,
+  getRegions
+});
+//# sourceMappingURL=address.cjs.map

package/dist/address.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/address/index.ts","../src/address/data.ts","../src/address/lookup.ts"],"sourcesContent":["export { getRegions, getRegionByCode, getProvinces, formatAddress } from './lookup.js';\nexport { REGIONS } from './data.js';\nexport type { Region, PhilippineAddress } from './data.js';\n","export interface Region {\n  code: string;\n  name: string;\n  provinces: string[];\n}\n\nexport interface PhilippineAddress {\n  region?: string;\n  province?: string;\n  city?: string;\n  barangay?: string;\n  zipCode?: string;\n  street?: string;\n  building?: string;\n  floor?: string;\n  unit?: string;\n}\n\nexport const REGIONS: Region[] = [\n  { code: 'NCR', name: 'National Capital Region', provinces: ['Metro Manila'] },\n  { code: '01', name: 'Ilocos Region', provinces: ['Ilocos Norte', 'Ilocos Sur', 'La Union', 'Pangasinan'] },\n  { code: '02', name: 'Cagayan Valley', provinces: ['Batanes', 'Cagayan', 'Isabela', 'Nueva Vizcaya', 'Quirino'] },\n  { code: '03', name: 'Central Luzon', provinces: ['Aurora', 'Bataan', 'Bulacan', 'Nueva Ecija', 'Pampanga', 'Tarlac', 'Zambales'] },\n  { code: '04A', name: 'CALABARZON', provinces: ['Batangas', 'Cavite', 'Laguna', 'Quezon', 'Rizal'] },\n  { code: '04B', name: 'MIMAROPA', provinces: ['Marinduque', 'Occidental Mindoro', 'Oriental Mindoro', 'Palawan', 'Romblon'] },\n  { code: '05', name: 'Bicol Region', provinces: ['Albay', 'Camarines Norte', 'Camarines Sur', 'Catanduanes', 'Masbate', 'Sorsogon'] },\n  { code: '06', name: 'Western Visayas', provinces: ['Aklan', 'Antique', 'Capiz', 'Guimaras', 'Iloilo', 'Negros Occidental'] },\n  { code: '07', name: 'Central Visayas', provinces: ['Bohol', 'Cebu', 'Negros Oriental', 'Siquijor'] },\n  { code: '08', name: 'Eastern Visayas', provinces: ['Biliran', 'Eastern Samar', 'Leyte', 'Northern Samar', 'Samar', 'Southern Leyte'] },\n  { code: '09', name: 'Zamboanga Peninsula', provinces: ['Zamboanga del Norte', 'Zamboanga del Sur', 'Zamboanga Sibugay'] },\n  { code: '10', name: 'Northern Mindanao', provinces: ['Bukidnon', 'Camiguin', 'Lanao del Norte', 'Misamis Occidental', 'Misamis Oriental'] },\n  { code: '11', name: 'Davao Region', provinces: ['Davao de Oro', 'Davao del Norte', 'Davao del Sur', 'Davao Occidental', 'Davao Oriental'] },\n  { code: '12', name: 'SOCCSKSARGEN', provinces: ['Cotabato', 'Sarangani', 'South Cotabato', 'Sultan Kudarat'] },\n  { code: '13', name: 'Caraga', provinces: ['Agusan del Norte', 'Agusan del Sur', 'Dinagat Islands', 'Surigao del Norte', 'Surigao del Sur'] },\n  { code: 'BARMM', name: 'Bangsamoro Autonomous Region in Muslim Mindanao', provinces: ['Basilan', 'Lanao del Sur', 'Maguindanao', 'Sulu', 'Tawi-Tawi'] },\n  { code: 'CAR', name: 'Cordillera Administrative Region', provinces: ['Abra', 'Apayao', 'Benguet', 'Ifugao', 'Kalinga', 'Mountain Province'] },\n];\n","import { REGIONS, type Region, type PhilippineAddress } from './data.js';\n\nexport function getRegions(): Region[] {\n  return [...REGIONS];\n}\n\nexport function getRegionByCode(code: string): Region | undefined {\n  return REGIONS.find(r => r.code === code);\n}\n\nexport function getProvinces(regionCode: string): string[] {\n  const region = getRegionByCode(regionCode);\n  return region ? [...region.provinces] : [];\n}\n\nexport function formatAddress(addr: PhilippineAddress): string {\n  const parts: string[] = [];\n  if (addr.unit) parts.push(addr.unit);\n  if (addr.floor) parts.push(`Floor ${addr.floor}`);\n  if (addr.building) parts.push(addr.building);\n  if (addr.street) parts.push(addr.street);\n  if (addr.barangay) parts.push(`Brgy. ${addr.barangay}`);\n  if (addr.city) parts.push(addr.city);\n  if (addr.province) parts.push(addr.province);\n  if (addr.zipCode) parts.push(addr.zipCode);\n  return parts.join(', ');\n}\n"],"mappings":"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","names":[]}

package/dist/address.d.cts

@@ -0,0 +1,24 @@
+interface Region {
+    code: string;
+    name: string;
+    provinces: string[];
+}
+interface PhilippineAddress {
+    region?: string;
+    province?: string;
+    city?: string;
+    barangay?: string;
+    zipCode?: string;
+    street?: string;
+    building?: string;
+    floor?: string;
+    unit?: string;
+}
+declare const REGIONS: Region[];
+
+declare function getRegions(): Region[];
+declare function getRegionByCode(code: string): Region | undefined;
+declare function getProvinces(regionCode: string): string[];
+declare function formatAddress(addr: PhilippineAddress): string;
+
+export { type PhilippineAddress, REGIONS, type Region, formatAddress, getProvinces, getRegionByCode, getRegions };

package/dist/address.d.ts

@@ -0,0 +1,24 @@
+interface Region {
+    code: string;
+    name: string;
+    provinces: string[];
+}
+interface PhilippineAddress {
+    region?: string;
+    province?: string;
+    city?: string;
+    barangay?: string;
+    zipCode?: string;
+    street?: string;
+    building?: string;
+    floor?: string;
+    unit?: string;
+}
+declare const REGIONS: Region[];
+
+declare function getRegions(): Region[];
+declare function getRegionByCode(code: string): Region | undefined;
+declare function getProvinces(regionCode: string): string[];
+declare function formatAddress(addr: PhilippineAddress): string;
+
+export { type PhilippineAddress, REGIONS, type Region, formatAddress, getProvinces, getRegionByCode, getRegions };

package/dist/address.js

@@ -0,0 +1,52 @@
+// src/address/data.ts
+var REGIONS = [
+  { code: "NCR", name: "National Capital Region", provinces: ["Metro Manila"] },
+  { code: "01", name: "Ilocos Region", provinces: ["Ilocos Norte", "Ilocos Sur", "La Union", "Pangasinan"] },
+  { code: "02", name: "Cagayan Valley", provinces: ["Batanes", "Cagayan", "Isabela", "Nueva Vizcaya", "Quirino"] },
+  { code: "03", name: "Central Luzon", provinces: ["Aurora", "Bataan", "Bulacan", "Nueva Ecija", "Pampanga", "Tarlac", "Zambales"] },
+  { code: "04A", name: "CALABARZON", provinces: ["Batangas", "Cavite", "Laguna", "Quezon", "Rizal"] },
+  { code: "04B", name: "MIMAROPA", provinces: ["Marinduque", "Occidental Mindoro", "Oriental Mindoro", "Palawan", "Romblon"] },
+  { code: "05", name: "Bicol Region", provinces: ["Albay", "Camarines Norte", "Camarines Sur", "Catanduanes", "Masbate", "Sorsogon"] },
+  { code: "06", name: "Western Visayas", provinces: ["Aklan", "Antique", "Capiz", "Guimaras", "Iloilo", "Negros Occidental"] },
+  { code: "07", name: "Central Visayas", provinces: ["Bohol", "Cebu", "Negros Oriental", "Siquijor"] },
+  { code: "08", name: "Eastern Visayas", provinces: ["Biliran", "Eastern Samar", "Leyte", "Northern Samar", "Samar", "Southern Leyte"] },
+  { code: "09", name: "Zamboanga Peninsula", provinces: ["Zamboanga del Norte", "Zamboanga del Sur", "Zamboanga Sibugay"] },
+  { code: "10", name: "Northern Mindanao", provinces: ["Bukidnon", "Camiguin", "Lanao del Norte", "Misamis Occidental", "Misamis Oriental"] },
+  { code: "11", name: "Davao Region", provinces: ["Davao de Oro", "Davao del Norte", "Davao del Sur", "Davao Occidental", "Davao Oriental"] },
+  { code: "12", name: "SOCCSKSARGEN", provinces: ["Cotabato", "Sarangani", "South Cotabato", "Sultan Kudarat"] },
+  { code: "13", name: "Caraga", provinces: ["Agusan del Norte", "Agusan del Sur", "Dinagat Islands", "Surigao del Norte", "Surigao del Sur"] },
+  { code: "BARMM", name: "Bangsamoro Autonomous Region in Muslim Mindanao", provinces: ["Basilan", "Lanao del Sur", "Maguindanao", "Sulu", "Tawi-Tawi"] },
+  { code: "CAR", name: "Cordillera Administrative Region", provinces: ["Abra", "Apayao", "Benguet", "Ifugao", "Kalinga", "Mountain Province"] }
+];
+
+// src/address/lookup.ts
+function getRegions() {
+  return [...REGIONS];
+}
+function getRegionByCode(code) {
+  return REGIONS.find((r) => r.code === code);
+}
+function getProvinces(regionCode) {
+  const region = getRegionByCode(regionCode);
+  return region ? [...region.provinces] : [];
+}
+function formatAddress(addr) {
+  const parts = [];
+  if (addr.unit) parts.push(addr.unit);
+  if (addr.floor) parts.push(`Floor ${addr.floor}`);
+  if (addr.building) parts.push(addr.building);
+  if (addr.street) parts.push(addr.street);
+  if (addr.barangay) parts.push(`Brgy. ${addr.barangay}`);
+  if (addr.city) parts.push(addr.city);
+  if (addr.province) parts.push(addr.province);
+  if (addr.zipCode) parts.push(addr.zipCode);
+  return parts.join(", ");
+}
+export {
+  REGIONS,
+  formatAddress,
+  getProvinces,
+  getRegionByCode,
+  getRegions
+};
+//# sourceMappingURL=address.js.map

package/dist/address.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/address/data.ts","../src/address/lookup.ts"],"sourcesContent":["export interface Region {\n  code: string;\n  name: string;\n  provinces: string[];\n}\n\nexport interface PhilippineAddress {\n  region?: string;\n  province?: string;\n  city?: string;\n  barangay?: string;\n  zipCode?: string;\n  street?: string;\n  building?: string;\n  floor?: string;\n  unit?: string;\n}\n\nexport const REGIONS: Region[] = [\n  { code: 'NCR', name: 'National Capital Region', provinces: ['Metro Manila'] },\n  { code: '01', name: 'Ilocos Region', provinces: ['Ilocos Norte', 'Ilocos Sur', 'La Union', 'Pangasinan'] },\n  { code: '02', name: 'Cagayan Valley', provinces: ['Batanes', 'Cagayan', 'Isabela', 'Nueva Vizcaya', 'Quirino'] },\n  { code: '03', name: 'Central Luzon', provinces: ['Aurora', 'Bataan', 'Bulacan', 'Nueva Ecija', 'Pampanga', 'Tarlac', 'Zambales'] },\n  { code: '04A', name: 'CALABARZON', provinces: ['Batangas', 'Cavite', 'Laguna', 'Quezon', 'Rizal'] },\n  { code: '04B', name: 'MIMAROPA', provinces: ['Marinduque', 'Occidental Mindoro', 'Oriental Mindoro', 'Palawan', 'Romblon'] },\n  { code: '05', name: 'Bicol Region', provinces: ['Albay', 'Camarines Norte', 'Camarines Sur', 'Catanduanes', 'Masbate', 'Sorsogon'] },\n  { code: '06', name: 'Western Visayas', provinces: ['Aklan', 'Antique', 'Capiz', 'Guimaras', 'Iloilo', 'Negros Occidental'] },\n  { code: '07', name: 'Central Visayas', provinces: ['Bohol', 'Cebu', 'Negros Oriental', 'Siquijor'] },\n  { code: '08', name: 'Eastern Visayas', provinces: ['Biliran', 'Eastern Samar', 'Leyte', 'Northern Samar', 'Samar', 'Southern Leyte'] },\n  { code: '09', name: 'Zamboanga Peninsula', provinces: ['Zamboanga del Norte', 'Zamboanga del Sur', 'Zamboanga Sibugay'] },\n  { code: '10', name: 'Northern Mindanao', provinces: ['Bukidnon', 'Camiguin', 'Lanao del Norte', 'Misamis Occidental', 'Misamis Oriental'] },\n  { code: '11', name: 'Davao Region', provinces: ['Davao de Oro', 'Davao del Norte', 'Davao del Sur', 'Davao Occidental', 'Davao Oriental'] },\n  { code: '12', name: 'SOCCSKSARGEN', provinces: ['Cotabato', 'Sarangani', 'South Cotabato', 'Sultan Kudarat'] },\n  { code: '13', name: 'Caraga', provinces: ['Agusan del Norte', 'Agusan del Sur', 'Dinagat Islands', 'Surigao del Norte', 'Surigao del Sur'] },\n  { code: 'BARMM', name: 'Bangsamoro Autonomous Region in Muslim Mindanao', provinces: ['Basilan', 'Lanao del Sur', 'Maguindanao', 'Sulu', 'Tawi-Tawi'] },\n  { code: 'CAR', name: 'Cordillera Administrative Region', provinces: ['Abra', 'Apayao', 'Benguet', 'Ifugao', 'Kalinga', 'Mountain Province'] },\n];\n","import { REGIONS, type Region, type PhilippineAddress } from './data.js';\n\nexport function getRegions(): Region[] {\n  return [...REGIONS];\n}\n\nexport function getRegionByCode(code: string): Region | undefined {\n  return REGIONS.find(r => r.code === code);\n}\n\nexport function getProvinces(regionCode: string): string[] {\n  const region = getRegionByCode(regionCode);\n  return region ? [...region.provinces] : [];\n}\n\nexport function formatAddress(addr: PhilippineAddress): string {\n  const parts: string[] = [];\n  if (addr.unit) parts.push(addr.unit);\n  if (addr.floor) parts.push(`Floor ${addr.floor}`);\n  if (addr.building) parts.push(addr.building);\n  if (addr.street) parts.push(addr.street);\n  if (addr.barangay) parts.push(`Brgy. ${addr.barangay}`);\n  if (addr.city) parts.push(addr.city);\n  if (addr.province) parts.push(addr.province);\n  if (addr.zipCode) parts.push(addr.zipCode);\n  return parts.join(', ');\n}\n"],"mappings":"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","names":[]}

package/dist/barcode.cjs

@@ -0,0 +1,57 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/barcode/index.ts
+var barcode_exports = {};
+__export(barcode_exports, {
+  calculateEAN13CheckDigit: () => calculateEAN13CheckDigit,
+  generateCode128Data: () => generateCode128Data,
+  validateEAN13: () => validateEAN13
+});
+module.exports = __toCommonJS(barcode_exports);
+
+// src/barcode/checksum.ts
+function calculateEAN13CheckDigit(digits12) {
+  const cleaned = digits12.replace(/\D/g, "");
+  if (cleaned.length !== 12) {
+    throw new Error("EAN-13 requires exactly 12 digits (without check digit)");
+  }
+  let sum = 0;
+  for (let i = 0; i < 12; i++) {
+    const d = parseInt(cleaned[i], 10);
+    sum += i % 2 === 0 ? d : d * 3;
+  }
+  return (10 - sum % 10) % 10;
+}
+function validateEAN13(ean) {
+  const cleaned = ean.replace(/\D/g, "");
+  if (cleaned.length !== 13) return false;
+  const expectedCheck = calculateEAN13CheckDigit(cleaned.slice(0, 12));
+  return parseInt(cleaned[12], 10) === expectedCheck;
+}
+function generateCode128Data(data) {
+  return data.trim();
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  calculateEAN13CheckDigit,
+  generateCode128Data,
+  validateEAN13
+});
+//# sourceMappingURL=barcode.cjs.map

package/dist/barcode.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/barcode/index.ts","../src/barcode/checksum.ts"],"sourcesContent":["export { calculateEAN13CheckDigit, validateEAN13, generateCode128Data } from './checksum.js';\n","export function calculateEAN13CheckDigit(digits12: string): number {\n  const cleaned = digits12.replace(/\\D/g, '');\n  if (cleaned.length !== 12) {\n    throw new Error('EAN-13 requires exactly 12 digits (without check digit)');\n  }\n  let sum = 0;\n  for (let i = 0; i < 12; i++) {\n    const d = parseInt(cleaned[i], 10);\n    sum += i % 2 === 0 ? d : d * 3;\n  }\n  return (10 - (sum % 10)) % 10;\n}\n\nexport function validateEAN13(ean: string): boolean {\n  const cleaned = ean.replace(/\\D/g, '');\n  if (cleaned.length !== 13) return false;\n  const expectedCheck = calculateEAN13CheckDigit(cleaned.slice(0, 12));\n  return parseInt(cleaned[12], 10) === expectedCheck;\n}\n\nexport function generateCode128Data(data: string): string {\n  return data.trim();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAO,SAAS,yBAAyB,UAA0B;AACjE,QAAM,UAAU,SAAS,QAAQ,OAAO,EAAE;AAC1C,MAAI,QAAQ,WAAW,IAAI;AACzB,UAAM,IAAI,MAAM,yDAAyD;AAAA,EAC3E;AACA,MAAI,MAAM;AACV,WAAS,IAAI,GAAG,IAAI,IAAI,KAAK;AAC3B,UAAM,IAAI,SAAS,QAAQ,CAAC,GAAG,EAAE;AACjC,WAAO,IAAI,MAAM,IAAI,IAAI,IAAI;AAAA,EAC/B;AACA,UAAQ,KAAM,MAAM,MAAO;AAC7B;AAEO,SAAS,cAAc,KAAsB;AAClD,QAAM,UAAU,IAAI,QAAQ,OAAO,EAAE;AACrC,MAAI,QAAQ,WAAW,GAAI,QAAO;AAClC,QAAM,gBAAgB,yBAAyB,QAAQ,MAAM,GAAG,EAAE,CAAC;AACnE,SAAO,SAAS,QAAQ,EAAE,GAAG,EAAE,MAAM;AACvC;AAEO,SAAS,oBAAoB,MAAsB;AACxD,SAAO,KAAK,KAAK;AACnB;","names":[]}

package/dist/barcode.d.cts

@@ -0,0 +1,5 @@
+declare function calculateEAN13CheckDigit(digits12: string): number;
+declare function validateEAN13(ean: string): boolean;
+declare function generateCode128Data(data: string): string;
+
+export { calculateEAN13CheckDigit, generateCode128Data, validateEAN13 };

package/dist/barcode.d.ts

@@ -0,0 +1,5 @@
+declare function calculateEAN13CheckDigit(digits12: string): number;
+declare function validateEAN13(ean: string): boolean;
+declare function generateCode128Data(data: string): string;
+
+export { calculateEAN13CheckDigit, generateCode128Data, validateEAN13 };

package/dist/barcode.js

@@ -0,0 +1,28 @@
+// src/barcode/checksum.ts
+function calculateEAN13CheckDigit(digits12) {
+  const cleaned = digits12.replace(/\D/g, "");
+  if (cleaned.length !== 12) {
+    throw new Error("EAN-13 requires exactly 12 digits (without check digit)");
+  }
+  let sum = 0;
+  for (let i = 0; i < 12; i++) {
+    const d = parseInt(cleaned[i], 10);
+    sum += i % 2 === 0 ? d : d * 3;
+  }
+  return (10 - sum % 10) % 10;
+}
+function validateEAN13(ean) {
+  const cleaned = ean.replace(/\D/g, "");
+  if (cleaned.length !== 13) return false;
+  const expectedCheck = calculateEAN13CheckDigit(cleaned.slice(0, 12));
+  return parseInt(cleaned[12], 10) === expectedCheck;
+}
+function generateCode128Data(data) {
+  return data.trim();
+}
+export {
+  calculateEAN13CheckDigit,
+  generateCode128Data,
+  validateEAN13
+};
+//# sourceMappingURL=barcode.js.map

package/dist/barcode.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/barcode/checksum.ts"],"sourcesContent":["export function calculateEAN13CheckDigit(digits12: string): number {\n  const cleaned = digits12.replace(/\\D/g, '');\n  if (cleaned.length !== 12) {\n    throw new Error('EAN-13 requires exactly 12 digits (without check digit)');\n  }\n  let sum = 0;\n  for (let i = 0; i < 12; i++) {\n    const d = parseInt(cleaned[i], 10);\n    sum += i % 2 === 0 ? d : d * 3;\n  }\n  return (10 - (sum % 10)) % 10;\n}\n\nexport function validateEAN13(ean: string): boolean {\n  const cleaned = ean.replace(/\\D/g, '');\n  if (cleaned.length !== 13) return false;\n  const expectedCheck = calculateEAN13CheckDigit(cleaned.slice(0, 12));\n  return parseInt(cleaned[12], 10) === expectedCheck;\n}\n\nexport function generateCode128Data(data: string): string {\n  return data.trim();\n}\n"],"mappings":";AAAO,SAAS,yBAAyB,UAA0B;AACjE,QAAM,UAAU,SAAS,QAAQ,OAAO,EAAE;AAC1C,MAAI,QAAQ,WAAW,IAAI;AACzB,UAAM,IAAI,MAAM,yDAAyD;AAAA,EAC3E;AACA,MAAI,MAAM;AACV,WAAS,IAAI,GAAG,IAAI,IAAI,KAAK;AAC3B,UAAM,IAAI,SAAS,QAAQ,CAAC,GAAG,EAAE;AACjC,WAAO,IAAI,MAAM,IAAI,IAAI,IAAI;AAAA,EAC/B;AACA,UAAQ,KAAM,MAAM,MAAO;AAC7B;AAEO,SAAS,cAAc,KAAsB;AAClD,QAAM,UAAU,IAAI,QAAQ,OAAO,EAAE;AACrC,MAAI,QAAQ,WAAW,GAAI,QAAO;AAClC,QAAM,gBAAgB,yBAAyB,QAAQ,MAAM,GAAG,EAAE,CAAC;AACnE,SAAO,SAAS,QAAQ,EAAE,GAAG,EAAE,MAAM;AACvC;AAEO,SAAS,oBAAoB,MAAsB;AACxD,SAAO,KAAK,KAAK;AACnB;","names":[]}

package/dist/compliance.cjs

@@ -0,0 +1,61 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/compliance/index.ts
+var compliance_exports = {};
+__export(compliance_exports, {
+  calculateInvoiceTotals: () => calculateInvoiceTotals,
+  formatTIN: () => formatTIN,
+  generateBIRSerial: () => generateBIRSerial,
+  isValidBIRInvoiceNumber: () => isValidBIRInvoiceNumber
+});
+module.exports = __toCommonJS(compliance_exports);
+function formatTIN(tin) {
+  const cleaned = tin.replace(/[^0-9]/g, "");
+  if (cleaned.length === 12) {
+    return `${cleaned.slice(0, 3)}-${cleaned.slice(3, 6)}-${cleaned.slice(6, 9)}-${cleaned.slice(9)}`;
+  }
+  if (cleaned.length === 15) {
+    return `${cleaned.slice(0, 3)}-${cleaned.slice(3, 6)}-${cleaned.slice(6, 9)}-${cleaned.slice(9, 12)}-${cleaned.slice(12)}`;
+  }
+  return tin;
+}
+function isValidBIRInvoiceNumber(invoiceNo) {
+  return /^[A-Z0-9]{2,12}$/.test(invoiceNo.toUpperCase().replace(/[\s-]/g, ""));
+}
+function generateBIRSerial(branchCode, sequence) {
+  const prefix = branchCode.slice(0, 2).toUpperCase();
+  const seq = String(sequence).padStart(7, "0");
+  return `${prefix}${seq}`;
+}
+function calculateInvoiceTotals(amounts, isVATExclusive) {
+  const subtotal = amounts.reduce((sum, a) => sum + a, 0);
+  const vatRate = 0.12;
+  const vatAmount = isVATExclusive ? Math.round(subtotal * vatRate * 100) / 100 : Math.round((subtotal - subtotal / (1 + vatRate)) * 100) / 100;
+  const totalAmount = isVATExclusive ? Math.round(subtotal * (1 + vatRate) * 100) / 100 : subtotal;
+  return { subtotal, vatAmount, totalAmount };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  calculateInvoiceTotals,
+  formatTIN,
+  generateBIRSerial,
+  isValidBIRInvoiceNumber
+});
+//# sourceMappingURL=compliance.cjs.map

package/dist/compliance.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/compliance/index.ts"],"sourcesContent":["/**\n * Philippine BIR Compliance utilities\n * - TIN formatting\n * - VAT registration checks\n * - Invoice numbering per BIR guidelines\n */\n\nexport function formatTIN(tin: string): string {\n  const cleaned = tin.replace(/[^0-9]/g, '');\n  if (cleaned.length === 12) {\n    return `${cleaned.slice(0, 3)}-${cleaned.slice(3, 6)}-${cleaned.slice(6, 9)}-${cleaned.slice(9)}`;\n  }\n  if (cleaned.length === 15) {\n    return `${cleaned.slice(0, 3)}-${cleaned.slice(3, 6)}-${cleaned.slice(6, 9)}-${cleaned.slice(9, 12)}-${cleaned.slice(12)}`;\n  }\n  return tin; // return as-is if unexpected format\n}\n\nexport function isValidBIRInvoiceNumber(invoiceNo: string): boolean {\n  // BIR serial numbers: 2 letters + 7 digits (e.g., AB1234567) or\n  // machine-registered: up to 12 alphanumeric characters\n  return /^[A-Z0-9]{2,12}$/.test(invoiceNo.toUpperCase().replace(/[\\s-]/g, ''));\n}\n\nexport function generateBIRSerial(\n  branchCode: string,\n  sequence: number\n): string {\n  const prefix = branchCode.slice(0, 2).toUpperCase();\n  const seq = String(sequence).padStart(7, '0');\n  return `${prefix}${seq}`;\n}\n\nexport interface InvoiceMetadata {\n  invoiceNumber: string;\n  date: Date;\n  sellerTIN: string;\n  sellerName: string;\n  buyerName?: string;\n  totalAmount: number;\n  vatAmount: number;\n  isVATExclusive: boolean;\n}\n\nexport function calculateInvoiceTotals(\n  amounts: number[],\n  isVATExclusive: boolean\n): { subtotal: number; vatAmount: number; totalAmount: number } {\n  const subtotal = amounts.reduce((sum, a) => sum + a, 0);\n  const vatRate = 0.12;\n  const vatAmount = isVATExclusive\n    ? Math.round(subtotal * vatRate * 100) / 100\n    : Math.round((subtotal - subtotal / (1 + vatRate)) * 100) / 100;\n  const totalAmount = isVATExclusive\n    ? Math.round(subtotal * (1 + vatRate) * 100) / 100\n    : subtotal;\n  return { subtotal, vatAmount, totalAmount };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAOO,SAAS,UAAU,KAAqB;AAC7C,QAAM,UAAU,IAAI,QAAQ,WAAW,EAAE;AACzC,MAAI,QAAQ,WAAW,IAAI;AACzB,WAAO,GAAG,QAAQ,MAAM,GAAG,CAAC,CAAC,IAAI,QAAQ,MAAM,GAAG,CAAC,CAAC,IAAI,QAAQ,MAAM,GAAG,CAAC,CAAC,IAAI,QAAQ,MAAM,CAAC,CAAC;AAAA,EACjG;AACA,MAAI,QAAQ,WAAW,IAAI;AACzB,WAAO,GAAG,QAAQ,MAAM,GAAG,CAAC,CAAC,IAAI,QAAQ,MAAM,GAAG,CAAC,CAAC,IAAI,QAAQ,MAAM,GAAG,CAAC,CAAC,IAAI,QAAQ,MAAM,GAAG,EAAE,CAAC,IAAI,QAAQ,MAAM,EAAE,CAAC;AAAA,EAC1H;AACA,SAAO;AACT;AAEO,SAAS,wBAAwB,WAA4B;AAGlE,SAAO,mBAAmB,KAAK,UAAU,YAAY,EAAE,QAAQ,UAAU,EAAE,CAAC;AAC9E;AAEO,SAAS,kBACd,YACA,UACQ;AACR,QAAM,SAAS,WAAW,MAAM,GAAG,CAAC,EAAE,YAAY;AAClD,QAAM,MAAM,OAAO,QAAQ,EAAE,SAAS,GAAG,GAAG;AAC5C,SAAO,GAAG,MAAM,GAAG,GAAG;AACxB;AAaO,SAAS,uBACd,SACA,gBAC8D;AAC9D,QAAM,WAAW,QAAQ,OAAO,CAAC,KAAK,MAAM,MAAM,GAAG,CAAC;AACtD,QAAM,UAAU;AAChB,QAAM,YAAY,iBACd,KAAK,MAAM,WAAW,UAAU,GAAG,IAAI,MACvC,KAAK,OAAO,WAAW,YAAY,IAAI,YAAY,GAAG,IAAI;AAC9D,QAAM,cAAc,iBAChB,KAAK,MAAM,YAAY,IAAI,WAAW,GAAG,IAAI,MAC7C;AACJ,SAAO,EAAE,UAAU,WAAW,YAAY;AAC5C;","names":[]}

package/dist/compliance.d.cts

@@ -0,0 +1,26 @@
+/**
+ * Philippine BIR Compliance utilities
+ * - TIN formatting
+ * - VAT registration checks
+ * - Invoice numbering per BIR guidelines
+ */
+declare function formatTIN(tin: string): string;
+declare function isValidBIRInvoiceNumber(invoiceNo: string): boolean;
+declare function generateBIRSerial(branchCode: string, sequence: number): string;
+interface InvoiceMetadata {
+    invoiceNumber: string;
+    date: Date;
+    sellerTIN: string;
+    sellerName: string;
+    buyerName?: string;
+    totalAmount: number;
+    vatAmount: number;
+    isVATExclusive: boolean;
+}
+declare function calculateInvoiceTotals(amounts: number[], isVATExclusive: boolean): {
+    subtotal: number;
+    vatAmount: number;
+    totalAmount: number;
+};
+
+export { type InvoiceMetadata, calculateInvoiceTotals, formatTIN, generateBIRSerial, isValidBIRInvoiceNumber };

package/dist/compliance.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Philippine BIR Compliance utilities
+ * - TIN formatting
+ * - VAT registration checks
+ * - Invoice numbering per BIR guidelines
+ */
+declare function formatTIN(tin: string): string;
+declare function isValidBIRInvoiceNumber(invoiceNo: string): boolean;
+declare function generateBIRSerial(branchCode: string, sequence: number): string;
+interface InvoiceMetadata {
+    invoiceNumber: string;
+    date: Date;
+    sellerTIN: string;
+    sellerName: string;
+    buyerName?: string;
+    totalAmount: number;
+    vatAmount: number;
+    isVATExclusive: boolean;
+}
+declare function calculateInvoiceTotals(amounts: number[], isVATExclusive: boolean): {
+    subtotal: number;
+    vatAmount: number;
+    totalAmount: number;
+};
+
+export { type InvoiceMetadata, calculateInvoiceTotals, formatTIN, generateBIRSerial, isValidBIRInvoiceNumber };

package/dist/compliance.js

@@ -0,0 +1,33 @@
+// src/compliance/index.ts
+function formatTIN(tin) {
+  const cleaned = tin.replace(/[^0-9]/g, "");
+  if (cleaned.length === 12) {
+    return `${cleaned.slice(0, 3)}-${cleaned.slice(3, 6)}-${cleaned.slice(6, 9)}-${cleaned.slice(9)}`;
+  }
+  if (cleaned.length === 15) {
+    return `${cleaned.slice(0, 3)}-${cleaned.slice(3, 6)}-${cleaned.slice(6, 9)}-${cleaned.slice(9, 12)}-${cleaned.slice(12)}`;
+  }
+  return tin;
+}
+function isValidBIRInvoiceNumber(invoiceNo) {
+  return /^[A-Z0-9]{2,12}$/.test(invoiceNo.toUpperCase().replace(/[\s-]/g, ""));
+}
+function generateBIRSerial(branchCode, sequence) {
+  const prefix = branchCode.slice(0, 2).toUpperCase();
+  const seq = String(sequence).padStart(7, "0");
+  return `${prefix}${seq}`;
+}
+function calculateInvoiceTotals(amounts, isVATExclusive) {
+  const subtotal = amounts.reduce((sum, a) => sum + a, 0);
+  const vatRate = 0.12;
+  const vatAmount = isVATExclusive ? Math.round(subtotal * vatRate * 100) / 100 : Math.round((subtotal - subtotal / (1 + vatRate)) * 100) / 100;
+  const totalAmount = isVATExclusive ? Math.round(subtotal * (1 + vatRate) * 100) / 100 : subtotal;
+  return { subtotal, vatAmount, totalAmount };
+}
+export {
+  calculateInvoiceTotals,
+  formatTIN,
+  generateBIRSerial,
+  isValidBIRInvoiceNumber
+};
+//# sourceMappingURL=compliance.js.map

package/dist/compliance.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/compliance/index.ts"],"sourcesContent":["/**\n * Philippine BIR Compliance utilities\n * - TIN formatting\n * - VAT registration checks\n * - Invoice numbering per BIR guidelines\n */\n\nexport function formatTIN(tin: string): string {\n  const cleaned = tin.replace(/[^0-9]/g, '');\n  if (cleaned.length === 12) {\n    return `${cleaned.slice(0, 3)}-${cleaned.slice(3, 6)}-${cleaned.slice(6, 9)}-${cleaned.slice(9)}`;\n  }\n  if (cleaned.length === 15) {\n    return `${cleaned.slice(0, 3)}-${cleaned.slice(3, 6)}-${cleaned.slice(6, 9)}-${cleaned.slice(9, 12)}-${cleaned.slice(12)}`;\n  }\n  return tin; // return as-is if unexpected format\n}\n\nexport function isValidBIRInvoiceNumber(invoiceNo: string): boolean {\n  // BIR serial numbers: 2 letters + 7 digits (e.g., AB1234567) or\n  // machine-registered: up to 12 alphanumeric characters\n  return /^[A-Z0-9]{2,12}$/.test(invoiceNo.toUpperCase().replace(/[\\s-]/g, ''));\n}\n\nexport function generateBIRSerial(\n  branchCode: string,\n  sequence: number\n): string {\n  const prefix = branchCode.slice(0, 2).toUpperCase();\n  const seq = String(sequence).padStart(7, '0');\n  return `${prefix}${seq}`;\n}\n\nexport interface InvoiceMetadata {\n  invoiceNumber: string;\n  date: Date;\n  sellerTIN: string;\n  sellerName: string;\n  buyerName?: string;\n  totalAmount: number;\n  vatAmount: number;\n  isVATExclusive: boolean;\n}\n\nexport function calculateInvoiceTotals(\n  amounts: number[],\n  isVATExclusive: boolean\n): { subtotal: number; vatAmount: number; totalAmount: number } {\n  const subtotal = amounts.reduce((sum, a) => sum + a, 0);\n  const vatRate = 0.12;\n  const vatAmount = isVATExclusive\n    ? Math.round(subtotal * vatRate * 100) / 100\n    : Math.round((subtotal - subtotal / (1 + vatRate)) * 100) / 100;\n  const totalAmount = isVATExclusive\n    ? Math.round(subtotal * (1 + vatRate) * 100) / 100\n    : subtotal;\n  return { subtotal, vatAmount, totalAmount };\n}\n"],"mappings":";AAOO,SAAS,UAAU,KAAqB;AAC7C,QAAM,UAAU,IAAI,QAAQ,WAAW,EAAE;AACzC,MAAI,QAAQ,WAAW,IAAI;AACzB,WAAO,GAAG,QAAQ,MAAM,GAAG,CAAC,CAAC,IAAI,QAAQ,MAAM,GAAG,CAAC,CAAC,IAAI,QAAQ,MAAM,GAAG,CAAC,CAAC,IAAI,QAAQ,MAAM,CAAC,CAAC;AAAA,EACjG;AACA,MAAI,QAAQ,WAAW,IAAI;AACzB,WAAO,GAAG,QAAQ,MAAM,GAAG,CAAC,CAAC,IAAI,QAAQ,MAAM,GAAG,CAAC,CAAC,IAAI,QAAQ,MAAM,GAAG,CAAC,CAAC,IAAI,QAAQ,MAAM,GAAG,EAAE,CAAC,IAAI,QAAQ,MAAM,EAAE,CAAC;AAAA,EAC1H;AACA,SAAO;AACT;AAEO,SAAS,wBAAwB,WAA4B;AAGlE,SAAO,mBAAmB,KAAK,UAAU,YAAY,EAAE,QAAQ,UAAU,EAAE,CAAC;AAC9E;AAEO,SAAS,kBACd,YACA,UACQ;AACR,QAAM,SAAS,WAAW,MAAM,GAAG,CAAC,EAAE,YAAY;AAClD,QAAM,MAAM,OAAO,QAAQ,EAAE,SAAS,GAAG,GAAG;AAC5C,SAAO,GAAG,MAAM,GAAG,GAAG;AACxB;AAaO,SAAS,uBACd,SACA,gBAC8D;AAC9D,QAAM,WAAW,QAAQ,OAAO,CAAC,KAAK,MAAM,MAAM,GAAG,CAAC;AACtD,QAAM,UAAU;AAChB,QAAM,YAAY,iBACd,KAAK,MAAM,WAAW,UAAU,GAAG,IAAI,MACvC,KAAK,OAAO,WAAW,YAAY,IAAI,YAAY,GAAG,IAAI;AAC9D,QAAM,cAAc,iBAChB,KAAK,MAAM,YAAY,IAAI,WAAW,GAAG,IAAI,MAC7C;AACJ,SAAO,EAAE,UAAU,WAAW,YAAY;AAC5C;","names":[]}