policyengine-us 1.420.0__py3-none-any.whl → 1.422.0__py3-none-any.whl

policyengine_us/tests/policy/baseline/gov/states/tx/twc/ccs/tx_ccs_maximum_payment.yaml

@@ -0,0 +1,141 @@
+- name: Case 1 - Low income family maximum payment calculation
+  period: 2024-01
+  input:
+    people:
+      parent1:
+        age: 30
+        employment_income: 12_000  # Annual income ($1,000/month, <20% SMI)
+      child1:
+        age: 3
+        is_disabled: false
+        is_citizen_or_legal_immigrant: true
+        tx_ccs_payment_rate: 500  # Monthly reimbursement rate
+    spm_units:
+      spm_unit:
+        members: [parent1, child1]
+        spm_unit_size: 2
+        tx_ccs_eligible: true
+    households:
+      household:
+        members: [parent1, child1]
+        state_code: TX
+  output:
+    # Reimbursement ($500) - copay ($22.70, rate-based) = $477.30
+    tx_ccs_maximum_payment: 477.3
+
+- name: Case 2 - Family with two children maximum payment
+  period: 2024-01
+  input:
+    people:
+      parent1:
+        age: 35
+        employment_income: 48_000  # Annual income ($4,000/month, ~55% SMI)
+      parent2:
+        age: 32
+      child1:
+        age: 5
+        is_disabled: false
+        is_citizen_or_legal_immigrant: true
+        tx_ccs_payment_rate: 600  # Monthly reimbursement for child1
+      child2:
+        age: 2
+        is_disabled: false
+        is_citizen_or_legal_immigrant: true
+        tx_ccs_payment_rate: 700  # Monthly reimbursement for child2
+    spm_units:
+      spm_unit:
+        members: [parent1, parent2, child1, child2]
+        spm_unit_size: 4
+        tx_ccs_eligible: true
+    households:
+      household:
+        members: [parent1, parent2, child1, child2]
+        state_code: TX
+  output:
+    # Total reimbursement ($1,300) - copay ($243.20, rate-based) = $1,056.80
+    tx_ccs_maximum_payment: 1_056.8
+
+- name: Case 3 - High income family with lower maximum payment
+  period: 2024-01
+  input:
+    people:
+      parent1:
+        age: 40
+        employment_income: 84_000  # Annual income ($7,000/month, 75-80% SMI)
+      parent2:
+        age: 38
+      child1:
+        age: 8
+        is_disabled: false
+        is_citizen_or_legal_immigrant: true
+        tx_ccs_payment_rate: 400
+      child2:
+        age: 5
+        is_disabled: false
+        is_citizen_or_legal_immigrant: true
+        tx_ccs_payment_rate: 450
+      child3:
+        age: 2
+        is_disabled: false
+        is_citizen_or_legal_immigrant: true
+        tx_ccs_payment_rate: 500
+    spm_units:
+      spm_unit:
+        members: [parent1, parent2, child1, child2, child3]
+        spm_unit_size: 5
+        tx_ccs_eligible: true
+    households:
+      household:
+        members: [parent1, parent2, child1, child2, child3]
+        state_code: TX
+  output:
+    # Total reimbursement ($1,350) - copay ($490, capped at 7%) = $860
+    tx_ccs_maximum_payment: 860
+
+- name: Case 4 - Copay exceeds reimbursement results in zero maximum payment
+  period: 2024-01
+  input:
+    people:
+      parent1:
+        age: 35
+        employment_income: 78_000  # High income
+      child1:
+        age: 6
+        is_disabled: false
+        is_citizen_or_legal_immigrant: true
+        tx_ccs_payment_rate: 200  # Low reimbursement rate
+    spm_units:
+      spm_unit:
+        members: [parent1, child1]
+        spm_unit_size: 2
+        tx_ccs_eligible: true
+    households:
+      household:
+        members: [parent1, child1]
+        state_code: TX
+  output:
+    tx_ccs_maximum_payment: 0  # Reimbursement ($200) < copay ($310), max(0, -110) = $0
+
+- name: Case 5 - Not eligible household has zero maximum payment
+  period: 2024-01
+  input:
+    people:
+      parent1:
+        age: 30
+        employment_income: 36_000
+      child1:
+        age: 4
+        is_disabled: false
+        is_citizen_or_legal_immigrant: true
+        tx_ccs_payment_rate: 500
+    spm_units:
+      spm_unit:
+        members: [parent1, child1]
+        spm_unit_size: 2
+        tx_ccs_eligible: false  # Not eligible
+    households:
+      household:
+        members: [parent1, child1]
+        state_code: TX
+  output:
+    tx_ccs_maximum_payment: 0  # Not eligible = no maximum payment

