policyengine-us 1.441.3__py3-none-any.whl → 1.504.0__py3-none-any.whl

policyengine_us/variables/gov/states/hi/dhs/tanf/income/hi_tanf_dependent_care_deduction.py

@@ -0,0 +1,40 @@
+from policyengine_us.model_api import *
+
+
+class hi_tanf_dependent_care_deduction(Variable):
+    value_type = float
+    entity = SPMUnit
+    label = "Hawaii TANF dependent care deduction"
+    unit = USD
+    definition_period = MONTH
+    reference = (
+        "https://humanservices.hawaii.gov/wp-content/uploads/2024/12/Hawaii_TANF_State_Plan_Signed_Certified-Eff_20231001.pdf#page=20",
+    )
+    defined_for = StateCode.HI
+
+    def formula(spm_unit, period, parameters):
+        p = parameters(period).gov.states.hi.dhs.tanf.deductions.dependent_care
+
+        # Get actual childcare expenses (YEAR variable, auto-converts to monthly)
+        expenses = spm_unit("childcare_expenses", period)
+
+        # Count children in the unit for the per-child cap
+        person = spm_unit.members
+        is_child = person("is_child", period.this_year)
+        num_children = spm_unit.sum(is_child)
+
+        # Determine rate based on MAX of adult hours
+        # If either parent works full-time, use full-time rate
+        is_adult = ~person("is_child", period.this_year)
+        hours = person("weekly_hours_worked_before_lsr", period.this_year)
+        # Only consider adult hours (children get 0)
+        adult_hours = where(is_adult, hours, 0)
+        max_adult_hours = spm_unit.max(adult_hours)
+
+        # Full-time = 32+ hours/week
+        # Rate is $175 (full-time) or $165 (part-time) per child
+        rate = p.amount.calc(max_adult_hours)
+        max_deduction = num_children * rate
+
+        # Deduct actual cost up to max per child
+        return min_(expenses, max_deduction)

policyengine_us/variables/gov/states/hi/dhs/tanf/income/hi_tanf_gross_income.py

@@ -0,0 +1,14 @@
+from policyengine_us.model_api import *
+
+
+class hi_tanf_gross_income(Variable):
+    value_type = float
+    entity = SPMUnit
+    label = "Hawaii TANF gross income"
+    unit = USD
+    definition_period = MONTH
+    reference = (
+        "https://humanservices.hawaii.gov/wp-content/uploads/2024/12/Hawaii_TANF_State_Plan_Signed_Certified-Eff_20231001.pdf#page=19",
+    )
+    defined_for = StateCode.HI
+    adds = ["tanf_gross_earned_income", "tanf_gross_unearned_income"]

policyengine_us/variables/gov/states/ia/tax/income/credits/ia_cdcc.py

@@ -18,6 +18,8 @@ class ia_cdcc(Variable):
     def formula(tax_unit, period, parameters):
         # Iowa matches the potential federal credit
         federal_cdcc = tax_unit("cdcc_potential", period)
-        netinc = add(tax_unit, period, ["ia_net_income"])
+        taxable_income = tax_unit("ia_taxable_income", period)
         p = parameters(period).gov.states.ia.tax.income
-        return federal_cdcc * p.credits.child_care.fraction.calc(netinc)
+        return federal_cdcc * p.credits.child_care.fraction.calc(
+            taxable_income
+        )

policyengine_us/variables/gov/states/id/tafi/eligibility/id_tafi_eligible.py

