policyengine-us 1.409.0__py3-none-any.whl → 1.411.0__py3-none-any.whl

policyengine_us/tests/policy/baseline/gov/states/ma/eec/ccfa/ma_ccfa_maximum_benefit_amount.yaml

@@ -0,0 +1,209 @@
+- name: No benefit when not eligible for CCFA
+  period: 2025-01
+  input:
+    ma_ccfa_eligible: false
+    state_code: MA
+  output:
+    ma_ccfa_maximum_benefit_amount: 0
+
+- name: Full reimbursement with zero copay
+  period: 2025-01
+  input:
+    people:
+      parent:
+        age: 30
+      child:
+        age: 3
+        ma_ccfa_maximum_reimbursement: 1_200
+    spm_units:
+      spm_unit:
+        members: [parent, child]
+        ma_ccfa_eligible: true
+        ma_ccfa_total_copay: 0
+    households:
+      household:
+        state_code: MA
+        members: [parent, child]
+  output:
+    ma_ccfa_maximum_benefit_amount: 1_200
+
+- name: Reduced benefit with copay
+  period: 2025-01
+  input:
+    people:
+      parent:
+        age: 30
+      child:
+        age: 3
+        ma_ccfa_maximum_reimbursement: 1_200
+    spm_units:
+      spm_unit:
+        members: [parent, child]
+        ma_ccfa_eligible: true
+        ma_ccfa_total_copay: 300
+    households:
+      household:
+        state_code: MA
+        members: [parent, child]
+  output:
+    ma_ccfa_maximum_benefit_amount: 900
+
+- name: Multiple children with different reimbursement rates
+  period: 2025-01
+  input:
+    people:
+      parent:
+        age: 35
+      infant:
+        age: 1
+        ma_ccfa_maximum_reimbursement: 1_500
+      toddler:
+        age: 3
+        ma_ccfa_maximum_reimbursement: 1_200
+      school_age:
+        age: 8
+        ma_ccfa_maximum_reimbursement: 800
+    spm_units:
+      spm_unit:
+        members: [parent, infant, toddler, school_age]
+        ma_ccfa_eligible: true
+        ma_ccfa_total_copay: 400
+    households:
+      household:
+        state_code: MA
+        members: [parent, infant, toddler, school_age]
+  output:
+    ma_ccfa_maximum_benefit_amount: 3_100  # (1500 + 1200 + 800) - 400
+
+- name: Zero benefit when copay exceeds reimbursement
+  period: 2025-01
+  input:
+    people:
+      parent:
+        age: 30
+      child:
+        age: 4
+        ma_ccfa_maximum_reimbursement: 500
+    spm_units:
+      spm_unit:
+        members: [parent, child]
+        ma_ccfa_eligible: true
+        ma_ccfa_total_copay: 600
+    households:
+      household:
+        state_code: MA
+        members: [parent, child]
+  output:
+    ma_ccfa_maximum_benefit_amount: 0  # max(500 - 600, 0) = 0
+
+- name: TAFDC recipient with categorical eligibility and no copay
+  period: 2025-01
+  input:
+    people:
+      parent:
+        age: 28
+      child1:
+        age: 2
+        ma_ccfa_maximum_reimbursement: 1_400
+      child2:
+        age: 5
+        ma_ccfa_maximum_reimbursement: 1_100
+    spm_units:
+      spm_unit:
+        members: [parent, child1, child2]
+        ma_ccfa_eligible: true
+        ma_tafdc_eligible: true
+        ma_ccfa_total_copay: 0  # TAFDC recipients typically have no copay
+    households:
+      household:
+        state_code: MA
+        members: [parent, child1, child2]
+  output:
+    ma_ccfa_maximum_benefit_amount: 2_500  # 1400 + 1100
+
+- name: High income family with maximum copay
+  period: 2025-01
+  input:
+    people:
+      parent1:
+        age: 40
+      parent2:
+        age: 38
+      child:
+        age: 6
+        ma_ccfa_maximum_reimbursement: 1_000
+    spm_units:
+      spm_unit:
+        members: [parent1, parent2, child]
+        ma_ccfa_eligible: true
+        ma_ccfa_total_copay: 800
+    households:
+      household:
+        state_code: MA
+        members: [parent1, parent2, child]
+  output:
+    ma_ccfa_maximum_benefit_amount: 200  # 1000 - 800
+
+- name: Single parent with infant - higher reimbursement rate
+  period: 2025-01
+  input:
+    people:
+      parent:
+        age: 25
+      infant:
+        age: 0.5  # 6 months old
+        ma_ccfa_maximum_reimbursement: 1_800  # Infants typically have higher rates
+    spm_units:
+      spm_unit:
+        members: [parent, infant]
+        ma_ccfa_eligible: true
+        ma_ccfa_total_copay: 150
+    households:
+      household:
+        state_code: MA
+        members: [parent, infant]
+  output:
+    ma_ccfa_maximum_benefit_amount: 1_650  # 1800 - 150
+
+- name: Family with disabled child - extended age eligibility
+  period: 2025-01
+  input:
+    people:
+      parent:
+        age: 45
+      disabled_child:
+        age: 14
+        is_disabled: true
+        ma_ccfa_maximum_reimbursement: 1_300
+    spm_units:
+      spm_unit:
+        members: [parent, disabled_child]
+        ma_ccfa_eligible: true
+        ma_ccfa_total_copay: 250
+    households:
+      household:
+        state_code: MA
+        members: [parent, disabled_child]
+  output:
+    ma_ccfa_maximum_benefit_amount: 1_050  # 1300 - 250
+
+- name: Edge case - exactly zero after copay
+  period: 2025-01
+  input:
+    people:
+      parent:
+        age: 32
+      child:
+        age: 7
+        ma_ccfa_maximum_reimbursement: 750
+    spm_units:
+      spm_unit:
+        members: [parent, child]
+        ma_ccfa_eligible: true
+        ma_ccfa_total_copay: 750
+    households:
+      household:
+        state_code: MA
+        members: [parent, child]
+  output:
+    ma_ccfa_maximum_benefit_amount: 0  # 750 - 750 = 0

