{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://openinherit.org/v3/extensions/india/india.json",
  "title": "India Extension",
  "description": "Indian succession — multi-personal-law system covering Hindu (coparcenary, HUF), Muslim personal law (school-based heir shares), Christian, Parsi, and Goa civil code estates; includes succession certificates and property classification",
  "type": "object",
  "required": [
    "personalLaw"
  ],
  "properties": {
    "personalLaw": {
      "description": "Which personal law governs this estate — India applies different succession laws based on religion",
      "enum": [
        "hindu_succession_act_1956",
        "indian_succession_act_1925",
        "muslim_personal_law",
        "parsi_succession",
        "special_marriage_act",
        "goa_civil_code"
      ]
    },
    "state": {
      "description": "Indian state — different states have variations (e.g. agricultural land ceiling, stamp duty)",
      "type": "string",
      "maxLength": 100
    },
    "probateRequired": {
      "description": "Whether probate is required — varies by religion and state. Mandatory for wills under Indian Succession Act in certain cities.",
      "type": "boolean"
    },
    "probateJurisdiction": {
      "description": "Which court has jurisdiction — District Court or High Court depending on estate value",
      "type": "object",
      "properties": {
        "court": {
          "type": "string",
          "maxLength": 255
        },
        "courtType": {
          "enum": [
            "district_court",
            "high_court"
          ]
        }
      },
      "additionalProperties": false
    },
    "agriculturalLand": {
      "description": "Agricultural land has special succession rules — cannot be willed in some states, subject to ceiling limits",
      "type": "object",
      "properties": {
        "hasAgriculturalLand": {
          "type": "boolean"
        },
        "stateCeilingApplies": {
          "type": "boolean"
        },
        "willingRestriction": {
          "type": "boolean",
          "description": "Whether agricultural land can be disposed of by will in this state"
        }
      },
      "additionalProperties": false
    },
    "nriComplications": {
      "description": "Non-Resident Indian complications — FEMA restrictions, repatriation limits, tax treaty implications",
      "type": "object",
      "properties": {
        "isNri": {
          "type": "boolean"
        },
        "femaRestrictions": {
          "type": "boolean",
          "description": "Whether FEMA (Foreign Exchange Management Act) restrictions apply"
        },
        "repatriationLimit": {
          "$ref": "../../common/money.json"
        },
        "dtaa": {
          "type": "string",
          "maxLength": 255,
          "description": "Applicable Double Taxation Avoidance Agreement"
        }
      },
      "additionalProperties": false
    },
    "goaException": {
      "description": "Goa follows the Portuguese Civil Code — community of property regime applies regardless of religion",
      "type": "object",
      "properties": {
        "applies": {
          "type": "boolean"
        },
        "communityOfProperty": {
          "type": "boolean",
          "description": "Whether community of property regime applies"
        },
        "forcedHeirship": {
          "type": "boolean",
          "description": "Portuguese-style forced heirship (legítima)"
        }
      },
      "additionalProperties": false
    },
    "stampDuty": {
      "description": "Stamp duty on succession — varies by state",
      "type": "object",
      "properties": {
        "stateRate": {
          "type": "number",
          "minimum": 0
        },
        "exemptions": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 255
          }
        }
      },
      "additionalProperties": false
    },
    "coparcenaryDetails": {
      "description": "Hindu Succession Act coparcenary property rules — Mitakshara (most of India) vs Dayabhaga (Bengal)",
      "$comment": "This section overlaps with the hindu-succession extension which models coparcenary in greater detail. For Hindu estates, prefer the hindu-succession extension's HUFDetails and Coparcener definitions. This section is retained for backwards compatibility.",
      "type": "object",
      "properties": {
        "school": {
          "enum": [
            "mitakshara",
            "dayabhaga"
          ]
        },
        "amendment2005Applies": {
          "type": "boolean",
          "description": "Hindu Succession (Amendment) Act 2005 — daughters equal coparceners"
        },
        "coparcenaryPropertyIdentified": {
          "type": "boolean"
        },
        "survivorshipApplies": {
          "type": "boolean"
        },
        "notes": {
          "type": "string",
          "maxLength": 2000
        }
      },
      "additionalProperties": false
    },
    "propertyClassification": {
      "description": "Ancestral vs self-acquired property distinction — ancestral property subject to coparcenary rules, self-acquired freely disposable",
      "type": "object",
      "properties": {
        "type": {
          "enum": [
            "ancestral",
            "self_acquired",
            "mixed"
          ]
        },
        "ancestralPropertyIdentified": {
          "type": "boolean"
        },
        "notes": {
          "type": "string",
          "maxLength": 2000
        }
      },
      "additionalProperties": false
    },
    "successionCertificate": {
      "description": "Procedural mechanism for succession under Indian Succession Act ss.370-390",
      "type": "object",
      "properties": {
        "type": {
          "enum": [
            "succession_certificate",
            "letters_of_administration",
            "probate",
            "legal_heir_certificate"
          ]
        },
        "court": {
          "type": "string",
          "maxLength": 255
        },
        "applicationDate": {
          "type": "string",
          "format": "date",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        "granted": {
          "type": "boolean"
        },
        "notes": {
          "type": "string",
          "maxLength": 2000
        }
      },
      "additionalProperties": false
    },
    "hufImplications": {
      "description": "Hindu Undivided Family (HUF) implications — karta's interest passes by survivorship to coparceners",
      "type": "object",
      "properties": {
        "hufExists": {
          "type": "boolean"
        },
        "deceasedWasKarta": {
          "type": "boolean"
        },
        "hufPropertyExcluded": {
          "type": "boolean",
          "description": "HUF property passes by survivorship, not succession"
        },
        "taxImplications": {
          "type": "string",
          "maxLength": 2000
        },
        "notes": {
          "type": "string",
          "maxLength": 2000
        }
      },
      "additionalProperties": false
    },
    "muslimSuccessionRules": {
      "description": "India-specific Muslim personal law application — school determines heir shares and distant kindred treatment",
      "type": "object",
      "properties": {
        "school": {
          "enum": [
            "hanafi",
            "shia_ithna_ashari",
            "shafi",
            "other"
          ]
        },
        "testamentaryThird": {
          "type": "boolean",
          "description": "Can only bequeath 1/3 without heir consent"
        },
        "heirConsent": {
          "type": "boolean",
          "description": "Heirs consented to bequest exceeding 1/3"
        },
        "notes": {
          "type": "string",
          "maxLength": 2000
        }
      },
      "additionalProperties": false
    },
    "parsiSuccessionRules": {
      "description": "Parsi succession rules under the Indian Succession Act 1925 Part V. Daughters receive half a son's share; widow receives equal to one child's share",
      "type": "object",
      "properties": {
        "daughterShareRule": {
          "description": "Daughter's share relative to son — always half under Parsi law",
          "type": "string",
          "maxLength": 200
        },
        "widowShareRule": {
          "description": "Widow's share — equal to one child's share",
          "type": "string",
          "maxLength": 200
        },
        "notes": {
          "type": "string",
          "maxLength": 1000
        }
      }
    },
    "christianSuccessionRules": {
      "description": "Christian succession under the Indian Succession Act 1925. Follows the ISA intestacy hierarchy with some state-specific deviations",
      "type": "object",
      "properties": {
        "followsIndianSuccessionAct": {
          "description": "Whether succession follows the Indian Succession Act 1925 (true for most states)",
          "type": "boolean"
        },
        "notes": {
          "type": "string",
          "maxLength": 1000
        }
      }
    },
    "notes": {
      "type": "string",
      "maxLength": 2000
    }
  },
  "minProperties": 1,
  "patternProperties": {
    "^x-inherit-[a-z][a-z0-9-]{1,54}$": {
      "type": "object",
      "maxProperties": 50,
      "propertyNames": {
        "pattern": "^[a-zA-Z_][a-zA-Z0-9_]*$",
        "maxLength": 64
      }
    }
  },
  "unevaluatedProperties": false,
  "propertyNames": {
    "pattern": "^(x-inherit-[a-z][a-z0-9-]*|[a-z][a-zA-Z0-9]*)$"
  }
}