policyengine_us/tests/policy/baseline/gov/states/tx/twc/ccs/tx_ccs_workforce_board_region.yaml

@@ -0,0 +1,79 @@
+- name: Gulf Coast - Harris County
+  period: 2024
+  input:
+    county: HARRIS_COUNTY_TX
+    state_code: TX
+  output:
+    tx_ccs_workforce_board_region: GULF_COAST
+
+- name: Gulf Coast - Fort Bend County
+  period: 2024
+  input:
+    county: FORT_BEND_COUNTY_TX
+    state_code: TX
+  output:
+    tx_ccs_workforce_board_region: GULF_COAST
+
+- name: Dallas County - Dallas
+  period: 2024
+  input:
+    county: DALLAS_COUNTY_TX
+    state_code: TX
+  output:
+    tx_ccs_workforce_board_region: DALLAS_COUNTY
+
+- name: Tarrant County - Fort Worth
+  period: 2024
+  input:
+    county: TARRANT_COUNTY_TX
+    state_code: TX
+  output:
+    tx_ccs_workforce_board_region: TARRANT_COUNTY
+
+- name: Capital Area - Travis County (Austin)
+  period: 2024
+  input:
+    county: TRAVIS_COUNTY_TX
+    state_code: TX
+  output:
+    tx_ccs_workforce_board_region: CAPITAL_AREA
+
+- name: Alamo - Bexar County (San Antonio)
+  period: 2024
+  input:
+    county: BEXAR_COUNTY_TX
+    state_code: TX
+  output:
+    tx_ccs_workforce_board_region: ALAMO
+
+- name: Panhandle - Potter County (Amarillo)
+  period: 2024
+  input:
+    county: POTTER_COUNTY_TX
+    state_code: TX
+  output:
+    tx_ccs_workforce_board_region: PANHANDLE
+
+- name: Borderplex - El Paso County
+  period: 2024
+  input:
+    county: EL_PASO_COUNTY_TX
+    state_code: TX
+  output:
+    tx_ccs_workforce_board_region: BORDERPLEX
+
+- name: Heart of Texas - McLennan County (Waco)
+  period: 2024
+  input:
+    county: MCLENNAN_COUNTY_TX
+    state_code: TX
+  output:
+    tx_ccs_workforce_board_region: HEART_OF_TEXAS
+
+- name: Cameron County - Brownsville
+  period: 2024
+  input:
+    county: CAMERON_COUNTY_TX
+    state_code: TX
+  output:
+    tx_ccs_workforce_board_region: CAMERON_COUNTY

policyengine_us/tests/policy/baseline/gov/usda/csfp/commodity_supplemental_food_program_eligible.yaml

