policyengine-us 1.418.0__py3-none-any.whl → 1.419.0__py3-none-any.whl

policyengine_us/tests/policy/baseline/gov/states/tx/tanf/integration.yaml

@@ -0,0 +1,291 @@
+- name: Case 1, single parent with low income eligible and receives full grant.
+  period: 2025-01
+  input:
+    people:
+      person1:
+        age: 30
+        is_tax_unit_head_or_spouse: true
+        employment_income: 0
+      person2:
+        age: 10
+    spm_units:
+      spm_unit:
+        members: [person1, person2]
+        spm_unit_cash_assets: 500
+        is_tanf_enrolled: false
+    households:
+      household:
+        members: [person1, person2]
+        state_code: TX
+  output:
+    tx_tanf_assistance_unit_size: 2
+    tx_tanf_caretaker_type: CARETAKER_WITHOUT_SECOND_PARENT
+    tx_tanf_budgetary_needs: 650
+    tx_tanf_recognizable_needs_test: true
+    # Recognizable needs = 650 * 0.25 = 162.5
+    # Countable income (0) < recognizable needs (162.5) → Pass
+    tx_tanf_budgetary_needs_test: true
+    # Countable income (0) < budgetary needs (650) → Pass
+    tx_tanf_countable_income: 0
+    # No earned or unearned income
+    tx_tanf_countable_resources: 500
+    # Cash assets only, no vehicle: 500 + 0 = 500
+    tx_tanf_income_eligible: true
+    # Applicant: passes both budgetary AND recognizable needs tests
+    tx_tanf_resources_eligible: true
+    # Resources (500) <= limit (1,000) → Pass
+    tx_tanf_eligible: true
+    tx_tanf_payment_standard: 320
+    # Caretaker without second parent, size 2 → $320
+    tx_tanf: 320
+    # Payment = max(payment_standard - countable_income, minimum_grant)
+    # Payment = max(320 - 0, 10) = 320
+
+- name: Case 2, household with earnings and child care expenses.
+  period: 2025-01
+  absolute_error_margin: 0.01
+  input:
+    people:
+      person1:
+        age: 30
+        is_tax_unit_head_or_spouse: true
+        employment_income: 3_000  # $250/month
+      person2:
+        age: 1
+    spm_units:
+      spm_unit:
+        members: [person1, person2]
+        spm_unit_cash_assets: 800
+        childcare_expenses: 2_400  # $200/month
+        is_tanf_enrolled: false
+    households:
+      household:
+        members: [person1, person2]
+        state_code: TX
+  output:
+    tx_tanf_assistance_unit_size: 2
+    tx_tanf_caretaker_type: CARETAKER_WITHOUT_SECOND_PARENT
+    tx_tanf_gross_earned_income: [250, 0]
+    # Person1: 3,000 / 12 = 250, Person2: 0
+    tx_tanf_earned_income_after_disregard_person: [87.1, 0]
+    # Person1 (applicant, 1/3 disregard):
+    #   After work expense: 250 - 120 = 130
+    #   Disregard = 130 / 3 = 43.33
+    #   After disregard = 130 - 43.33 = 86.67 ≈ 87.1
+    tx_tanf_dependent_care_deduction: 200
+    # Child age 1 → $200/month cap (min of actual $200 or cap $200)
+    tx_tanf_countable_earned_income: 0
+    # Sum person-level: 87.1 + 0 = 87.1
+    # After dependent care: max(87.1 - 200, 0) = 0
+    tx_tanf_countable_income: 0
+    # Earned (0) + unearned (0) = 0
+    tx_tanf_budgetary_needs: 650
+    tx_tanf_income_eligible: true
+    # Countable income (0) < budgetary needs (650) AND recognizable needs (162.5)
+    tx_tanf_countable_resources: 800
+    tx_tanf_resources_eligible: true
+    # Resources (800) <= limit (1,000) → Pass
+    tx_tanf_eligible: true
+    tx_tanf_payment_standard: 320
+    tx_tanf: 320
+    # Payment = max(320 - 0, 10) = 320
+
+- name: Case 3, two parent household exceeds resource limit.
+  period: 2025-01
+  input:
+    people:
+      person1:
+        age: 30
+        is_tax_unit_head_or_spouse: true
+        employment_income: 0
+      person2:
+        age: 29
+        is_tax_unit_head_or_spouse: true
+        employment_income: 0
+      person3:
+        age: 10
+    spm_units:
+      spm_unit:
+        members: [person1, person2, person3]
+        spm_unit_cash_assets: 15_000
+        is_tanf_enrolled: false
+    households:
+      household:
+        members: [person1, person2, person3]
+        state_code: TX
+  output:
+    tx_tanf_assistance_unit_size: 3
+    # Both parents + child eligible
+    tx_tanf_caretaker_type: CARETAKER_WITH_SECOND_PARENT
+    # Two eligible parents
+    tx_tanf_countable_income: 0
+    tx_tanf_budgetary_needs: 824
+    # Caretaker with second parent, size 3 → $824
+    tx_tanf_recognizable_needs_test: true
+    # Recognizable needs = 824 * 0.25 = 206
+    # Countable income (0) < recognizable needs (206) → Pass
+    tx_tanf_budgetary_needs_test: true
+    # Countable income (0) < budgetary needs (824) → Pass
+    tx_tanf_income_eligible: true
+    # Applicant: passes both budgetary AND recognizable needs tests
+    tx_tanf_countable_resources: 15_000
+    # Cash assets: 15,000
+    tx_tanf_resources_eligible: false
+    # Resources (15,000) > limit (1,000) → Fail
+    tx_tanf_eligible: false
+    # Failed resources test
+    tx_tanf_payment_standard: 405
+    # Even though ineligible, payment standard would be $405 for this household
+    tx_tanf: 0
+    # Ineligible → no payment
+
+- name: Case 4, applicant vs continuing recipient with same income.
+  period: 2025-01
+  absolute_error_margin: 0.01
+  input:
+    people:
+      person1:
+        age: 30
+        is_tax_unit_head_or_spouse: true
+        employment_income: 4_800  # $400/month
+      person2:
+        age: 10
+    spm_units:
+      spm_unit:
+        members: [person1, person2]
+        spm_unit_cash_assets: 800
+        is_tanf_enrolled: true  # Continuing recipient
+    households:
+      household:
+        members: [person1, person2]
+        state_code: TX
+  output:
+    tx_tanf_assistance_unit_size: 2
+    tx_tanf_gross_earned_income: [400, 0]
+    tx_tanf_earned_income_after_disregard_person: [28, 0]
+    # Person1 (continuing, 90% disregard):
+    #   After work expense: 400 - 120 = 280
+    #   After disregard: 280 - min(280 * 0.9, 1400) = 280 - 252 = 28
+    tx_tanf_countable_earned_income: 28
+    tx_tanf_countable_income: 28
+    tx_tanf_recognizable_needs_test: true
+    # Recognizable needs = 650 * 0.25 = 162.5
+    # Countable income (28) < recognizable needs (162.5) → Pass
+    tx_tanf_income_eligible: true
+    # Continuing: only needs to pass recognizable needs test
+    tx_tanf_eligible: true
+    tx_tanf_payment_standard: 320
+    tx_tanf: 292
+    # Payment = max(320 - 28, 10) = 292
+
+- name: Case 5, same household as applicant instead of continuing.
+  period: 2025-01
+  absolute_error_margin: 0.01
+  input:
+    people:
+      person1:
+        age: 30
+        is_tax_unit_head_or_spouse: true
+        employment_income: 4_800  # $400/month
+      person2:
+        age: 10
+    spm_units:
+      spm_unit:
+        members: [person1, person2]
+        spm_unit_cash_assets: 800
+        is_tanf_enrolled: false  # New applicant
+    households:
+      household:
+        members: [person1, person2]
+        state_code: TX
+  output:
+    tx_tanf_assistance_unit_size: 2
+    tx_tanf_gross_earned_income: [400, 0]
+    tx_tanf_earned_income_after_disregard_person: [187.6, 0]
+    # Person1 (applicant, 1/3 disregard):
+    #   After work expense: 400 - 120 = 280
+    #   Disregard = 280 / 3 = 93.33
+    #   After disregard = 280 - 93.33 = 186.67 ≈ 187.6
+    tx_tanf_countable_earned_income: 187.6
+    tx_tanf_countable_income: 187.6
+    tx_tanf_budgetary_needs_test: true
+    # Countable income (187.6) < budgetary needs (650) → Pass
+    tx_tanf_recognizable_needs_test: false
+    # Countable income (187.6) > recognizable needs (162.5) → Fail
+    tx_tanf_income_eligible: false
+    # Applicant: must pass BOTH budgetary AND recognizable needs tests
+    tx_tanf_eligible: false
+    tx_tanf: 0
+
+- name: Case 6, mixed immigration status child-only case.
+  period: 2025-01
+  input:
+    people:
+      person1:
+        age: 30
+        is_tax_unit_head_or_spouse: true
+        employment_income: 0
+        immigration_status: UNDOCUMENTED
+      person2:
+        age: 10
+        immigration_status: CITIZEN
+      person3:
+        age: 8
+        immigration_status: CITIZEN
+    spm_units:
+      spm_unit:
+        members: [person1, person2, person3]
+        spm_unit_cash_assets: 500
+        is_tanf_enrolled: false
+    households:
+      household:
+        members: [person1, person2, person3]
+        state_code: TX
+  output:
+    tx_tanf_assistance_unit_size: 2
+    # Only the 2 citizen children eligible, parent ineligible
+    tx_tanf_caretaker_type: NON_CARETAKER
+    # No eligible parents → child-only case
+    tx_tanf_budgetary_needs: 369
+    # Non-caretaker, size 2 → $369
+    tx_tanf_countable_income: 0
+    tx_tanf_income_eligible: true
+    tx_tanf_resources_eligible: true
+    tx_tanf_eligible: true
+    tx_tanf_payment_standard: 182
+    # Non-caretaker, size 2 → $182
+    tx_tanf: 182
+
+- name: Case 7, child-only case with children receiving SSI.
+  period: 2025-01
+  input:
+    people:
+      person1:
+        age: 30
+        is_tax_unit_head_or_spouse: true
+        employment_income: 0
+      person2:
+        age: 10
+        ssi: 900
+      person3:
+        age: 8
+    spm_units:
+      spm_unit:
+        members: [person1, person2, person3]
+        spm_unit_cash_assets: 500
+        is_tanf_enrolled: false
+    households:
+      household:
+        members: [person1, person2, person3]
+        state_code: TX
+  output:
+    tx_tanf_assistance_unit_size: 2
+    # Parent + child without SSI eligible
+    # Child receiving SSI excluded from assistance unit
+    tx_tanf_caretaker_type: CARETAKER_WITHOUT_SECOND_PARENT
+    tx_tanf_countable_income: 0
+    tx_tanf_income_eligible: true
+    tx_tanf_resources_eligible: true
+    tx_tanf_eligible: true
+    tx_tanf_payment_standard: 320
+    tx_tanf: 320

