policyengine-us 1.442.1__py3-none-any.whl → 1.444.0__py3-none-any.whl

policyengine_us/tests/policy/baseline/gov/states/il/hfs/hbwd/eligibility/il_hbwd_employment_eligible.yaml

@@ -0,0 +1,34 @@
+- name: Case 1, employment eligible with employment income.
+  period: 2024-01
+  input:
+    state_code: IL
+    employment_income: 24_000  # $2,000/month
+  output:
+    il_hbwd_employment_eligible: true
+
+- name: Case 2, employment eligible with self-employment income.
+  period: 2024-01
+  input:
+    state_code: IL
+    self_employment_income: 18_000  # $1,500/month
+  output:
+    il_hbwd_employment_eligible: true
+
+- name: Case 3, employment eligible with both.
+  period: 2024-01
+  input:
+    state_code: IL
+    employment_income: 12_000  # $1,000/month
+    self_employment_income: 6_000  # $500/month
+  output:
+    il_hbwd_employment_eligible: true
+
+- name: Case 4, employment ineligible with no earned income.
+  period: 2024-01
+  input:
+    state_code: IL
+    employment_income: 0
+    self_employment_income: 0
+    social_security: 12_000  # $1,000/month
+  output:
+    il_hbwd_employment_eligible: false

policyengine_us/tests/policy/baseline/gov/states/il/hfs/hbwd/eligibility/il_hbwd_immigration_status_eligible.yaml

@@ -0,0 +1,47 @@
+- name: Case 1, citizen eligible.
+  period: 2024-01
+  input:
+    state_code: IL
+    immigration_status: CITIZEN
+  output:
+    il_hbwd_immigration_status_eligible: true
+
+- name: Case 2, legal permanent resident eligible.
+  period: 2024-01
+  input:
+    state_code: IL
+    immigration_status: LEGAL_PERMANENT_RESIDENT
+  output:
+    il_hbwd_immigration_status_eligible: true
+
+- name: Case 3, refugee eligible.
+  period: 2024-01
+  input:
+    state_code: IL
+    immigration_status: REFUGEE
+  output:
+    il_hbwd_immigration_status_eligible: true
+
+- name: Case 4, asylee eligible.
+  period: 2024-01
+  input:
+    state_code: IL
+    immigration_status: ASYLEE
+  output:
+    il_hbwd_immigration_status_eligible: true
+
+- name: Case 5, undocumented ineligible.
+  period: 2024-01
+  input:
+    state_code: IL
+    immigration_status: UNDOCUMENTED
+  output:
+    il_hbwd_immigration_status_eligible: false
+
+- name: Case 6, DACA ineligible.
+  period: 2024-01
+  input:
+    state_code: IL
+    immigration_status: DACA
+  output:
+    il_hbwd_immigration_status_eligible: false

policyengine_us/tests/policy/baseline/gov/states/il/hfs/hbwd/eligibility/il_hbwd_income_eligible.yaml

@@ -0,0 +1,25 @@
+- name: Case 1, income eligible single person below limit.
+  period: 2024-01
+  input:
+    state_code: IL
+    employment_income: 36_000  # $3,000/month
+    social_security: 12_000  # $1,000/month
+  output:
+    il_hbwd_income_eligible: true
+
+- name: Case 2, income eligible at exactly 350% FPL for single.
+  period: 2024-01
+  input:
+    state_code: IL
+    employment_income: 52_716  # $4,393/month
+  output:
+    il_hbwd_income_eligible: true
+
+- name: Case 3, income eligible after exemptions.
+  period: 2024-01
+  input:
+    state_code: IL
+    employment_income: 60_000  # $5,000/month
+  output:
+    il_hbwd_income_eligible: true
+    # Gross $5,000, after expenses and exemptions becomes eligible

policyengine_us/tests/policy/baseline/gov/states/il/hfs/hbwd/il_hbwd_person.yaml