policyengine_us/tests/policy/baseline/gov/states/ma/eec/ccfa/ma_ccfa_region.yaml

@@ -0,0 +1,23 @@
+- name: Case 1
+  period: 2024-01
+  input:
+    county_str: BERKSHIRE_COUNTY_MA
+    state_code: MA
+  output:
+    ma_ccfa_region: WESTERN_CENTRAL_AND_SOUTHEAST
+
+- name: Case 2
+  period: 2024-01
+  input:
+    county_str: ESSEX_COUNTY_MA
+    state_code: MA
+  output:
+    ma_ccfa_region: NORTHEAST
+
+- name: Case 3
+  period: 2024-01
+  input:
+    county_str: SUFFOLK_COUNTY_MA
+    state_code: MA
+  output:
+    ma_ccfa_region: METRO_AND_BOSTON_METRO

policyengine_us/tests/policy/baseline/gov/states/ma/eec/ccfa/reimbursement/ma_ccfa_center_based_early_education_reimbursement.yaml

@@ -0,0 +1,10 @@
+- name: Case 1, region 1, infant.
+  period: 2025-01
+  absolute_error_margin: 0.2
+  input:
+    age: 0.5
+    county_str: BERKSHIRE_COUNTY_MA
+    ma_ccfa_care_provider_type: CENTER_BASED_CARE_EARLY_EDUCATION
+    state_code: MA
+  output:
+    ma_ccfa_center_based_early_education_reimbursement: 105

policyengine_us/tests/policy/baseline/gov/states/ma/eec/ccfa/reimbursement/ma_ccfa_center_based_school_age_reimbursement.yaml

@@ -0,0 +1,11 @@
+- name: Case 1, region 1, school age, full day.
+  period: 2025-01
+  absolute_error_margin: 0.2
+  input:
+    age: 6
+    county_str: BERKSHIRE_COUNTY_MA
+    ma_ccfa_care_provider_type: CENTER_BASED_CARE_SCHOOL_AGE
+    ma_ccfa_schedule_type: FULL_DAY
+    state_code: MA
+  output:
+    ma_ccfa_center_based_school_age_reimbursement: 49.69