@@ -0,0 +1,37 @@
+from policyengine_us.model_api import *
+
+
+class id_tafi_eligible(Variable):
+    value_type = bool
+    entity = SPMUnit
+    label = "Idaho TAFI eligible"
+    definition_period = MONTH
+    reference = (
+        "https://www.law.cornell.edu/regulations/idaho/IDAPA-16.03.08.100",
+        "https://www.law.cornell.edu/regulations/idaho/IDAPA-16.03.08.254",
+    )
+    defined_for = StateCode.ID
+
+    def formula(spm_unit, period, parameters):
+        p = parameters(period).gov.states.id.tafi
+        # Demographic eligibility - use federal baseline (IDAPA 16.03.08.125)
+        demographic_eligible = spm_unit("is_demographic_tanf_eligible", period)
+
+        # Immigration eligibility - use federal baseline (IDAPA 16.03.08.131)
+        immigration_eligible = (
+            add(spm_unit, period, ["is_citizen_or_legal_immigrant"]) > 0
+        )
+
+        # Resources eligibility (IDAPA 16.03.08.200)
+        resources_eligible = spm_unit("id_tafi_resources_eligible", period)
+
+        # Income eligibility - grant calculation must result in positive amount
+        grant_standard = spm_unit("id_tafi_grant_standard", period)
+        income_eligible = grant_standard > 0
+
+        return (
+            demographic_eligible
+            & immigration_eligible
+            & resources_eligible
+            & income_eligible
+        )

policyengine_us/variables/gov/states/id/tafi/eligibility/id_tafi_resources_eligible.py

@@ -0,0 +1,18 @@
+from policyengine_us.model_api import *
+
+
+class id_tafi_resources_eligible(Variable):
+    value_type = bool
+    entity = SPMUnit
+    label = "Idaho TAFI resources eligible"
+    definition_period = MONTH
+    reference = (
+        "https://www.law.cornell.edu/regulations/idaho/IDAPA-16.03.08.200"
+    )
+    defined_for = StateCode.ID
+
+    def formula(spm_unit, period, parameters):
+        p = parameters(period).gov.states.id.tafi.resources
+        # Per IDAPA 16.03.08.200: Resources must not exceed $5,000
+        resources = spm_unit("spm_unit_assets", period.this_year)
+        return resources <= p.limit

policyengine_us/variables/gov/states/id/tafi/id_tafi.py

@@ -0,0 +1,19 @@
+from policyengine_us.model_api import *
+
+
+class id_tafi(Variable):
+    value_type = float
+    entity = SPMUnit
+    label = "Idaho Temporary Assistance for Families in Idaho (TAFI)"
+    unit = USD
+    definition_period = MONTH
+    reference = (
+        "https://www.law.cornell.edu/regulations/idaho/IDAPA-16.03.08.248"
+    )
+    defined_for = "id_tafi_eligible"
+
+    def formula(spm_unit, period, parameters):
+        p = parameters(period).gov.states.id.tafi
+        grant_standard = spm_unit("id_tafi_grant_standard", period)
+        # Cap at maximum grant
+        return min_(grant_standard, p.maximum_grant)

policyengine_us/variables/gov/states/id/tafi/income/id_tafi_countable_earned_income.py

@@ -0,0 +1,20 @@
+from policyengine_us.model_api import *
+
+
+class id_tafi_countable_earned_income(Variable):
+    value_type = float
+    entity = SPMUnit
+    label = "Idaho TAFI countable earned income"
+    unit = USD
+    definition_period = MONTH
+    reference = (
+        "https://www.law.cornell.edu/regulations/idaho/IDAPA-16.03.08.252"
+    )
+    defined_for = StateCode.ID
+
+    def formula(spm_unit, period, parameters):
+        p = parameters(period).gov.states.id.tafi.income.earned
+        gross_earned = add(spm_unit, period, ["tanf_gross_earned_income"])
+        # Per IDAPA 16.03.08.252: 60% of gross earned income is subtracted
+        # from the work incentive table amount
+        return gross_earned * p.countable_rate

policyengine_us/variables/gov/states/id/tafi/income/id_tafi_countable_unearned_income.py