policyengine_us/tests/policy/baseline/gov/states/tx/tanf/ottanf/tx_ottanf.yaml

@@ -0,0 +1,47 @@
+- name: Case 1, eligible for OTTANF receives $83.33/month.
+  period: 2025-01
+  absolute_error_margin: 0.01
+  input:
+    tx_ottanf_eligible: true
+    state_code: TX
+  output:
+    tx_ottanf: 83.33
+    # Eligible → receives $1,000 / 12 = $83.33/month equivalent
+
+- name: Case 2, not eligible for OTTANF receives nothing.
+  period: 2025-01
+  input:
+    tx_ottanf_eligible: false
+    state_code: TX
+  output:
+    tx_ottanf: 0
+    # Not eligible → no payment
+
+- name: Case 3, integration test with full scenario.
+  period: 2025-01
+  absolute_error_margin: 0.3
+  input:
+    people:
+      person1:
+        age: 30
+        is_tax_unit_head_or_spouse: true
+        employment_income: 2_400  # $200/month - low enough to pass TANF
+        immigration_status: CITIZEN
+      person2:
+        age: 10
+        immigration_status: CITIZEN
+    spm_units:
+      spm_unit:
+        members: [person1, person2]
+        spm_unit_size: 2
+        spm_unit_cash_assets: 800
+        tx_ottanf_crisis_criteria: true
+    households:
+      household:
+        members: [person1, person2]
+        state_code: TX
+  output:
+    tx_ottanf_eligible: true
+    # Meets TANF eligibility + $10 grant + crisis criteria
+    tx_ottanf: 83.33
+    # One-time payment of $1,000 / 12 = $83.33/month equivalent