@@ -0,0 +1,171 @@
+- name: Person under 60 is not eligible regardless of income
+  period: 2024
+  input:
+    people:
+      person:
+        age: 59
+      spouse:
+        age: 62
+    spm_units:
+      spm_unit:
+        members: [person, spouse]
+        school_meal_fpg_ratio: 1.0  # Below the 130% limit
+  output:
+    commodity_supplemental_food_program_eligible: [false, true]
+
+- name: Person exactly 60 is eligible with low income
+  period: 2024
+  input:
+    people:
+      person:
+        age: 60
+    spm_units:
+      spm_unit:
+        members: [person]
+        school_meal_fpg_ratio: 1.2  # Below the 130% limit
+  output:
+    commodity_supplemental_food_program_eligible: true
+
+- name: Elderly person eligible with income at exactly 130% FPG
+  period: 2024
+  input:
+    people:
+      person:
+        age: 65
+    spm_units:
+      spm_unit:
+        members: [person]
+        school_meal_fpg_ratio: 1.3  # Exactly at the limit
+  output:
+    commodity_supplemental_food_program_eligible: true
+
+- name: Elderly person not eligible with income above 130% FPG
+  period: 2024
+  input:
+    people:
+      person:
+        age: 70
+    spm_units:
+      spm_unit:
+        members: [person]
+        school_meal_fpg_ratio: 1.31  # Just above the limit
+  output:
+    commodity_supplemental_food_program_eligible: false
+
+- name: Multiple household members with different eligibility
+  period: 2024
+  input:
+    people:
+      child:
+        age: 10
+      adult:
+        age: 45
+      senior1:
+        age: 60
+      senior2:
+        age: 75
+    spm_units:
+      spm_unit:
+        members: [child, adult, senior1, senior2]
+        school_meal_fpg_ratio: 1.2  # Below the 130% limit
+  output:
+    commodity_supplemental_food_program_eligible: [false, false, true, true]
+
+- name: 2025 period with higher FPG limit of 150%
+  period: 2025
+  input:
+    people:
+      person:
+        age: 65
+    spm_units:
+      spm_unit:
+        members: [person]
+        school_meal_fpg_ratio: 1.45  # Between 130% and 150%
+  output:
+    commodity_supplemental_food_program_eligible: true
+
+- name: 2025 period - not eligible above 150% FPG
+  period: 2025
+  input:
+    people:
+      person:
+        age: 65
+    spm_units:
+      spm_unit:
+        members: [person]
+        school_meal_fpg_ratio: 1.51  # Just above the 150% limit
+  output:
+    commodity_supplemental_food_program_eligible: false
+
+- name: Edge case - person turns 60 during the year
+  period: 2024
+  input:
+    people:
+      person:
+        age: 60  # Assume they're 60 at some point in 2024
+    spm_units:
+      spm_unit:
+        members: [person]
+        school_meal_fpg_ratio: 1.0
+  output:
+    commodity_supplemental_food_program_eligible: true
+
+- name: High income elderly person not eligible
+  period: 2024
+  input:
+    people:
+      person:
+        age: 80
+    spm_units:
+      spm_unit:
+        members: [person]
+        school_meal_fpg_ratio: 2.5  # Well above the 130% limit
+  output:
+    commodity_supplemental_food_program_eligible: false
+
+- name: Young adult with very low income still not eligible
+  period: 2024
+  input:
+    people:
+      person:
+        age: 30
+    spm_units:
+      spm_unit:
+        members: [person]
+        school_meal_fpg_ratio: 0.5  # Very low income
+  output:
+    commodity_supplemental_food_program_eligible: false
+
+- name: Texas income ineligible
+  period: 2025
+  input:
+    people:
+      person:
+        age: 65
+    spm_units:
+      spm_unit:
+        members: [person]
+        school_meal_fpg_ratio: 1.4
+    households:
+      household:
+        members: [person]
+        state_code: TX
+  output:
+    commodity_supplemental_food_program_eligible: false
+
+- name: Texas income eligible
+  period: 2025
+  input:
+    people:
+      person:
+        age: 65
+    spm_units:
+      spm_unit:
+        members: [person]
+        school_meal_fpg_ratio: 1.3
+    households:
+      household:
+        members: [person]
+        state_code: TX
+  output:
+    commodity_supplemental_food_program_eligible: true

policyengine_us/variables/gov/states/tx/dta/csfp/tx_dta_csfp_income_eligible.py

@@ -0,0 +1,14 @@
+from policyengine_us.model_api import *
+
+
+class tx_dta_csfp_income_eligible(Variable):
+    value_type = bool
+    entity = Person
+    definition_period = YEAR
+    label = "Texas Commodity Supplemental Food Program income eligible"
+    defined_for = StateCode.TX
+
+    def formula(person, period, parameters):
+        p = parameters(period).gov.states.tx.dta.csfp
+        fpg = person.spm_unit("school_meal_fpg_ratio", period)
+        return fpg <= p.fpg_limit