@@ -0,0 +1,16 @@
+from policyengine_us.model_api import *
+
+
+class id_tafi_countable_unearned_income(Variable):
+    value_type = float
+    entity = SPMUnit
+    label = "Idaho TAFI countable unearned income"
+    unit = USD
+    definition_period = MONTH
+    reference = (
+        "https://www.law.cornell.edu/regulations/idaho/IDAPA-16.03.08.250"
+    )
+    defined_for = StateCode.ID
+
+    # Per IDAPA 16.03.08.250: 100% of unearned income is counted
+    adds = ["tanf_gross_unearned_income"]

policyengine_us/variables/gov/states/id/tafi/income/id_tafi_grant_standard.py

@@ -0,0 +1,31 @@
+from policyengine_us.model_api import *
+
+
+class id_tafi_grant_standard(Variable):
+    value_type = float
+    entity = SPMUnit
+    label = "Idaho TAFI grant standard"
+    unit = USD
+    definition_period = MONTH
+    reference = (
+        "https://www.law.cornell.edu/regulations/idaho/IDAPA-16.03.08.249",
+        "https://www.law.cornell.edu/regulations/idaho/IDAPA-16.03.08.250",
+        "https://www.law.cornell.edu/regulations/idaho/IDAPA-16.03.08.252",
+    )
+    defined_for = StateCode.ID
+
+    def formula(spm_unit, period, parameters):
+        p = parameters(period).gov.states.id.tafi
+        countable_earned = spm_unit("id_tafi_countable_earned_income", period)
+        countable_unearned = spm_unit(
+            "id_tafi_countable_unearned_income", period
+        )
+        work_incentive = spm_unit("id_tafi_work_incentive_amount", period)
+
+        # With earned: work_incentive - earned; Without: maximum_grant
+        base = where(
+            countable_earned > 0,
+            work_incentive - countable_earned,
+            p.maximum_grant,
+        )
+        return max_(base - countable_unearned, 0)

policyengine_us/variables/gov/states/id/tafi/income/id_tafi_work_incentive_amount.py

@@ -0,0 +1,22 @@
+from policyengine_us.model_api import *
+
+
+class id_tafi_work_incentive_amount(Variable):
+    value_type = float
+    entity = SPMUnit
+    label = "Idaho TAFI work incentive table amount"
+    unit = USD
+    definition_period = MONTH
+    reference = (
+        "https://www.law.cornell.edu/regulations/idaho/IDAPA-16.03.08.251"
+    )
+    defined_for = StateCode.ID
+
+    def formula(spm_unit, period, parameters):
+        p = parameters(period).gov.states.id.tafi.work_incentive_table
+        size = spm_unit("spm_unit_size", period.this_year)
+        capped_size = min_(size, p.max_size)
+        base_amount = p.amount[capped_size]
+        additional_people = max_(size - p.max_size, 0)
+        additional_amount = additional_people * p.additional_person
+        return base_amount + additional_amount

policyengine_us/variables/gov/states/il/dhs/aabd/eligibility/il_aabd_immigration_status_eligible_person.py

@@ -18,6 +18,6 @@ class il_aabd_immigration_status_eligible_person(Variable):
         immigration_status_str = immigration_status.decode_to_str()
         has_qualifying_status = np.isin(
             immigration_status_str,
-            p.qualified_noncitizen_status,
+            p.qualified_noncitizen_statuses,
         )
         return has_qualifying_status | is_citizen

policyengine_us/variables/gov/states/il/dhs/aabd/eligibility/il_aabd_non_financial_eligible_person.py

@@ -6,15 +6,33 @@ class il_aabd_non_financial_eligible_person(Variable):
     entity = Person
     definition_period = MONTH
     label = "Eligible person for Illinois Aid to the Aged, Blind or Disabled (AABD)"
-    reference = "https://www.law.cornell.edu/regulations/illinois/title-89/part-113/subpart-B"
+    reference = (
+        "https://www.law.cornell.edu/regulations/illinois/title-89/part-113/subpart-B",
+        "https://www.dhs.state.il.us/page.aspx?item=15910",
+    )
     defined_for = StateCode.IL
 
     def formula(person, period, parameters):