policyengine_us/tests/policy/baseline/gov/states/tx/tanf/ottanf/tx_ottanf_crisis_criteria.yaml

@@ -0,0 +1,17 @@
+- name: Case 1, household meets crisis criteria.
+  period: 2025-01
+  input:
+    tx_ottanf_crisis_criteria: true
+    state_code: TX
+  output:
+    tx_ottanf_crisis_criteria: true
+    # User input - household experiencing crisis
+
+- name: Case 2, household does not meet crisis criteria.
+  period: 2025-01
+  input:
+    tx_ottanf_crisis_criteria: false
+    state_code: TX
+  output:
+    tx_ottanf_crisis_criteria: false
+    # User input - household not experiencing crisis

policyengine_us/tests/policy/baseline/gov/states/tx/tanf/ottanf/tx_ottanf_eligible.yaml

@@ -0,0 +1,158 @@
+- name: Case 1 - Eligible (all requirements met)
+  period: 2025-01
+  input:
+    people:
+      person1:
+        age: 30
+        employment_income: 2_400  # $200/month - low enough to pass TANF
+      person2:
+        age: 10
+    spm_units:
+      spm_unit:
+        members: [person1, person2]
+        spm_unit_size: 2
+        spm_unit_cash_assets: 500
+        tx_ottanf_crisis_criteria: true
+    households:
+      household:
+        members: [person1, person2]
+        state_code: TX
+  output:
+    tx_ottanf_eligible: true
+    # Low income passes TANF eligibility, meets $10 grant minimum, has crisis
+
+- name: Case 2 - Not eligible (no crisis criteria)
+  period: 2025-01
+  input:
+    people:
+      person1:
+        age: 30
+        employment_income: 2_400
+      person2:
+        age: 10
+    spm_units:
+      spm_unit:
+        members: [person1, person2]
+        spm_unit_size: 2
+        spm_unit_cash_assets: 500
+        tx_ottanf_crisis_criteria: false
+    households:
+      household:
+        members: [person1, person2]
+        state_code: TX
+  output:
+    tx_ottanf_eligible: false
+    # Fails crisis criteria requirement
+
+- name: Case 3 - Not eligible (income too high for TANF)
+  period: 2025-01
+  input:
+    people:
+      person1:
+        age: 30
+        employment_income: 48_000  # $4,000/month - way too high
+      person2:
+        age: 10
+    spm_units:
+      spm_unit:
+        members: [person1, person2]
+        spm_unit_size: 2
+        spm_unit_cash_assets: 500
+        tx_ottanf_crisis_criteria: true
+    households:
+      household:
+        members: [person1, person2]
+        state_code: TX
+  output:
+    tx_ottanf_eligible: false
+    # Income too high, fails TANF eligibility
+
+- name: Case 4 - Not eligible (resources too high)
+  period: 2025-01
+  input:
+    people:
+      person1:
+        age: 30
+        employment_income: 2_400
+      person2:
+        age: 10
+    spm_units:
+      spm_unit:
+        members: [person1, person2]
+        spm_unit_size: 2
+        spm_unit_cash_assets: 2_000  # Over $1,000 limit
+        tx_ottanf_crisis_criteria: true
+    households:
+      household:
+        members: [person1, person2]
+        state_code: TX
+  output:
+    tx_ottanf_eligible: false
+    # Resources too high, fails TANF resources eligibility
+
+- name: Case 5 - Not eligible (no eligible child)
+  period: 2025-01
+  input:
+    people:
+      person1:
+        age: 30
+        employment_income: 2_400
+    spm_units:
+      spm_unit:
+        members: [person1]
+        spm_unit_size: 1
+        spm_unit_cash_assets: 500
+        tx_ottanf_crisis_criteria: true
+    households:
+      household:
+        members: [person1]
+        state_code: TX
+  output:
+    tx_ottanf_eligible: false
+    # No eligible child, fails TANF child requirement
+
+- name: Case 6 - Eligible (low income applicant)
+  period: 2025-01
+  input:
+    people:
+      person1:
+        age: 30
+        employment_income: 1_200  # $100/month
+      person2:
+        age: 5
+    spm_units:
+      spm_unit:
+        members: [person1, person2]
+        spm_unit_size: 2
+        spm_unit_cash_assets: 200
+        tx_ottanf_crisis_criteria: true
+    households:
+      household:
+        members: [person1, person2]
+        state_code: TX
+  output:
+    tx_ottanf_eligible: true
+    # Very low income, passes all TANF tests
+
+- name: Case 7 - Eligible (with childcare deduction)
+  period: 2025-01
+  input:
+    people:
+      person1:
+        employment_income: 6_000  # $500/month
+      person2:
+        age: 1
+    spm_units:
+      spm_unit:
+        members: [person1, person2]
+        spm_unit_size: 2
+        spm_unit_cash_assets: 500
+        childcare_expenses: 2_400  # $200/month
+        tx_ottanf_crisis_criteria: true
+    households:
+      household:
+        members: [person1, person2]
+        state_code: TX
+  output:
+    tx_ottanf_eligible: true
+    # With childcare deduction, income is low enough to pass