policyengine_us/tests/policy/baseline/gov/states/ma/eec/ccfa/reimbursement/ma_ccfa_family_child_care_reimbursement.yaml

@@ -0,0 +1,10 @@
+- name: Case 1, region 1, 2 years old.
+  period: 2025-01
+  absolute_error_margin: 0.2
+  input:
+    county_str: BERKSHIRE_COUNTY_MA
+    ma_ccfa_care_provider_type: FAMILY_CHILD_CARE
+    age: 2
+    state_code: MA
+  output:
+    ma_ccfa_family_child_care_reimbursement: 49.39

policyengine_us/tests/policy/baseline/gov/states/ma/eec/ccfa/reimbursement/ma_ccfa_head_start_partner_and_kindergarten_reimbursement.yaml

@@ -0,0 +1,10 @@
+- name: Case 1, region 1, full day.
+  period: 2025-01
+  absolute_error_margin: 0.2
+  input:
+    county_str: BERKSHIRE_COUNTY_MA
+    ma_ccfa_care_provider_type: HEAD_START_PARTNER_AND_KINDERGARTEN
+    ma_ccfa_schedule_type: FULL_DAY
+    state_code: MA
+  output:
+    ma_ccfa_head_start_partner_and_kindergarten_reimbursement: 58.09

policyengine_us/tests/policy/baseline/gov/states/ma/eec/ccfa/reimbursement/ma_ccfa_informal_child_care_reimbursement.yaml

@@ -0,0 +1,10 @@
+- name: Case 1, informal child care in relative home.
+  period: 2025-01
+  absolute_error_margin: 0.2
+  input:
+    county_str: BERKSHIRE_COUNTY_MA
+    ma_ccfa_care_provider_type: INFORMAL_CHILD_CARE
+    state_code: MA
+    ma_ccfa_is_in_relatives_home_care: true
+  output:
+    ma_ccfa_informal_child_care_reimbursement: 24.57

policyengine_us/tests/policy/baseline/gov/states/ma/eec/ccfa/reimbursement/ma_ccfa_maximum_reimbursement.yaml

@@ -0,0 +1,27 @@
+- name: Case 1, region 1, center based care school age full day for 10 days.
+  period: 2025-01
+  absolute_error_margin: 0.2
+  input:
+    county_str: BERKSHIRE_COUNTY_MA
+    ma_ccfa_child_age_category: SCHOOL_AGE
+    ma_ccfa_schedule_type: FULL_DAY
+    ma_ccfa_care_provider_type: CENTER_BASED_CARE_SCHOOL_AGE
+    childcare_attending_days_per_month: 10
+    childcare_hours_per_day: 6
+    state_code: MA
+  output:
+    ma_ccfa_maximum_reimbursement: 496.9
+
+- name: Case 2, region 1, informal child care full day for 10 days.
+  period: 2025-01
+  absolute_error_margin: 0.2
+  input:
+    county_str: BERKSHIRE_COUNTY_MA
+    ma_ccfa_care_provider_type: INFORMAL_CHILD_CARE
+    ma_ccfa_is_in_relatives_home_care: true
+    childcare_attending_days_per_month: 10
+    childcare_hours_per_day: 6
+    state_code: MA
+  output:
+    ma_ccfa_uncapped_daily_payment: 24.57
+    ma_ccfa_maximum_reimbursement: 245.7

policyengine_us/tests/policy/baseline/gov/states/ma/eec/ccfa/reimbursement/ma_ccfa_reimbursement_ratio.yaml