policyengine_us/variables/gov/states/tx/twc/ccs/copay/tx_ccs_copay.py

@@ -0,0 +1,40 @@
+from policyengine_us.model_api import *
+
+
+class tx_ccs_copay(Variable):
+    value_type = float
+    entity = SPMUnit
+    unit = USD
+    label = "Texas Child Care Services (CCS) copayment"
+    definition_period = MONTH
+    reference = "https://wspanhandle.com/child-care/for-parents/"
+    defined_for = "tx_ccs_eligible"
+
+    def formula(spm_unit, period, parameters):
+        p = parameters(period).gov.states.tx.twc.ccs.copay
+
+        # Get household income and SMI ratio
+        income = spm_unit("tx_ccs_countable_income", period)
+        smi = spm_unit("hhs_smi", period)
+        income_to_smi_ratio = income / smi
+
+        # Count eligible children in care
+        eligible_children = spm_unit.sum(
+            spm_unit.members("tx_ccs_eligible_child", period)
+        )
+
+        # Calculate copayment rates based on income bracket
+        # Use Panhandle Region's values
+        first_child_rate = p.rate.first_child.calc(income_to_smi_ratio)
+        additional_child_rate = p.rate.additional_child
+
+        # Calculate copayments as percentage of income
+        first_child_copay = first_child_rate * income
+        additional_children = max_(eligible_children - 1, 0)
+        additional_copay = additional_child_rate * income * additional_children
+
+        # Total copayment, capped at maximum rate
+        total_copay = first_child_copay + additional_copay
+        max_copay = p.rate.maximum * income
+
+        return min_(total_copay, max_copay)

policyengine_us/variables/gov/states/tx/twc/ccs/eligibility/tx_ccs_asset_eligible.py

@@ -0,0 +1,16 @@
+from policyengine_us.model_api import *
+
+
+class tx_ccs_asset_eligible(Variable):
+    value_type = bool
+    entity = SPMUnit
+    label = "Texas CCS asset eligible"
+    definition_period = MONTH
+    reference = "https://www.law.cornell.edu/regulations/texas/40-Tex-Admin-Code-SS-809-41"
+    defined_for = StateCode.TX
+
+    def formula(spm_unit, period, parameters):
+        p = parameters(period).gov.states.tx.twc.ccs
+        assets = spm_unit("spm_unit_assets", period.this_year)
+        asset_limit = p.assets.limit
+        return assets <= asset_limit

policyengine_us/variables/gov/states/tx/twc/ccs/eligibility/tx_ccs_eligible.py

@@ -0,0 +1,28 @@
+from policyengine_us.model_api import *
+
+
+class tx_ccs_eligible(Variable):
+    value_type = bool
+    entity = SPMUnit
+    label = "Texas CCS eligible"
+    definition_period = MONTH
+    reference = "https://www.law.cornell.edu/regulations/texas/40-Tex-Admin-Code-SS-809-41"
+    defined_for = StateCode.TX
+
+    def formula(spm_unit, period, parameters):
+        # Check all eligibility criteria
+        income_eligible = spm_unit("tx_ccs_income_eligible", period)
+        asset_eligible = spm_unit("tx_ccs_asset_eligible", period)
+        work_eligible = spm_unit("tx_ccs_work_requirement_eligible", period)
+
+        # Check if at least one child is age-eligible
+        person = spm_unit.members
+        age_eligible = person("tx_ccs_eligible_child", period)
+        has_eligible_child = spm_unit.any(age_eligible)
+
+        return (
+            income_eligible
+            & asset_eligible
+            & work_eligible
+            & has_eligible_child
+        )

policyengine_us/variables/gov/states/tx/twc/ccs/eligibility/tx_ccs_eligible_child.py

