shareneus 1.5.94 → 1.5.95

package/dist/index.d.ts

@@ -141,5 +141,5 @@ export { GetBillPdfDataUrl } from "./purchases/bills/bill-pdf/bill-pdf.service";
 export { GetInvoicePrintInfo } from "./accounting/invoice/inv-print.service";
 export { CreateReceiptPDFService } from "./accounting/payment-receive/payment-receipt-pdf/receipt-pdf.service";
 export { CreateInvoicePDFService } from "./accounting/invoice/invoice-pdf/invoice-pdf.service";
-export { calculateLineTax, extractNetFromInclusive, sumTaxComponents, computeTaxSummary, determineSupplyType, findTaxCodeByRateAndSupplyType, calculateWithholding, roundAmount, validateTaxId, validateHSNSACLength, convertFlatToTaxes, } from "./tax";
+export { CalculateLineTax, ExtractNetFromInclusive, SumTaxComponents, ComputeTaxSummary, DetermineSupplyType, FindTaxCodeByRateAndSupplyType, CalculateWithholding, RoundAmount, ValidateTaxId, ValidateHSNSACLength, ConvertFlatToTaxes, } from "./tax";
 export type { TaxComponentType, CalcMethod, AppliedOn, RoundingMethod, TaxCategory, SupplyType, ResolvedSupplyType, WithholdingType, ResolverType, IRegimeComponent, IRegimeFeatures, IRounding, ITreatment, ITaxRegime, ITaxCodeComponent, ITaxCode, ITaxComponent, ITaxSummaryLine, ITaxSummary, IWithholding, IWithholdingCalcInput, ITaxCalcLineInput, ITaxSummaryInput, IRoundingConfig, IInclusiveResult, ITaxExemption, ITaxAuthority, IExternalProvider, } from "./tax";

package/dist/index.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DebitNotePdfService = exports.DCWithoutPricePdfService = exports.DCLandscapeWithoutPricePdfService = exports.DCLandscapePdfService = exports.CustomerBalancesService = exports.SalesByCustomerPDFService = exports.CustWiseSalesDetailsService = exports.CreditNoteTotalsService = exports.CreditNotePdfService = exports.ConsultationPDFService = exports.ConsultationFullPrintService = exports.ConsultationFeeReceiptPrintService = exports.CNPrintService = exports.ChecklistsPDFService = exports.CheckListPrintService = exports.CategoryWiseItemPDFService = exports.SalesReceiptprintService = exports.AppointmentTotalsService = exports.AnalysisPDFService = exports.VenBalanceXlsxFileService = exports.TallySalesImportXlsxFileService = exports.StockXlsxFileService = exports.IssueSparesXlsxFileService = exports.ScheduledDrugXlsxFileService = exports.ScheduledDrugSummaryXlsxFileService = exports.SalesByServiceSummaryXlsxFileService = exports.SummaryXlsxFileService = exports.ServiceAdvisorWisePartXlsxFileService = exports.ServiceAdvisorWiseLaborXlsxFileService = exports.RepairOrdersXlsxFileService = exports.PaymentsMadeXlsxFileService = exports.PaymentReceiveXlsxFileService = exports.OperatorWiseSummaryXlsxFileService = exports.OperatorWiseDetailsXlsxFileService = exports.ManfWiseSalesXlsxFileService = exports.ItemsWiseSalesXlsxFileService = exports.ItemWiseMOSummaryXlsxFileService = exports.ItemWiseMODetailsXlsxFileService = exports.ItemWiseDoctorSaleXlsxFileService = exports.InvoicesWiseXlsxFileService = exports.InsuranceExpireXlsxFileService = exports.GSTR2ExcelService = exports.GSTR1ExcelService = exports.GSTROXlsxFileService = exports.ExpiringDrugsXlsxFileService = exports.SalesByCustomerXlsxFileService = exports.CustWiseSalesXlsxFileService = exports.CustBalanceXlsxFileService = exports.CategoryWiseItemXlsxFileService = exports.AnalysisXlsxFileService = void 0;
 exports.TaskPDfService = exports.PrintSharedService = exports.SharedPDFService = exports.SharedInvoiceprintService = exports.WOPrintService = exports.ScheduledDrugSummaryPDFService = exports.ScheduledDrugPDFService = exports.SalesTotalsService = exports.SaleReceiptPrintService = exports.SalesReceiptpdfService = exports.SalesPrintService = exports.SalesPdfService = exports.SalesByServiceSummaryPDF = exports.ROTotalsService = exports.ROPrintService = exports.RoprintService = exports.RepairOrdersReportsPDFService = exports.ReorderPointPDFService = exports.ReceiptPrintService = exports.PurchaseOrderPDFService = exports.PurchaseOrderTotalsService = exports.PurchaseOrderPrintService = exports.PosReceiptPrintService = exports.POTotalsService = exports.PaymentsReportPDFService = exports.ReceiptPDFService = exports.PackShipPrintService = exports.PackShipPDFService = exports.OperatorWiseSalesSummaryPDF = exports.OperatorWiseSalesDetailsPDF = exports.MaterialOutprintService = exports.MeetingPdfService = exports.ManfWiseSalesService = exports.ItemWiseSalesPDFService = exports.ItemWiseMOSummaryPDF = exports.ItemWiseMODetailsPDF = exports.ItemWiseDoctorSalePDFService = exports.ItemDetaisPdf = exports.IssuePartsprintService = exports.InvoiceTotalsService = exports.InvoiceLandscapePdfService = exports.InsuranceExpirePDF = exports.ExpiringDrugPDFService = exports.EstPrintService = exports.EquipmentDesignPdf = exports.DeliveryChallanTotalsService = exports.DeliveryChallanPrintService = exports.DeliveryChallanPdfService = exports.DebitNoteTotalsService = exports.DebitNotePrintService = void 0;
 exports.CreateInvoicePDFService = exports.CreateReceiptPDFService = exports.GetInvoicePrintInfo = exports.GetBillPdfDataUrl = exports.GetBillPDF = exports.GetInvoicePDF = exports.ProductWithoutOwnerPDFService = exports.ProductWithoutOwnerXlsxFileService = exports.Divide = exports.Multiply = exports.Subtract = exports.Add = exports.ServiceHistoryPDFService = exports.SalesTotalCalculationsWithDecimals = exports.GetNumber = exports.GetAgeString = exports.IsNull = exports.IsNotNull = exports.GetServicePriceForPriceList = exports.ApplyServicePriceListToOpcode = exports.ApplyServicePriceListToProcedure = exports.CalcItemFinalSalePrice = exports.GetItemPriceForPriceList = exports.SalesReceiveTotalsService = exports.SalesReceivePrintService = exports.SalesReceivePdfService = exports.AdjustmentDrugPDFService = exports.HSNSummaryPDFService = exports.HSNSummaryExcelService = exports.ItemBarCodeLabelPdf = exports.NextServiceDatePDFService = exports.NextServiceDateXlsxFileService = exports.ConsultationLetterHeadPDFService = exports.InvoiceLetterheadPdfService = exports.InvoicePortraitPrintService = exports.HCInvoiceprintService = exports.InvoiceprintService = exports.MyDate = exports.TrUtils = exports.VendorDebitNoteTotalsService = exports.VendorDebitNotePrintService = exports.VendorDebitNotePdfService = exports.VendorCreditNoteTotalsService = exports.VendorCreditNotePrintService = exports.VendorCreditNotePDFService = exports.VendorBalancesService = exports.TransferOrderPrintService = exports.TechnicianPrintService = exports.TechnicianpdfService = exports.TaskReportsPDfService = void 0;