@@ -0,0 +1,34 @@
+- name: Case 1, HBWD person with premium.
+  period: 2024-01
+  absolute_error_margin: 0.01
+  input:
+    state_code: IL
+    il_hbwd_eligible: true
+    il_hbwd_countable_earned_income: 1_000
+    il_hbwd_countable_unearned_income: 1_200
+  output:
+    il_hbwd_person: -100
+    # Premium: $100 (earned $25 + unearned $75)
+    # Earned $1,000 → bracket 4 → $25
+    # Unearned $1,200 → bracket 4 → $75
+    # Benefit: -$100 (cost to individual)
+
+- name: Case 2, HBWD person not eligible.
+  period: 2024-01
+  input:
+    state_code: IL
+    il_hbwd_eligible: false
+  output:
+    il_hbwd_person: 0
+    # Not eligible → no premium → no cost
+
+- name: Case 3, HBWD person with zero premium.
+  period: 2024-01
+  input:
+    state_code: IL
+    il_hbwd_eligible: true
+    il_hbwd_countable_earned_income: 100
+    il_hbwd_countable_unearned_income: 0
+  output:
+    il_hbwd_person: 0
+    # Both income in first bracket → $0 premium

policyengine_us/tests/policy/baseline/gov/states/il/hfs/hbwd/il_hbwd_premium.yaml

@@ -0,0 +1,84 @@
+- name: Case 1, premium with only earned income.
+  period: 2024-01
+  absolute_error_margin: 0.01
+  input:
+    state_code: IL
+    il_hbwd_eligible: true
+    il_hbwd_countable_earned_income: 2_000
+    il_hbwd_countable_unearned_income: 0
+  output:
+    il_hbwd_premium: 50
+    # Earned $2,000 → bracket 8 (2001-2250) → $50
+    # Unearned $0 → bracket 0 → $0
+    # Total: $50
+
+- name: Case 2, premium with earned and unearned.
+  period: 2024-01
+  absolute_error_margin: 0.01
+  input:
+    state_code: IL
+    il_hbwd_eligible: true
+    il_hbwd_countable_earned_income: 1_000
+    il_hbwd_countable_unearned_income: 1_200
+  output:
+    il_hbwd_premium: 100
+    # Earned $1,000 → bracket 4 (1001-1250) → $25
+    # Unearned $1,200 → bracket 4 (1001-1250) → $75
+    # Total: $25 + $75 = $100
+
+- name: Case 3, premium with higher income.
+  period: 2024-01
+  absolute_error_margin: 0.01
+  input:
+    state_code: IL
+    il_hbwd_eligible: true
+    il_hbwd_countable_earned_income: 3_000
+    il_hbwd_countable_unearned_income: 2_000
+  output:
+    il_hbwd_premium: 225
+    # Earned $3,000 → bracket 12 (3001-3250) → $75
+    # Unearned $2,000 → bracket 8 (2001-2250) → $150
+    # Total: $75 + $150 = $225
+
+- name: Case 4, premium capped at $500.
+  period: 2024-01
+  absolute_error_margin: 0.01
+  input:
+    state_code: IL
+    il_hbwd_eligible: true
+    il_hbwd_countable_earned_income: 5_000
+    il_hbwd_countable_unearned_income: 5_000
+  output:
+    il_hbwd_premium: 500
+    # Earned $5,000+ → bracket 20 → $125
+    # Unearned $5,000+ → bracket 20 → $375
+    # Uncapped: $500
+    # Capped: $500
+
+- name: Case 5, no premium in first bracket.
+  period: 2024-01
+  absolute_error_margin: 0.01
+  input:
+    state_code: IL
+    il_hbwd_eligible: true
+    il_hbwd_countable_earned_income: 200
+    il_hbwd_countable_unearned_income: 0
+  output:
+    il_hbwd_premium: 0
+    # Earned $200 → bracket 0 (0-250) → $0
+    # Unearned $0 → bracket 0 → $0
+    # Total: $0
+
+- name: Case 6, verify bracket boundary at $250.
+  period: 2024-01
+  absolute_error_margin: 0.01
+  input:
+    state_code: IL
+    il_hbwd_eligible: true
+    il_hbwd_countable_earned_income: 250
+    il_hbwd_countable_unearned_income: 250
+  output:
+    il_hbwd_premium: 25
+    # Earned $250 → bracket 1 (251-500) → $6
+    # Unearned $250 → bracket 1 (251-500) → $19
+    # Total: $6 + $19 = $25