policyengine_us/tests/policy/baseline/gov/states/tx/tanf/resources/tx_tanf_countable_resources.yaml

@@ -0,0 +1,39 @@
+- name: Case 1, only cash assets.
+  period: 2025-01
+  input:
+    spm_unit_cash_assets: 6_000
+    household_vehicles_value: 0
+    state_code: TX
+  output:
+    tx_tanf_countable_resources: 6_000
+    # Cash assets (6,000) + countable vehicle (0) = 6,000
+
+- name: Case 2, cash assets plus vehicle under exemption.
+  period: 2025-01
+  input:
+    spm_unit_cash_assets: 6_000
+    household_vehicles_value: 4_000
+    state_code: TX
+  output:
+    tx_tanf_countable_resources: 6_000
+    # Cash assets (6,000) + max(4,000 - 4,650, 0) = 6,000 + 0 = 6,000
+
+- name: Case 3, vehicle exceeds exemption.
+  period: 2025-01
+  input:
+    spm_unit_cash_assets: 6_000
+    household_vehicles_value: 12_000
+    state_code: TX
+  output:
+    tx_tanf_countable_resources: 13_350
+    # Cash assets (6,000) + max(12,000 - 4,650, 0) = 6,000 + 7,350 = 13,350
+
+- name: Case 4, no assets.
+  period: 2025-01
+  input:
+    spm_unit_cash_assets: 0
+    household_vehicles_value: 0
+    state_code: TX
+  output:
+    tx_tanf_countable_resources: 0
+    # No cash or vehicle assets