-exports.convertFlatToTaxes = exports.validateHSNSACLength = exports.validateTaxId = exports.roundAmount = exports.calculateWithholding = exports.findTaxCodeByRateAndSupplyType = exports.determineSupplyType = exports.computeTaxSummary = exports.sumTaxComponents = exports.extractNetFromInclusive = exports.calculateLineTax = void 0;
+exports.ConvertFlatToTaxes = exports.ValidateHSNSACLength = exports.ValidateTaxId = exports.RoundAmount = exports.CalculateWithholding = exports.FindTaxCodeByRateAndSupplyType = exports.DetermineSupplyType = exports.ComputeTaxSummary = exports.SumTaxComponents = exports.ExtractNetFromInclusive = exports.CalculateLineTax = void 0;
 var analysis_excel_service_1 = require("./accounting/invoice/reports/excel/analysis-excel.service");
 Object.defineProperty(exports, "AnalysisXlsxFileService", { enumerable: true, get: function () { return analysis_excel_service_1.AnalysisXlsxFileService; } });
 var category_wise_item_excel_service_1 = require("./accounting/invoice/reports/excel/category-wise-item-excel.service");
@@ -300,14 +300,14 @@ var invoice_pdf_service_2 = require("./accounting/invoice/invoice-pdf/invoice-pd
 Object.defineProperty(exports, "CreateInvoicePDFService", { enumerable: true, get: function () { return invoice_pdf_service_2.CreateInvoicePDFService; } });
 // Tax System — Calculation functions
 var tax_1 = require("./tax");
-Object.defineProperty(exports, "calculateLineTax", { enumerable: true, get: function () { return tax_1.calculateLineTax; } });
-Object.defineProperty(exports, "extractNetFromInclusive", { enumerable: true, get: function () { return tax_1.extractNetFromInclusive; } });
-Object.defineProperty(exports, "sumTaxComponents", { enumerable: true, get: function () { return tax_1.sumTaxComponents; } });
-Object.defineProperty(exports, "computeTaxSummary", { enumerable: true, get: function () { return tax_1.computeTaxSummary; } });
-Object.defineProperty(exports, "determineSupplyType", { enumerable: true, get: function () { return tax_1.determineSupplyType; } });
-Object.defineProperty(exports, "findTaxCodeByRateAndSupplyType", { enumerable: true, get: function () { return tax_1.findTaxCodeByRateAndSupplyType; } });
-Object.defineProperty(exports, "calculateWithholding", { enumerable: true, get: function () { return tax_1.calculateWithholding; } });
-Object.defineProperty(exports, "roundAmount", { enumerable: true, get: function () { return tax_1.roundAmount; } });
-Object.defineProperty(exports, "validateTaxId", { enumerable: true, get: function () { return tax_1.validateTaxId; } });
-Object.defineProperty(exports, "validateHSNSACLength", { enumerable: true, get: function () { return tax_1.validateHSNSACLength; } });
-Object.defineProperty(exports, "convertFlatToTaxes", { enumerable: true, get: function () { return tax_1.convertFlatToTaxes; } });
+Object.defineProperty(exports, "CalculateLineTax", { enumerable: true, get: function () { return tax_1.CalculateLineTax; } });
+Object.defineProperty(exports, "ExtractNetFromInclusive", { enumerable: true, get: function () { return tax_1.ExtractNetFromInclusive; } });
+Object.defineProperty(exports, "SumTaxComponents", { enumerable: true, get: function () { return tax_1.SumTaxComponents; } });
+Object.defineProperty(exports, "ComputeTaxSummary", { enumerable: true, get: function () { return tax_1.ComputeTaxSummary; } });
+Object.defineProperty(exports, "DetermineSupplyType", { enumerable: true, get: function () { return tax_1.DetermineSupplyType; } });
+Object.defineProperty(exports, "FindTaxCodeByRateAndSupplyType", { enumerable: true, get: function () { return tax_1.FindTaxCodeByRateAndSupplyType; } });
+Object.defineProperty(exports, "CalculateWithholding", { enumerable: true, get: function () { return tax_1.CalculateWithholding; } });
+Object.defineProperty(exports, "RoundAmount", { enumerable: true, get: function () { return tax_1.RoundAmount; } });
+Object.defineProperty(exports, "ValidateTaxId", { enumerable: true, get: function () { return tax_1.ValidateTaxId; } });
+Object.defineProperty(exports, "ValidateHSNSACLength", { enumerable: true, get: function () { return tax_1.ValidateHSNSACLength; } });
+Object.defineProperty(exports, "ConvertFlatToTaxes", { enumerable: true, get: function () { return tax_1.ConvertFlatToTaxes; } });

package/dist/tax/index.d.ts

@@ -4,6 +4,6 @@
  * This is the entry point for all tax-related functionality.
  * Import from "shareneus/tax" in both UI and API code.
  */
-export type { TaxComponentType, CalcMethod, AppliedOn, RoundingMethod, TaxCategory, SupplyType, ResolvedSupplyType, WithholdingType, ResolverType, IRegimeComponent, IRegimeFeatures, IRounding, ITreatment, ITaxRegime, ITaxCodeComponent, ITaxCode, ITaxComponent, ITaxSummaryLine, ITaxSummary, IWithholding, IWithholdingCalcInput, IComponentOverride, ITaxCalcLineInput, ITaxSummaryInput, IRoundingConfig, IDocumentTotalsInput, IDocumentTotals, ITaxExemption, ITaxAuthority, IExternalProvider, } from "./tax.types";
+export type { TaxComponentType, CalcMethod, AppliedOn, RoundingMethod, TaxCategory, SupplyType, ResolvedSupplyType, WithholdingType, ResolverType, IRegimeComponent, IRegimeFeatures, IRounding, ITreatment, ITaxRegime, ITaxCodeComponent, ITaxCode, ITaxComponent, ITaxSummaryLine, ITaxSummary, IWithholding, IWithholdingCalcInput, IComponentOverride, ITaxCalcLineInput, ITaxSummaryInput, IRoundingConfig, IDocumentTotalsInput, IDocumentTotals, ITaxIdLabel, ITaxIdEntry, ITaxExemption, ITaxAuthority, IExternalProvider, } from "./tax.types";
 export type { IInclusiveResult } from "./tax-calculator";
-export { calculateLineTax, extractNetFromInclusive, sumTaxComponents, computeTaxSummary, computeDocumentTotals, determineSupplyType, findTaxCodeByRateAndSupplyType, calculateWithholding, roundAmount, validateTaxId, validateHSNSACLength, convertFlatToTaxes, } from "./tax-calculator";
+export { CalculateLineTax, ExtractNetFromInclusive, SumTaxComponents, ComputeTaxSummary, ComputeDocumentTotals, DetermineSupplyType, FindTaxCodeByRateAndSupplyType, CalculateWithholding, RoundAmount, ValidateTaxId, ValidateHSNSACLength, ConvertFlatToTaxes, GetDefaultTaxIdLabels, GetPrintableTaxIds, } from "./tax-calculator";

package/dist/tax/index.js

@@ -6,17 +6,19 @@
  * Import from "shareneus/tax" in both UI and API code.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.convertFlatToTaxes = exports.validateHSNSACLength = exports.validateTaxId = exports.roundAmount = exports.calculateWithholding = exports.findTaxCodeByRateAndSupplyType = exports.determineSupplyType = exports.computeDocumentTotals = exports.computeTaxSummary = exports.sumTaxComponents = exports.extractNetFromInclusive = exports.calculateLineTax = void 0;
+exports.GetPrintableTaxIds = exports.GetDefaultTaxIdLabels = exports.ConvertFlatToTaxes = exports.ValidateHSNSACLength = exports.ValidateTaxId = exports.RoundAmount = exports.CalculateWithholding = exports.FindTaxCodeByRateAndSupplyType = exports.DetermineSupplyType = exports.ComputeDocumentTotals = exports.ComputeTaxSummary = exports.SumTaxComponents = exports.ExtractNetFromInclusive = exports.CalculateLineTax = void 0;
 var tax_calculator_1 = require("./tax-calculator");
-Object.defineProperty(exports, "calculateLineTax", { enumerable: true, get: function () { return tax_calculator_1.calculateLineTax; } });
-Object.defineProperty(exports, "extractNetFromInclusive", { enumerable: true, get: function () { return tax_calculator_1.extractNetFromInclusive; } });
-Object.defineProperty(exports, "sumTaxComponents", { enumerable: true, get: function () { return tax_calculator_1.sumTaxComponents; } });
-Object.defineProperty(exports, "computeTaxSummary", { enumerable: true, get: function () { return tax_calculator_1.computeTaxSummary; } });
-Object.defineProperty(exports, "computeDocumentTotals", { enumerable: true, get: function () { return tax_calculator_1.computeDocumentTotals; } });
-Object.defineProperty(exports, "determineSupplyType", { enumerable: true, get: function () { return tax_calculator_1.determineSupplyType; } });
-Object.defineProperty(exports, "findTaxCodeByRateAndSupplyType", { enumerable: true, get: function () { return tax_calculator_1.findTaxCodeByRateAndSupplyType; } });
-Object.defineProperty(exports, "calculateWithholding", { enumerable: true, get: function () { return tax_calculator_1.calculateWithholding; } });
-Object.defineProperty(exports, "roundAmount", { enumerable: true, get: function () { return tax_calculator_1.roundAmount; } });
-Object.defineProperty(exports, "validateTaxId", { enumerable: true, get: function () { return tax_calculator_1.validateTaxId; } });
-Object.defineProperty(exports, "validateHSNSACLength", { enumerable: true, get: function () { return tax_calculator_1.validateHSNSACLength; } });
-Object.defineProperty(exports, "convertFlatToTaxes", { enumerable: true, get: function () { return tax_calculator_1.convertFlatToTaxes; } });
+Object.defineProperty(exports, "CalculateLineTax", { enumerable: true, get: function () { return tax_calculator_1.CalculateLineTax; } });
+Object.defineProperty(exports, "ExtractNetFromInclusive", { enumerable: true, get: function () { return tax_calculator_1.ExtractNetFromInclusive; } });
+Object.defineProperty(exports, "SumTaxComponents", { enumerable: true, get: function () { return tax_calculator_1.SumTaxComponents; } });
+Object.defineProperty(exports, "ComputeTaxSummary", { enumerable: true, get: function () { return tax_calculator_1.ComputeTaxSummary; } });
+Object.defineProperty(exports, "ComputeDocumentTotals", { enumerable: true, get: function () { return tax_calculator_1.ComputeDocumentTotals; } });
+Object.defineProperty(exports, "DetermineSupplyType", { enumerable: true, get: function () { return tax_calculator_1.DetermineSupplyType; } });
+Object.defineProperty(exports, "FindTaxCodeByRateAndSupplyType", { enumerable: true, get: function () { return tax_calculator_1.FindTaxCodeByRateAndSupplyType; } });
+Object.defineProperty(exports, "CalculateWithholding", { enumerable: true, get: function () { return tax_calculator_1.CalculateWithholding; } });
+Object.defineProperty(exports, "RoundAmount", { enumerable: true, get: function () { return tax_calculator_1.RoundAmount; } });
+Object.defineProperty(exports, "ValidateTaxId", { enumerable: true, get: function () { return tax_calculator_1.ValidateTaxId; } });
+Object.defineProperty(exports, "ValidateHSNSACLength", { enumerable: true, get: function () { return tax_calculator_1.ValidateHSNSACLength; } });
+Object.defineProperty(exports, "ConvertFlatToTaxes", { enumerable: true, get: function () { return tax_calculator_1.ConvertFlatToTaxes; } });
+Object.defineProperty(exports, "GetDefaultTaxIdLabels", { enumerable: true, get: function () { return tax_calculator_1.GetDefaultTaxIdLabels; } });
+Object.defineProperty(exports, "GetPrintableTaxIds", { enumerable: true, get: function () { return tax_calculator_1.GetPrintableTaxIds; } });

package/dist/tax/tax-calculator.d.ts

@@ -14,7 +14,7 @@
  * IMPORTANT: All monetary calculations use Big.js to avoid floating-point
  * precision issues. Never use plain JS arithmetic (* / + -) for money.
  */
-import { ITaxCode, ITaxComponent, ITaxSummary, ITaxCalcLineInput, ITaxSummaryInput, IRoundingConfig, IDocumentTotalsInput, IDocumentTotals, ResolvedSupplyType, IWithholding, IWithholdingCalcInput } from "./tax.types";
+import { ITaxCode, ITaxComponent, ITaxSummary, ITaxCalcLineInput, ITaxSummaryInput, IRoundingConfig, IDocumentTotalsInput, IDocumentTotals, ResolvedSupplyType, IWithholding, IWithholdingCalcInput, ITaxIdLabel, ITaxIdEntry } from "./tax.types";
 /**
  * Calculates tax for a single line item based on the provided TaxCode.
  *
@@ -27,7 +27,7 @@ import { ITaxCode, ITaxComponent, ITaxSummary, ITaxCalcLineInput, ITaxSummaryInp
  *
  * @example
  * // India GST 18% Intra-State on Rs 5,000 item
- * const result = calculateLineTax({
+ * const result = CalculateLineTax({
  *     NetAmt: 5000,
  *     TaxCode: gst18IntraTaxCode,
  * });
@@ -38,7 +38,7 @@ import { ITaxCode, ITaxComponent, ITaxSummary, ITaxCalcLineInput, ITaxSummaryInp
  *
  * @example
  * // India GST 28% + Specific Cess (Rs 12/liter) on 100 liters
- * const result = calculateLineTax({
+ * const result = CalculateLineTax({
  *     NetAmt: 10000,
  *     Qty: 100,
  *     TaxCode: gst28CessDrinkTaxCode,
@@ -49,7 +49,7 @@ import { ITaxCode, ITaxComponent, ITaxSummary, ITaxCalcLineInput, ITaxSummaryInp
  * //   { Code: "CESS", Rate: 0,  Amt: 1200, TaxCodeId: 201 },
  * // ]
  */
-export declare function calculateLineTax(input: ITaxCalcLineInput, rounding?: IRoundingConfig): ITaxComponent[];
+export declare function CalculateLineTax(input: ITaxCalcLineInput, rounding?: IRoundingConfig): ITaxComponent[];
 /**
  * Extracts the pre-tax (net) amount from a tax-inclusive price.
  *
@@ -71,7 +71,7 @@ export declare function calculateLineTax(input: ITaxCalcLineInput, rounding?: IR
  *
  * @example
  * // Price Rs 5,900 inclusive of GST 18%
- * const netAmt = extractNetFromInclusive(5900, gst18IntraTaxCode);
+ * const netAmt = ExtractNetFromInclusive(5900, gst18IntraTaxCode);
  * // Returns: 5000 (because 5000 + 18% = 5900)
  */
 /**
@@ -87,7 +87,7 @@ export interface IInclusiveResult {
     /** If set, the back-calculation is approximate — component structure doesn't support exact inversion */
     Warning?: string;
 }