policyengine_us/tests/policy/baseline/gov/states/il/hfs/hbwd/integration.yaml

@@ -0,0 +1,183 @@
+- name: Case 1, eligible working disabled individual.
+  period: 2024-01
+  absolute_error_margin: 0.01
+  input:
+    state_code: IL
+    age: 28
+    is_ssi_disabled: true
+    employment_income: 24_000  # $2,000/month
+    social_security_disability: 12_000  # $1,000/month
+    spm_unit_cash_assets: 15_000
+  output:
+    # Eligibility components
+    il_hbwd_age_eligible: true
+    il_hbwd_disability_eligible: true
+    il_hbwd_employment_eligible: true
+    il_hbwd_income_eligible: true
+    il_hbwd_asset_eligible: true
+    il_hbwd_eligible: true
+    # Income calculation
+    il_hbwd_gross_earned_income: 2_000  # 24,000 / 12
+    il_hbwd_countable_income: 2_728.13
+    # Earned: $2,000 - $211.55 (expenses) - $50 (exemptions) = $1,738.45
+    # Unearned: $1,000 - $10 (remaining flat exemption)
+    # Total: ~$2,728.13
+    # Premium calculation
+    il_hbwd_premium: 113
+    # Earned $1,713.45 → bracket 6 (1501-1750) → $38
+    # Unearned $1,000 → bracket 4 (1001-1250) → $75
+    # Total: $38 + $75 = $113
+
+- name: Case 2, couple with one eligible member.
+  period: 2024-01
+  absolute_error_margin: 0.01
+  input:
+    people:
+      person1:
+        age: 45
+        is_ssi_disabled: true
+        employment_income: 30_000  # $2,500/month
+        social_security_disability: 9_600  # $800/month
+      person2:
+        age: 43
+        is_ssi_disabled: false
+        employment_income: 36_000  # $3,000/month
+    spm_units:
+      spm_unit:
+        members: [person1, person2]
+        spm_unit_cash_assets: 12_000
+    households:
+      household:
+        members: [person1, person2]
+        state_code: IL
+  output:
+    il_hbwd_eligible: [true, false]
+    # person1: disabled + employed = eligible
+    # person2: not disabled = ineligible
+    il_hbwd_disability_eligible: [true, false]
+    il_hbwd_employment_eligible: [true, true]
+    il_hbwd_income_eligible: [true, true]
+    il_hbwd_asset_eligible: [true, true]
+
+- name: Case 3, self-employed individual with childcare expenses.
+  period: 2024-01
+  absolute_error_margin: 0.01
+  input:
+    people:
+      person1:
+        age: 35
+        is_ssi_disabled: true
+        self_employment_income: 30_000  # $2,500/month
+        monthly_hours_worked: 160  # Full-time
+      person2:
+        age: 5
+    spm_units:
+      spm_unit:
+        members: [person1, person2]
+        childcare_expenses: 1_920  # $160/month
+        spm_unit_cash_assets: 8_000
+    tax_units:
+      tax_unit:
+        members: [person1, person2]
+        tax_unit_dependents: 1
+    households:
+      household:
+        members: [person1, person2]
+        state_code: IL
+  output:
+    il_hbwd_age_eligible: [true, false]
+    il_hbwd_disability_eligible: [true, false]
+    il_hbwd_employment_eligible: [true, false]
+    il_hbwd_eligible: [true, false]
+    # Income calculation for person1
+    il_hbwd_gross_earned_income: [2_500, 0]
+    # $30,000 / 12 = $2,500
+    il_hbwd_countable_earned_income: [2_193.44, 0]
+    # Gross: $2,500
+    # After expenses and exemptions: $2,193.44
+
+- name: Case 4, near income limit boundary.
+  period: 2024-01
+  absolute_error_margin: 0.01
+  input:
+    state_code: IL
+    age: 50
+    is_ssi_disabled: true
+    employment_income: 48_000  # $4,000/month
+    social_security_disability: 4_800  # $400/month
+    spm_unit_cash_assets: 20_000
+  output:
+    il_hbwd_age_eligible: true
+    il_hbwd_disability_eligible: true
+    il_hbwd_employment_eligible: true
+    il_hbwd_eligible: true
+    il_hbwd_income_eligible: true
+    # Total income after deductions: ~$4,089
+    # 350% FPL for single (2024): ~$4,393
+    # Just under limit → eligible
+    il_hbwd_premium: 100
+    # Premium: $100
+
+- name: Case 5, eligible with high income after exemptions.
+  period: 2024-01
+  absolute_error_margin: 0.01
+  input:
+    state_code: IL
+    age: 40
+    is_ssi_disabled: true
+    employment_income: 60_000  # $5,000/month
+    spm_unit_cash_assets: 10_000
+  output:
+    il_hbwd_age_eligible: true
+    il_hbwd_disability_eligible: true
+    il_hbwd_employment_eligible: true
+    il_hbwd_asset_eligible: true
+    il_hbwd_income_eligible: true
+    # Countable income after expenses and exemptions: ~$4,618
+    # With exemptions, now under 350% FPL limit
+    il_hbwd_eligible: true
+
+- name: Case 6, SSDI recipient with part-time work.
+  period: 2024-01
+  absolute_error_margin: 0.01
+  input:
+    state_code: IL
+    age: 55
+    is_ssi_disabled: false
+    social_security_disability: 18_000  # $1,500/month SSDI
+    employment_income: 12_000  # $1,000/month part-time
+    spm_unit_cash_assets: 5_000
+  output:
+    il_hbwd_age_eligible: true
+    il_hbwd_disability_eligible: true  # Via SSDI receipt
+    il_hbwd_employment_eligible: true
+    il_hbwd_income_eligible: true
+    il_hbwd_asset_eligible: true
+    il_hbwd_eligible: true
+    # Income calculation
+    il_hbwd_gross_earned_income: 1_000
+    il_hbwd_countable_income: 2_349.95
+    # Earned after expenses and exemptions: ~$850
+    # Unearned: $1,500
+    # Total: ~$2,349.95
+    il_hbwd_premium: 132
+    # Earned $824.95 → bracket 3 (751-1000) → $19
+    # Unearned $1,500 → bracket 6 (1501-1750) → $113
+    # Total: $19 + $113 = $132
+
+- name: Case 7, ineligible too young.
+  period: 2024-01
+  input:
+    state_code: IL
+    age: 15
+    is_ssi_disabled: true
+    employment_income: 12_000  # $1,000/month
+    spm_unit_cash_assets: 5_000
+  output:
+    il_hbwd_age_eligible: false
+    il_hbwd_disability_eligible: true
+    il_hbwd_employment_eligible: true
+    il_hbwd_income_eligible: true
+    il_hbwd_asset_eligible: true
+    il_hbwd_eligible: false
+    # Age < 16 → ineligible despite meeting other criteria

