Universal childcare entitlement

policyengine_uk/parameters/gov/dwp/universal_childcare_entitlement/age/max_age.yaml

@@ -0,0 +1,12 @@
+description: The Department for Education provides universal childcare entitlement in England for children until a maximum age, when they reach compulsory school age.
+metadata:
+  unit: year
+  period: year
+  label: Maximum age for universal childcare entitlement
+  reference:
+    - title: Childcare Act 2006 - section 7 & part of the regulation that says children are eligible under compulsory school age in the second link. 
+      href: https://www.legislation.gov.uk/ukpga/2006/21/section/7 & https://commonslibrary.parliament.uk/free-childcare-entitlements-for-three-and-four-year-olds-in-england/
+    - title: Ducment for 15 hours free childcare for 3 and 4-year-olds
+      href: https://www.gov.uk/help-with-childcare-costs/free-childcare-and-education-for-3-to-4-year-olds?step-by-step-nav=f237ec8e-e82c-4ffa-8fba-2a88a739783b
+values:
+  2015-01-01: 4

policyengine_uk/parameters/gov/dwp/universal_childcare_entitlement/age/min_age.yaml

@@ -0,0 +1,12 @@
+description: The Department for Education provides universal childcare entitlement in England for children from a minimum age, when they reach compulsory school age.
+metadata:
+  unit: year
+  period: year
+  label: Minimum age for universal childcare entitlement
+  reference:
+    - title: The Local Authority (Duty to Secure Early Years Provision Free of Charge) Regulations 2014 - regulation 3
+      href: https://www.legislation.gov.uk/uksi/2014/2147/regulation/3/made
+    - title: Ducment for 15 hours free childcare for 3 and 4-year-olds
+      href: https://www.gov.uk/help-with-childcare-costs/free-childcare-and-education-for-3-to-4-year-olds?step-by-step-nav=f237ec8e-e82c-4ffa-8fba-2a88a739783b
+values:
+  2015-01-01: 3

policyengine_uk/parameters/gov/dwp/universal_childcare_entitlement/hours_per_year.yaml

@@ -0,0 +1,12 @@
+description: The Department for Education provides universal childcare entitlement in England, offering specific hours per year.
+metadata:
+  unit: hour
+  period: year
+  label: Annual universal childcare entitlement hours
+  reference:
+    - title: The Local Authority (Duty to Secure Early Years Provision Free of Charge) Regulations 2014 - regulation 4
+      href: https://www.legislation.gov.uk/uksi/2014/2147/regulation/4/made
+    - title: Ducment for 15 hours free childcare for 3 and 4-year-olds
+      href: https://www.gov.uk/help-with-childcare-costs/free-childcare-and-education-for-3-to-4-year-olds?step-by-step-nav=f237ec8e-e82c-4ffa-8fba-2a88a739783b
+values:
+  2015-01-01: 570

policyengine_uk/tests/policy/baseline/gov/dwp/universal_childcare_entitlement/universal_free_childcare_eligibility.yaml

@@ -0,0 +1,34 @@
+- name: non eligible
+  period: 2025
+  input:
+    age: 2
+    is_child: true
+  output:
+    universal_childcare_entitlement_eligibility: false
+
+
+- name: Eligible 4
+  period: 2025
+  input:
+    age: 4
+    is_child: true
+  output:
+    universal_childcare_entitlement_eligibility: true
+
+
+- name: non Eligible 5
+  period: 2025
+  input:
+    age: 5
+    is_child: true
+  output:
+    universal_childcare_entitlement_eligibility: false
+
+
+- name: Eligible 3
+  period: 2025
+  input:
+    age: 3.5
+    is_child: true
+  output:
+    universal_childcare_entitlement_eligibility: true

policyengine_uk/tests/policy/baseline/gov/dwp/universal_childcare_entitlement/universal_free_childcare_hours.yaml

@@ -0,0 +1,13 @@
+- name: Eligible child gets full hours
+  period: 2025
+  input:
+    universal_childcare_entitlement_eligibility: true
+  output:
+    universal_childcare_entitlement_hours: 570
+
+- name: Non eligible child 
+  period: 2025
+  input:
+    universal_childcare_entitlement_eligibility: false
+  output:
+    universal_childcare_entitlement_hours: 0

policyengine_uk/variables/gov/dwp/universal_childcare_entitlement/universal_childcare_entitlement_eligibility.py

@@ -0,0 +1,38 @@
+from policyengine_uk.model_api import *
+
+
+class universal_childcare_entitlement_eligibility(Variable):
+    value_type = bool
+    entity = BenUnit
+    label = "universal childcare entitlement eligibility"
+    documentation = "Whether the benefit unit has any children eligible for universal childcare entitlement"
+    definition_period = YEAR
+
+    def formula(benunit, period, parameters):
+        """
+        Calculate eligibility for universal childcare entitlement.
+
+        Args:
+            benunit: The benefit unit
+            period: The time period
+            parameters: Policy parameters
+
+        Returns:
+            bool: Whether the benefit unit has any eligible children
+        """
+        # Get parameters
+        p = parameters(period).gov.dwp.universal_childcare_entitlement.age
+
+        # Get ages of all members in the benefit unit
+        age = benunit.members("age", period)
+
+        # Check if they are children
+        is_child = benunit.members("is_child", period)
+
+        # Check if age is within eligible range using parameters
+        is_eligible_age = (age >= p.min_age) & (age <= p.max_age)
+
+        # Child must be within age range and officially counted as a child
+        has_eligible_child = benunit.any(is_child & is_eligible_age)
+
+        return has_eligible_child.astype(bool)

policyengine_uk/variables/gov/dwp/universal_childcare_entitlement/universal_childcare_entitlement_hours.py

@@ -0,0 +1,35 @@
+from policyengine_uk.model_api import *
+
+
+class universal_childcare_entitlement_hours(Variable):
+    value_type = float
+    entity = BenUnit
+    label = "universal childcare entitlement hours per year"
+    documentation = "Number of free childcare hours per year the benefit unit is entitled to"
+    definition_period = YEAR
+    unit = "hour"
+
+    def formula(benunit, period, parameters):
+        """
+        Calculate number of free hours the benefit unit is entitled to.
+
+        Args:
+            benunit: The benefit unit
+            period: The time period
+            parameters: Policy parameters
+
+        Returns:
+            float: Number of free childcare hours per year
+        """
+        # Get eligibility status
+        is_eligible = benunit(
+            "universal_childcare_entitlement_eligibility", period
+        )
+
+        # Use hours directly from parameters file
+        hours = parameters(
+            period
+        ).gov.dwp.universal_childcare_entitlement.hours_per_year
+
+        # Return hours if eligible, 0 if not
+        return where(is_eligible, hours, 0)