@livefolio/sdk 0.4.4 → 0.5.0-rc.2

package/dist/index.js

@@ -48,6 +48,42 @@ function reconcile(targets, portfolio, prices, assets) {
   return orders;
 }
 
+// src/portfolio/ids.ts
+var _lotCounter = 0;
+function nextLotId() {
+  return `lot_${++_lotCounter}`;
+}
+
+// src/tax/holding-period.ts
+var MS_PER_DAY = 864e5;
+function holdingPeriodDays(lot, asOf) {
+  return (asOf.getTime() - lot.openDate.getTime()) / MS_PER_DAY;
+}
+function isLongTerm(days) {
+  return days > 365;
+}
+function realize(lot, qty, salePrice, asOf) {
+  if (qty <= 0) throw new RangeError(`realize: qty must be positive, got ${qty}`);
+  if (qty > lot.quantity) throw new RangeError(`realize: lot ${lot.id} has ${lot.quantity}, cannot sell ${qty}`);
+  const basisPerShare = lot.basis / lot.quantity;
+  const basis = basisPerShare * qty;
+  const proceeds = qty * salePrice;
+  const event = {
+    asset: lot.asset,
+    lotId: lot.id,
+    quantity: qty,
+    openDate: lot.openDate,
+    closeDate: asOf,
+    proceeds,
+    basis,
+    termType: isLongTerm(holdingPeriodDays(lot, asOf)) ? "long" : "short",
+    gain: proceeds - basis,
+    incomeKind: "capital-gain"
+  };
+  const remainingLot = qty === lot.quantity ? null : { ...lot, quantity: lot.quantity - qty, basis: lot.basis - basis };
+  return { event, remainingLot };
+}
+
 // src/portfolio/apply.ts
 var newPositionId = /* @__PURE__ */ (() => {
   let n = 0;
@@ -56,10 +92,49 @@ var newPositionId = /* @__PURE__ */ (() => {
 function findOrder(orders, id) {
   return orders.find((o) => o.id === id);
 }
+function consumeLots(lots, realized, assetId, qty, price, fees, closeDate, preferLotId) {
+  const sortedLots = lots.filter((l) => l.asset.id === assetId && l.quantity > 0).sort((a, b) => {
+    if (preferLotId) {
+      if (a.id === preferLotId) return -1;
+      if (b.id === preferLotId) return 1;
+    }
+    return a.openDate.getTime() - b.openDate.getTime();
+  });
+  const held = sortedLots.reduce((s, x) => s + x.quantity, 0);
+  if (held < qty) {
+    throw new RangeError(`applyFills: cannot sell ${qty} of ${assetId} \u2014 lot ledger holds ${held}`);
+  }
+  let need = qty;
+  const totalQty = qty;
+  for (const l of sortedLots) {
+    if (need <= 0) break;
+    const take2 = Math.min(l.quantity, need);
+    const basisPerShare = l.basis / l.quantity;
+    const consumedBasis = basisPerShare * take2;
+    const proceeds = take2 * price - take2 / totalQty * fees;
+    realized.push({
+      asset: l.asset,
+      lotId: l.id,
+      quantity: take2,
+      openDate: l.openDate,
+      closeDate,
+      proceeds,
+      basis: consumedBasis,
+      termType: isLongTerm(holdingPeriodDays(l, closeDate)) ? "long" : "short",
+      gain: proceeds - consumedBasis,
+      incomeKind: "capital-gain"
+    });
+    l.quantity -= take2;
+    l.basis -= consumedBasis;
+    need -= take2;
+  }
+}
 function applyFills(portfolio, fills, orders) {
   let positions = [...portfolio.positions];
   let cash = portfolio.cash;
   let t = portfolio.t;
+  const lots = (portfolio.lots ?? []).map((l) => ({ ...l }));
+  const realized = [...portfolio.realized ?? []];
   for (const fill of fills) {
     const order = findOrder(orders, fill.orderRef);
     if (!order) {
@@ -78,6 +153,16 @@ function applyFills(portfolio, fills, orders) {
         };
         positions.push(pos);
         cash -= fill.quantity * fill.price + fill.fees;
+        if (order.side === "long") {
+          lots.push({
+            id: nextLotId(),
+            asset: order.asset,
+            quantity: fill.quantity,
+            openDate: fill.t,
+            openPrice: fill.price,
+            basis: fill.quantity * fill.price + fill.fees
+          });
+        }
         break;
       }
       case "close": {
@@ -92,6 +177,9 @@ function applyFills(portfolio, fills, orders) {
         } else {
           positions[idx] = { ...pos, quantity: remaining };
         }
+        if (pos.side === "long") {
+          consumeLots(lots, realized, pos.asset.id, fill.quantity, fill.price, fill.fees, fill.t, fill.lotId);
+        }
         break;
       }
       case "adjust": {
@@ -125,6 +213,14 @@ function applyFills(portfolio, fills, orders) {
               basis: prev.basis + cost
             };
           }
+          lots.push({
+            id: nextLotId(),
+            asset: order.asset,
+            quantity: fill.quantity,
+            openDate: fill.t,
+            openPrice: fill.price,
+            basis: cost
+          });
         } else if (idx >= 0) {
           const prev = positions[idx];
           cash += fill.quantity * fill.price - fill.fees;
@@ -139,12 +235,16 @@ function applyFills(portfolio, fills, orders) {
               basis: basisPerShare * remaining
             };
           }
+          consumeLots(lots, realized, order.asset.id, fill.quantity, fill.price, fill.fees, fill.t, fill.lotId);
         }
         break;
       }
     }
+    for (let i = lots.length - 1; i >= 0; i--) {
+      if (lots[i].quantity <= 1e-9) lots.splice(i, 1);
+    }
   }
-  return { cash, positions, t };
+  return { cash, positions, lots, realized, t };
 }
 function applyOrders(portfolio, orders) {
   let positions = [...portfolio.positions];
@@ -1037,7 +1137,7 @@ function pollingStreamFromHistorical(opts) {
 import { DateTime } from "luxon";
 
 // src/calendars/holiday-rules.ts
-var MS_PER_DAY = 864e5;
+var MS_PER_DAY2 = 864e5;
 function nthWeekdayOfMonth(year, month, weekday, n) {
   const first = new Date(Date.UTC(year, month - 1, 1));
   const offset = (weekday - first.getUTCDay() + 7) % 7;
@@ -1046,7 +1146,7 @@ function nthWeekdayOfMonth(year, month, weekday, n) {
 function lastWeekdayOfMonth(year, month, weekday) {
   const last = new Date(Date.UTC(year, month, 0));
   const offset = (last.getUTCDay() - weekday + 7) % 7;
-  return new Date(last.getTime() - offset * MS_PER_DAY);
+  return new Date(last.getTime() - offset * MS_PER_DAY2);
 }
 function easter(year) {
   const a = year % 19;
@@ -1067,8 +1167,8 @@ function easter(year) {
 }
 function observed(d) {
   const dow = d.getUTCDay();
-  if (dow === 6) return new Date(d.getTime() - MS_PER_DAY);
-  if (dow === 0) return new Date(d.getTime() + MS_PER_DAY);
+  if (dow === 6) return new Date(d.getTime() - MS_PER_DAY2);
+  if (dow === 0) return new Date(d.getTime() + MS_PER_DAY2);
   return d;
 }
 function resolveHolidays(rules, year) {
@@ -1106,21 +1206,21 @@ function resolveSpecialOpens(rules, year) {
   return out;
 }
 function sundayToMonday(d) {
-  return d.getUTCDay() === 0 ? new Date(d.getTime() + MS_PER_DAY) : d;
+  return d.getUTCDay() === 0 ? new Date(d.getTime() + MS_PER_DAY2) : d;
 }
 function nearestWorkday(d) {
   const dow = d.getUTCDay();
-  if (dow === 6) return new Date(d.getTime() - MS_PER_DAY);
-  if (dow === 0) return new Date(d.getTime() + MS_PER_DAY);
+  if (dow === 6) return new Date(d.getTime() - MS_PER_DAY2);
+  if (dow === 0) return new Date(d.getTime() + MS_PER_DAY2);
   return d;
 }
 function firstMondayOnOrAfter(year, month, day, nth = 1) {
   const start = new Date(Date.UTC(year, month - 1, day));
   const offset = (1 - start.getUTCDay() + 7) % 7;
-  return new Date(start.getTime() + (offset + 7 * (nth - 1)) * MS_PER_DAY);
+  return new Date(start.getTime() + (offset + 7 * (nth - 1)) * MS_PER_DAY2);
 }
 function easterPlus(year, dayDelta) {
-  return new Date(easter(year).getTime() + dayDelta * MS_PER_DAY);
+  return new Date(easter(year).getTime() + dayDelta * MS_PER_DAY2);
 }
 function dropIfNotInDays(d, allowed) {
   if (d === null) return null;
@@ -1128,7 +1228,7 @@ function dropIfNotInDays(d, allowed) {
 }
 
 // src/calendars/exchange-calendar.ts
-var MS_PER_DAY2 = 864e5;
+var MS_PER_DAY3 = 864e5;
 var DEFAULT_WEEKMASK = /* @__PURE__ */ new Set([1, 2, 3, 4, 5]);
 var EMPTY_ADHOC = /* @__PURE__ */ new Map();
 function ymdKey(d) {
@@ -1289,14 +1389,14 @@ var ExchangeCalendar = class {
   }
   /** Returns the first trading day strictly after `t`. */
   next(t) {
-    let d = new Date(this.normalize(t).getTime() + MS_PER_DAY2);
-    while (!this.isOpen(d)) d = new Date(d.getTime() + MS_PER_DAY2);
+    let d = new Date(this.normalize(t).getTime() + MS_PER_DAY3);
+    while (!this.isOpen(d)) d = new Date(d.getTime() + MS_PER_DAY3);
     return d;
   }
   /** Returns the first trading day strictly before `t`. */
   previous(t) {
-    let d = new Date(this.normalize(t).getTime() - MS_PER_DAY2);
-    while (!this.isOpen(d)) d = new Date(d.getTime() - MS_PER_DAY2);
+    let d = new Date(this.normalize(t).getTime() - MS_PER_DAY3);
+    while (!this.isOpen(d)) d = new Date(d.getTime() - MS_PER_DAY3);
     return d;
   }
   /**
@@ -1309,7 +1409,7 @@ var ExchangeCalendar = class {
     const end = this.normalize(range.to).getTime();
     while (d.getTime() < end) {
       if (this.isOpen(d)) out.push(d);
-      d = new Date(d.getTime() + MS_PER_DAY2);
+      d = new Date(d.getTime() + MS_PER_DAY3);
     }
     return out;
   }
@@ -1360,7 +1460,7 @@ var ExchangeCalendar = class {
 };
 
 // src/calendars/nyse.ts
-var MS_PER_DAY3 = 864e5;
+var MS_PER_DAY4 = 864e5;
 var SUN = 0;
 var MON = 1;
 var TUE = 2;
@@ -1524,7 +1624,7 @@ var REGULAR_HOLIDAYS = [
     resolve: (y) => {
       const start = utcDate(y, 11, 2);
       const offset = (TUE - start.getUTCDay() + 7) % 7;
-      return new Date(start.getTime() + offset * MS_PER_DAY3);
+      return new Date(start.getTime() + offset * MS_PER_DAY4);
     }
   },
   // ── Veterans/Armistice Day (Nov 11, 1934-1953) ─────────────────────────────
@@ -1555,7 +1655,7 @@ var REGULAR_HOLIDAYS = [
     validUntil: 1941,
     resolve: (y) => {
       const last = lastWeekdayOfMonth(y, 11, THU);
-      return new Date(last.getTime() - 7 * MS_PER_DAY3);
+      return new Date(last.getTime() - 7 * MS_PER_DAY4);
     }
   },
   // ── Christmas ──────────────────────────────────────────────────────────────
@@ -1912,7 +2012,7 @@ function* generateSummerSaturdays() {
     const end = /* @__PURE__ */ new Date(`${to}T00:00:00.000Z`);
     while (d.getTime() <= end.getTime()) {
       if (d.getUTCDay() === SAT) yield ymd(d);
-      d = new Date(d.getTime() + MS_PER_DAY3);
+      d = new Date(d.getTime() + MS_PER_DAY4);
     }
   }
 }
@@ -1922,7 +2022,7 @@ function* generateWWIShutdown() {
   while (d.getTime() <= end.getTime()) {
     const dow = d.getUTCDay();
     if (dow !== SUN) yield ymd(d);
-    d = new Date(d.getTime() + MS_PER_DAY3);
+    d = new Date(d.getTime() + MS_PER_DAY4);
   }
 }
 var ADHOC_HOLIDAYS = /* @__PURE__ */ new Set([
@@ -1940,7 +2040,7 @@ var SPECIAL_CLOSES = [
     closeAt: { h: 13, m: 0 },
     resolve: (y) => {
       const t = nthWeekdayOfMonth(y, 11, THU, 4);
-      return new Date(t.getTime() + MS_PER_DAY3);
+      return new Date(t.getTime() + MS_PER_DAY4);
     }
   },
   {
@@ -1950,7 +2050,7 @@ var SPECIAL_CLOSES = [
     closeAt: { h: 14, m: 0 },
     resolve: (y) => {
       const t = nthWeekdayOfMonth(y, 11, THU, 4);
-      return new Date(t.getTime() + MS_PER_DAY3);
+      return new Date(t.getTime() + MS_PER_DAY4);
     }
   },
   {
@@ -2111,7 +2211,7 @@ var SPECIAL_CLOSES_ADHOC = /* @__PURE__ */ new Map([
     if (dow >= MON && dow <= FRI) {
       SPECIAL_CLOSES_ADHOC.set(ymd(d), { h: 14, m: 0 });
     }
-    d = new Date(d.getTime() + MS_PER_DAY3);
+    d = new Date(d.getTime() + MS_PER_DAY4);
   }
 })();
 (() => {
@@ -2122,7 +2222,7 @@ var SPECIAL_CLOSES_ADHOC = /* @__PURE__ */ new Map([
     if (dow >= MON && dow <= FRI) {
       SPECIAL_CLOSES_ADHOC.set(ymd(d), { h: 14, m: 0 });
     }
-    d = new Date(d.getTime() + MS_PER_DAY3);
+    d = new Date(d.getTime() + MS_PER_DAY4);
   }
 })();
 (() => {
@@ -2133,7 +2233,7 @@ var SPECIAL_CLOSES_ADHOC = /* @__PURE__ */ new Map([
     if (dow >= MON && dow <= FRI) {
       SPECIAL_CLOSES_ADHOC.set(ymd(d), { h: 14, m: 0 });
     }
-    d = new Date(d.getTime() + MS_PER_DAY3);
+    d = new Date(d.getTime() + MS_PER_DAY4);
   }
 })();
 (() => {
@@ -2144,7 +2244,7 @@ var SPECIAL_CLOSES_ADHOC = /* @__PURE__ */ new Map([
     if (dow >= MON && dow <= FRI) {
       SPECIAL_CLOSES_ADHOC.set(ymd(d), { h: 14, m: 0 });
     }
-    d = new Date(d.getTime() + MS_PER_DAY3);
+    d = new Date(d.getTime() + MS_PER_DAY4);
   }
 })();
 (() => {
@@ -2155,7 +2255,7 @@ var SPECIAL_CLOSES_ADHOC = /* @__PURE__ */ new Map([
     if (dow >= MON && dow <= FRI) {
       SPECIAL_CLOSES_ADHOC.set(ymd(d), { h: 14, m: 30 });
     }
-    d = new Date(d.getTime() + MS_PER_DAY3);
+    d = new Date(d.getTime() + MS_PER_DAY4);
   }
 })();
 (() => {
@@ -2166,7 +2266,7 @@ var SPECIAL_CLOSES_ADHOC = /* @__PURE__ */ new Map([
     if (dow >= MON && dow <= FRI) {
       SPECIAL_CLOSES_ADHOC.set(ymd(d), { h: 15, m: 0 });
     }
-    d = new Date(d.getTime() + MS_PER_DAY3);
+    d = new Date(d.getTime() + MS_PER_DAY4);
   }
 })();
 var SPECIAL_OPENS = [];
@@ -2283,7 +2383,7 @@ var NYSEExchangeCalendar = class extends ExchangeCalendar {
 };
 
 // src/calendars/lse.ts
-var MS_PER_DAY4 = 864e5;
+var MS_PER_DAY5 = 864e5;
 var SUN2 = 0;
 var MON2 = 1;
 var TUE2 = 2;
@@ -2295,14 +2395,14 @@ var WEEKDAYS_MON_FRI2 = /* @__PURE__ */ new Set([1, 2, 3, 4, 5]);
 var MON_TUE = /* @__PURE__ */ new Set([MON2, TUE2]);
 function weekendToMonday(d) {
   const dow = d.getUTCDay();
-  if (dow === SAT2) return new Date(d.getTime() + 2 * MS_PER_DAY4);
-  if (dow === SUN2) return new Date(d.getTime() + MS_PER_DAY4);
+  if (dow === SAT2) return new Date(d.getTime() + 2 * MS_PER_DAY5);
+  if (dow === SUN2) return new Date(d.getTime() + MS_PER_DAY5);
   return d;
 }
 function previousFriday(d) {
   const dow = d.getUTCDay();
-  if (dow === SAT2) return new Date(d.getTime() - MS_PER_DAY4);
-  if (dow === SUN2) return new Date(d.getTime() - 2 * MS_PER_DAY4);
+  if (dow === SAT2) return new Date(d.getTime() - MS_PER_DAY5);
+  if (dow === SUN2) return new Date(d.getTime() - 2 * MS_PER_DAY5);
   return d;
 }
 var REGULAR_HOLIDAYS2 = [
@@ -2494,7 +2594,7 @@ function getCalendar(name) {
 }
 
 // src/calendars/crypto-24x7.ts
-var MS_PER_DAY5 = 864e5;
+var MS_PER_DAY6 = 864e5;
 function midnightUtc(d) {
   return new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()));
 }
@@ -2503,10 +2603,10 @@ var Crypto24x7Calendar = class {
     return true;
   }
   next(t) {
-    return new Date(midnightUtc(t).getTime() + MS_PER_DAY5);
+    return new Date(midnightUtc(t).getTime() + MS_PER_DAY6);
   }
   previous(t) {
-    return new Date(midnightUtc(t).getTime() - MS_PER_DAY5);
+    return new Date(midnightUtc(t).getTime() - MS_PER_DAY6);
   }
   sessions(range) {
     const out = [];
@@ -2514,7 +2614,7 @@ var Crypto24x7Calendar = class {
     const end = range.to.getTime();
     while (cursor.getTime() < end) {
       out.push(cursor);
-      cursor = new Date(cursor.getTime() + MS_PER_DAY5);
+      cursor = new Date(cursor.getTime() + MS_PER_DAY6);
     }
     return out;
   }
@@ -2522,7 +2622,7 @@ var Crypto24x7Calendar = class {
     return this.sessions(range).map((date) => ({
       date,
       open: date,
-      close: new Date(date.getTime() + MS_PER_DAY5)
+      close: new Date(date.getTime() + MS_PER_DAY6)
     }));
   }
   isEarlyClose(_t) {
@@ -2966,6 +3066,196 @@ __export(features_exports, {
   sma: () => sma,
   volatility: () => volatility
 });
+
+// src/tax/index.ts
+var tax_exports = {};
+__export(tax_exports, {
+  ORDINARY_OFFSET_CAP: () => ORDINARY_OFFSET_CAP,
+  aggregateByYear: () => aggregateByYear,
+  bucketByTerm: () => bucketByTerm,
+  computeTaxBill: () => computeTaxBill,
+  crossOffset: () => crossOffset,
+  holdingPeriodDays: () => holdingPeriodDays,
+  isLongTerm: () => isLongTerm,
+  netWithinBucket: () => netWithinBucket,
+  realize: () => realize,
+  selectFIFO: () => selectFIFO,
+  selectHIFO: () => selectHIFO,
+  selectLIFO: () => selectLIFO,
+  selectMinTax: () => selectMinTax
+});
+
+// src/tax/lot-selection.ts
+function take(sorted, qty) {
+  let need = qty;
+  const out = [];
+  for (const lot of sorted) {
+    if (lot.quantity <= 0) continue;
+    if (need <= 0) break;
+    const q = Math.min(lot.quantity, need);
+    out.push({ lotId: lot.id, quantity: q });
+    need -= q;
+  }
+  if (need > 1e-9) {
+    const held = sorted.reduce((s, l) => s + Math.max(0, l.quantity), 0);
+    throw new RangeError(`lot-selection: need ${qty} but only ${held} held`);
+  }
+  return out;
+}
+function selectFIFO(lots, qty) {
+  return take(
+    [...lots].sort((a, b) => a.openDate.getTime() - b.openDate.getTime()),
+    qty
+  );
+}
+function selectLIFO(lots, qty) {
+  return take(
+    [...lots].sort((a, b) => b.openDate.getTime() - a.openDate.getTime()),
+    qty
+  );
+}
+function selectHIFO(lots, qty) {
+  return take(
+    [...lots].filter((l) => l.quantity > 0).sort((a, b) => b.basis / b.quantity - a.basis / a.quantity),
+    qty
+  );
+}
+function selectMinTax(lots, qty, ctx) {
+  const tier = (l) => {
+    const gainPerShare = ctx.price - l.basis / l.quantity;
+    const lt = isLongTerm(holdingPeriodDays(l, ctx.asOf));
+    if (gainPerShare < 0) return lt ? 0 : 1;
+    return lt ? 2 : 3;
+  };
+  const sorted = [...lots].filter((l) => l.quantity > 0).sort((a, b) => {
+    const ta = tier(a);
+    const tb = tier(b);
+    if (ta !== tb) return ta - tb;
+    const gainA = ctx.price - a.basis / a.quantity;
+    const gainB = ctx.price - b.basis / b.quantity;
+    return gainA - gainB;
+  });
+  return take(sorted, qty);
+}
+
+// src/tax/aggregation.ts
+var ORDINARY_OFFSET_CAP = 3e3;
+function bucketByTerm(events) {
+  const short = [];
+  const long = [];
+  for (const e of events) {
+    if (e.incomeKind !== "capital-gain") continue;
+    (e.termType === "long" ? long : short).push(e);
+  }
+  return { short, long };
+}
+function netWithinBucket(events) {
+  let gains = 0;
+  let losses = 0;
+  for (const e of events) {
+    if (e.gain >= 0) gains += e.gain;
+    else losses += -e.gain;
+  }
+  return { gains, losses, net: gains - losses };
+}
+function crossOffset(netShort, netLong) {
+  if (netShort >= 0 && netLong >= 0) {
+    return { taxableShort: netShort, taxableLong: netLong, ordinaryOffset: 0, carryForward: 0 };
+  }
+  if (netShort < 0 && netLong < 0) {
+    const totalLoss = -(netShort + netLong);
+    const ordinaryOffset2 = Math.min(ORDINARY_OFFSET_CAP, totalLoss);
+    return { taxableShort: 0, taxableLong: 0, ordinaryOffset: ordinaryOffset2, carryForward: totalLoss - ordinaryOffset2 };
+  }
+  const combined = netShort + netLong;
+  if (combined >= 0) {
+    const taxableShort = netShort > 0 ? combined : 0;
+    const taxableLong = netLong > 0 ? combined : 0;
+    return { taxableShort, taxableLong, ordinaryOffset: 0, carryForward: 0 };
+  }
+  const loss = -combined;
+  const ordinaryOffset = Math.min(ORDINARY_OFFSET_CAP, loss);
+  return { taxableShort: 0, taxableLong: 0, ordinaryOffset, carryForward: loss - ordinaryOffset };
+}
+function aggregateByYear(events) {
+  const out = /* @__PURE__ */ new Map();
+  const blank = () => ({
+    shortTermGains: 0,
+    shortTermLosses: 0,
+    longTermGains: 0,
+    longTermLosses: 0,
+    qualifiedDividends: 0,
+    ordinaryDividends: 0,
+    interestIncome: 0
+  });
+  for (const e of events) {
+    const year = e.closeDate.getUTCFullYear();
+    const acc = out.get(year) ?? blank();
+    switch (e.incomeKind) {
+      case "capital-gain":
+        if (e.termType === "long") {
+          if (e.gain >= 0) acc.longTermGains += e.gain;
+          else acc.longTermLosses += -e.gain;
+        } else {
+          if (e.gain >= 0) acc.shortTermGains += e.gain;
+          else acc.shortTermLosses += -e.gain;
+        }
+        break;
+      case "qualified-dividend":
+        acc.qualifiedDividends += e.proceeds;
+        break;
+      case "ordinary-dividend":
+        acc.ordinaryDividends += e.proceeds;
+        break;
+      case "interest":
+        acc.interestIncome += e.proceeds;
+        break;
+    }
+    out.set(year, acc);
+  }
+  return out;
+}
+function computeTaxBill(income, rates) {
+  const netShort = income.shortTermGains - income.shortTermLosses;
+  const netLong = income.longTermGains - income.longTermLosses;
+  const off = crossOffset(netShort, netLong);
+  const ordinaryPortion = (off.taxableShort + income.ordinaryDividends + income.interestIncome) * rates.shortTerm;
+  const ltPortion = (off.taxableLong + income.qualifiedDividends) * rates.longTerm;
+  const total = ordinaryPortion + ltPortion;
+  return { total, breakdown: { ordinaryPortion, ltPortion, carryForward: off.carryForward } };
+}
+
+// src/portfolio/derived.ts
+function positionsByAsset(portfolio) {
+  const byId = /* @__PURE__ */ new Map();
+  for (const lot of portfolio.lots ?? []) {
+    const cur = byId.get(lot.asset.id);
+    if (cur) {
+      cur.quantity += lot.quantity;
+      cur.basis += lot.basis;
+      if (lot.openDate < cur.openDate) {
+        cur.openDate = lot.openDate;
+        cur.openPrice = lot.openPrice;
+      }
+    } else {
+      byId.set(lot.asset.id, {
+        asset: lot.asset,
+        quantity: lot.quantity,
+        basis: lot.basis,
+        openDate: lot.openDate,
+        openPrice: lot.openPrice
+      });
+    }
+  }
+  return Array.from(byId.values()).map((agg) => ({
+    id: `lot_view_${agg.asset.id}`,
+    asset: agg.asset,
+    side: "long",
+    quantity: agg.quantity,
+    entry: { date: agg.openDate, price: agg.openPrice },
+    basis: agg.basis
+  }));
+}
 export {
   BacktestExecutor,
   Crypto24x7Calendar,
@@ -2974,16 +3264,21 @@ export {
   LSEExchangeCalendar,
   MemoryFeatureCache,
   NYSEExchangeCalendar,
+  ORDINARY_OFFSET_CAP,
   RoutingDataFeed,
   RoutingDataFeedError,
   RoutingQuoteFeed,
   RoutingQuoteFeedError,
   RoutingStreamingDataFeed,
   RoutingStreamingDataFeedError,
+  aggregateByYear,
   applyFills,
   applyOrders,
   barsToSeries,
+  bucketByTerm,
   collectBars,
+  computeTaxBill,
+  crossOffset,
   defineFeature,
   drawdown,
   ema,
@@ -2993,18 +3288,28 @@ export {
   fromSpec,
   getCalendar,
   getFeatureCompute,
+  holdingPeriodDays,
+  isLongTerm,
   isRebalanceDay,
+  netWithinBucket,
   paramsHash,
   periodKey,
   pollingStreamFromHistorical,
+  positionsByAsset,
+  realize,
   reconcile,
   returnSeries,
   rsi,
   runBacktest,
   runLive,
+  selectFIFO,
+  selectHIFO,
+  selectLIFO,
+  selectMinTax,
   seriesAt,
   sma,
   tactical_exports as tactical,
+  tax_exports as tax,
   volatility,
   withStreamingSynthetics,
   withSynthetics