policyengine_us/tests/policy/contrib/local/ny/nyc_mamdani_income_tax.yaml

@@ -0,0 +1,51 @@
+- name: Person below threshold in 2026
+  period: 2026
+  reforms: policyengine_us.reforms.local.ny.mamdani_income_tax.nyc_mamdani_income_tax
+  input:
+    gov.local.ny.mamdani_income_tax.in_effect: True
+    nyc_taxable_income: 800_000
+    in_nyc: true
+  output:
+    nyc_mamdani_income_tax: 0
+
+- name: Person at threshold in 2026
+  period: 2026
+  reforms: policyengine_us.reforms.local.ny.mamdani_income_tax.nyc_mamdani_income_tax
+  input:
+    gov.local.ny.mamdani_income_tax.in_effect: True
+    nyc_taxable_income: 1_000_000
+    in_nyc: true
+  output:
+    nyc_mamdani_income_tax: 0
+
+- name: Person above threshold in 2026
+  period: 2026
+  reforms: policyengine_us.reforms.local.ny.mamdani_income_tax.nyc_mamdani_income_tax
+  input:
+    gov.local.ny.mamdani_income_tax.in_effect: True
+    nyc_taxable_income: 1_200_000
+    in_nyc: true
+  output:
+    # (1_200_000 - 1_000_000) * 0.02 = 200_000 * 0.02 = 4_000
+    nyc_mamdani_income_tax: 4_000
+
+- name: Person well above threshold in 2026
+  period: 2026
+  reforms: policyengine_us.reforms.local.ny.mamdani_income_tax.nyc_mamdani_income_tax
+  input:
+    gov.local.ny.mamdani_income_tax.in_effect: True
+    nyc_taxable_income: 2_000_000
+    in_nyc: true
+  output:
+    # (2_000_000 - 1_000_000) * 0.02 = 1_000_000 * 0.02 = 20_000
+    nyc_mamdani_income_tax: 20_000
+
+- name: Person not in NYC (no tax)
+  period: 2026
+  reforms: policyengine_us.reforms.local.ny.mamdani_income_tax.nyc_mamdani_income_tax
+  input:
+    gov.local.ny.mamdani_income_tax.in_effect: True
+    nyc_taxable_income: 1_500_000
+    in_nyc: false
+  output:
+    nyc_mamdani_income_tax: 0

