{
  "article": "canada.md",
  "as_of": "2026-11-12",
  "scope": "Educational interaction specifications; no investment recommendations or live pricing",
  "convention": "Store return and weight percentages as fractions internally. All monetary outputs CAD except clearly marked USD.",
  "modules": [
    {
      "id": "canada-exposure",
      "title": "How much Nvidia is inside this portfolio?",
      "article_marker": "[interactive:canada-exposure]",
      "purpose": "Calculate direct and nested Nvidia ownership separately from broader AI-related economic sensitivity.",
      "placement": "After the overlapping-funds section.",
      "units": "CAD values; fractions internally; percentages in controls and display.",
      "default_label": "Hypothetical C$100,000 portfolio. The VFV 8.4% input is a historical September 30, 2026 observation; all account values and global-fund weights are invented. This is not a current holdings estimate.",
      "inputs": [
        {
          "key": "rows",
          "type": "editable_rows",
          "fields": [
            {
              "key": "label",
              "type": "text"
            },
            {
              "key": "cadValue",
              "type": "number",
              "min": 0,
              "max": 1000000000,
              "step": 100
            },
            {
              "key": "known",
              "type": "boolean"
            },
            {
              "key": "sleeveWeight",
              "type": "number",
              "min": 0,
              "max": 1,
              "display": "percent",
              "step": 0.01
            },
            {
              "key": "nvidiaWeight",
              "type": "number",
              "min": 0,
              "max": 1,
              "display": "percent",
              "step": 0.001
            }
          ],
          "default": [
            {
              "label": "Illustrative global equity fund",
              "cadValue": 60000,
              "known": true,
              "sleeveWeight": 0.45,
              "nvidiaWeight": 0.08,
              "input_kind": "hypothetical"
            },
            {
              "label": "VFV with historical weight",
              "cadValue": 25000,
              "known": true,
              "sleeveWeight": 1,
              "nvidiaWeight": 0.084,
              "input_kind": "hypothetical_account_with_historical_reference",
              "weight_as_of": "2026-09-30",
              "source_url": "https://fund-docs.vanguard.com/VFV_SandP_500_Index_ETF_9563_FS_EN_CA.pdf"
            },
            {
              "label": "Direct Nvidia, valued in CAD",
              "cadValue": 5000,
              "known": true,
              "sleeveWeight": 1,
              "nvidiaWeight": 1,
              "input_kind": "hypothetical"
            },
            {
              "label": "Cash",
              "cadValue": 10000,
              "known": true,
              "sleeveWeight": 1,
              "nvidiaWeight": 0,
              "input_kind": "hypothetical"
            }
          ]
        },
        {
          "key": "nvidiaShock",
          "label": "Isolated Nvidia price change",
          "type": "range",
          "min": -1,
          "max": 1,
          "step": 0.01,
          "default": -0.3,
          "display": "percent",
          "input_kind": "hypothetical"
        }
      ],
      "equations": {
        "rowExposure": "cadValue * sleeveWeight * nvidiaWeight for rows whose weight is known",
        "portfolioValue": "sum(cadValue) across every row",
        "knownNvidiaExposure": "sum(rowExposure) for known rows",
        "unknownValue": "sum(cadValue) for unknown rows",
        "knownExposureShare": "knownNvidiaExposure / portfolioValue when portfolioValue > 0",
        "isolatedCADChange": "knownNvidiaExposure * nvidiaShock",
        "isolatedPortfolioChange": "isolatedCADChange / portfolioValue when portfolioValue > 0"
      },
      "outputs": [
        {
          "key": "portfolioValue",
          "label": "Portfolio value",
          "format": "CAD"
        },
        {
          "key": "knownNvidiaExposure",
          "label": "Underlying Nvidia amount",
          "format": "CAD"
        },
        {
          "key": "knownExposureShare",
          "label": "Underlying Nvidia share",
          "format": "percent_2dp"
        },
        {
          "key": "isolatedCADChange",
          "label": "Isolated Nvidia scenario change",
          "format": "signed_CAD"
        },
        {
          "key": "isolatedPortfolioChange",
          "label": "Effect on whole portfolio",
          "format": "signed_percent_2dp"
        },
        {
          "key": "unknownValue",
          "label": "Holdings still needing a weight",
          "format": "CAD"
        }
      ],
      "default_expected": {
        "rowExposure": [
          2160,
          2100,
          5000,
          0
        ],
        "portfolioValue": 100000,
        "knownNvidiaExposure": 9260,
        "knownExposureShare": 0.0926,
        "isolatedCADChange": -2778,
        "isolatedPortfolioChange": -0.02778,
        "unknownValue": 0
      },
      "reference_inputs": [
        {
          "key": "VFV Nvidia look-through weight",
          "value": 0.084,
          "unit": "fraction of fund NAV",
          "as_of": "2026-09-30",
          "checked_date": "2026-11-12",
          "source_url": "https://fund-docs.vanguard.com/VFV_SandP_500_Index_ETF_9563_FS_EN_CA.pdf",
          "title": "Vanguard S&P 500 Index ETF fact sheet",
          "display_rule": "Historical reference; never call this the current weight. Change the label to user assumption if edited."
        }
      ],
      "boundary_tests": [
        {
          "case": "All amounts zero",
          "expect": "Amount outputs zero; percentage outputs null with “Add a holding”; never NaN or Infinity."
        },
        {
          "case": "Only C$10,000 direct Nvidia, shock -100%",
          "expect": {
            "knownNvidiaExposure": 10000,
            "knownExposureShare": 1,
            "isolatedCADChange": -10000,
            "isolatedPortfolioChange": -1
          }
        },
        {
          "case": "Only C$10,000 cash",
          "expect": {
            "knownNvidiaExposure": 0,
            "knownExposureShare": 0,
            "isolatedCADChange": 0
          }
        },
        {
          "case": "Nested weights 50% and 20% on C$1,000",
          "expect": {
            "knownNvidiaExposure": 100
          }
        },
        {
          "case": "C$5,000 known direct Nvidia and C$5,000 unknown fund",
          "expect": {
            "portfolioValue": 10000,
            "knownNvidiaExposure": 5000,
            "knownExposureShare": 0.5,
            "unknownValue": 5000
          },
          "display": "Show “at least 50% identified; half the portfolio remains unmeasured.” Do not show unknown as zero."
        },
        {
          "case": "Negative amount, nonfinite value or weight outside 0..100%",
          "expect": "Reject with a field-specific message; retain last valid calculation."
        }
      ],
      "caveats": [
        "No derivatives, leverage, short positions, taxes, fees or changes in other holdings.",
        "Prices and FX are held unchanged except for the explicit Nvidia shock. Correlated moves are not estimated.",
        "Fund weights drift; reference dates must stay visible.",
        "Enter a fund once and multiply through its underlying layers; do not count its internal funds again as account assets.",
        "All account values must use the same CAD valuation basis."
      ],
      "ui": {
        "layout": "Editable holdings table plus amount/share tiles and a horizontal contribution bar; stack controls on mobile.",
        "accessibility": "Every numeric field has an explicit label and unit; contribution labels remain visible without colour; announce recalculated totals politely; support keyboard editing.",
        "optional_control": "Unknown weight checkbox per row; Reset illustration button."
      }
    },
    {
      "id": "canada-fx",
      "title": "Separate the stock move from the currency move",
      "article_marker": "[interactive:canada-fx]",
      "purpose": "Show the exact multiplicative translation for an unhedged U.S. investment and an idealized currency-neutral comparator.",
      "placement": "End of currency section.",
      "default_label": "Hypothetical scenario. The comparison is arithmetic, not a forecast for VFV, XQQ or a CDR.",
      "inputs": [
        {
          "key": "initialCAD",
          "label": "Starting investment",
          "unit": "CAD",
          "type": "number",
          "min": 0,
          "max": 1000000000,
          "default": 10000,
          "input_kind": "hypothetical"
        },
        {
          "key": "stockReturn",
          "label": "U.S.-dollar investment return",
          "type": "range",
          "min": -1,
          "max": 2,
          "step": 0.01,
          "default": 0.2,
          "display": "percent",
          "input_kind": "hypothetical"
        },
        {
          "key": "startFX",
          "label": "Starting Canadian dollars per US$1",
          "type": "number",
          "min": 0.01,
          "max": 10,
          "step": 0.0001,
          "default": 1.4,
          "input_kind": "hypothetical"
        },
        {
          "key": "fxChange",
          "label": "Change in CAD per US$1",
          "type": "range",
          "min": -0.9,
          "max": 1,
          "step": 0.01,
          "default": -0.1,
          "display": "percent",
          "input_kind": "hypothetical",
          "help": "A negative number means each U.S. dollar buys fewer Canadian dollars: the Canadian dollar has strengthened."
        }
      ],
      "equations": {
        "endFX": "startFX * (1 + fxChange)",
        "unhedgedReturn": "(1 + stockReturn) * (1 + fxChange) - 1",
        "unhedgedEndCAD": "initialCAD * (1 + unhedgedReturn)",
        "idealHedgedReturn": "stockReturn",
        "idealHedgedEndCAD": "initialCAD * (1 + stockReturn)",
        "currencyDifferenceCAD": "unhedgedEndCAD - idealHedgedEndCAD",
        "interactionTerm": "stockReturn * fxChange"
      },
      "outputs": [
        {
          "key": "endFX",
          "label": "Scenario ending CAD per US$1",
          "format": "4dp"
        },
        {
          "key": "unhedgedReturn",
          "label": "Unhedged Canadian-dollar return",
          "format": "signed_percent_2dp"
        },
        {
          "key": "unhedgedEndCAD",
          "label": "Unhedged ending value",
          "format": "CAD"
        },
        {
          "key": "idealHedgedReturn",
          "label": "Ideal currency-neutral return, before costs",
          "format": "signed_percent_2dp"
        },
        {
          "key": "currencyDifferenceCAD",
          "label": "Translation effect versus ideal comparator",
          "format": "signed_CAD"
        }
      ],
      "default_expected": {
        "endFX": 1.26,
        "unhedgedReturn": 0.08,
        "unhedgedEndCAD": 10800,
        "idealHedgedReturn": 0.2,
        "idealHedgedEndCAD": 12000,
        "currencyDifferenceCAD": -1200,
        "interactionTerm": -0.02
      },
      "reference_inputs": [
        {
          "key": "Bank of Canada USD/CAD daily average",
          "value": 1.4181,
          "unit": "CAD per USD",
          "as_of": "2026-11-10",
          "checked_date": "2026-11-12",
          "source_url": "https://www.bankofcanada.ca/rates/exchange/daily-exchange-rates/",
          "title": "Bank of Canada daily exchange rates",
          "display_rule": "Offer as an optional dated reference beside the hypothetical starting FX. Choosing it updates startFX only and preserves fxChange, so the hypothetical percentage scenario stays constant. Never label it a live rate or brokerage quote."
        }
      ],
      "boundary_tests": [
        {
          "case": "stockReturn=0.20; fxChange=0",
          "expect": {
            "unhedgedReturn": 0.2,
            "currencyDifferenceCAD": 0
          }
        },
        {
          "case": "stockReturn=0; fxChange=-0.10",
          "expect": {
            "unhedgedReturn": -0.1
          }
        },
        {
          "case": "stockReturn=-0.20; fxChange=0.10",
          "expect": {
            "unhedgedReturn": -0.12
          }
        },
        {
          "case": "stockReturn=-1; fxChange=0.50",
          "expect": {
            "unhedgedReturn": -1,
            "unhedgedEndCAD": 0,
            "idealHedgedEndCAD": 0
          }
        },
        {
          "case": "initialCAD=0",
          "expect": "Dollar outputs zero; scenario percentage return remains mathematically defined."
        },
        {
          "case": "startFX<=0 or fxChange<=-1 or stockReturn<-1",
          "expect": "Reject invalid inputs; no division by zero or negative ending exchange rate."
        },
        {
          "case": "Use reference startFX=1.4181 with fxChange=-0.10",
          "expect": {
            "endFX": 1.27629,
            "unhedgedReturn": 0.08
          }
        }
      ],
      "caveats": [
        "The ideal hedge assumes perfect currency neutralization and no costs or interest-rate carry. Actual hedged funds and CDRs will differ.",
        "The simplified calculation treats the investment return as a USD total return with distributions reinvested in USD; real cash-flow timing can change results.",
        "No transaction spread, tax, fee or timing mismatch is included.",
        "Hedging does not eliminate company risk or currencies affecting the business itself."
      ],
      "ui": {
        "layout": "Two equal starting bars split into ending unhedged and ideal-comparator values; include a three-part arithmetic strip: equity + currency + interaction.",
        "accessibility": "State currency direction in words as well as signs; keyboard controls; no red/green-only semantics.",
        "optional_control": "Show a 3x3 scenario grid with stock returns -20%,0%,20% and FX changes -10%,0%,10%; all hypothetical."
      }
    },
    {
      "id": "canada-power",
      "title": "Turn a megawatt headline into an energy bill",
      "article_marker": "[interactive:canada-power]",
      "purpose": "Distinguish IT nameplate power, average electricity draw, facility overhead, energy and operating cost.",
      "placement": "After the electricity discussion.",
      "default_label": "Entire project and price scenario is hypothetical. It does not model Bell, TELUS, an Alberta project or a utility investment.",
      "inputs": [
        {
          "key": "itMW",
          "label": "IT nameplate electrical capacity",
          "unit": "MW",
          "type": "number",
          "min": 0,
          "max": 5000,
          "step": 1,
          "default": 20,
          "input_kind": "hypothetical"
        },
        {
          "key": "averageDraw",
          "label": "Average IT electrical draw as share of nameplate",
          "type": "range",
          "min": 0,
          "max": 1,
          "step": 0.01,
          "default": 0.65,
          "display": "percent",
          "input_kind": "hypothetical",
          "help": "Electrical load fraction, including actual idle draw; not GPU utilization, occupancy, or billable utilization."
        },
        {
          "key": "pue",
          "label": "Facility energy divided by IT energy (PUE)",
          "type": "number",
          "min": 1,
          "max": 3,
          "step": 0.01,
          "default": 1.2,
          "input_kind": "hypothetical"
        },
        {
          "key": "hours",
          "label": "Hours in modeled period",
          "unit": "hours",
          "type": "number",
          "min": 0,
          "max": 8784,
          "step": 1,
          "default": 8760,
          "input_kind": "hypothetical",
          "help": "8,760 hours represents a 365-day year; reduce for a commissioning period."
        },
        {
          "key": "energyRate",
          "label": "Assumed energy price",
          "unit": "CAD/MWh",
          "type": "number",
          "min": 0,
          "max": 1000,
          "step": 1,
          "default": 70,
          "input_kind": "hypothetical"
        }
      ],
      "equations": {
        "averageITMW": "itMW * averageDraw",
        "averageFacilityMW": "itMW * averageDraw * pue",
        "itMWh": "itMW * averageDraw * hours",
        "facilityMWh": "itMW * averageDraw * pue * hours",
        "overheadMWh": "facilityMWh - itMWh",
        "energyCostCAD": "facilityMWh * energyRate",
        "incrementalCostPer10Dollars": "facilityMWh * 10"
      },
      "outputs": [
        {
          "key": "averageFacilityMW",
          "label": "Average facility power",
          "format": "MW_2dp"
        },
        {
          "key": "facilityMWh",
          "label": "Facility energy over period",
          "format": "MWh_0dp"
        },
        {
          "key": "overheadMWh",
          "label": "Facility overhead energy",
          "format": "MWh_0dp"
        },
        {
          "key": "energyCostCAD",
          "label": "Energy-only cost",
          "format": "CAD"
        },
        {
          "key": "incrementalCostPer10Dollars",
          "label": "Cost change for an extra C$10/MWh",
          "format": "CAD"
        }
      ],
      "default_expected": {
        "averageITMW": 13,
        "averageFacilityMW": 15.6,
        "itMWh": 113880,
        "facilityMWh": 136656,
        "overheadMWh": 22776,
        "energyCostCAD": 9565920,
        "incrementalCostPer10Dollars": 1366560
      },
      "reference_inputs": [
        {
          "key": "Alberta requested new data-centre load",
          "value": 19565,
          "unit": "MW",
          "as_of": "2026-07-30",
          "checked_date": "2026-11-12",
          "source_url": "https://www.alberta.ca/datacentres/numbers",
          "title": "Alberta By the Numbers",
          "display_rule": "Context card only: approximate requested connections, not approvals, construction, operating load, or Nvidia-specific demand. Do not load automatically into the project inputs."
        },
        {
          "key": "AESO Phase 1 allocated large-load connection capacity",
          "value": 1200,
          "unit": "MW",
          "as_of": "Status page checked 2026-11-12; announcement date not displayed for this section",
          "checked_date": "2026-11-12",
          "source_url": "https://www.aeso.ca/grid/connecting-to-the-grid/large-load-projects/",
          "title": "AESO Large Load Projects",
          "display_rule": "Context card only: allocation with executed load contracts is not an operating-power reading; do not divide it into IT capacity without project-specific definitions."
        }
      ],
      "boundary_tests": [
        {
          "case": "itMW=0 or averageDraw=0 or hours=0",
          "expect": "Energy and cost zero in this simplified model; label that fixed nonenergy costs may persist."
        },
        {
          "case": "pue=1",
          "expect": "Facility energy equals IT energy; overhead energy zero."
        },
        {
          "case": "itMW=1; averageDraw=1; pue=1; hours=8760; energyRate=70",
          "expect": {
            "facilityMWh": 8760,
            "energyCostCAD": 613200
          }
        },
        {
          "case": "Default scenario except energyRate=0",
          "expect": {
            "facilityMWh": 136656,
            "energyCostCAD": 0
          }
        },
        {
          "case": "Double default energyRate to140",
          "expect": {
            "energyCostCAD": 19131840
          }
        },
        {
          "case": "pue<1; averageDraw outside0..1; negative or nonfinite input",
          "expect": "Reject with unit-specific validation."
        }
      ],
      "caveats": [
        "Energy-only model excludes demand charges, transmission, taxes, fuel backup, capital expenditure, debt service, wages and GPU replacement.",
        "PUE is simplified as constant; real overhead varies with climate, facility design and load.",
        "An empty compute workload does not imply zero electrical draw. Enter average measured electrical demand, not occupancy.",
        "Grid connection MW, facility MW and IT MW are different concepts; reference cards must not imply direct comparability.",
        "No conclusion about project profitability, grid approval likelihood or shareholder returns is produced."
      ],
      "ui": {
        "layout": "Input panel plus stacked IT/overhead energy bar and energy-cost tile; separate dated reference cards below.",
        "accessibility": "Use clear MW versus MWh labels and explain each; keyboard number fields; readable text summaries for charts.",
        "optional_control": "Show energy cost at user rate ±C$10/MWh with lower rate floored at zero."
      }
    }
  ],
  "implementation_requirements": [
    "Use the exact module IDs in article markers.",
    "Display hypothetical labels before controls and keep dated reference labels visible.",
    "Retain full-precision calculations; round only rendered outputs.",
    "Do not substitute unavailable source data with zero or silently refresh dates.",
    "No trading prompts, affiliate links, personal-data collection or account connection needed."
  ]
}