@@ -0,0 +1,22 @@
+from policyengine_us.model_api import *
+
+
+class tx_ccs_eligible_child(Variable):
+    value_type = bool
+    entity = Person
+    label = "Texas CCS eligible child"
+    definition_period = MONTH
+    reference = "https://www.law.cornell.edu/regulations/texas/40-Tex-Admin-Code-SS-809-41"
+    defined_for = StateCode.TX
+
+    def formula(person, period, parameters):
+        p = parameters(period).gov.states.tx.twc.ccs.age_threshold
+        age = person("age", period.this_year)
+        is_disabled = person("is_disabled", period)
+        age_limit = where(is_disabled, p.disabled_child, p.child)
+        age_eligible = age < age_limit
+        is_dependent = person("is_tax_unit_dependent", period)
+        immigration_status_eligible = person(
+            "is_citizen_or_legal_immigrant", period
+        )
+        return age_eligible & is_dependent & immigration_status_eligible

policyengine_us/variables/gov/states/tx/twc/ccs/eligibility/tx_ccs_income_eligible.py

@@ -0,0 +1,19 @@
+from policyengine_us.model_api import *
+
+
+class tx_ccs_income_eligible(Variable):
+    value_type = bool
+    entity = SPMUnit
+    label = "Texas CCS income eligible"
+    definition_period = MONTH
+    reference = "https://www.law.cornell.edu/regulations/texas/40-Tex-Admin-Code-SS-809-41"
+    defined_for = StateCode.TX
+
+    def formula(spm_unit, period, parameters):
+        p = parameters(period).gov.states.tx.twc.ccs
+        # Get monthly countable income
+        monthly_income = spm_unit("tx_ccs_countable_income", period)
+        # Calculate monthly SMI limit
+        smi = spm_unit("hhs_smi", period)
+        income_limit = smi * p.income.smi_rate
+        return monthly_income <= income_limit

policyengine_us/variables/gov/states/tx/twc/ccs/eligibility/tx_ccs_work_exempt.py

@@ -0,0 +1,26 @@
+from policyengine_us.model_api import *
+
+
+class tx_ccs_work_exempt(Variable):
+    value_type = bool
+    entity = Person
+    label = "Texas CCS work requirement exempt"
+    definition_period = YEAR
+    reference = "https://www.law.cornell.edu/regulations/texas/40-Tex-Admin-Code-SS-809-50"
+    defined_for = StateCode.TX
+
+    def formula(person, period):
+        # Exemption 1: Full-time student
+        is_full_time_student = person("is_full_time_student", period)
+
+        # Exemption 2: Parent with documented medical disability
+        is_disabled = person("is_disabled", period)
+
+        # Exemption 3: Parent caring for a physically or mentally disabled family member
+        # This exemption is NOT implemented due to complexity in determining:
+        # - Which parent is the designated caregiver
+        # - Whether caring for disabled spouse vs disabled child has different implications
+        # - Whether both parents can claim exemption or just one
+        # Future enhancement could add this with better data on caregiving roles
+
+        return is_full_time_student | is_disabled

policyengine_us/variables/gov/states/tx/twc/ccs/eligibility/tx_ccs_work_requirement_eligible.py

@@ -0,0 +1,44 @@
+from policyengine_us.model_api import *
+
+
+class tx_ccs_work_requirement_eligible(Variable):
+    value_type = bool
+    entity = SPMUnit
+    label = "Texas CCS work requirement eligible"
+    definition_period = MONTH
+    reference = "https://www.law.cornell.edu/regulations/texas/40-Tex-Admin-Code-SS-809-56"
+    defined_for = StateCode.TX
+
+    def formula(spm_unit, period, parameters):
+        p = parameters(period).gov.states.tx.twc.ccs.work_requirements
+
+        person = spm_unit.members
+        is_head_or_spouse = person("is_tax_unit_head_or_spouse", period)
+        is_exempt = person("tx_ccs_work_exempt", period)
+        work_hours = person("weekly_hours_worked", period.this_year)
+
+        # Count non-exempt parents and calculate their total work hours
+        is_non_exempt_parent = is_head_or_spouse & ~is_exempt
+        num_non_exempt_parents = spm_unit.sum(is_non_exempt_parent)
+        total_work_hours = spm_unit.sum(
+            where(is_non_exempt_parent, work_hours, 0)
+        )
+
+        # Determine work hours requirement based on non-exempt parents
+        # If 0-1 non-exempt parents: 25 hours
+        # If 2+ non-exempt parents: 50 hours
+        requirement = where(
+            num_non_exempt_parents > 1, p.two_parent, p.single_parent
+        )
+
+        # Check each parent individually
+        # A parent meets requirements if they are:
+        # - Exempt from work, OR
+        # - Part of a household that meets the work hour requirement
+        household_meets_work_requirement = total_work_hours >= requirement
+        parent_meets_requirement = is_exempt | household_meets_work_requirement
+
+        # SPM unit is eligible if ALL parents meet requirements
+        # (Non-parents automatically pass)
+        person_eligible = parent_meets_requirement | ~is_head_or_spouse
+        return spm_unit.all(person_eligible)