policyengine_us/variables/gov/states/il/hfs/hbwd/asset/il_hbwd_countable_assets.py

@@ -0,0 +1,34 @@
+from policyengine_us.model_api import *
+
+
+class il_hbwd_countable_assets(Variable):
+    value_type = float
+    unit = USD
+    entity = Person
+    label = "Illinois Health Benefits for Workers with Disabilities countable assets"
+    definition_period = MONTH
+    reference = (
+        "https://www.law.cornell.edu/regulations/illinois/Ill-Admin-Code-tit-89-SS-120.381",
+        "https://www.law.cornell.edu/regulations/illinois/Ill-Admin-Code-tit-89-SS-120.510",
+        "https://hfs.illinois.gov/medicalprograms/hbwd/eligibility.html",
+    )
+    defined_for = StateCode.IL
+
+    def formula(person, period, parameters):
+        # HBWD exempt assets per § 120.381:
+        # - Primary residence (homestead)
+        # - Personal effects and household goods
+        # - One vehicle (full exemption if essential, $4,500 if not)
+        # - Life insurance ≤$1,500
+        # - Burial resources
+        # - Retirement accounts inaccessible before age 59.5
+        # - Medical savings accounts (26 USC 220)
+        # Currently only implementing vehicle exemption
+        # § 120.381 and § 113.141 have identical vehicle exemption rules,
+        # so using AABD vehicle calculation
+        cash_assets = person.spm_unit("spm_unit_cash_assets", period.this_year)
+        vehicle_value = person.spm_unit(
+            "il_aabd_countable_vehicle_value", period
+        )
+        # TODO: Implement homestead, retirement account, burial, and other exemptions
+        return cash_assets + vehicle_value

policyengine_us/variables/gov/states/il/hfs/hbwd/eligibility/il_hbwd_age_eligible.py