-export declare function extractNetFromInclusive(inclusivePrice: number, taxCode: ITaxCode, qty?: number, rounding?: IRoundingConfig): IInclusiveResult;
+export declare function ExtractNetFromInclusive(inclusivePrice: number, taxCode: ITaxCode, qty?: number, rounding?: IRoundingConfig): IInclusiveResult;
 /**
  * Sums the Amt of all tax components on a line item.
  *
@@ -95,10 +95,10 @@ export declare function extractNetFromInclusive(inclusivePrice: number, taxCode:
  * @returns Total tax amount
  *
  * @example
- * const totalTax = sumTaxComponents(lineItem.Taxes);
+ * const totalTax = SumTaxComponents(lineItem.Taxes);
  * // CGST 450 + SGST 450 = 900
  */
-export declare function sumTaxComponents(taxes: ITaxComponent[] | undefined | null): number;
+export declare function SumTaxComponents(taxes: ITaxComponent[] | undefined | null): number;
 /**
  * Computes the document-level TaxSummary by aggregating all line items' Taxes[].
  *
@@ -111,13 +111,13 @@ export declare function sumTaxComponents(taxes: ITaxComponent[] | undefined | nu
  *
  * Rounding behavior (via input.Rounding):
  *   - TaxComponentTotal ON: each bucket's Amt is rounded to Precision
- *   - Otherwise: Amts are at currency precision (from calculateLineTax)
+ *   - Otherwise: Amts are at currency precision (from CalculateLineTax)
  *
  * @param input - All line items with Taxes[] and NetAmt, plus regime code and optional rounding
  * @returns ITaxSummary — the aggregated summary (stored on the document)
  *
  * @example
- * const summary = computeTaxSummary({
+ * const summary = ComputeTaxSummary({
  *     Lines: invoice.Items.map(item => ({
  *         Taxes: item.Taxes,
  *         NetAmt: item.UnAmt - item.Disc - item.RecDisc,
@@ -135,7 +135,7 @@ export declare function sumTaxComponents(taxes: ITaxComponent[] | undefined | nu
  * //   RegimeCode: "IN_GST"
  * // }
  */