@@ -0,0 +1,31 @@
+- name: Case 1, in 2024, 6 hours per day, part time.
+  period: 2024-01
+  input:
+    childcare_hours_per_day: 6
+    state_code: MA
+  output:
+    ma_ccfa_reimbursement_ratio: 0.6
+
+- name: Case 2, in 2024, 7 hours per day, full time.
+  period: 2024-01
+  input:
+    childcare_hours_per_day: 7
+    state_code: MA
+  output:
+    ma_ccfa_reimbursement_ratio: 1
+
+- name: Case 3, in 2025, 6 hours per day, full time.
+  period: 2025-01
+  input:
+    childcare_hours_per_day: 6
+    state_code: MA
+  output:
+    ma_ccfa_reimbursement_ratio: 1
+
+- name: Case 4, in 2025, 5 hours per day, part time.
+  period: 2025-01
+  input:
+    childcare_hours_per_day: 5
+    state_code: MA
+  output:
+    ma_ccfa_reimbursement_ratio: 0.6

policyengine_us/tests/policy/baseline/gov/states/ma/eec/ccfa/reimbursement/ma_ccfa_uncapped_daily_payment.yaml

@@ -0,0 +1,8 @@
+- name: Case 1.
+  period: 2024-01
+  input: 
+    ma_ccfa_center_based_early_education_reimbursement: 105
+    ma_ccfa_care_provider_type: CENTER_BASED_CARE_EARLY_EDUCATION
+    state_code: MA
+  output:
+    ma_ccfa_uncapped_daily_payment: 105

policyengine_us/tests/policy/contrib/aca/ptc_additional_bracket.yaml

@@ -0,0 +1,117 @@
+- name: Single filer at 250% FPL - uses baseline value
+  period: 2026
+  reforms: policyengine_us.reforms.aca.aca_ptc_additional_bracket.aca_ptc_additional_bracket
+  absolute_error_margin: 0.00001
+  input:
+    gov.contrib.aca.ptc_additional_bracket.in_effect: true
+    aca_magi_fraction: 2.5
+  output:
+    aca_ptc_phase_out_rate: 0.04
+
+- name: Single filer at 300% FPL - uses baseline value
+  period: 2026
+  reforms: policyengine_us.reforms.aca.aca_ptc_additional_bracket.aca_ptc_additional_bracket
+  absolute_error_margin: 0.00001
+  input:
+    gov.contrib.aca.ptc_additional_bracket.in_effect: true
+    aca_magi_fraction: 3.0
+  output:
+    aca_ptc_phase_out_rate: 0.06
+
+- name: Single filer at 400% FPL - linear increase to 10%
+  period: 2026
+  reforms: policyengine_us.reforms.aca.aca_ptc_additional_bracket.aca_ptc_additional_bracket
+  absolute_error_margin: 0.00001
+  input:
+    gov.contrib.aca.ptc_additional_bracket.in_effect: true
+    aca_magi_fraction: 4.0
+  output:
+    aca_ptc_phase_out_rate: 0.10
+
+- name: Single filer at 500% FPL - linear increase to 14%
+  period: 2026
+  reforms: policyengine_us.reforms.aca.aca_ptc_additional_bracket.aca_ptc_additional_bracket
+  absolute_error_margin: 0.00001
+  input:
+    gov.contrib.aca.ptc_additional_bracket.in_effect: true
+    aca_magi_fraction: 5.0
+  output:
+    aca_ptc_phase_out_rate: 0.14
+
+- name: Single filer at 600% FPL - linear increase to 18%
+  period: 2026
+  reforms: policyengine_us.reforms.aca.aca_ptc_additional_bracket.aca_ptc_additional_bracket
+  absolute_error_margin: 0.00001
+  input:
+    gov.contrib.aca.ptc_additional_bracket.in_effect: true
+    aca_magi_fraction: 6.0
+  output:
+    aca_ptc_phase_out_rate: 0.18
+
+- name: Single filer at 350% FPL - interpolated value
+  period: 2026
+  reforms: policyengine_us.reforms.aca.aca_ptc_additional_bracket.aca_ptc_additional_bracket
+  absolute_error_margin: 0.00001
+  input:
+    gov.contrib.aca.ptc_additional_bracket.in_effect: true
+    aca_magi_fraction: 3.5
+  output:
+    aca_ptc_phase_out_rate: 0.08
+
+- name: Baseline comparison at 400% FPL - shows difference
+  period: 2026
+  absolute_error_margin: 0.00001
+  input:
+    aca_magi_fraction: 4.0
+  output:
+    aca_ptc_phase_out_rate: 0.0996
+
+- name: Edge case - Lower boundary at 0% FPL
+  period: 2026
+  reforms: policyengine_us.reforms.aca.aca_ptc_additional_bracket.aca_ptc_additional_bracket
+  absolute_error_margin: 0.00001
+  input:
+    gov.contrib.aca.ptc_additional_bracket.in_effect: true
+    aca_magi_fraction: 0.0
+  output:
+    aca_ptc_phase_out_rate: 0.0
+
+- name: Edge case - Lower boundary at 150% FPL (first bracket threshold)
+  period: 2026
+  reforms: policyengine_us.reforms.aca.aca_ptc_additional_bracket.aca_ptc_additional_bracket
+  absolute_error_margin: 0.00001
+  input:
+    gov.contrib.aca.ptc_additional_bracket.in_effect: true
+    aca_magi_fraction: 1.5
+  output:
+    aca_ptc_phase_out_rate: 0.0
+
+- name: Edge case - First positive bracket at 200% FPL
+  period: 2026
+  reforms: policyengine_us.reforms.aca.aca_ptc_additional_bracket.aca_ptc_additional_bracket
+  absolute_error_margin: 0.00001
+  input:
+    gov.contrib.aca.ptc_additional_bracket.in_effect: true
+    aca_magi_fraction: 2.0
+  output:
+    aca_ptc_phase_out_rate: 0.02
+
+- name: Edge case - Upper boundary at 1000% FPL (highest defined bracket)
+  period: 2026
+  reforms: policyengine_us.reforms.aca.aca_ptc_additional_bracket.aca_ptc_additional_bracket
+  absolute_error_margin: 0.00001
+  input:
+    gov.contrib.aca.ptc_additional_bracket.in_effect: true
+    aca_magi_fraction: 10.0
+  output:
+    aca_ptc_phase_out_rate: 0.34
+
+- name: Edge case - Interpolation between 1.5 and 2.0 at 175% FPL
+  period: 2026
+  reforms: policyengine_us.reforms.aca.aca_ptc_additional_bracket.aca_ptc_additional_bracket
+  absolute_error_margin: 0.00001
+  input:
+    gov.contrib.aca.ptc_additional_bracket.in_effect: true
+    aca_magi_fraction: 1.75
+  output:
+    aca_ptc_phase_out_rate: 0.01