@@ -0,0 +1,20 @@
+from policyengine_us.model_api import *
+
+
+class il_hbwd_age_eligible(Variable):
+    value_type = bool
+    entity = Person
+    label = (
+        "Illinois Health Benefits for Workers with Disabilities age eligible"
+    )
+    definition_period = MONTH
+    reference = (
+        "https://www.law.cornell.edu/regulations/illinois/Ill-Admin-Code-tit-89-SS-120.510",
+        "https://hfs.illinois.gov/medicalprograms/hbwd/eligibility.html",
+    )
+    defined_for = StateCode.IL
+
+    def formula(person, period, parameters):
+        p = parameters(period).gov.states.il.hfs.hbwd.eligibility
+        age = person("monthly_age", period)
+        return p.age.calc(age)

policyengine_us/variables/gov/states/il/hfs/hbwd/eligibility/il_hbwd_asset_eligible.py

@@ -0,0 +1,21 @@
+from policyengine_us.model_api import *
+
+
+class il_hbwd_asset_eligible(Variable):
+    value_type = bool
+    entity = Person
+    label = (
+        "Illinois Health Benefits for Workers with Disabilities asset eligible"
+    )
+    definition_period = MONTH
+    reference = (
+        "https://www.law.cornell.edu/regulations/illinois/Ill-Admin-Code-tit-89-SS-120.510",
+        "https://hfs.illinois.gov/medicalprograms/hbwd/eligibility.html",
+    )
+    defined_for = StateCode.IL
+
+    def formula(person, period, parameters):
+        p = parameters(period).gov.states.il.hfs.hbwd.eligibility
+        # Check countable assets against $25,000 limit
+        countable_assets = person("il_hbwd_countable_assets", period)
+        return countable_assets <= p.asset.limit

policyengine_us/variables/gov/states/il/hfs/hbwd/eligibility/il_hbwd_disability_eligible.py

@@ -0,0 +1,20 @@
+from policyengine_us.model_api import *
+
+
+class il_hbwd_disability_eligible(Variable):
+    value_type = bool
+    entity = Person
+    label = "Illinois Health Benefits for Workers with Disabilities disability eligible"
+    definition_period = MONTH
+    reference = (
+        "https://www.law.cornell.edu/regulations/illinois/Ill-Admin-Code-tit-89-SS-120.510",
+        "https://hfs.illinois.gov/medicalprograms/hbwd/eligibility.html",
+    )
+    defined_for = StateCode.IL
+
+    def formula(person, period, parameters):
+        # Must meet Social Security Administration's definition of disability
+        is_ssi_disabled = person("is_ssi_disabled", period)
+        # Or currently receiving SSDI
+        receives_ssdi = person("social_security_disability", period) > 0
+        return is_ssi_disabled | receives_ssdi

policyengine_us/variables/gov/states/il/hfs/hbwd/eligibility/il_hbwd_eligible.py

@@ -0,0 +1,33 @@
+from policyengine_us.model_api import *
+
+
+class il_hbwd_eligible(Variable):
+    value_type = bool
+    entity = Person
+    label = "Illinois Health Benefits for Workers with Disabilities eligible"
+    definition_period = MONTH
+    reference = (
+        "https://www.law.cornell.edu/regulations/illinois/Ill-Admin-Code-tit-89-SS-120.510",
+        "https://hfs.illinois.gov/medicalprograms/hbwd/eligibility.html",
+        "https://hfs.illinois.gov/medicalprograms/hbwd.html",
+    )
+    defined_for = StateCode.IL
+
+    def formula(person, period, parameters):
+        age_eligible = person("il_hbwd_age_eligible", period)
+        disability_eligible = person("il_hbwd_disability_eligible", period)
+        employment_eligible = person("il_hbwd_employment_eligible", period)
+        income_eligible = person("il_hbwd_income_eligible", period)
+        asset_eligible = person("il_hbwd_asset_eligible", period)
+        immigration_eligible = person(
+            "il_hbwd_immigration_status_eligible", period
+        )
+
+        return (
+            age_eligible
+            & disability_eligible
+            & employment_eligible
+            & income_eligible
+            & asset_eligible
+            & immigration_eligible
+        )