-        aged_or_blind_or_disabled = person(
-            "il_aabd_aged_blind_disabled_person", period
-        )
+        # Per IDHS Policy Manual PM 11-01-00, a person must either:
+        # 1. Receive SSI, OR
+        # 2. Be ineligible for SSI due to income (but meet all other SSI requirements)
+        #
+        # Note: The policy manual only mentions "disabled" for under-65 persons
+        # who are SSI-ineligible due to income, but 89 Ill. Admin. Code 113.40(b)
+        # explicitly states: "The Department will make the determination of
+        # blindness when the client has been denied SSI on the basis of too
+        # much income." So blind persons are also covered.
+        #
+        # is_ssi_eligible checks categorical (aged/blind/disabled), resources,
+        # and immigration status for SSI. If True, person qualifies for IL AABD
+        # regardless of whether they actually receive SSI (income may be too high).
+        ssi_status_eligible = person("is_ssi_eligible", period.this_year)
+
+        # IL AABD has additional qualified noncitizen categories beyond SSI
+        # (e.g., abuse victims, trafficking victims, military families per
+        # 89 Ill. Admin. Code 113.10), so we check IL-specific immigration.
         immigration_status_eligible = person(
             "il_aabd_immigration_status_eligible_person", period
         )
 
-        return aged_or_blind_or_disabled & immigration_status_eligible
+        return ssi_status_eligible & immigration_status_eligible

policyengine_us/variables/gov/states/il/dhs/aabd/income/il_aabd_ssi_income.py

@@ -0,0 +1,21 @@
+from policyengine_us.model_api import *
+
+
+class il_aabd_ssi_income(Variable):
+    value_type = float
+    entity = Person
+    definition_period = MONTH
+    unit = USD
+    label = "SSI income for IL AABD calculation"
+    documentation = (
+        "SSI amount used in IL AABD unearned income calculation. "
+        "By default, uses calculated ssi. When il_aabd_use_reported_ssi "
+        "is True, uses ssi_reported instead."
+    )
+    defined_for = StateCode.IL
+
+    def formula(person, period, parameters):
+        use_reported = person("il_aabd_use_reported_ssi", period.this_year)
+        reported = person("ssi_reported", period)
+        calculated = person("ssi", period)
+        return where(use_reported, reported, calculated)

policyengine_us/variables/gov/states/il/dhs/aabd/income/il_aabd_use_reported_ssi.py

@@ -0,0 +1,14 @@
+from policyengine_us.model_api import *
+
+
+class il_aabd_use_reported_ssi(Variable):
+    value_type = bool
+    entity = Person
+    definition_period = YEAR
+    default_value = False
+    label = "Use reported SSI for IL AABD calculation"
+    documentation = (
+        "When True, IL AABD uses ssi_reported instead of calculated ssi "
+        "as unearned income. This allows API partners to show both federal "
+        "SSI entitlement and IL AABD eligibility in a single response."
+    )

policyengine_us/variables/gov/states/il/dhs/tanf/eligibility/il_tanf_immigration_status_eligible_person.py