-export declare function computeTaxSummary(input: ITaxSummaryInput): ITaxSummary;
+export declare function ComputeTaxSummary(input: ITaxSummaryInput): ITaxSummary;
 /**
  * Computes all document-level totals in one call: SubTotal, TaxTotal,
  * TaxSummary, Round, and Total.
@@ -160,7 +160,7 @@ export declare function computeTaxSummary(input: ITaxSummaryInput): ITaxSummary;
  *
  * @example
  * // India GST invoice with 2 lines
- * const totals = computeDocumentTotals({
+ * const totals = ComputeDocumentTotals({
  *     Lines: [
  *         { NetAmt: 5000, Taxes: [{ Code: "CGST", Rate: 9, Amt: 450, TaxCodeId: 1 },
  *                                  { Code: "SGST", Rate: 9, Amt: 450, TaxCodeId: 1 }] },
@@ -179,7 +179,7 @@ export declare function computeTaxSummary(input: ITaxSummaryInput): ITaxSummary;
  * //   ]
  * // }
  */
-export declare function computeDocumentTotals(input: IDocumentTotalsInput): IDocumentTotals;
+export declare function ComputeDocumentTotals(input: IDocumentTotalsInput): IDocumentTotals;
 /**
  * Determines Intra-State or Inter-State based on seller and buyer state codes.
  *
@@ -193,11 +193,11 @@ export declare function computeDocumentTotals(input: IDocumentTotalsInput): IDoc
  * @returns "Intra" if same state, "Inter" if different states, "Unknown" if data missing
  *
  * @example
- * determineSupplyType("29", "29"); // "Intra" — both Karnataka
- * determineSupplyType("29", "33"); // "Inter" — Karnataka to Tamil Nadu
- * determineSupplyType("", "33");   // "Unknown" — seller state missing
+ * DetermineSupplyType("29", "29"); // "Intra" — both Karnataka
+ * DetermineSupplyType("29", "33"); // "Inter" — Karnataka to Tamil Nadu
+ * DetermineSupplyType("", "33");   // "Unknown" — seller state missing
  */
-export declare function determineSupplyType(sellerStateCode: string, buyerStateCode: string): ResolvedSupplyType;
+export declare function DetermineSupplyType(sellerStateCode: string, buyerStateCode: string): ResolvedSupplyType;
 /**
  * Finds a TaxCode by combined rate and supply type.
  *
@@ -212,9 +212,9 @@ export declare function determineSupplyType(sellerStateCode: string, buyerStateC
  *
  * @example
  * // Find GST 18% Inter-State (simple percentage-only tax code)
- * const interCode = findTaxCodeByRateAndSupplyType(allTaxCodes, 18, "Inter");
+ * const interCode = FindTaxCodeByRateAndSupplyType(allTaxCodes, 18, "Inter");
  */
-export declare function findTaxCodeByRateAndSupplyType(taxCodes: ITaxCode[], combinedRate: number, supplyType: "Intra" | "Inter"): ITaxCode | undefined;
+export declare function FindTaxCodeByRateAndSupplyType(taxCodes: ITaxCode[], combinedRate: number, supplyType: "Intra" | "Inter"): ITaxCode | undefined;
 /**
  * Rounds a number according to the specified rounding configuration.
  *
@@ -223,7 +223,7 @@ export declare function findTaxCodeByRateAndSupplyType(taxCodes: ITaxCode[], com
  * - Japan: truncate (floor) to whole numbers
  * - Some EU countries: banker's rounding
  */
-export declare function roundAmount(value: number, config: IRoundingConfig): number;
+export declare function RoundAmount(value: number, config: IRoundingConfig): number;
 /**
  * Validates a tax identification number against the regime's format regex.
  *
@@ -233,10 +233,10 @@ export declare function roundAmount(value: number, config: IRoundingConfig): num
  *
  * @example
  * // Validate Indian GSTIN
- * validateTaxId("29ABCDE1234F1Z5", "^[0-9]{2}[A-Z]{5}[0-9]{4}[A-Z]{1}[1-9A-Z]{1}Z[0-9A-Z]{1}$");
+ * ValidateTaxId("29ABCDE1234F1Z5", "^[0-9]{2}[A-Z]{5}[0-9]{4}[A-Z]{1}[1-9A-Z]{1}Z[0-9A-Z]{1}$");
  * // Returns: true
  */
-export declare function validateTaxId(taxId: string, formatRegex: string): boolean;
+export declare function ValidateTaxId(taxId: string, formatRegex: string): boolean;
 /**
  * Validates HSN/SAC code length against entity settings.
  *
@@ -245,10 +245,52 @@ export declare function validateTaxId(taxId: string, formatRegex: string): boole
  * @returns true if valid, false if invalid
  *
  * @example
- * validateHSNSACLength("8471", "4"); // true
- * validateHSNSACLength("8471", "6"); // false — needs 6 digits
+ * ValidateHSNSACLength("8471", "4"); // true
+ * ValidateHSNSACLength("8471", "6"); // false — needs 6 digits
  */