policyengine_us/variables/gov/states/il/hfs/hbwd/eligibility/il_hbwd_employment_eligible.py

@@ -0,0 +1,25 @@
+from policyengine_us.model_api import *
+
+
+class il_hbwd_employment_eligible(Variable):
+    value_type = bool
+    entity = Person
+    label = "Illinois Health Benefits for Workers with Disabilities employment eligible"
+    definition_period = MONTH
+    reference = (
+        "https://www.law.cornell.edu/regulations/illinois/Ill-Admin-Code-tit-89-SS-120.510",
+        "https://hfs.illinois.gov/medicalprograms/hbwd/eligibility.html",
+    )
+    defined_for = StateCode.IL
+
+    def formula(person, period, parameters):
+        # Per § 120.510(l)(1), employment is verified by current payment
+        # under FICA or IMRF. We use earned income as a proxy for
+        # employment with FICA contributions.
+        #
+        # Not currently modeled:
+        # - § 120.510(l)(2)(A): Future employment exception (60 days)
+        # - § 120.510(l)(2)(B): Medical inability grace period (90 days)
+        # - § 120.510(l)(2)(C): Job loss grace period (30 days)
+        earned_income = person("il_hbwd_gross_earned_income", period)
+        return earned_income > 0

policyengine_us/variables/gov/states/il/hfs/hbwd/eligibility/il_hbwd_immigration_status_eligible.py

@@ -0,0 +1,26 @@
+from policyengine_us.model_api import *
+
+
+class il_hbwd_immigration_status_eligible(Variable):
+    value_type = bool
+    entity = Person
+    label = "Illinois Health Benefits for Workers with Disabilities immigration status eligible"
+    definition_period = MONTH
+    reference = (
+        "https://www.law.cornell.edu/regulations/illinois/Ill-Admin-Code-tit-89-SS-120.310",
+        "https://www.law.cornell.edu/regulations/illinois/Ill-Admin-Code-tit-89-SS-120.510",
+    )
+    defined_for = StateCode.IL
+
+    def formula(person, period, parameters):
+        p = parameters(period).gov.states.il.hfs.hbwd.eligibility
+        immigration_status = person("immigration_status", period)
+        is_citizen = (
+            immigration_status == immigration_status.possible_values.CITIZEN
+        )
+        immigration_status_str = immigration_status.decode_to_str()
+        has_qualifying_status = np.isin(
+            immigration_status_str,
+            p.qualified_noncitizen_statuses,
+        )
+        return has_qualifying_status | is_citizen

policyengine_us/variables/gov/states/il/hfs/hbwd/eligibility/il_hbwd_income_eligible.py

@@ -0,0 +1,23 @@
+from policyengine_us.model_api import *
+
+
+class il_hbwd_income_eligible(Variable):
+    value_type = bool
+    entity = Person
+    label = "Illinois Health Benefits for Workers with Disabilities income eligible"
+    definition_period = MONTH
+    reference = (
+        "https://www.law.cornell.edu/regulations/illinois/Ill-Admin-Code-tit-89-SS-120.510",
+        "https://hfs.illinois.gov/medicalprograms/hbwd/eligibility.html",
+    )
+    defined_for = StateCode.IL
+
+    def formula(person, period, parameters):
+        p = parameters(period).gov.states.il.hfs.hbwd.eligibility
+        # Income limit is 350% of FPL
+        fpg = person.spm_unit("spm_unit_fpg", period)
+        income_limit = fpg * p.income.limit
+        # Check household countable income against limit
+        # Per § 120.510(f), counts individual + spouse income
+        countable_income = person.spm_unit("il_hbwd_countable_income", period)
+        return countable_income <= income_limit