policyengine_us/variables/gov/states/tx/twc/ccs/payment/tx_ccs_care_schedule.py

@@ -0,0 +1,18 @@
+from policyengine_us.model_api import *
+
+
+class TXCCSCareSchedule(Enum):
+    FULL_TIME = "Full Time"
+    PART_TIME = "Part Time"
+    BLENDED = "Blended"
+
+
+class tx_ccs_care_schedule(Variable):
+    value_type = Enum
+    possible_values = TXCCSCareSchedule
+    default_value = TXCCSCareSchedule.FULL_TIME
+    entity = Person
+    definition_period = MONTH
+    label = "Texas Child Care Services (CCS) care schedule"
+    defined_for = StateCode.TX
+    reference = "https://www.twc.texas.gov/sites/default/files/ccel/docs/bcy25-board-max-provider-payment-rates-4-age-groups-twc.pdf"

policyengine_us/variables/gov/states/tx/twc/ccs/payment/tx_ccs_payment_rate.py

@@ -0,0 +1,36 @@
+from policyengine_us.model_api import *
+
+
+class tx_ccs_payment_rate(Variable):
+    value_type = float
+    entity = Person
+    label = "Texas Child Care Services (CCS) payment amount"
+    unit = USD
+    definition_period = MONTH
+    defined_for = "tx_ccs_eligible_child"
+    reference = "https://www.twc.texas.gov/sites/default/files/ccel/docs/bcy25-board-max-provider-payment-rates-4-age-groups-twc.pdf#page=9"
+
+    def formula(person, period, parameters):
+        # Get the household's workforce board region
+        household = person.household
+        region = household("tx_ccs_workforce_board_region", period)
+
+        # Get the payment parameters
+        p = parameters(period).gov.states.tx.twc.ccs.payment
+
+        # Get the provider characteristics
+        provider_type = person("tx_ccs_provider_type", period)
+        provider_rating = person("tx_ccs_provider_rating", period)
+        age_category = person("tx_ccs_child_age_category", period)
+        care_schedule = person("tx_ccs_care_schedule", period)
+
+        # Calculate monthly payment based on region-specific rates
+        attending_days_per_month = person(
+            "childcare_attending_days_per_month", period.this_year
+        )
+        return (
+            p.rates[region][provider_type][provider_rating][age_category][
+                care_schedule
+            ]
+            * attending_days_per_month
+        )

policyengine_us/variables/gov/states/tx/twc/ccs/payment/tx_ccs_provider_rating.py

@@ -0,0 +1,21 @@
+from policyengine_us.model_api import *
+
+
+class TXCCSProviderRating(Enum):
+    REG = "Regular"
+    TRS2 = "Texas Rising Star 2"
+    TRS3 = "Texas Rising Star 3"
+    TRS4 = "Texas Rising Star 4"
+    TSR = "Texas School Ready"
+    NONE = "None"
+
+
+class tx_ccs_provider_rating(Variable):
+    value_type = Enum
+    possible_values = TXCCSProviderRating
+    default_value = TXCCSProviderRating.REG
+    entity = Person
+    definition_period = MONTH
+    label = "Texas Child Care Services (CCS) provider rating"
+    defined_for = StateCode.TX
+    reference = "https://www.twc.texas.gov/sites/default/files/ccel/docs/bcy25-board-max-provider-payment-rates-4-age-groups-twc.pdf"