policyengine_us/tests/policy/baseline/gov/states/tx/tanf/tx_regular_tanf.yaml

@@ -0,0 +1,74 @@
+- name: Case 1, regular TANF higher than OTTANF.
+  period: 2025-01
+  absolute_error_margin: 0.3
+  input:
+    tx_regular_tanf: 320
+    tx_ottanf: 83.33
+    state_code: TX
+  output:
+    tx_tanf: 320
+    # Regular TANF ($320/month) > OTTANF ($83.33/month) → Choose TANF
+
+- name: Case 2, OTTANF higher than regular TANF.
+  period: 2025-01
+  absolute_error_margin: 0.3
+  input:
+    tx_regular_tanf: 0
+    tx_ottanf: 83.33
+    state_code: TX
+  output:
+    tx_tanf: 83.33
+    # Regular TANF ($0) < OTTANF ($83.33/month) → Choose OTTANF
+
+- name: Case 3, both zero.
+  period: 2025-01
+  input:
+    tx_regular_tanf: 0
+    tx_ottanf: 0
+    state_code: TX
+  output:
+    tx_tanf: 0
+    # Both zero → zero
+
+- name: Case 4, equal amounts.
+  period: 2025-01
+  absolute_error_margin: 0.3
+  input:
+    tx_regular_tanf: 83.33
+    tx_ottanf: 83.33
+    state_code: TX
+  output:
+    tx_tanf: 83.33
+    # Both equal → returns 83.33
+
+- name: Case 5, integration test regular TANF better for low income.
+  period: 2025-01
+  absolute_error_margin: 0.3
+  input:
+    people:
+      person1:
+        age: 30
+        is_tax_unit_head_or_spouse: true
+        employment_income: 0
+        immigration_status: CITIZEN
+      person2:
+        age: 10
+        immigration_status: CITIZEN
+    spm_units:
+      spm_unit:
+        members: [person1, person2]
+        spm_unit_cash_assets: 500
+        is_tanf_enrolled: false
+        tx_ottanf_crisis_criteria: true
+    households:
+      household:
+        members: [person1, person2]
+        state_code: TX
+  output:
+    tx_regular_tanf: 320
+    # Low income → eligible for regular TANF
+    tx_ottanf: 83.33
+    # Also eligible for OTTANF
+    tx_tanf: 320
+    # Regular TANF ($320) > OTTANF ($83.33) → Choose TANF
+

