global: snapshot

2026-07-23 00:48:11 -07:00 · 2026-01-02 19:23:20 +01:00
parent 3e9b1cc2b2
commit c33444a92e
14 changed files with 557 additions and 557 deletions
@@ -1,7 +1,7 @@
 /**
 * Address cohort folder builder
 * Creates option trees for address-based cohorts (has addrCount)
- * Address cohorts use _0satsPattern which has PricePaidPattern (no percentiles)
+ * Address cohorts use _0satsPattern which has CostBasisPattern (no percentiles)
 */

 import {
@@ -104,8 +104,8 @@ export function createAddressCohortFolder(ctx, args) {
      // Unrealized section
      ...createUnrealizedSection(ctx, list, useGroupName, title),

-      // Price paid section (no percentiles for address cohorts)
-      ...createPricePaidSection(ctx, list, useGroupName, title),
+      // Cost basis section (no percentiles for address cohorts)
+      ...createCostBasisSection(ctx, list, useGroupName, title),

      // Activity section
      ...createActivitySection(ctx, list, useGroupName, title),
@@ -237,32 +237,32 @@ function createUnrealizedSection(ctx, list, useGroupName, title) {
 }

 /**
- * Create price paid section (no percentiles for address cohorts)
+ * Create cost basis section (no percentiles for address cohorts)
 * @param {PartialContext} ctx
 * @param {readonly AddressCohortObject[]} list
 * @param {boolean} useGroupName
 * @param {string} title
 * @returns {PartialOptionsTree}
 */
-function createPricePaidSection(ctx, list, useGroupName, title) {
+function createCostBasisSection(ctx, list, useGroupName, title) {
  const { s } = ctx;

  return [
    {
-      name: "Price Paid",
+      name: "Cost Basis",
      tree: [
        {
          name: "min",
-          title: `Min Price Paid ${title}`,
+          title: `Min Cost Basis ${title}`,
          top: list.map(({ color, name, tree }) =>
-            s({ metric: tree.pricePaid.minPricePaid, name: useGroupName ? name : "Min", color }),
+            s({ metric: tree.costBasis.minCostBasis, name: useGroupName ? name : "Min", color }),
          ),
        },
        {
          name: "max",
-          title: `Max Price Paid ${title}`,
+          title: `Max Cost Basis ${title}`,
          top: list.map(({ color, name, tree }) =>
-            s({ metric: tree.pricePaid.maxPricePaid, name: useGroupName ? name : "Max", color }),
+            s({ metric: tree.costBasis.maxCostBasis, name: useGroupName ? name : "Max", color }),
          ),
        },
      ],
@@ -20,6 +20,6 @@ export {
  createRealizedPriceSeries,
  createRealizedPriceRatioSeries,
  createRealizedCapSeries,
-  createPricePaidMinMaxSeries,
-  createPricePercentilesSeries,
+  createCostBasisMinMaxSeries,
+  createCostBasisPercentilesSeries,
 } from "./shared.js";
@@ -178,39 +178,39 @@ export function createRealizedCapSeries(ctx, list, useGroupName) {
 }

 /**
- * Create price paid min/max series (available on all cohorts)
+ * Create cost basis min/max series (available on all cohorts)
 * @param {PartialContext} ctx
 * @param {readonly CohortObject[]} list
 * @param {boolean} useGroupName
 * @returns {AnyFetchedSeriesBlueprint[]}
 */
-export function createPricePaidMinMaxSeries(ctx, list, useGroupName) {
+export function createCostBasisMinMaxSeries(ctx, list, useGroupName) {
  const { s } = ctx;

  return list.flatMap(({ color, name, tree }) => [
-    s({ metric: tree.pricePaid.minPricePaid, name: useGroupName ? `${name} min` : "Min", color }),
-    s({ metric: tree.pricePaid.maxPricePaid, name: useGroupName ? `${name} max` : "Max", color }),
+    s({ metric: tree.costBasis.minCostBasis, name: useGroupName ? `${name} min` : "Min", color }),
+    s({ metric: tree.costBasis.maxCostBasis, name: useGroupName ? `${name} max` : "Max", color }),
  ]);
 }

 /**
- * Create price percentile series (only for cohorts with PricePaidPattern2)
+ * Create cost basis percentile series (only for cohorts with CostBasisPattern2)
 * @param {PartialContext} ctx
- * @param {readonly CohortWithPricePercentiles[]} list
+ * @param {readonly CohortWithCostBasisPercentiles[]} list
 * @param {boolean} useGroupName
 * @returns {AnyFetchedSeriesBlueprint[]}
 */
-export function createPricePercentilesSeries(ctx, list, useGroupName) {
+export function createCostBasisPercentilesSeries(ctx, list, useGroupName) {
  const { s, colors } = ctx;

  return list.flatMap(({ color, name, tree }) => {
-    const pp = tree.pricePaid.pricePercentiles;
+    const percentiles = tree.costBasis.percentiles;
    return [
-      s({ metric: pp.pct10, name: useGroupName ? `${name} p10` : "p10", color, defaultActive: false }),
-      s({ metric: pp.pct25, name: useGroupName ? `${name} p25` : "p25", color, defaultActive: false }),
-      s({ metric: pp.pct50, name: useGroupName ? `${name} p50` : "p50", color }),
-      s({ metric: pp.pct75, name: useGroupName ? `${name} p75` : "p75", color, defaultActive: false }),
-      s({ metric: pp.pct90, name: useGroupName ? `${name} p90` : "p90", color, defaultActive: false }),
+      s({ metric: percentiles.pct10, name: useGroupName ? `${name} p10` : "p10", color, defaultActive: false }),
+      s({ metric: percentiles.pct25, name: useGroupName ? `${name} p25` : "p25", color, defaultActive: false }),
+      s({ metric: percentiles.pct50, name: useGroupName ? `${name} p50` : "p50", color }),
+      s({ metric: percentiles.pct75, name: useGroupName ? `${name} p75` : "p75", color, defaultActive: false }),
+      s({ metric: percentiles.pct90, name: useGroupName ? `${name} p90` : "p90", color, defaultActive: false }),
    ];
  });
 }
@@ -3,8 +3,8 @@
 * Creates option trees for UTXO-based cohorts (no addrCount)
 *
 * Two main builders:
- * - createAgeCohortFolder: For term, maxAge, minAge, ageRange, epoch (has price percentiles)
- * - createAmountCohortFolder: For geAmount, ltAmount, amountRange, type (no price percentiles)
+ * - createAgeCohortFolder: For term, maxAge, minAge, ageRange, epoch (has cost basis percentiles)
+ * - createAmountCohortFolder: For geAmount, ltAmount, amountRange, type (no cost basis percentiles)
 */

 import {
@@ -16,13 +16,13 @@ import {
  createRealizedPriceSeries,
  createRealizedPriceRatioSeries,
  createRealizedCapSeries,
-  createPricePaidMinMaxSeries,
-  createPricePercentilesSeries,
+  createCostBasisMinMaxSeries,
+  createCostBasisPercentilesSeries,
 } from "./shared.js";

 /**
 * Create a cohort folder for age-based UTXO cohorts (term, maxAge, minAge, ageRange, epoch)
- * These cohorts have price percentiles via PricePaidPattern2
+ * These cohorts have cost basis percentiles via CostBasisPattern2
 * @param {PartialContext} ctx
 * @param {AgeCohortObject | AgeCohortGroupObject} args
 * @returns {PartialOptionsGroup}
@@ -40,7 +40,7 @@ export function createAgeCohortFolder(ctx, args) {
      createUtxoCountSection(ctx, list, useGroupName, title),
      createRealizedSection(ctx, list, args, useGroupName, isSingle, title),
      ...createUnrealizedSection(ctx, list, useGroupName, title),
-      ...createPricePaidSectionWithPercentiles(ctx, list, useGroupName, title),
+      ...createCostBasisSectionWithPercentiles(ctx, list, useGroupName, title),
      ...createActivitySection(ctx, list, useGroupName, title),
    ],
  };
@@ -48,7 +48,7 @@ export function createAgeCohortFolder(ctx, args) {

 /**
 * Create a cohort folder for amount-based UTXO cohorts (geAmount, ltAmount, amountRange, type)
- * These cohorts have only min/max price paid via PricePaidPattern
+ * These cohorts have only min/max cost basis via CostBasisPattern
 * @param {PartialContext} ctx
 * @param {AmountCohortObject | AmountCohortGroupObject} args
 * @returns {PartialOptionsGroup}
@@ -66,7 +66,7 @@ export function createAmountCohortFolder(ctx, args) {
      createUtxoCountSection(ctx, list, useGroupName, title),
      createRealizedSection(ctx, list, args, useGroupName, isSingle, title),
      ...createUnrealizedSection(ctx, list, useGroupName, title),
-      ...createPricePaidSectionBasic(ctx, list, useGroupName, title),
+      ...createCostBasisSectionBasic(ctx, list, useGroupName, title),
      ...createActivitySection(ctx, list, useGroupName, title),
    ],
  };
@@ -87,7 +87,7 @@ export function createUtxoCohortFolder(ctx, args) {
  const title = args.title ? `${useGroupName ? "by" : "of"} ${args.title}` : "";

  // Runtime check for percentiles
-  const hasPercentiles = "pricePercentiles" in list[0].tree.pricePaid;
+  const hasPercentiles = "percentiles" in list[0].tree.costBasis;

  return {
    name: args.name || "all",
@@ -97,8 +97,8 @@ export function createUtxoCohortFolder(ctx, args) {
      createRealizedSection(ctx, list, args, useGroupName, isSingle, title),
      ...createUnrealizedSection(ctx, list, useGroupName, title),
      ...(hasPercentiles
-        ? createPricePaidSectionWithPercentiles(ctx, /** @type {readonly AgeCohortObject[]} */ (list), useGroupName, title)
-        : createPricePaidSectionBasic(ctx, list, useGroupName, title)),
+        ? createCostBasisSectionWithPercentiles(ctx, /** @type {readonly AgeCohortObject[]} */ (list), useGroupName, title)
+        : createCostBasisSectionBasic(ctx, list, useGroupName, title)),
      ...createActivitySection(ctx, list, useGroupName, title),
    ],
  };
@@ -372,38 +372,38 @@ function createUnrealizedSection(ctx, list, useGroupName, title) {
 }

 /**
- * Create price paid section for cohorts WITH percentiles (age cohorts)
+ * Create cost basis section for cohorts WITH percentiles (age cohorts)
 * @param {PartialContext} ctx
 * @param {readonly AgeCohortObject[]} list
 * @param {boolean} useGroupName
 * @param {string} title
 * @returns {PartialOptionsTree}
 */
-function createPricePaidSectionWithPercentiles(ctx, list, useGroupName, title) {
+function createCostBasisSectionWithPercentiles(ctx, list, useGroupName, title) {
  const { s } = ctx;

  return [
    {
-      name: "Price Paid",
+      name: "Cost Basis",
      tree: [
        {
          name: "min",
-          title: `Min Price Paid ${title}`,
+          title: `Min Cost Basis ${title}`,
          top: list.map(({ color, name, tree }) =>
-            s({ metric: tree.pricePaid.minPricePaid, name: useGroupName ? name : "Min", color }),
+            s({ metric: tree.costBasis.minCostBasis, name: useGroupName ? name : "Min", color }),
          ),
        },
        {
          name: "max",
-          title: `Max Price Paid ${title}`,
+          title: `Max Cost Basis ${title}`,
          top: list.map(({ color, name, tree }) =>
-            s({ metric: tree.pricePaid.maxPricePaid, name: useGroupName ? name : "Max", color }),
+            s({ metric: tree.costBasis.maxCostBasis, name: useGroupName ? name : "Max", color }),
          ),
        },
        {
          name: "percentiles",
-          title: `Price Paid Percentiles ${title}`,
-          top: createPricePercentilesSeries(ctx, list, useGroupName),
+          title: `Cost Basis Percentiles ${title}`,
+          top: createCostBasisPercentilesSeries(ctx, list, useGroupName),
        },
      ],
    },
@@ -411,32 +411,32 @@ function createPricePaidSectionWithPercentiles(ctx, list, useGroupName, title) {
 }

 /**
- * Create price paid section for cohorts WITHOUT percentiles (amount cohorts)
+ * Create cost basis section for cohorts WITHOUT percentiles (amount cohorts)
 * @param {PartialContext} ctx
 * @param {readonly UtxoCohortObject[]} list
 * @param {boolean} useGroupName
 * @param {string} title
 * @returns {PartialOptionsTree}
 */
-function createPricePaidSectionBasic(ctx, list, useGroupName, title) {
+function createCostBasisSectionBasic(ctx, list, useGroupName, title) {
  const { s } = ctx;

  return [
    {
-      name: "Price Paid",
+      name: "Cost Basis",
      tree: [
        {
          name: "min",
-          title: `Min Price Paid ${title}`,
+          title: `Min Cost Basis ${title}`,
          top: list.map(({ color, name, tree }) =>
-            s({ metric: tree.pricePaid.minPricePaid, name: useGroupName ? name : "Min", color }),
+            s({ metric: tree.costBasis.minCostBasis, name: useGroupName ? name : "Min", color }),
          ),
        },
        {
          name: "max",
-          title: `Max Price Paid ${title}`,
+          title: `Max Cost Basis ${title}`,
          top: list.map(({ color, name, tree }) =>
-            s({ metric: tree.pricePaid.maxPricePaid, name: useGroupName ? name : "Max", color }),
+            s({ metric: tree.costBasis.maxCostBasis, name: useGroupName ? name : "Max", color }),
          ),
        },
      ],
@@ -121,14 +121,14 @@
 * @property {Color} color
 * @property {UtxoCohortPattern} tree
 *
- * Age cohorts (term, maxAge, minAge, ageRange, epoch) - have price percentiles
+ * Age cohorts (term, maxAge, minAge, ageRange, epoch) - have cost basis percentiles
 * @typedef {Object} AgeCohortObject
 * @property {string} name
 * @property {string} title
 * @property {Color} color
- * @property {PatternWithPricePercentiles} tree
+ * @property {PatternWithCostBasisPercentiles} tree
 *
- * Amount cohorts (geAmount, ltAmount, amountRange, type) - no price percentiles
+ * Amount cohorts (geAmount, ltAmount, amountRange, type) - no cost basis percentiles
 * @typedef {Object} AmountCohortObject
 * @property {string} name
 * @property {string} title