@lacspace/market 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lacspace
+
+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/dist/index.cjs

@@ -0,0 +1,178 @@
+'use strict';
+
+// src/index.ts
+function formatINR(amount, opts = {}) {
+  const { symbol = "\u20B9", decimals = 2 } = opts;
+  const neg = amount < 0;
+  const fixed = Math.abs(amount).toFixed(decimals);
+  const [intPart = "0", frac = ""] = fixed.split(".");
+  const last3 = intPart.slice(-3);
+  const rest = intPart.slice(0, -3);
+  const grouped = rest ? rest.replace(/\B(?=(\d{2})+(?!\d))/g, ",") + "," + last3 : last3;
+  return `${neg ? "-" : ""}${symbol}${grouped}${decimals > 0 ? "." + frac : ""}`;
+}
+function pnl(o) {
+  return (o.sell - o.buy) * o.qty;
+}
+function changePercent(current, reference) {
+  if (reference === 0) return 0;
+  return (current - reference) / reference * 100;
+}
+function pnlPercent(o) {
+  return changePercent(o.sell, o.buy);
+}
+function cagr(begin, end, years) {
+  if (begin <= 0 || years <= 0) return NaN;
+  return Math.pow(end / begin, 1 / years) - 1;
+}
+function toMillis(d) {
+  if (d instanceof Date) return d.getTime();
+  if (typeof d === "number") return d;
+  return new Date(d).getTime();
+}
+function xirr(flows, guess = 0.1) {
+  if (flows.length < 2) return NaN;
+  const cf = flows.map((f) => ({ amount: f.amount, t: toMillis(f.date) })).sort((a, b) => a.t - b.t);
+  const t0 = cf[0].t;
+  const yearFrac = (t) => (t - t0) / (365 * 24 * 3600 * 1e3);
+  const npv = (r2) => cf.reduce((s, c) => s + c.amount / Math.pow(1 + r2, yearFrac(c.t)), 0);
+  const dnpv = (r2) => cf.reduce((s, c) => {
+    const y = yearFrac(c.t);
+    return s - y * c.amount / Math.pow(1 + r2, y + 1);
+  }, 0);
+  let r = guess;
+  for (let i = 0; i < 100; i++) {
+    const f = npv(r);
+    if (Math.abs(f) < 1e-7) return r;
+    const d = dnpv(r);
+    if (d === 0) break;
+    const next = r - f / d;
+    if (!isFinite(next)) break;
+    if (Math.abs(next - r) < 1e-10) return next;
+    r = next;
+  }
+  return r;
+}
+function averagePrice(trades) {
+  let qty = 0;
+  let value = 0;
+  for (const t of trades) {
+    qty += t.qty;
+    value += t.price * t.qty;
+  }
+  return qty === 0 ? 0 : value / qty;
+}
+function positionSize(o) {
+  const riskAmount = o.capital * (o.riskPercent / 100);
+  const perShareRisk = Math.abs(o.entry - o.stop);
+  if (perShareRisk === 0) return 0;
+  return Math.floor(riskAmount / perShareRisk);
+}
+function roundToTick(price, tick = 0.05) {
+  if (tick <= 0) return price;
+  return Number((Math.round(price / tick) * tick).toFixed(4));
+}
+function circuitLimits(prevClose, percent) {
+  const delta = prevClose * (percent / 100);
+  return {
+    upper: roundToTick(prevClose + delta),
+    lower: roundToTick(prevClose - delta)
+  };
+}
+var IN_DISCOUNT_BROKER = {
+  segments: {
+    delivery: {
+      brokeragePct: 0,
+      brokerageCap: 0,
+      sttBuy: 1e-3,
+      sttSell: 1e-3,
+      exchangeTxn: 297e-7,
+      stampBuy: 15e-5,
+      dpPerScrip: 13.5
+    },
+    intraday: {
+      brokeragePct: 3e-4,
+      brokerageCap: 20,
+      sttBuy: 0,
+      sttSell: 25e-5,
+      exchangeTxn: 297e-7,
+      stampBuy: 3e-5,
+      dpPerScrip: 0
+    },
+    futures: {
+      brokeragePct: 3e-4,
+      brokerageCap: 20,
+      sttBuy: 0,
+      sttSell: 2e-4,
+      exchangeTxn: 173e-7,
+      stampBuy: 2e-5,
+      dpPerScrip: 0
+    },
+    options: {
+      brokeragePct: 0,
+      brokerageCap: 20,
+      brokerageFlat: 20,
+      sttBuy: 0,
+      sttSell: 1e-3,
+      exchangeTxn: 3503e-7,
+      stampBuy: 3e-5,
+      dpPerScrip: 0
+    }
+  },
+  sebi: 1e-6,
+  // ₹10 per crore
+  gst: 0.18
+};
+function round2(n) {
+  return Math.round(n * 100) / 100;
+}
+function legBrokerage(turnover, r) {
+  if (turnover <= 0) return 0;
+  if (r.brokerageFlat !== void 0) return r.brokerageFlat;
+  if (r.brokeragePct === 0) return 0;
+  return Math.min(turnover * r.brokeragePct, r.brokerageCap);
+}
+function charges(input, config = IN_DISCOUNT_BROKER) {
+  const r = config.segments[input.segment];
+  const buyVal = (input.buy || 0) * input.qty;
+  const sellVal = (input.sell || 0) * input.qty;
+  const turnover = buyVal + sellVal;
+  const brokerage = legBrokerage(buyVal, r) + legBrokerage(sellVal, r);
+  const stt = buyVal * r.sttBuy + sellVal * r.sttSell;
+  const exchangeTxn = turnover * r.exchangeTxn;
+  const sebi = turnover * config.sebi;
+  const stamp = buyVal * r.stampBuy;
+  const gst = (brokerage + exchangeTxn + sebi) * config.gst;
+  const dp = sellVal > 0 ? r.dpPerScrip : 0;
+  const totalCharges = brokerage + stt + exchangeTxn + sebi + stamp + gst + dp;
+  const grossPnl = sellVal - buyVal;
+  return {
+    turnover: round2(turnover),
+    brokerage: round2(brokerage),
+    stt: round2(stt),
+    exchangeTxn: round2(exchangeTxn),
+    sebi: round2(sebi),
+    stamp: round2(stamp),
+    gst: round2(gst),
+    dp: round2(dp),
+    totalCharges: round2(totalCharges),
+    grossPnl: round2(grossPnl),
+    netPnl: round2(grossPnl - totalCharges),
+    breakeven: input.qty === 0 ? 0 : round2(totalCharges / input.qty)
+  };
+}
+
+exports.IN_DISCOUNT_BROKER = IN_DISCOUNT_BROKER;
+exports.averagePrice = averagePrice;
+exports.cagr = cagr;
+exports.changePercent = changePercent;
+exports.charges = charges;
+exports.circuitLimits = circuitLimits;
+exports.formatINR = formatINR;
+exports.pnl = pnl;
+exports.pnlPercent = pnlPercent;
+exports.positionSize = positionSize;
+exports.roundToTick = roundToTick;
+exports.xirr = xirr;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["r"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * @lacspace/market\n * The money & mechanics toolkit every stock-market app re-implements.\n *\n * P&L, returns, CAGR, XIRR, tick-size rounding, circuit limits, position sizing\n * — plus a real Indian brokerage & charges calculator (STT, GST, SEBI, stamp,\n * exchange txn) with discount-broker presets.\n *\n * Zero dependencies · isomorphic · fully typed.\n */\n\n/* ------------------------------------------------------------------ *\n * Formatting\n * ------------------------------------------------------------------ */\n\nexport interface FormatMoneyOptions {\n  symbol?: string;\n  decimals?: number;\n}\n\n/**\n * Format a number in the Indian numbering system (lakh / crore grouping).\n * @example formatINR(1234567.5) // \"₹12,34,567.50\"\n */\nexport function formatINR(amount: number, opts: FormatMoneyOptions = {}): string {\n  const { symbol = \"₹\", decimals = 2 } = opts;\n  const neg = amount < 0;\n  const fixed = Math.abs(amount).toFixed(decimals);\n  const [intPart = \"0\", frac = \"\"] = fixed.split(\".\");\n  const last3 = intPart.slice(-3);\n  const rest = intPart.slice(0, -3);\n  const grouped = rest\n    ? rest.replace(/\\B(?=(\\d{2})+(?!\\d))/g, \",\") + \",\" + last3\n    : last3;\n  return `${neg ? \"-\" : \"\"}${symbol}${grouped}${decimals > 0 ? \".\" + frac : \"\"}`;\n}\n\n/* ------------------------------------------------------------------ *\n * Returns & P&L\n * ------------------------------------------------------------------ */\n\n/** Absolute profit/loss for a round-trip. */\nexport function pnl(o: { buy: number; sell: number; qty: number }): number {\n  return (o.sell - o.buy) * o.qty;\n}\n\n/** Percentage change from `reference` to `current` (e.g. LTP vs prev close). */\nexport function changePercent(current: number, reference: number): number {\n  if (reference === 0) return 0;\n  return ((current - reference) / reference) * 100;\n}\n\n/** Profit/loss as a percentage of the buy price. */\nexport function pnlPercent(o: { buy: number; sell: number }): number {\n  return changePercent(o.sell, o.buy);\n}\n\n/** Compound Annual Growth Rate as a fraction (0.15 = 15%). */\nexport function cagr(begin: number, end: number, years: number): number {\n  if (begin <= 0 || years <= 0) return NaN;\n  return Math.pow(end / begin, 1 / years) - 1;\n}\n\nexport interface CashFlow {\n  /** Negative = money out (investment), positive = money in (redemption). */\n  amount: number;\n  date: Date | string | number;\n}\n\nfunction toMillis(d: Date | string | number): number {\n  if (d instanceof Date) return d.getTime();\n  if (typeof d === \"number\") return d;\n  return new Date(d).getTime();\n}\n\n/**\n * Extended Internal Rate of Return for irregularly-spaced cash flows.\n * Returns an annualised rate as a fraction. Uses Newton–Raphson.\n * @example xirr([{amount:-10000, date:\"2024-01-01\"}, {amount:12000, date:\"2025-01-01\"}]) // ~0.20\n */\nexport function xirr(flows: CashFlow[], guess = 0.1): number {\n  if (flows.length < 2) return NaN;\n  const cf = flows\n    .map((f) => ({ amount: f.amount, t: toMillis(f.date) }))\n    .sort((a, b) => a.t - b.t);\n  const t0 = cf[0]!.t;\n  const yearFrac = (t: number) => (t - t0) / (365 * 24 * 3600 * 1000);\n  const npv = (r: number) =>\n    cf.reduce((s, c) => s + c.amount / Math.pow(1 + r, yearFrac(c.t)), 0);\n  const dnpv = (r: number) =>\n    cf.reduce((s, c) => {\n      const y = yearFrac(c.t);\n      return s - (y * c.amount) / Math.pow(1 + r, y + 1);\n    }, 0);\n\n  let r = guess;\n  for (let i = 0; i < 100; i++) {\n    const f = npv(r);\n    if (Math.abs(f) < 1e-7) return r;\n    const d = dnpv(r);\n    if (d === 0) break;\n    const next = r - f / d;\n    if (!isFinite(next)) break;\n    if (Math.abs(next - r) < 1e-10) return next;\n    r = next;\n  }\n  return r;\n}\n\n/* ------------------------------------------------------------------ *\n * Position mechanics\n * ------------------------------------------------------------------ */\n\n/** Volume-weighted average price across a set of trades. */\nexport function averagePrice(trades: { price: number; qty: number }[]): number {\n  let qty = 0;\n  let value = 0;\n  for (const t of trades) {\n    qty += t.qty;\n    value += t.price * t.qty;\n  }\n  return qty === 0 ? 0 : value / qty;\n}\n\n/**\n * Risk-based position sizing. Returns the whole-share quantity so that a stop-out\n * costs at most `riskPercent` of capital.\n * @example positionSize({ capital: 100000, riskPercent: 1, entry: 500, stop: 480 }) // 50\n */\nexport function positionSize(o: {\n  capital: number;\n  riskPercent: number;\n  entry: number;\n  stop: number;\n}): number {\n  const riskAmount = o.capital * (o.riskPercent / 100);\n  const perShareRisk = Math.abs(o.entry - o.stop);\n  if (perShareRisk === 0) return 0;\n  return Math.floor(riskAmount / perShareRisk);\n}\n\n/** Round a price to the nearest exchange tick (default ₹0.05 for NSE equity). */\nexport function roundToTick(price: number, tick = 0.05): number {\n  if (tick <= 0) return price;\n  return Number((Math.round(price / tick) * tick).toFixed(4));\n}\n\n/** Upper & lower circuit price for a given previous close and band percent. */\nexport function circuitLimits(\n  prevClose: number,\n  percent: number,\n): { upper: number; lower: number } {\n  const delta = prevClose * (percent / 100);\n  return {\n    upper: roundToTick(prevClose + delta),\n    lower: roundToTick(prevClose - delta),\n  };\n}\n\n/* ------------------------------------------------------------------ *\n * Brokerage & statutory charges (India)\n * ------------------------------------------------------------------ */\n\nexport type Segment = \"delivery\" | \"intraday\" | \"futures\" | \"options\";\n\nexport interface SegmentRates {\n  /** Brokerage as a fraction of turnover per side (0.0003 = 0.03%). */\n  brokeragePct: number;\n  /** Per-order brokerage cap (₹). */\n  brokerageCap: number;\n  /** Flat per-order brokerage (₹) — overrides the pct/cap model when set. */\n  brokerageFlat?: number;\n  sttBuy: number;\n  sttSell: number;\n  exchangeTxn: number;\n  stampBuy: number;\n  /** Depository (DP) charge per scrip on the sell leg (₹). */\n  dpPerScrip: number;\n}\n\nexport interface ChargeConfig {\n  segments: Record<Segment, SegmentRates>;\n  sebi: number;\n  gst: number;\n}\n\n/**\n * Default rates approximating an Indian discount broker (Zerodha-style) as of\n * FY2024–25. Statutory rates change — override any field via the `config`\n * argument of {@link charges} and always verify against the live rate card.\n */\nexport const IN_DISCOUNT_BROKER: ChargeConfig = {\n  segments: {\n    delivery: {\n      brokeragePct: 0,\n      brokerageCap: 0,\n      sttBuy: 0.001,\n      sttSell: 0.001,\n      exchangeTxn: 0.0000297,\n      stampBuy: 0.00015,\n      dpPerScrip: 13.5,\n    },\n    intraday: {\n      brokeragePct: 0.0003,\n      brokerageCap: 20,\n      sttBuy: 0,\n      sttSell: 0.00025,\n      exchangeTxn: 0.0000297,\n      stampBuy: 0.00003,\n      dpPerScrip: 0,\n    },\n    futures: {\n      brokeragePct: 0.0003,\n      brokerageCap: 20,\n      sttBuy: 0,\n      sttSell: 0.0002,\n      exchangeTxn: 0.0000173,\n      stampBuy: 0.00002,\n      dpPerScrip: 0,\n    },\n    options: {\n      brokeragePct: 0,\n      brokerageCap: 20,\n      brokerageFlat: 20,\n      sttBuy: 0,\n      sttSell: 0.001,\n      exchangeTxn: 0.0003503,\n      stampBuy: 0.00003,\n      dpPerScrip: 0,\n    },\n  },\n  sebi: 0.000001, // ₹10 per crore\n  gst: 0.18,\n};\n\nexport interface ChargeInput {\n  segment: Segment;\n  /** Buy price per unit. Omit / 0 for a sell-only leg. */\n  buy: number;\n  /** Sell price per unit. Omit / 0 for a buy-only leg. */\n  sell: number;\n  qty: number;\n}\n\nexport interface ChargeBreakdown {\n  turnover: number;\n  brokerage: number;\n  stt: number;\n  exchangeTxn: number;\n  sebi: number;\n  stamp: number;\n  gst: number;\n  dp: number;\n  totalCharges: number;\n  grossPnl: number;\n  netPnl: number;\n  /** Per-share price move needed just to break even on charges. */\n  breakeven: number;\n}\n\nfunction round2(n: number): number {\n  return Math.round(n * 100) / 100;\n}\n\nfunction legBrokerage(turnover: number, r: SegmentRates): number {\n  if (turnover <= 0) return 0;\n  if (r.brokerageFlat !== undefined) return r.brokerageFlat;\n  if (r.brokeragePct === 0) return 0;\n  return Math.min(turnover * r.brokeragePct, r.brokerageCap);\n}\n\n/**\n * Full brokerage + statutory charges breakdown for a trade, Indian market.\n * @example\n * charges({ segment: \"intraday\", buy: 100, sell: 102, qty: 500 });\n * // { brokerage, stt, gst, sebi, stamp, exchangeTxn, totalCharges, netPnl, breakeven, ... }\n */\nexport function charges(\n  input: ChargeInput,\n  config: ChargeConfig = IN_DISCOUNT_BROKER,\n): ChargeBreakdown {\n  const r = config.segments[input.segment];\n  const buyVal = (input.buy || 0) * input.qty;\n  const sellVal = (input.sell || 0) * input.qty;\n  const turnover = buyVal + sellVal;\n\n  const brokerage = legBrokerage(buyVal, r) + legBrokerage(sellVal, r);\n  const stt = buyVal * r.sttBuy + sellVal * r.sttSell;\n  const exchangeTxn = turnover * r.exchangeTxn;\n  const sebi = turnover * config.sebi;\n  const stamp = buyVal * r.stampBuy;\n  const gst = (brokerage + exchangeTxn + sebi) * config.gst;\n  const dp = sellVal > 0 ? r.dpPerScrip : 0;\n\n  const totalCharges = brokerage + stt + exchangeTxn + sebi + stamp + gst + dp;\n  const grossPnl = sellVal - buyVal;\n\n  return {\n    turnover: round2(turnover),\n    brokerage: round2(brokerage),\n    stt: round2(stt),\n    exchangeTxn: round2(exchangeTxn),\n    sebi: round2(sebi),\n    stamp: round2(stamp),\n    gst: round2(gst),\n    dp: round2(dp),\n    totalCharges: round2(totalCharges),\n    grossPnl: round2(grossPnl),\n    netPnl: round2(grossPnl - totalCharges),\n    breakeven: input.qty === 0 ? 0 : round2(totalCharges / input.qty),\n  };\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,126 @@
+/**
+ * @lacspace/market
+ * The money & mechanics toolkit every stock-market app re-implements.
+ *
+ * P&L, returns, CAGR, XIRR, tick-size rounding, circuit limits, position sizing
+ * — plus a real Indian brokerage & charges calculator (STT, GST, SEBI, stamp,
+ * exchange txn) with discount-broker presets.
+ *
+ * Zero dependencies · isomorphic · fully typed.
+ */
+interface FormatMoneyOptions {
+    symbol?: string;
+    decimals?: number;
+}
+/**
+ * Format a number in the Indian numbering system (lakh / crore grouping).
+ * @example formatINR(1234567.5) // "₹12,34,567.50"
+ */
+declare function formatINR(amount: number, opts?: FormatMoneyOptions): string;
+/** Absolute profit/loss for a round-trip. */
+declare function pnl(o: {
+    buy: number;
+    sell: number;
+    qty: number;
+}): number;
+/** Percentage change from `reference` to `current` (e.g. LTP vs prev close). */
+declare function changePercent(current: number, reference: number): number;
+/** Profit/loss as a percentage of the buy price. */
+declare function pnlPercent(o: {
+    buy: number;
+    sell: number;
+}): number;
+/** Compound Annual Growth Rate as a fraction (0.15 = 15%). */
+declare function cagr(begin: number, end: number, years: number): number;
+interface CashFlow {
+    /** Negative = money out (investment), positive = money in (redemption). */
+    amount: number;
+    date: Date | string | number;
+}
+/**
+ * Extended Internal Rate of Return for irregularly-spaced cash flows.
+ * Returns an annualised rate as a fraction. Uses Newton–Raphson.
+ * @example xirr([{amount:-10000, date:"2024-01-01"}, {amount:12000, date:"2025-01-01"}]) // ~0.20
+ */
+declare function xirr(flows: CashFlow[], guess?: number): number;
+/** Volume-weighted average price across a set of trades. */
+declare function averagePrice(trades: {
+    price: number;
+    qty: number;
+}[]): number;
+/**
+ * Risk-based position sizing. Returns the whole-share quantity so that a stop-out
+ * costs at most `riskPercent` of capital.
+ * @example positionSize({ capital: 100000, riskPercent: 1, entry: 500, stop: 480 }) // 50
+ */
+declare function positionSize(o: {
+    capital: number;
+    riskPercent: number;
+    entry: number;
+    stop: number;
+}): number;
+/** Round a price to the nearest exchange tick (default ₹0.05 for NSE equity). */
+declare function roundToTick(price: number, tick?: number): number;
+/** Upper & lower circuit price for a given previous close and band percent. */
+declare function circuitLimits(prevClose: number, percent: number): {
+    upper: number;
+    lower: number;
+};
+type Segment = "delivery" | "intraday" | "futures" | "options";
+interface SegmentRates {
+    /** Brokerage as a fraction of turnover per side (0.0003 = 0.03%). */
+    brokeragePct: number;
+    /** Per-order brokerage cap (₹). */
+    brokerageCap: number;
+    /** Flat per-order brokerage (₹) — overrides the pct/cap model when set. */
+    brokerageFlat?: number;
+    sttBuy: number;
+    sttSell: number;
+    exchangeTxn: number;
+    stampBuy: number;
+    /** Depository (DP) charge per scrip on the sell leg (₹). */
+    dpPerScrip: number;
+}
+interface ChargeConfig {
+    segments: Record<Segment, SegmentRates>;
+    sebi: number;
+    gst: number;
+}
+/**
+ * Default rates approximating an Indian discount broker (Zerodha-style) as of
+ * FY2024–25. Statutory rates change — override any field via the `config`
+ * argument of {@link charges} and always verify against the live rate card.
+ */
+declare const IN_DISCOUNT_BROKER: ChargeConfig;
+interface ChargeInput {
+    segment: Segment;
+    /** Buy price per unit. Omit / 0 for a sell-only leg. */
+    buy: number;
+    /** Sell price per unit. Omit / 0 for a buy-only leg. */
+    sell: number;
+    qty: number;
+}
+interface ChargeBreakdown {
+    turnover: number;
+    brokerage: number;
+    stt: number;
+    exchangeTxn: number;
+    sebi: number;
+    stamp: number;
+    gst: number;
+    dp: number;
+    totalCharges: number;
+    grossPnl: number;
+    netPnl: number;
+    /** Per-share price move needed just to break even on charges. */
+    breakeven: number;
+}
+/**
+ * Full brokerage + statutory charges breakdown for a trade, Indian market.
+ * @example
+ * charges({ segment: "intraday", buy: 100, sell: 102, qty: 500 });
+ * // { brokerage, stt, gst, sebi, stamp, exchangeTxn, totalCharges, netPnl, breakeven, ... }
+ */
+declare function charges(input: ChargeInput, config?: ChargeConfig): ChargeBreakdown;
+
+export { type CashFlow, type ChargeBreakdown, type ChargeConfig, type ChargeInput, type FormatMoneyOptions, IN_DISCOUNT_BROKER, type Segment, type SegmentRates, averagePrice, cagr, changePercent, charges, circuitLimits, formatINR, pnl, pnlPercent, positionSize, roundToTick, xirr };

package/dist/index.d.ts

@@ -0,0 +1,126 @@
+/**
+ * @lacspace/market
+ * The money & mechanics toolkit every stock-market app re-implements.
+ *
+ * P&L, returns, CAGR, XIRR, tick-size rounding, circuit limits, position sizing
+ * — plus a real Indian brokerage & charges calculator (STT, GST, SEBI, stamp,
+ * exchange txn) with discount-broker presets.
+ *
+ * Zero dependencies · isomorphic · fully typed.
+ */
+interface FormatMoneyOptions {
+    symbol?: string;
+    decimals?: number;
+}
+/**
+ * Format a number in the Indian numbering system (lakh / crore grouping).
+ * @example formatINR(1234567.5) // "₹12,34,567.50"
+ */
+declare function formatINR(amount: number, opts?: FormatMoneyOptions): string;
+/** Absolute profit/loss for a round-trip. */
+declare function pnl(o: {
+    buy: number;
+    sell: number;
+    qty: number;
+}): number;
+/** Percentage change from `reference` to `current` (e.g. LTP vs prev close). */
+declare function changePercent(current: number, reference: number): number;
+/** Profit/loss as a percentage of the buy price. */
+declare function pnlPercent(o: {
+    buy: number;
+    sell: number;
+}): number;
+/** Compound Annual Growth Rate as a fraction (0.15 = 15%). */
+declare function cagr(begin: number, end: number, years: number): number;
+interface CashFlow {
+    /** Negative = money out (investment), positive = money in (redemption). */
+    amount: number;
+    date: Date | string | number;
+}
+/**
+ * Extended Internal Rate of Return for irregularly-spaced cash flows.
+ * Returns an annualised rate as a fraction. Uses Newton–Raphson.
+ * @example xirr([{amount:-10000, date:"2024-01-01"}, {amount:12000, date:"2025-01-01"}]) // ~0.20
+ */
+declare function xirr(flows: CashFlow[], guess?: number): number;
+/** Volume-weighted average price across a set of trades. */
+declare function averagePrice(trades: {
+    price: number;
+    qty: number;
+}[]): number;
+/**
+ * Risk-based position sizing. Returns the whole-share quantity so that a stop-out
+ * costs at most `riskPercent` of capital.
+ * @example positionSize({ capital: 100000, riskPercent: 1, entry: 500, stop: 480 }) // 50
+ */
+declare function positionSize(o: {
+    capital: number;
+    riskPercent: number;
+    entry: number;
+    stop: number;
+}): number;
+/** Round a price to the nearest exchange tick (default ₹0.05 for NSE equity). */
+declare function roundToTick(price: number, tick?: number): number;
+/** Upper & lower circuit price for a given previous close and band percent. */
+declare function circuitLimits(prevClose: number, percent: number): {
+    upper: number;
+    lower: number;
+};
+type Segment = "delivery" | "intraday" | "futures" | "options";
+interface SegmentRates {
+    /** Brokerage as a fraction of turnover per side (0.0003 = 0.03%). */
+    brokeragePct: number;
+    /** Per-order brokerage cap (₹). */
+    brokerageCap: number;
+    /** Flat per-order brokerage (₹) — overrides the pct/cap model when set. */
+    brokerageFlat?: number;
+    sttBuy: number;
+    sttSell: number;
+    exchangeTxn: number;
+    stampBuy: number;
+    /** Depository (DP) charge per scrip on the sell leg (₹). */
+    dpPerScrip: number;
+}
+interface ChargeConfig {
+    segments: Record<Segment, SegmentRates>;
+    sebi: number;
+    gst: number;
+}
+/**
+ * Default rates approximating an Indian discount broker (Zerodha-style) as of
+ * FY2024–25. Statutory rates change — override any field via the `config`
+ * argument of {@link charges} and always verify against the live rate card.
+ */
+declare const IN_DISCOUNT_BROKER: ChargeConfig;
+interface ChargeInput {
+    segment: Segment;
+    /** Buy price per unit. Omit / 0 for a sell-only leg. */
+    buy: number;
+    /** Sell price per unit. Omit / 0 for a buy-only leg. */
+    sell: number;
+    qty: number;
+}
+interface ChargeBreakdown {
+    turnover: number;
+    brokerage: number;
+    stt: number;
+    exchangeTxn: number;
+    sebi: number;
+    stamp: number;
+    gst: number;
+    dp: number;
+    totalCharges: number;
+    grossPnl: number;
+    netPnl: number;
+    /** Per-share price move needed just to break even on charges. */
+    breakeven: number;
+}
+/**
+ * Full brokerage + statutory charges breakdown for a trade, Indian market.
+ * @example
+ * charges({ segment: "intraday", buy: 100, sell: 102, qty: 500 });
+ * // { brokerage, stt, gst, sebi, stamp, exchangeTxn, totalCharges, netPnl, breakeven, ... }
+ */
+declare function charges(input: ChargeInput, config?: ChargeConfig): ChargeBreakdown;
+
+export { type CashFlow, type ChargeBreakdown, type ChargeConfig, type ChargeInput, type FormatMoneyOptions, IN_DISCOUNT_BROKER, type Segment, type SegmentRates, averagePrice, cagr, changePercent, charges, circuitLimits, formatINR, pnl, pnlPercent, positionSize, roundToTick, xirr };

package/dist/index.js

@@ -0,0 +1,165 @@
+// src/index.ts
+function formatINR(amount, opts = {}) {
+  const { symbol = "\u20B9", decimals = 2 } = opts;
+  const neg = amount < 0;
+  const fixed = Math.abs(amount).toFixed(decimals);
+  const [intPart = "0", frac = ""] = fixed.split(".");
+  const last3 = intPart.slice(-3);
+  const rest = intPart.slice(0, -3);
+  const grouped = rest ? rest.replace(/\B(?=(\d{2})+(?!\d))/g, ",") + "," + last3 : last3;
+  return `${neg ? "-" : ""}${symbol}${grouped}${decimals > 0 ? "." + frac : ""}`;
+}
+function pnl(o) {
+  return (o.sell - o.buy) * o.qty;
+}
+function changePercent(current, reference) {
+  if (reference === 0) return 0;
+  return (current - reference) / reference * 100;
+}
+function pnlPercent(o) {
+  return changePercent(o.sell, o.buy);
+}
+function cagr(begin, end, years) {
+  if (begin <= 0 || years <= 0) return NaN;
+  return Math.pow(end / begin, 1 / years) - 1;
+}
+function toMillis(d) {
+  if (d instanceof Date) return d.getTime();
+  if (typeof d === "number") return d;
+  return new Date(d).getTime();
+}
+function xirr(flows, guess = 0.1) {
+  if (flows.length < 2) return NaN;
+  const cf = flows.map((f) => ({ amount: f.amount, t: toMillis(f.date) })).sort((a, b) => a.t - b.t);
+  const t0 = cf[0].t;
+  const yearFrac = (t) => (t - t0) / (365 * 24 * 3600 * 1e3);
+  const npv = (r2) => cf.reduce((s, c) => s + c.amount / Math.pow(1 + r2, yearFrac(c.t)), 0);
+  const dnpv = (r2) => cf.reduce((s, c) => {
+    const y = yearFrac(c.t);
+    return s - y * c.amount / Math.pow(1 + r2, y + 1);
+  }, 0);
+  let r = guess;
+  for (let i = 0; i < 100; i++) {
+    const f = npv(r);
+    if (Math.abs(f) < 1e-7) return r;
+    const d = dnpv(r);
+    if (d === 0) break;
+    const next = r - f / d;
+    if (!isFinite(next)) break;
+    if (Math.abs(next - r) < 1e-10) return next;
+    r = next;
+  }
+  return r;
+}
+function averagePrice(trades) {
+  let qty = 0;
+  let value = 0;
+  for (const t of trades) {
+    qty += t.qty;
+    value += t.price * t.qty;
+  }
+  return qty === 0 ? 0 : value / qty;
+}
+function positionSize(o) {
+  const riskAmount = o.capital * (o.riskPercent / 100);
+  const perShareRisk = Math.abs(o.entry - o.stop);
+  if (perShareRisk === 0) return 0;
+  return Math.floor(riskAmount / perShareRisk);
+}
+function roundToTick(price, tick = 0.05) {
+  if (tick <= 0) return price;
+  return Number((Math.round(price / tick) * tick).toFixed(4));
+}
+function circuitLimits(prevClose, percent) {
+  const delta = prevClose * (percent / 100);
+  return {
+    upper: roundToTick(prevClose + delta),
+    lower: roundToTick(prevClose - delta)
+  };
+}
+var IN_DISCOUNT_BROKER = {
+  segments: {
+    delivery: {
+      brokeragePct: 0,
+      brokerageCap: 0,
+      sttBuy: 1e-3,
+      sttSell: 1e-3,
+      exchangeTxn: 297e-7,
+      stampBuy: 15e-5,
+      dpPerScrip: 13.5
+    },
+    intraday: {
+      brokeragePct: 3e-4,
+      brokerageCap: 20,
+      sttBuy: 0,
+      sttSell: 25e-5,
+      exchangeTxn: 297e-7,
+      stampBuy: 3e-5,
+      dpPerScrip: 0
+    },
+    futures: {
+      brokeragePct: 3e-4,
+      brokerageCap: 20,
+      sttBuy: 0,
+      sttSell: 2e-4,
+      exchangeTxn: 173e-7,
+      stampBuy: 2e-5,
+      dpPerScrip: 0
+    },
+    options: {
+      brokeragePct: 0,
+      brokerageCap: 20,
+      brokerageFlat: 20,
+      sttBuy: 0,
+      sttSell: 1e-3,
+      exchangeTxn: 3503e-7,
+      stampBuy: 3e-5,
+      dpPerScrip: 0
+    }
+  },
+  sebi: 1e-6,
+  // ₹10 per crore
+  gst: 0.18
+};
+function round2(n) {
+  return Math.round(n * 100) / 100;
+}
+function legBrokerage(turnover, r) {
+  if (turnover <= 0) return 0;
+  if (r.brokerageFlat !== void 0) return r.brokerageFlat;
+  if (r.brokeragePct === 0) return 0;
+  return Math.min(turnover * r.brokeragePct, r.brokerageCap);
+}
+function charges(input, config = IN_DISCOUNT_BROKER) {
+  const r = config.segments[input.segment];
+  const buyVal = (input.buy || 0) * input.qty;
+  const sellVal = (input.sell || 0) * input.qty;
+  const turnover = buyVal + sellVal;
+  const brokerage = legBrokerage(buyVal, r) + legBrokerage(sellVal, r);
+  const stt = buyVal * r.sttBuy + sellVal * r.sttSell;
+  const exchangeTxn = turnover * r.exchangeTxn;
+  const sebi = turnover * config.sebi;
+  const stamp = buyVal * r.stampBuy;
+  const gst = (brokerage + exchangeTxn + sebi) * config.gst;
+  const dp = sellVal > 0 ? r.dpPerScrip : 0;
+  const totalCharges = brokerage + stt + exchangeTxn + sebi + stamp + gst + dp;
+  const grossPnl = sellVal - buyVal;
+  return {
+    turnover: round2(turnover),
+    brokerage: round2(brokerage),
+    stt: round2(stt),
+    exchangeTxn: round2(exchangeTxn),
+    sebi: round2(sebi),
+    stamp: round2(stamp),
+    gst: round2(gst),
+    dp: round2(dp),
+    totalCharges: round2(totalCharges),
+    grossPnl: round2(grossPnl),
+    netPnl: round2(grossPnl - totalCharges),
+    breakeven: input.qty === 0 ? 0 : round2(totalCharges / input.qty)
+  };
+}
+
+export { IN_DISCOUNT_BROKER, averagePrice, cagr, changePercent, charges, circuitLimits, formatINR, pnl, pnlPercent, positionSize, roundToTick, xirr };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["r"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * @lacspace/market\n * The money & mechanics toolkit every stock-market app re-implements.\n *\n * P&L, returns, CAGR, XIRR, tick-size rounding, circuit limits, position sizing\n * — plus a real Indian brokerage & charges calculator (STT, GST, SEBI, stamp,\n * exchange txn) with discount-broker presets.\n *\n * Zero dependencies · isomorphic · fully typed.\n */\n\n/* ------------------------------------------------------------------ *\n * Formatting\n * ------------------------------------------------------------------ */\n\nexport interface FormatMoneyOptions {\n  symbol?: string;\n  decimals?: number;\n}\n\n/**\n * Format a number in the Indian numbering system (lakh / crore grouping).\n * @example formatINR(1234567.5) // \"₹12,34,567.50\"\n */\nexport function formatINR(amount: number, opts: FormatMoneyOptions = {}): string {\n  const { symbol = \"₹\", decimals = 2 } = opts;\n  const neg = amount < 0;\n  const fixed = Math.abs(amount).toFixed(decimals);\n  const [intPart = \"0\", frac = \"\"] = fixed.split(\".\");\n  const last3 = intPart.slice(-3);\n  const rest = intPart.slice(0, -3);\n  const grouped = rest\n    ? rest.replace(/\\B(?=(\\d{2})+(?!\\d))/g, \",\") + \",\" + last3\n    : last3;\n  return `${neg ? \"-\" : \"\"}${symbol}${grouped}${decimals > 0 ? \".\" + frac : \"\"}`;\n}\n\n/* ------------------------------------------------------------------ *\n * Returns & P&L\n * ------------------------------------------------------------------ */\n\n/** Absolute profit/loss for a round-trip. */\nexport function pnl(o: { buy: number; sell: number; qty: number }): number {\n  return (o.sell - o.buy) * o.qty;\n}\n\n/** Percentage change from `reference` to `current` (e.g. LTP vs prev close). */\nexport function changePercent(current: number, reference: number): number {\n  if (reference === 0) return 0;\n  return ((current - reference) / reference) * 100;\n}\n\n/** Profit/loss as a percentage of the buy price. */\nexport function pnlPercent(o: { buy: number; sell: number }): number {\n  return changePercent(o.sell, o.buy);\n}\n\n/** Compound Annual Growth Rate as a fraction (0.15 = 15%). */\nexport function cagr(begin: number, end: number, years: number): number {\n  if (begin <= 0 || years <= 0) return NaN;\n  return Math.pow(end / begin, 1 / years) - 1;\n}\n\nexport interface CashFlow {\n  /** Negative = money out (investment), positive = money in (redemption). */\n  amount: number;\n  date: Date | string | number;\n}\n\nfunction toMillis(d: Date | string | number): number {\n  if (d instanceof Date) return d.getTime();\n  if (typeof d === \"number\") return d;\n  return new Date(d).getTime();\n}\n\n/**\n * Extended Internal Rate of Return for irregularly-spaced cash flows.\n * Returns an annualised rate as a fraction. Uses Newton–Raphson.\n * @example xirr([{amount:-10000, date:\"2024-01-01\"}, {amount:12000, date:\"2025-01-01\"}]) // ~0.20\n */\nexport function xirr(flows: CashFlow[], guess = 0.1): number {\n  if (flows.length < 2) return NaN;\n  const cf = flows\n    .map((f) => ({ amount: f.amount, t: toMillis(f.date) }))\n    .sort((a, b) => a.t - b.t);\n  const t0 = cf[0]!.t;\n  const yearFrac = (t: number) => (t - t0) / (365 * 24 * 3600 * 1000);\n  const npv = (r: number) =>\n    cf.reduce((s, c) => s + c.amount / Math.pow(1 + r, yearFrac(c.t)), 0);\n  const dnpv = (r: number) =>\n    cf.reduce((s, c) => {\n      const y = yearFrac(c.t);\n      return s - (y * c.amount) / Math.pow(1 + r, y + 1);\n    }, 0);\n\n  let r = guess;\n  for (let i = 0; i < 100; i++) {\n    const f = npv(r);\n    if (Math.abs(f) < 1e-7) return r;\n    const d = dnpv(r);\n    if (d === 0) break;\n    const next = r - f / d;\n    if (!isFinite(next)) break;\n    if (Math.abs(next - r) < 1e-10) return next;\n    r = next;\n  }\n  return r;\n}\n\n/* ------------------------------------------------------------------ *\n * Position mechanics\n * ------------------------------------------------------------------ */\n\n/** Volume-weighted average price across a set of trades. */\nexport function averagePrice(trades: { price: number; qty: number }[]): number {\n  let qty = 0;\n  let value = 0;\n  for (const t of trades) {\n    qty += t.qty;\n    value += t.price * t.qty;\n  }\n  return qty === 0 ? 0 : value / qty;\n}\n\n/**\n * Risk-based position sizing. Returns the whole-share quantity so that a stop-out\n * costs at most `riskPercent` of capital.\n * @example positionSize({ capital: 100000, riskPercent: 1, entry: 500, stop: 480 }) // 50\n */\nexport function positionSize(o: {\n  capital: number;\n  riskPercent: number;\n  entry: number;\n  stop: number;\n}): number {\n  const riskAmount = o.capital * (o.riskPercent / 100);\n  const perShareRisk = Math.abs(o.entry - o.stop);\n  if (perShareRisk === 0) return 0;\n  return Math.floor(riskAmount / perShareRisk);\n}\n\n/** Round a price to the nearest exchange tick (default ₹0.05 for NSE equity). */\nexport function roundToTick(price: number, tick = 0.05): number {\n  if (tick <= 0) return price;\n  return Number((Math.round(price / tick) * tick).toFixed(4));\n}\n\n/** Upper & lower circuit price for a given previous close and band percent. */\nexport function circuitLimits(\n  prevClose: number,\n  percent: number,\n): { upper: number; lower: number } {\n  const delta = prevClose * (percent / 100);\n  return {\n    upper: roundToTick(prevClose + delta),\n    lower: roundToTick(prevClose - delta),\n  };\n}\n\n/* ------------------------------------------------------------------ *\n * Brokerage & statutory charges (India)\n * ------------------------------------------------------------------ */\n\nexport type Segment = \"delivery\" | \"intraday\" | \"futures\" | \"options\";\n\nexport interface SegmentRates {\n  /** Brokerage as a fraction of turnover per side (0.0003 = 0.03%). */\n  brokeragePct: number;\n  /** Per-order brokerage cap (₹). */\n  brokerageCap: number;\n  /** Flat per-order brokerage (₹) — overrides the pct/cap model when set. */\n  brokerageFlat?: number;\n  sttBuy: number;\n  sttSell: number;\n  exchangeTxn: number;\n  stampBuy: number;\n  /** Depository (DP) charge per scrip on the sell leg (₹). */\n  dpPerScrip: number;\n}\n\nexport interface ChargeConfig {\n  segments: Record<Segment, SegmentRates>;\n  sebi: number;\n  gst: number;\n}\n\n/**\n * Default rates approximating an Indian discount broker (Zerodha-style) as of\n * FY2024–25. Statutory rates change — override any field via the `config`\n * argument of {@link charges} and always verify against the live rate card.\n */\nexport const IN_DISCOUNT_BROKER: ChargeConfig = {\n  segments: {\n    delivery: {\n      brokeragePct: 0,\n      brokerageCap: 0,\n      sttBuy: 0.001,\n      sttSell: 0.001,\n      exchangeTxn: 0.0000297,\n      stampBuy: 0.00015,\n      dpPerScrip: 13.5,\n    },\n    intraday: {\n      brokeragePct: 0.0003,\n      brokerageCap: 20,\n      sttBuy: 0,\n      sttSell: 0.00025,\n      exchangeTxn: 0.0000297,\n      stampBuy: 0.00003,\n      dpPerScrip: 0,\n    },\n    futures: {\n      brokeragePct: 0.0003,\n      brokerageCap: 20,\n      sttBuy: 0,\n      sttSell: 0.0002,\n      exchangeTxn: 0.0000173,\n      stampBuy: 0.00002,\n      dpPerScrip: 0,\n    },\n    options: {\n      brokeragePct: 0,\n      brokerageCap: 20,\n      brokerageFlat: 20,\n      sttBuy: 0,\n      sttSell: 0.001,\n      exchangeTxn: 0.0003503,\n      stampBuy: 0.00003,\n      dpPerScrip: 0,\n    },\n  },\n  sebi: 0.000001, // ₹10 per crore\n  gst: 0.18,\n};\n\nexport interface ChargeInput {\n  segment: Segment;\n  /** Buy price per unit. Omit / 0 for a sell-only leg. */\n  buy: number;\n  /** Sell price per unit. Omit / 0 for a buy-only leg. */\n  sell: number;\n  qty: number;\n}\n\nexport interface ChargeBreakdown {\n  turnover: number;\n  brokerage: number;\n  stt: number;\n  exchangeTxn: number;\n  sebi: number;\n  stamp: number;\n  gst: number;\n  dp: number;\n  totalCharges: number;\n  grossPnl: number;\n  netPnl: number;\n  /** Per-share price move needed just to break even on charges. */\n  breakeven: number;\n}\n\nfunction round2(n: number): number {\n  return Math.round(n * 100) / 100;\n}\n\nfunction legBrokerage(turnover: number, r: SegmentRates): number {\n  if (turnover <= 0) return 0;\n  if (r.brokerageFlat !== undefined) return r.brokerageFlat;\n  if (r.brokeragePct === 0) return 0;\n  return Math.min(turnover * r.brokeragePct, r.brokerageCap);\n}\n\n/**\n * Full brokerage + statutory charges breakdown for a trade, Indian market.\n * @example\n * charges({ segment: \"intraday\", buy: 100, sell: 102, qty: 500 });\n * // { brokerage, stt, gst, sebi, stamp, exchangeTxn, totalCharges, netPnl, breakeven, ... }\n */\nexport function charges(\n  input: ChargeInput,\n  config: ChargeConfig = IN_DISCOUNT_BROKER,\n): ChargeBreakdown {\n  const r = config.segments[input.segment];\n  const buyVal = (input.buy || 0) * input.qty;\n  const sellVal = (input.sell || 0) * input.qty;\n  const turnover = buyVal + sellVal;\n\n  const brokerage = legBrokerage(buyVal, r) + legBrokerage(sellVal, r);\n  const stt = buyVal * r.sttBuy + sellVal * r.sttSell;\n  const exchangeTxn = turnover * r.exchangeTxn;\n  const sebi = turnover * config.sebi;\n  const stamp = buyVal * r.stampBuy;\n  const gst = (brokerage + exchangeTxn + sebi) * config.gst;\n  const dp = sellVal > 0 ? r.dpPerScrip : 0;\n\n  const totalCharges = brokerage + stt + exchangeTxn + sebi + stamp + gst + dp;\n  const grossPnl = sellVal - buyVal;\n\n  return {\n    turnover: round2(turnover),\n    brokerage: round2(brokerage),\n    stt: round2(stt),\n    exchangeTxn: round2(exchangeTxn),\n    sebi: round2(sebi),\n    stamp: round2(stamp),\n    gst: round2(gst),\n    dp: round2(dp),\n    totalCharges: round2(totalCharges),\n    grossPnl: round2(grossPnl),\n    netPnl: round2(grossPnl - totalCharges),\n    breakeven: input.qty === 0 ? 0 : round2(totalCharges / input.qty),\n  };\n}\n"]}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@lacspace/market",
+  "version": "1.0.0",
+  "description": "Stock-market money math — P&L, returns, CAGR, XIRR, tick-size rounding, circuit limits, position sizing and an Indian brokerage & charges calculator (STT, GST, SEBI, stamp). Zero-dependency.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "stock-market",
+    "trading",
+    "brokerage-calculator",
+    "stt",
+    "pnl",
+    "xirr",
+    "cagr",
+    "position-sizing",
+    "circuit-limits",
+    "nse",
+    "bse",
+    "typescript"
+  ],
+  "author": "Lacspace <contact@lacspace.com>",
+  "license": "MIT",
+  "homepage": "https://lacspace.com/packages",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lacspace/npm-packages.git",
+    "directory": "market"
+  },
+  "bugs": {
+    "url": "https://github.com/lacspace/npm-packages/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}