-export declare function validateHSNSACLength(code: string, requiredLength: string): boolean;
+export declare function ValidateHSNSACLength(code: string, requiredLength: string): boolean;
+/**
+ * Returns default TaxIdLabels for a given country.
+ *
+ * Used as seed data when creating TaxRegime records. The returned array is
+ * stored on TaxRegime.Features.TaxIdLabels[], which becomes the source of truth.
+ * At runtime, UI reads TaxIdLabels from TaxRegime — NOT from this function.
+ *
+ * @param country - ISO 3166-1 alpha-2 country code ("IN", "AU", "US", etc.)
+ * @returns Array of ITaxIdLabel — default tax ID definitions for the country
+ *
+ * @example
+ * // When seeding India GST regime:
+ * const labels = GetDefaultTaxIdLabels("IN");
+ * // Returns: [
+ * //   { Label: "GSTIN", Primary: true, Required: false, RegexValidate: "..." },
+ * //   { Label: "PAN",   Primary: false, Required: true,  RegexValidate: "..." },
+ * //   { Label: "CIN",   Primary: false, Required: false },
+ * // ]
+ */
+export declare function GetDefaultTaxIdLabels(country: string): ITaxIdLabel[];
+/**
+ * Filters TaxIds[] entries to only those marked for printing.
+ *
+ * Print logic: include if `Print` is `true` or `undefined` (default = print).
+ * Exclude only when `Print` is explicitly `false`.
+ *
+ * Used by invoice/PDF templates to determine which entity and
+ * customer/vendor tax IDs to render.
+ *
+ * @param taxIds - The TaxIds[] array from Entity Settings, Customer, or Vendor
+ * @returns Filtered array of printable entries
+ *
+ * @example
+ * const entityTaxIds = [
+ *     { Label: "GSTIN", Value: "29ABCDE1234F1Z5", Print: true },
+ *     { Label: "PAN", Value: "ABCDE1234F", Print: false },
+ *     { Label: "CIN", Value: "U12345MH2020PTC123456" },  // Print undefined = include
+ * ];
+ * GetPrintableTaxIds(entityTaxIds);
+ * // Returns: [{ Label: "GSTIN", Value: "29ABCDE1234F1Z5" }, { Label: "CIN", Value: "U12345MH2020PTC123456" }]
+ */
+export declare function GetPrintableTaxIds(taxIds: ITaxIdEntry[] | undefined): ITaxIdEntry[];
 /**
  * Calculates a withholding tax entry.
  *
@@ -267,7 +309,7 @@ export declare function validateHSNSACLength(code: string, requiredLength: strin
  *
  * @example
  * // India GST TDS — 2% on Rs 3,00,000 taxable value
- * const tds = calculateWithholding({
+ * const tds = CalculateWithholding({
  *     Type: "Deducted",
  *     Section: "51",
  *     Rate: 2,
@@ -278,7 +320,7 @@ export declare function validateHSNSACLength(code: string, requiredLength: strin
  *
  * @example
  * // India GST TCS — 1% on Rs 5,00,000 net value
- * const tcs = calculateWithholding({
+ * const tcs = CalculateWithholding({
  *     Type: "Collected",
  *     Section: "52",
  *     Rate: 1,
@@ -289,7 +331,7 @@ export declare function validateHSNSACLength(code: string, requiredLength: strin
  *
  * @example
  * // US Federal Withholding — 24% backup withholding
- * const wht = calculateWithholding({
+ * const wht = CalculateWithholding({
  *     Type: "Deducted",
  *     Section: "FITW",
  *     Rate: 24,
@@ -298,7 +340,7 @@ export declare function validateHSNSACLength(code: string, requiredLength: strin
  * });
  * // Returns: { Type: "Deducted", Section: "FITW", Rate: 24, BaseAmt: 10000, Amt: 2400, PartyLiable: "Buyer" }
  */
-export declare function calculateWithholding(input: IWithholdingCalcInput, rounding?: IRoundingConfig): IWithholding;
+export declare function CalculateWithholding(input: IWithholdingCalcInput, rounding?: IRoundingConfig): IWithholding;
 /**
  * Converts legacy flat CGST/SGST/IGST fields to a Taxes[] array.
  *
@@ -310,12 +352,12 @@ export declare function calculateWithholding(input: IWithholdingCalcInput, round
  * @returns Array of ITaxComponent
  *
  * @example
- * const taxes = convertFlatToTaxes(
+ * const taxes = ConvertFlatToTaxes(
  *     { CGST: 450, SGST: 450, IGST: 0, TCode: 106, NetAmt: 5000 },
  *     gst18IntraTaxCode
  * );
  */