@@ -15,7 +15,7 @@ class il_tanf_immigration_status_eligible_person(Variable):
         immigration_status_str = immigration_status.decode_to_str()
         has_qualifying_status = np.isin(
             immigration_status_str,
-            p.qualified_noncitizen_status,
+            p.qualified_noncitizen_statuses,
         )
         is_citizen = (
             immigration_status == immigration_status.possible_values.CITIZEN

policyengine_us/variables/gov/states/il/hfs/bcc/eligibility/il_bcc_age_eligible.py

@@ -0,0 +1,15 @@
+from policyengine_us.model_api import *
+
+
+class il_bcc_age_eligible(Variable):
+    value_type = bool
+    entity = Person
+    label = "Illinois Health Benefits for Persons with Breast or Cervical Cancer age eligible"
+    definition_period = YEAR
+    reference = ("https://www.dhs.state.il.us/page.aspx?item=33528",)
+    defined_for = StateCode.IL
+
+    def formula(person, period, parameters):
+        p = parameters(period).gov.states.il.hfs.bcc.eligibility
+        age = person("age", period)
+        return age < p.age

policyengine_us/variables/gov/states/il/hfs/bcc/eligibility/il_bcc_eligible.py

@@ -0,0 +1,27 @@
+from policyengine_us.model_api import *
+
+
+class il_bcc_eligible(Variable):
+    value_type = bool
+    entity = Person
+    label = "Illinois Health Benefits for Persons with Breast or Cervical Cancer eligible"
+    definition_period = YEAR
+    reference = (
+        "https://www.dhs.state.il.us/page.aspx?item=33528",
+        "https://www.dhs.state.il.us/page.aspx?item=33527",
+    )
+    defined_for = StateCode.IL
+
+    def formula(person, period, parameters):
+        is_female = person("is_female", period)
+        age_eligible = person("il_bcc_age_eligible", period)
+        immigration_eligible = person(
+            "il_hfs_immigration_status_eligible", period
+        )
+        insurance_eligible = person("il_bcc_insurance_eligible", period)
+        return (
+            is_female
+            & age_eligible
+            & immigration_eligible
+            & insurance_eligible
+        )

policyengine_us/variables/gov/states/il/hfs/bcc/eligibility/il_bcc_insurance_eligible.py

@@ -0,0 +1,29 @@
+from policyengine_us.model_api import *
+
+
+class il_bcc_insurance_eligible(Variable):
+    value_type = bool
+    entity = Person
+    label = "Illinois BCC insurance eligible"
+    definition_period = YEAR
+    reference = (
+        "https://www.dhs.state.il.us/page.aspx?item=33528",
+        "https://www.ilga.gov/legislation/ilcs/documents/030500050K5-2.htm",
+    )
+    defined_for = StateCode.IL
+
+    def formula(person, period, parameters):
+        # Per PM 06-20-02, persons are eligible if they are "uninsured".
+        # A person is NOT uninsured (thus ineligible) if they have:
+        # - Medicaid eligibility through another pathway
+        # - Health coverage that would pay for cancer treatment
+        #
+        # Exceptions that still qualify as "uninsured":
+        # - Coverage with limited benefits
+        # - Coverage where lifetime cap has been met/exceeded
+        # - Coverage that excludes cancer treatment
+        # - Indian Health Service coverage only
+        on_medicaid = person("receives_medicaid", period)
+        has_qualifying_coverage = person("has_bcc_qualifying_coverage", period)
+        has_disqualifying_coverage = on_medicaid | has_qualifying_coverage
+        return ~has_disqualifying_coverage

policyengine_us/variables/gov/states/il/hfs/fpp/eligibility/il_fpp_eligible.py

@@ -0,0 +1,40 @@
+from policyengine_us.model_api import *
+
+
+class il_fpp_eligible(Variable):
+    value_type = bool
+    entity = Person
+    label = "Illinois Family Planning Program eligible"
+    definition_period = YEAR
+    reference = (
+        "https://www.dhs.state.il.us/page.aspx?item=146077",
+        "https://hfs.illinois.gov/medicalclients/familyplanning.html",
+        "https://www.ilga.gov/agencies/JCAR/EntirePart?titlepart=07700635",
+    )
+    defined_for = StateCode.IL
+
+    def formula(person, period, parameters):
+        # Note: Illinois has two Family Planning programs:
+        # 1. Family Planning Presumptive Eligibility (FPPE) - temporary
+        #    coverage, does NOT require citizenship/immigration status
+        # 2. Ongoing Family Planning Program - 1 year coverage, REQUIRES
+        #    US citizenship or qualified immigrant status
+        # This variable models the ongoing program. The only eligibility
+        # difference between the two is the immigration requirement.
+
+        income_eligible = person("il_fpp_income_eligible", period)
+        # Must NOT be pregnant (pregnant individuals should apply for
+        # maternal health programs instead)
+        not_pregnant = ~person("is_pregnant", period)
+        # Use shared IL HFS immigration status check
+        immigration_eligible = person(
+            "il_hfs_immigration_status_eligible", period
+        )
+        # Cannot be enrolled in other non-spenddown full medical coverage
+        not_on_medicaid = ~person("receives_medicaid", period)
+        return (
+            income_eligible
+            & not_pregnant
+            & immigration_eligible
+            & not_on_medicaid
+        )

policyengine_us/variables/gov/states/il/hfs/fpp/eligibility/il_fpp_income_eligible.py

@@ -0,0 +1,18 @@
+from policyengine_us.model_api import *
+
+
+class il_fpp_income_eligible(Variable):
+    value_type = bool
+    entity = Person
+    label = "Illinois Family Planning Program income eligible"
+    definition_period = YEAR
+    reference = (
+        "https://www.dhs.state.il.us/page.aspx?item=146077",
+        "https://hfs.illinois.gov/medicalclients/familyplanning.html",
+    )
+    defined_for = StateCode.IL
+
+    def formula(person, period, parameters):
+        p = parameters(period).gov.states.il.hfs.fpp.eligibility
+        income_level = person("il_fpp_income_level", period)
+        return income_level <= p.income_limit

policyengine_us/variables/gov/states/il/hfs/fpp/il_fpp_income_level.py

@@ -0,0 +1,29 @@
+from policyengine_us.model_api import *
+from policyengine_us.variables.gov.hhs.tax_unit_fpg import fpg
+
+
+class il_fpp_income_level(Variable):
+    value_type = float
+    entity = Person
+    label = "Illinois Family Planning Program income level"
+    unit = "/1"
+    definition_period = YEAR
+    reference = (
+        "https://www.dhs.state.il.us/page.aspx?item=146077",
+        "https://hfs.illinois.gov/medicalclients/familyplanning.html",
+    )
+    defined_for = StateCode.IL
+
+    def formula(person, period, parameters):
+        # Only the applicant's income is counted (not household income)
+        income = person("adjusted_gross_income_person", period)
+
+        # Fixed household size of 2 per IL FPP policy
+        p = parameters(period).gov.states.il.hfs.fpp.eligibility
+
+        # Calculate FPG using fixed household size
+        state_group = person.household("state_group_str", period)
+        fpp_fpg = fpg(p.household_size, state_group, period, parameters)
+
+        # Return income as fraction of FPL
+        return income / fpp_fpg

policyengine_us/variables/gov/states/il/hfs/hbi/eligibility/il_hbi_age_eligible.py

@@ -0,0 +1,32 @@
+from policyengine_us.model_api import *
+
+
+class il_hbi_age_eligible(Variable):
+    value_type = bool
+    entity = Person
+    label = "Meets Illinois Health Benefits for Immigrants age eligibility"
+    definition_period = YEAR
+    defined_for = StateCode.IL
+    reference = (
+        "https://hfs.illinois.gov/medicalclients/healthbenefitsforimmigrants.html",
+        "https://www.dhs.state.il.us/page.aspx?item=161600",
+        "https://hfs.illinois.gov/medicalprograms/allkids/about.html",
+    )
+    # Illinois HBI covers specific age groups:
+    # - Children: 0-18 (All Kids)
+    # - Adults: 42-64 (HBIA)
+    # - Seniors: 65+ (HBIS)
+    #
+    # Note: Ages 19-41 are NOT covered by any Illinois immigrant health program.
+
+    def formula(person, period, parameters):
+        p = parameters(period).gov.states.il.hfs.hbi.eligibility
+
+        age = person("age", period)
+
+        # Determine if in a covered age group
+        is_child = age <= p.child.max_age
+        is_adult = (age >= p.adult.min_age) & (age <= p.adult.max_age)
+        is_senior = age >= p.senior.min_age
+
+        return is_child | is_adult | is_senior

policyengine_us/variables/gov/states/il/hfs/hbi/eligibility/il_hbi_eligible.py

@@ -0,0 +1,60 @@
+from policyengine_us.model_api import *
+
+
+class il_hbi_eligible(Variable):
+    value_type = bool
+    entity = Person
+    label = "Eligible for Illinois Health Benefits for Immigrants"
+    definition_period = YEAR
+    defined_for = StateCode.IL
+    reference = (
+        "https://hfs.illinois.gov/medicalclients/healthbenefitsforimmigrants.html",
+        "https://www.dhs.state.il.us/page.aspx?item=161600",
+        "https://hfs.illinois.gov/medicalprograms/allkids/about.html",
+    )
+    # Illinois Health Benefits for Immigrants (HBI) is a state-funded program
+    # providing health coverage to income-eligible residents who are not eligible
+    # for federal Medicaid due to their immigration status.
+    #
+    # The program includes three components:
+    # - All Kids: Children 0-18 up to 318% FPL
+    # - HBIA (Health Benefits for Immigrant Adults): Ages 42-64 up to 138% FPL
+    # - HBIS (Health Benefits for Immigrant Seniors): Ages 65+ up to 100% FPL
+    #
+    # Note: Ages 19-41 are not covered.
+
+    def formula(person, period, parameters):
+        p = parameters(period).gov.states.il.hfs.hbi.eligibility
+
+        # Check base eligibility criteria
+        immigration_eligible = person(
+            "il_hbi_immigration_status_eligible", period
+        )
+        age_eligible = person("il_hbi_age_eligible", period)
+        income_eligible = person("il_hbi_income_eligible", period)
+        resource_eligible = person("il_hbi_resource_eligible", period)
+
+        # Determine age group for program-specific in_effect checks
+        age = person("age", period)
+        is_child = age <= p.child.max_age
+        is_adult = (age >= p.adult.min_age) & (age <= p.adult.max_age)
+        is_senior = age >= p.senior.min_age
+
+        # Check if the relevant program is in effect for each age group
+        child_in_effect = p.child.in_effect
+        adult_in_effect = p.adult.in_effect
+        senior_in_effect = p.senior.in_effect
+
+        program_in_effect = (
+            (is_child & child_in_effect)
+            | (is_adult & adult_in_effect)
+            | (is_senior & senior_in_effect)
+        )
+
+        return (
+            immigration_eligible
+            & age_eligible
+            & income_eligible
+            & resource_eligible
+            & program_in_effect
+        )

policyengine_us/variables/gov/states/il/hfs/hbi/eligibility/il_hbi_immigration_status_eligible.py

@@ -0,0 +1,23 @@
+from policyengine_us.model_api import *
+
+
+class il_hbi_immigration_status_eligible(Variable):
+    value_type = bool
+    entity = Person
+    label = "Has eligible immigration status for Illinois HBI"
+    definition_period = YEAR
+    defined_for = StateCode.IL
+    reference = (
+        "https://hfs.illinois.gov/medicalclients/healthbenefitsforimmigrants.html",
+        "https://www.dhs.state.il.us/page.aspx?item=161600",
+    )
+    # Illinois Health Benefits for Immigrants (HBI) covers residents who are not
+    # eligible for federal Medicaid due to their immigration status.
+
+    def formula(person, period, parameters):
+        # Eligible for HBI if NOT eligible for federal Medicaid
+        # due to immigration status
+        federal_eligible = person(
+            "is_medicaid_immigration_status_eligible", period
+        )
+        return ~federal_eligible