policyengine_us/tests/policy/contrib/aca/ptc_simplified_bracket.yaml

@@ -0,0 +1,117 @@
+- name: Single filer at 100% FPL - starts at 0%
+  period: 2028
+  reforms: policyengine_us.reforms.aca.aca_ptc_simplified_bracket.aca_ptc_simplified_bracket
+  absolute_error_margin: 0.00001
+  input:
+    gov.contrib.aca.ptc_simplified_bracket.in_effect: true
+    aca_magi_fraction: 1.0
+  output:
+    aca_ptc_phase_out_rate: 0.0
+
+- name: Single filer at 200% FPL - linear increase to 4%
+  period: 2028
+  reforms: policyengine_us.reforms.aca.aca_ptc_simplified_bracket.aca_ptc_simplified_bracket
+  absolute_error_margin: 0.00001
+  input:
+    gov.contrib.aca.ptc_simplified_bracket.in_effect: true
+    aca_magi_fraction: 2.0
+  output:
+    aca_ptc_phase_out_rate: 0.04
+
+- name: Single filer at 300% FPL - linear increase to 8%
+  period: 2028
+  reforms: policyengine_us.reforms.aca.aca_ptc_simplified_bracket.aca_ptc_simplified_bracket
+  absolute_error_margin: 0.00001
+  input:
+    gov.contrib.aca.ptc_simplified_bracket.in_effect: true
+    aca_magi_fraction: 3.0
+  output:
+    aca_ptc_phase_out_rate: 0.08
+
+- name: Single filer at 400% FPL - linear increase to 12%
+  period: 2028
+  reforms: policyengine_us.reforms.aca.aca_ptc_simplified_bracket.aca_ptc_simplified_bracket
+  absolute_error_margin: 0.00001
+  input:
+    gov.contrib.aca.ptc_simplified_bracket.in_effect: true
+    aca_magi_fraction: 4.0
+  output:
+    aca_ptc_phase_out_rate: 0.12
+
+- name: Single filer at 500% FPL - linear increase to 16%
+  period: 2028
+  reforms: policyengine_us.reforms.aca.aca_ptc_simplified_bracket.aca_ptc_simplified_bracket
+  absolute_error_margin: 0.00001
+  input:
+    gov.contrib.aca.ptc_simplified_bracket.in_effect: true
+    aca_magi_fraction: 5.0
+  output:
+    aca_ptc_phase_out_rate: 0.16
+
+- name: Single filer at 600% FPL - linear increase to 20%
+  period: 2028
+  reforms: policyengine_us.reforms.aca.aca_ptc_simplified_bracket.aca_ptc_simplified_bracket
+  absolute_error_margin: 0.00001
+  input:
+    gov.contrib.aca.ptc_simplified_bracket.in_effect: true
+    aca_magi_fraction: 6.0
+  output:
+    aca_ptc_phase_out_rate: 0.20
+
+- name: Single filer at 150% FPL - interpolated value
+  period: 2028
+  reforms: policyengine_us.reforms.aca.aca_ptc_simplified_bracket.aca_ptc_simplified_bracket
+  absolute_error_margin: 0.00001
+  input:
+    gov.contrib.aca.ptc_simplified_bracket.in_effect: true
+    aca_magi_fraction: 1.5
+  output:
+    aca_ptc_phase_out_rate: 0.02
+
+- name: Baseline comparison at 400% FPL - shows difference
+  period: 2028
+  absolute_error_margin: 0.00001
+  input:
+    aca_magi_fraction: 4.0
+  output:
+    aca_ptc_phase_out_rate: 0.0996
+
+- name: Edge case - Lower boundary at 0% FPL
+  period: 2028
+  reforms: policyengine_us.reforms.aca.aca_ptc_simplified_bracket.aca_ptc_simplified_bracket
+  absolute_error_margin: 0.00001
+  input:
+    gov.contrib.aca.ptc_simplified_bracket.in_effect: true
+    aca_magi_fraction: 0.0
+  output:
+    aca_ptc_phase_out_rate: 0.0
+
+- name: Edge case - Upper boundary at 1000% FPL
+  period: 2028
+  reforms: policyengine_us.reforms.aca.aca_ptc_simplified_bracket.aca_ptc_simplified_bracket
+  absolute_error_margin: 0.00001
+  input:
+    gov.contrib.aca.ptc_simplified_bracket.in_effect: true
+    aca_magi_fraction: 10.0
+  output:
+    aca_ptc_phase_out_rate: 0.36
+
+- name: Edge case - Interpolation between 1.0 and 2.0 at 175% FPL
+  period: 2028
+  reforms: policyengine_us.reforms.aca.aca_ptc_simplified_bracket.aca_ptc_simplified_bracket
+  absolute_error_margin: 0.00001
+  input:
+    gov.contrib.aca.ptc_simplified_bracket.in_effect: true
+    aca_magi_fraction: 1.75
+  output:
+    aca_ptc_phase_out_rate: 0.03
+
+- name: Comparison with additional bracket reform at 600% FPL
+  period: 2028
+  reforms: policyengine_us.reforms.aca.aca_ptc_simplified_bracket.aca_ptc_simplified_bracket
+  absolute_error_margin: 0.00001
+  input:
+    gov.contrib.aca.ptc_simplified_bracket.in_effect: true
+    aca_magi_fraction: 6.0
+  output:
+    aca_ptc_phase_out_rate: 0.20