policyengine_us/tests/policy/baseline/gov/states/tx/tanf/tx_tanf.yaml

@@ -0,0 +1,89 @@
+- name: Case 1, single parent with no income receives full grant.
+  period: 2025-01
+  input:
+    people:
+      person1:
+        age: 30
+        is_tax_unit_head_or_spouse: true
+        employment_income: 0
+      person2:
+        age: 10
+    spm_units:
+      spm_unit:
+        members: [person1, person2]
+        spm_unit_cash_assets: 800
+        is_tanf_enrolled: false
+    households:
+      household:
+        members: [person1, person2]
+        state_code: TX
+  output:
+    tx_regular_tanf: 320
+
+- name: Case 2, benefit reduced by countable income.
+  period: 2025-01
+  absolute_error_margin: 0.01
+  input:
+    people:
+      person1:
+        age: 30
+        is_tax_unit_head_or_spouse: true
+        employment_income: 3_000
+      person2:
+        age: 10
+    spm_units:
+      spm_unit:
+        members: [person1, person2]
+        spm_unit_cash_assets: 800
+        is_tanf_enrolled: false
+    households:
+      household:
+        members: [person1, person2]
+        state_code: TX
+  output:
+    tx_regular_tanf: 232.90
+
+- name: Case 3, minimum grant applied.
+  period: 2025-01
+  absolute_error_margin: 0.01
+  input:
+    people:
+      person1:
+        age: 30
+        is_tax_unit_head_or_spouse: true
+        employment_income: 3_720
+      person2:
+        age: 10
+    spm_units:
+      spm_unit:
+        members: [person1, person2]
+        spm_unit_cash_assets: 800
+        is_tanf_enrolled: false
+    households:
+      household:
+        members: [person1, person2]
+        state_code: TX
+  output:
+    tx_regular_tanf: 192.70
+
+- name: Case 4, ineligible household receives zero.
+  period: 2025-01
+  input:
+    people:
+      person1:
+        age: 30
+        is_tax_unit_head_or_spouse: true
+        employment_income: 24_000
+      person2:
+        age: 10
+    spm_units:
+      spm_unit:
+        members: [person1, person2]
+        spm_unit_cash_assets: 800
+        is_tanf_enrolled: false
+    households:
+      household:
+        members: [person1, person2]
+        state_code: TX
+  output:
+    tx_regular_tanf: 0