-export declare function convertFlatToTaxes(lineItem: {
+export declare function ConvertFlatToTaxes(lineItem: {
     CGST?: number;
     SGST?: number;
     IGST?: number;

package/dist/tax/tax-calculator.js

@@ -19,18 +19,20 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.calculateLineTax = calculateLineTax;
-exports.extractNetFromInclusive = extractNetFromInclusive;
-exports.sumTaxComponents = sumTaxComponents;
-exports.computeTaxSummary = computeTaxSummary;
-exports.computeDocumentTotals = computeDocumentTotals;
-exports.determineSupplyType = determineSupplyType;
-exports.findTaxCodeByRateAndSupplyType = findTaxCodeByRateAndSupplyType;
-exports.roundAmount = roundAmount;
-exports.validateTaxId = validateTaxId;
-exports.validateHSNSACLength = validateHSNSACLength;
-exports.calculateWithholding = calculateWithholding;
-exports.convertFlatToTaxes = convertFlatToTaxes;
+exports.CalculateLineTax = CalculateLineTax;
+exports.ExtractNetFromInclusive = ExtractNetFromInclusive;
+exports.SumTaxComponents = SumTaxComponents;
+exports.ComputeTaxSummary = ComputeTaxSummary;
+exports.ComputeDocumentTotals = ComputeDocumentTotals;
+exports.DetermineSupplyType = DetermineSupplyType;
+exports.FindTaxCodeByRateAndSupplyType = FindTaxCodeByRateAndSupplyType;
+exports.RoundAmount = RoundAmount;
+exports.ValidateTaxId = ValidateTaxId;
+exports.ValidateHSNSACLength = ValidateHSNSACLength;
+exports.GetDefaultTaxIdLabels = GetDefaultTaxIdLabels;
+exports.GetPrintableTaxIds = GetPrintableTaxIds;
+exports.CalculateWithholding = CalculateWithholding;
+exports.ConvertFlatToTaxes = ConvertFlatToTaxes;
 const big_js_1 = __importDefault(require("big.js"));
 const util_1 = require("../shared/util");
 const math_operations_1 = require("../shared/math-operations");
@@ -49,7 +51,7 @@ const math_operations_1 = require("../shared/math-operations");
  *
  * @example
  * // India GST 18% Intra-State on Rs 5,000 item
- * const result = calculateLineTax({
+ * const result = CalculateLineTax({
  *     NetAmt: 5000,
  *     TaxCode: gst18IntraTaxCode,
  * });
@@ -60,7 +62,7 @@ const math_operations_1 = require("../shared/math-operations");
  *
  * @example
  * // India GST 28% + Specific Cess (Rs 12/liter) on 100 liters
- * const result = calculateLineTax({
+ * const result = CalculateLineTax({
  *     NetAmt: 10000,
  *     Qty: 100,
  *     TaxCode: gst28CessDrinkTaxCode,
@@ -71,7 +73,7 @@ const math_operations_1 = require("../shared/math-operations");
  * //   { Code: "CESS", Rate: 0,  Amt: 1200, TaxCodeId: 201 },
  * // ]
  */
-function calculateLineTax(input, rounding = { Method: "Round", Precision: 2 }) {
+function CalculateLineTax(input, rounding = { Method: "Round", Precision: 2 }) {
     const { TaxCode, RCM, ComponentOverrides } = input;
     const netAmt = (0, util_1.GetNumber)(input.NetAmt);
     const qty = (0, util_1.GetNumber)(input.Qty, 1);
@@ -95,21 +97,21 @@ function calculateLineTax(input, rounding = { Method: "Round", Precision: 2 }) {
     for (const comp of TaxCode.Components) {
         if (comp.AppliedOn !== "PostTax") {
             // Apply ComponentOverrides if provided (e.g., CESS Rate/PerUnitAmt from item master)
-            const effectiveComp = applyComponentOverride(comp, ComponentOverrides);
-            const calculated = calculateSingleComponent(effectiveComp, netAmt, qty, lineRounding);
+            const effectiveComp = ApplyComponentOverride(comp, ComponentOverrides);
+            const calculated = CalculateSingleComponent(effectiveComp, netAmt, qty, lineRounding);
             if (comp.Type === "Tax") {
                 primaryTaxTotal = (0, math_operations_1.Add)(primaryTaxTotal, calculated.Amt);
             }
-            result.push(buildTaxComponent(effectiveComp, calculated.Amt, TaxCode._id));
+            result.push(BuildTaxComponent(effectiveComp, calculated.Amt, TaxCode._id));
         }
     }
     // Second pass: calculate components that apply on PostTax (tax-on-tax)
     for (const comp of TaxCode.Components) {
         if (comp.AppliedOn === "PostTax") {
-            const effectiveComp = applyComponentOverride(comp, ComponentOverrides);
+            const effectiveComp = ApplyComponentOverride(comp, ComponentOverrides);
             const postTaxBase = (0, math_operations_1.Add)(netAmt, primaryTaxTotal);
-            const calculated = calculateSingleComponent(effectiveComp, postTaxBase, qty, lineRounding);
-            result.push(buildTaxComponent(effectiveComp, calculated.Amt, TaxCode._id));
+            const calculated = CalculateSingleComponent(effectiveComp, postTaxBase, qty, lineRounding);
+            result.push(BuildTaxComponent(effectiveComp, calculated.Amt, TaxCode._id));
         }
     }
     return result;
@@ -123,7 +125,7 @@ function calculateLineTax(input, rounding = { Method: "Round", Precision: 2 }) {
  * Primary use case: CESS components where the TaxCode has placeholder values
  * (Rate: 0, PerUnitAmt: 0) and the actual values come from the item master.
  */
-function applyComponentOverride(comp, overrides) {
+function ApplyComponentOverride(comp, overrides) {
     var _a, _b, _c;
     if (!overrides)
         return comp;
@@ -144,7 +146,7 @@ function applyComponentOverride(comp, overrides) {
  * MaxOfPercentOrPerUnit is used for India CESS on tobacco categories where
  * the cess is "X% or ₹Y per unit, whichever is higher" (CBIC notification).
  */
-function calculateSingleComponent(comp, baseAmt, qty, rounding) {
+function CalculateSingleComponent(comp, baseAmt, qty, rounding) {
     const method = comp.CalcMethod || "Percent";
     let amt = 0;
     let taxableAmt = baseAmt;
@@ -183,7 +185,7 @@ function calculateSingleComponent(comp, baseAmt, qty, rounding) {
         }
     }
     // Apply rounding
-    amt = roundAmount(amt, rounding);
+    amt = RoundAmount(amt, rounding);
     return { Amt: amt, taxableAmt };
 }
 /**
@@ -201,7 +203,7 @@ function calculateSingleComponent(comp, baseAmt, qty, rounding) {
  * TaxableAmt is NOT stored — it's derivable from line item fields (Qty × UnitPrice - Discount).
  * TaxAmt (sum of Taxes[].Amt) is NOT stored — it's a simple addition, computed on the fly.
  */
-function buildTaxComponent(comp, amt, taxCodeId) {
+function BuildTaxComponent(comp, amt, taxCodeId) {
     const result = {
         Code: comp.Code,
         Rate: comp.Rate,
@@ -222,7 +224,7 @@ function buildTaxComponent(comp, amt, taxCodeId) {
     }
     return result;
 }
-function extractNetFromInclusive(inclusivePrice, taxCode, qty = 1, rounding = { Method: "Round", Precision: 2 }) {
+function ExtractNetFromInclusive(inclusivePrice, taxCode, qty = 1, rounding = { Method: "Round", Precision: 2 }) {
     if (!taxCode.Components || taxCode.Components.length === 0) {
         return { NetAmt: inclusivePrice };
     }
@@ -262,10 +264,10 @@ function extractNetFromInclusive(inclusivePrice, taxCode, qty = 1, rounding = {
     let netAmt;
     if (totalPercentRate > 0) {
         const divisor = new big_js_1.default(1).plus(new big_js_1.default(totalPercentRate).div(100));
-        netAmt = roundAmount(new big_js_1.default(priceAfterFixedDeduction).div(divisor).toNumber(), rounding);
+        netAmt = RoundAmount(new big_js_1.default(priceAfterFixedDeduction).div(divisor).toNumber(), rounding);
     }
     else {
-        netAmt = roundAmount(priceAfterFixedDeduction, rounding);
+        netAmt = RoundAmount(priceAfterFixedDeduction, rounding);
     }
     return { NetAmt: netAmt, Warning: warning };
 }
@@ -279,10 +281,10 @@ function extractNetFromInclusive(inclusivePrice, taxCode, qty = 1, rounding = {
  * @returns Total tax amount
  *
  * @example
- * const totalTax = sumTaxComponents(lineItem.Taxes);
+ * const totalTax = SumTaxComponents(lineItem.Taxes);
  * // CGST 450 + SGST 450 = 900
  */
-function sumTaxComponents(taxes) {
+function SumTaxComponents(taxes) {
     if (!taxes || taxes.length === 0)
         return 0;
     let total = 0;
@@ -306,13 +308,13 @@ function sumTaxComponents(taxes) {
  *
  * Rounding behavior (via input.Rounding):
  *   - TaxComponentTotal ON: each bucket's Amt is rounded to Precision
- *   - Otherwise: Amts are at currency precision (from calculateLineTax)
+ *   - Otherwise: Amts are at currency precision (from CalculateLineTax)
  *
  * @param input - All line items with Taxes[] and NetAmt, plus regime code and optional rounding
  * @returns ITaxSummary — the aggregated summary (stored on the document)
  *
  * @example
- * const summary = computeTaxSummary({
+ * const summary = ComputeTaxSummary({
  *     Lines: invoice.Items.map(item => ({
  *         Taxes: item.Taxes,
  *         NetAmt: item.UnAmt - item.Disc - item.RecDisc,
@@ -330,7 +332,7 @@ function sumTaxComponents(taxes) {
  * //   RegimeCode: "IN_GST"
  * // }
  */
-function computeTaxSummary(input) {
+function ComputeTaxSummary(input) {
     const { Lines, RegimeCode, Rounding } = input;
     // Group by Code+Rate (more granular than Code-only for rate-wise reporting)
     const groupMap = new Map();
@@ -370,7 +372,7 @@ function computeTaxSummary(input) {
         let amt = group.Amt;
         // If TaxComponentTotal rounding is active, round each bucket's Amt
         if (Rounding === null || Rounding === void 0 ? void 0 : Rounding.TaxComponentTotal) {
-            amt = roundAmount(amt, { Method: Rounding.Method, Precision: Rounding.Precision });
+            amt = RoundAmount(amt, { Method: Rounding.Method, Precision: Rounding.Precision });
         }
         summaryLines.push({
             Code: group.Code,
@@ -414,7 +416,7 @@ function computeTaxSummary(input) {
  *
  * @example
  * // India GST invoice with 2 lines
- * const totals = computeDocumentTotals({
+ * const totals = ComputeDocumentTotals({
  *     Lines: [
  *         { NetAmt: 5000, Taxes: [{ Code: "CGST", Rate: 9, Amt: 450, TaxCodeId: 1 },
  *                                  { Code: "SGST", Rate: 9, Amt: 450, TaxCodeId: 1 }] },
@@ -433,7 +435,7 @@ function computeTaxSummary(input) {
  * //   ]
  * // }
  */
-function computeDocumentTotals(input) {
+function ComputeDocumentTotals(input) {
     const { Lines, Rounding, RegimeCode } = input;
     // 1. SubTotal = sum of line NetAmts
     let subTotal = 0;
@@ -441,7 +443,7 @@ function computeDocumentTotals(input) {
         subTotal = (0, math_operations_1.Add)(subTotal, (0, util_1.GetNumber)(line.NetAmt));
     }
     // 2. TaxSummary (handles TaxComponentTotal rounding internally)
-    const taxSummary = computeTaxSummary({
+    const taxSummary = ComputeTaxSummary({
         Lines,
         RegimeCode,
         Rounding,
@@ -454,7 +456,7 @@ function computeDocumentTotals(input) {
     let roundedTotal = grandTotal;
     let roundAdj = 0;
     if (Rounding.DocTotal !== false) { // default true
-        roundedTotal = roundAmount(grandTotal, { Method: Rounding.Method, Precision: Rounding.Precision });
+        roundedTotal = RoundAmount(grandTotal, { Method: Rounding.Method, Precision: Rounding.Precision });
         roundAdj = (0, math_operations_1.Subtract)(roundedTotal, grandTotal);
     }
     return {
@@ -482,11 +484,11 @@ function computeDocumentTotals(input) {
  * @returns "Intra" if same state, "Inter" if different states, "Unknown" if data missing
  *
  * @example
- * determineSupplyType("29", "29"); // "Intra" — both Karnataka
- * determineSupplyType("29", "33"); // "Inter" — Karnataka to Tamil Nadu
- * determineSupplyType("", "33");   // "Unknown" — seller state missing
+ * DetermineSupplyType("29", "29"); // "Intra" — both Karnataka
+ * DetermineSupplyType("29", "33"); // "Inter" — Karnataka to Tamil Nadu
+ * DetermineSupplyType("", "33");   // "Unknown" — seller state missing
  */
-function determineSupplyType(sellerStateCode, buyerStateCode) {
+function DetermineSupplyType(sellerStateCode, buyerStateCode) {
     if (!sellerStateCode || !buyerStateCode) {
         return "Unknown";
     }
@@ -506,9 +508,9 @@ function determineSupplyType(sellerStateCode, buyerStateCode) {
  *
  * @example
  * // Find GST 18% Inter-State (simple percentage-only tax code)
- * const interCode = findTaxCodeByRateAndSupplyType(allTaxCodes, 18, "Inter");
+ * const interCode = FindTaxCodeByRateAndSupplyType(allTaxCodes, 18, "Inter");
  */
-function findTaxCodeByRateAndSupplyType(taxCodes, combinedRate, supplyType) {
+function FindTaxCodeByRateAndSupplyType(taxCodes, combinedRate, supplyType) {
     return taxCodes.find(tc => tc.IsActive &&
         tc.CombinedRate === combinedRate &&
         (tc.SupplyType === supplyType || tc.SupplyType === "All"));
@@ -524,7 +526,7 @@ function findTaxCodeByRateAndSupplyType(taxCodes, combinedRate, supplyType) {
  * - Japan: truncate (floor) to whole numbers
  * - Some EU countries: banker's rounding
  */
-function roundAmount(value, config) {
+function RoundAmount(value, config) {
     var _a;
     const precision = (_a = config.Precision) !== null && _a !== void 0 ? _a : 2;
     const big = new big_js_1.default((0, util_1.GetNumber)(value));
@@ -553,10 +555,10 @@ function roundAmount(value, config) {
  *
  * @example
  * // Validate Indian GSTIN
- * validateTaxId("29ABCDE1234F1Z5", "^[0-9]{2}[A-Z]{5}[0-9]{4}[A-Z]{1}[1-9A-Z]{1}Z[0-9A-Z]{1}$");
+ * ValidateTaxId("29ABCDE1234F1Z5", "^[0-9]{2}[A-Z]{5}[0-9]{4}[A-Z]{1}[1-9A-Z]{1}Z[0-9A-Z]{1}$");
  * // Returns: true
  */
-function validateTaxId(taxId, formatRegex) {
+function ValidateTaxId(taxId, formatRegex) {
     if (!taxId || !formatRegex)
         return false;
     try {
@@ -575,10 +577,10 @@ function validateTaxId(taxId, formatRegex) {
  * @returns true if valid, false if invalid
  *
  * @example
- * validateHSNSACLength("8471", "4"); // true
- * validateHSNSACLength("8471", "6"); // false — needs 6 digits
+ * ValidateHSNSACLength("8471", "4"); // true
+ * ValidateHSNSACLength("8471", "6"); // false — needs 6 digits
  */
-function validateHSNSACLength(code, requiredLength) {
+function ValidateHSNSACLength(code, requiredLength) {
     if (!code)
         return false;
     const trimmed = code.trim();
@@ -587,6 +589,79 @@ function validateHSNSACLength(code, requiredLength) {
         return false;
     return trimmed.length >= len;
 }
+/**
+ * Returns default TaxIdLabels for a given country.
+ *
+ * Used as seed data when creating TaxRegime records. The returned array is
+ * stored on TaxRegime.Features.TaxIdLabels[], which becomes the source of truth.
+ * At runtime, UI reads TaxIdLabels from TaxRegime — NOT from this function.
+ *
+ * @param country - ISO 3166-1 alpha-2 country code ("IN", "AU", "US", etc.)
+ * @returns Array of ITaxIdLabel — default tax ID definitions for the country
+ *
+ * @example
+ * // When seeding India GST regime:
+ * const labels = GetDefaultTaxIdLabels("IN");
+ * // Returns: [
+ * //   { Label: "GSTIN", Primary: true, Required: false, RegexValidate: "..." },
+ * //   { Label: "PAN",   Primary: false, Required: true,  RegexValidate: "..." },
+ * //   { Label: "CIN",   Primary: false, Required: false },
+ * // ]
+ */
+function GetDefaultTaxIdLabels(country) {
+    switch (country) {
+        case "IN": return [
+            { Label: "GSTIN", Required: false, Primary: true, RegexValidate: "^[0-9]{2}[A-Z]{5}[0-9]{4}[A-Z]{1}[1-9A-Z]{1}Z[0-9A-Z]{1}$" },
+            { Label: "PAN", Required: true, Primary: false, RegexValidate: "^[A-Z]{5}[0-9]{4}[A-Z]{1}$" },
+            { Label: "CIN", Required: false, Primary: false },
+        ];
+        case "AU": return [
+            { Label: "ABN", Required: true, Primary: true, RegexValidate: "^[0-9]{11}$" },
+        ];
+        case "US": return [
+            { Label: "EIN", Required: false, Primary: true, RegexValidate: "^[0-9]{2}-[0-9]{7}$" },
+        ];
+        case "GB": return [
+            { Label: "VAT No", Required: true, Primary: true, RegexValidate: "^GB[0-9]{9}$" },
+        ];
+        case "AE": return [
+            { Label: "TRN", Required: true, Primary: true, RegexValidate: "^[0-9]{15}$" },
+        ];
+        case "CA": return [
+            { Label: "BN", Required: true, Primary: true },
+            { Label: "GST/HST No", Required: false, Primary: false },
+        ];
+        default: return [
+            { Label: "Tax ID", Required: false, Primary: true },
+        ];
+    }
+}
+/**
+ * Filters TaxIds[] entries to only those marked for printing.
+ *
+ * Print logic: include if `Print` is `true` or `undefined` (default = print).
+ * Exclude only when `Print` is explicitly `false`.
+ *
+ * Used by invoice/PDF templates to determine which entity and
+ * customer/vendor tax IDs to render.
+ *
+ * @param taxIds - The TaxIds[] array from Entity Settings, Customer, or Vendor
+ * @returns Filtered array of printable entries
+ *
+ * @example
+ * const entityTaxIds = [
+ *     { Label: "GSTIN", Value: "29ABCDE1234F1Z5", Print: true },
+ *     { Label: "PAN", Value: "ABCDE1234F", Print: false },
+ *     { Label: "CIN", Value: "U12345MH2020PTC123456" },  // Print undefined = include
+ * ];
+ * GetPrintableTaxIds(entityTaxIds);
+ * // Returns: [{ Label: "GSTIN", Value: "29ABCDE1234F1Z5" }, { Label: "CIN", Value: "U12345MH2020PTC123456" }]
+ */
+function GetPrintableTaxIds(taxIds) {
+    if (!taxIds || taxIds.length === 0)
+        return [];
+    return taxIds.filter(t => t.Print !== false);
+}
 // ============================================================
 // Withholding Tax — Generic TDS/TCS for all countries
 // ============================================================
@@ -608,7 +683,7 @@ function validateHSNSACLength(code, requiredLength) {
  *
  * @example
  * // India GST TDS — 2% on Rs 3,00,000 taxable value
- * const tds = calculateWithholding({
+ * const tds = CalculateWithholding({
  *     Type: "Deducted",
  *     Section: "51",
  *     Rate: 2,
@@ -619,7 +694,7 @@ function validateHSNSACLength(code, requiredLength) {
  *
  * @example
  * // India GST TCS — 1% on Rs 5,00,000 net value
- * const tcs = calculateWithholding({
+ * const tcs = CalculateWithholding({
  *     Type: "Collected",
  *     Section: "52",
  *     Rate: 1,
@@ -630,7 +705,7 @@ function validateHSNSACLength(code, requiredLength) {
  *
  * @example
  * // US Federal Withholding — 24% backup withholding
- * const wht = calculateWithholding({
+ * const wht = CalculateWithholding({
  *     Type: "Deducted",
  *     Section: "FITW",
  *     Rate: 24,
@@ -639,10 +714,10 @@ function validateHSNSACLength(code, requiredLength) {
  * });
  * // Returns: { Type: "Deducted", Section: "FITW", Rate: 24, BaseAmt: 10000, Amt: 2400, PartyLiable: "Buyer" }
  */
-function calculateWithholding(input, rounding = { Method: "Round", Precision: 2 }) {
+function CalculateWithholding(input, rounding = { Method: "Round", Precision: 2 }) {
     const baseAmt = (0, util_1.GetNumber)(input.BaseAmt);
     const rate = (0, util_1.GetNumber)(input.Rate);
-    const amt = roundAmount((0, math_operations_1.Multiply)(baseAmt, (0, math_operations_1.Divide)(rate, 100)), rounding);
+    const amt = RoundAmount((0, math_operations_1.Multiply)(baseAmt, (0, math_operations_1.Divide)(rate, 100)), rounding);
     return {
         Type: input.Type,
         Section: input.Section,
@@ -666,12 +741,12 @@ function calculateWithholding(input, rounding = { Method: "Round", Precision: 2
  * @returns Array of ITaxComponent
  *
  * @example
- * const taxes = convertFlatToTaxes(
+ * const taxes = ConvertFlatToTaxes(
  *     { CGST: 450, SGST: 450, IGST: 0, TCode: 106, NetAmt: 5000 },
  *     gst18IntraTaxCode
  * );
  */
-function convertFlatToTaxes(lineItem, taxCode) {
+function ConvertFlatToTaxes(lineItem, taxCode) {
     var _a, _b, _c, _d, _e, _f, _g, _h, _j;
     const taxes = [];
     const netAmt = (0, util_1.GetNumber)(lineItem.NetAmt);
@@ -683,7 +758,7 @@ function convertFlatToTaxes(lineItem, taxCode) {
         const rate = (_c = (_b = (_a = taxCode === null || taxCode === void 0 ? void 0 : taxCode.Components) === null || _a === void 0 ? void 0 : _a.find(c => c.Code === "CGST")) === null || _b === void 0 ? void 0 : _b.Rate) !== null && _c !== void 0 ? _c : (netAmt > 0 ? (0, math_operations_1.Multiply)((0, math_operations_1.Divide)(cgst, netAmt), 100) : 0);
         taxes.push({
             Code: "CGST",
-            Rate: roundAmount(rate, { Method: "Round", Precision: 4 }),
+            Rate: RoundAmount(rate, { Method: "Round", Precision: 4 }),
             Amt: cgst,
             TaxCodeId: taxCodeId,
         });
@@ -692,7 +767,7 @@ function convertFlatToTaxes(lineItem, taxCode) {
         const rate = (_f = (_e = (_d = taxCode === null || taxCode === void 0 ? void 0 : taxCode.Components) === null || _d === void 0 ? void 0 : _d.find(c => c.Code === "SGST")) === null || _e === void 0 ? void 0 : _e.Rate) !== null && _f !== void 0 ? _f : (netAmt > 0 ? (0, math_operations_1.Multiply)((0, math_operations_1.Divide)(sgst, netAmt), 100) : 0);
         taxes.push({
             Code: "SGST",
-            Rate: roundAmount(rate, { Method: "Round", Precision: 4 }),
+            Rate: RoundAmount(rate, { Method: "Round", Precision: 4 }),
             Amt: sgst,
             TaxCodeId: taxCodeId,
         });
@@ -701,7 +776,7 @@ function convertFlatToTaxes(lineItem, taxCode) {
         const rate = (_j = (_h = (_g = taxCode === null || taxCode === void 0 ? void 0 : taxCode.Components) === null || _g === void 0 ? void 0 : _g.find(c => c.Code === "IGST")) === null || _h === void 0 ? void 0 : _h.Rate) !== null && _j !== void 0 ? _j : (netAmt > 0 ? (0, math_operations_1.Multiply)((0, math_operations_1.Divide)(igst, netAmt), 100) : 0);
         taxes.push({
             Code: "IGST",
-            Rate: roundAmount(rate, { Method: "Round", Precision: 4 }),
+            Rate: RoundAmount(rate, { Method: "Round", Precision: 4 }),
             Amt: igst,
             TaxCodeId: taxCodeId,
         });

package/dist/tax/tax.types.d.ts

@@ -40,8 +40,10 @@ export interface IRegimeFeatures {
     HasWithholding: boolean;
     HasHSN: boolean;
     HasSAC: boolean;
-    TaxIdLabel?: string;
-    TaxIdFormat?: string;
+    /** Tax ID field definitions for this regime.
+     *  UI reads this to build tax ID forms on Entity Settings, Customer, and Vendor screens.
+     *  Only Primary entries are shown on Customer/Vendor; all shown on Entity Settings. */
+    TaxIdLabels?: ITaxIdLabel[];
 }
 /** Rounding rules for a regime.
  *  Three rounding points control WHERE in the calculation chain rounding is applied.
@@ -326,6 +328,25 @@ export interface IDocumentTotals {
     /** Final amount: GrandTotal + Round */
     Total: number;
 }
+/** Defines a tax ID field on TaxRegime — the source of truth for what tax IDs a regime needs.
+ *  UI reads TaxRegime.Features.TaxIdLabels[] to build form fields dynamically.
+ *  Entity Settings shows all entries; Customer/Vendor shows only Primary entries. */
+export interface ITaxIdLabel {
+    /** Display label — "GSTIN", "PAN", "CIN", "ABN", "EIN", "VAT No" */
+    Label: string;
+    /** Regex pattern for format validation (e.g., "^[0-9]{2}[A-Z]{5}..." for GSTIN) */
+    RegexValidate?: string;
+    /** UI hint — should the form field be required? (not a mongoose-level required) */
+    Required?: boolean;
+    /** Show on Customer/Vendor screens too? If false/undefined, only shown on Entity Settings. */
+    Primary?: boolean;
+}
+/** A stored tax ID entry on Entity Settings, Customer, or Vendor */
+export interface ITaxIdEntry {
+    Label: string;
+    Value: string;
+    Print?: boolean;
+}
 /**
  * Tax exemption reasons — used when a line item or contact is exempt from tax.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shareneus",
-  "version": "1.5.94",
+  "version": "1.5.95",
   "description": "",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",