policyengine_us/variables/gov/states/ma/eec/ccfa/copay/ma_ccfa_base_copay.py

@@ -0,0 +1,27 @@
+from policyengine_us.model_api import *
+
+
+class ma_ccfa_base_copay(Variable):
+    value_type = float
+    entity = SPMUnit
+    unit = USD
+    label = "Massachusetts Child Care Financial Assistance (CCFA) parent base copay"
+    definition_period = MONTH
+    defined_for = StateCode.MA
+    reference = "https://www.mass.gov/doc/eecs-financial-assistance-policy-guide-february-1-2022/download#page=76"
+
+    def formula(spm_unit, period, parameters):
+        p = parameters(period).gov.states.ma.eec.ccfa.copay.fee_level
+
+        # Step 1: Get the family's copay level
+        copay_level = spm_unit("ma_ccfa_copay_level", period)
+
+        # Step 2: Get the fee percentage for that level
+        fee_percentage = p.fee_percentages[copay_level]
+
+        # Step 3: Calculate fee on income above poverty
+        income = spm_unit("ma_ccfa_countable_income", period)
+        fpg = spm_unit("ma_ccfa_fpg", period)
+        income_above_poverty_level = max_(income - fpg, 0)
+
+        return income_above_poverty_level * fee_percentage

policyengine_us/variables/gov/states/ma/eec/ccfa/copay/ma_ccfa_copay_level.py

@@ -0,0 +1,30 @@
+from policyengine_us.model_api import *
+
+
+class ma_ccfa_copay_level(Variable):
+    value_type = int
+    entity = SPMUnit
+    label = "Massachusetts CCSP copay level"
+    definition_period = MONTH
+    defined_for = StateCode.MA
+    reference = "https://www.mass.gov/doc/parent-fee-chart-fy2025/download"
+
+    def formula(spm_unit, period, parameters):
+        p = parameters(period).gov.states.ma.eec.ccfa.copay.fee_level
+        income = spm_unit("ma_ccfa_countable_income", period)
+        family_size = spm_unit("spm_unit_size", period)
+        capped_size = np.clip(family_size, 2, 12)
+        fpg = spm_unit("ma_ccfa_fpg", period)
+
+        # Calculate income as ratio of FPG
+        income_ratio = income / fpg
+
+        # Get the increment for this family size
+        ratio_increment = p.income_ratio_increments[capped_size]
+
+        # Calculate how many increments above 100% FPG the income is.
+        levels_above_fpg = max_(0, income_ratio - 1) / ratio_increment
+
+        fee_level = 1 + np.ceil(levels_above_fpg)
+
+        return min_(fee_level, p.maximum_level)

policyengine_us/variables/gov/states/ma/eec/ccfa/copay/ma_ccfa_total_copay.py

@@ -0,0 +1,35 @@
+from policyengine_us.model_api import *
+
+
+class ma_ccfa_total_copay(Variable):
+    value_type = float
+    entity = SPMUnit
+    unit = USD
+    label = "Massachusetts Child Care Financial Assistance (CCFA) parent total copay"
+    definition_period = MONTH
+    defined_for = StateCode.MA
+    reference = "https://www.mass.gov/doc/eecs-financial-assistance-policy-guide-february-1-2022/download#page=76"
+
+    def formula(spm_unit, period, parameters):
+        # TAFDC recipients get free child care (no copay)
+        tafdc_eligible = spm_unit("ma_tafdc_eligible", period)
+
+        p = parameters(period).gov.states.ma.eec.ccfa.copay.ratio
+        base_copay = spm_unit("ma_ccfa_base_copay", period)
+        eligible_child = spm_unit.members("ma_ccfa_eligible_child", period)
+        num_children = spm_unit.sum(eligible_child)
+
+        first_child_fee = (num_children >= 1) * (base_copay * p.first_child)
+        second_child_fee = (num_children >= 2) * (base_copay * p.second_child)
+
+        additional_children_count = max_(0, num_children - 2)
+        additional_children_fee = additional_children_count * (
+            base_copay * p.additional_child
+        )
+
+        total_copay = (
+            first_child_fee + second_child_fee + additional_children_fee
+        )
+
+        # Return zero copay for TAFDC recipients
+        return where(tafdc_eligible, 0, total_copay)