@openinherit/sdk 1.0.0

package/dist/estate/types.gen.d.ts

@@ -0,0 +1,2140 @@
+export type ClientOptions = {
+    baseUrl: 'https://api.openinherit.org/v1' | (string & {});
+};
+/**
+ * The top-level INHERIT document envelope
+ */
+export type InheritDocument = Schema;
+/**
+ * The estate — links all entities together
+ */
+export type Estate = Estate2;
+/**
+ * Any person referenced in the estate
+ */
+export type Person = Person2;
+/**
+ * Relationship between two people
+ */
+export type Relationship = Relationship2;
+/**
+ * Family group structure
+ */
+export type Kinship = Kinship2;
+/**
+ * Real property (land, buildings)
+ */
+export type Property = Property2;
+/**
+ * Non-property assets (bank accounts, investments, etc.)
+ */
+export type Asset = Asset2;
+/**
+ * Debts, mortgages, loans
+ */
+export type Liability = Liability2;
+/**
+ * A gift in a will
+ */
+export type Bequest = Bequest2;
+/**
+ * Trust arrangements
+ */
+export type Trust = Trust2;
+/**
+ * Named executor or administrator
+ */
+export type Executor = Executor2;
+/**
+ * Guardian appointment for minor children
+ */
+export type Guardian = Guardian2;
+/**
+ * Non-binding wishes (funeral, organ donation, etc.)
+ */
+export type Wish = Wish2;
+/**
+ * Legal documents (wills, codicils, powers of attorney)
+ */
+export type Document = Document2;
+/**
+ * Witness attestation of a document
+ */
+export type Attestation = Attestation2;
+/**
+ * Power of attorney or deputyship
+ */
+export type ProxyAuthorisation = ProxyAuthorisation2;
+/**
+ * Professional interest in the estate
+ */
+export type DealerInterest = DealerInterest2;
+/**
+ * Assets that pass outside the will
+ */
+export type NonprobateTransfer = NonprobateTransfer2;
+/**
+ * Monetary amounts (integer pennies + currency)
+ */
+export type Money = Money2;
+/**
+ * Postal addresses
+ */
+export type Address = Address2;
+/**
+ * ISO 3166-2 jurisdiction codes
+ */
+export type Jurisdiction = Jurisdiction2;
+/**
+ * External identifiers (NI number, passport, etc.)
+ */
+export type Identifier = Identifier2;
+/**
+ * Time-bound legislation rules
+ */
+export type TemporalRule = TemporalRule2;
+/**
+ * IHT thresholds, intestacy rules, IFPA 1975 for England & Wales
+ */
+export type ExtensionUkEnglandWales = UkEnglandWales;
+/**
+ * US estate planning — community property, elective share, homestead
+ */
+export type ExtensionUsEstate = UsEstate;
+/**
+ * Canadian provincial succession rules
+ */
+export type ExtensionCanada = Canada;
+/**
+ * AU/NZ superannuation, family provision, Maori land
+ */
+export type ExtensionAustraliaNz = AustraliaNz;
+/**
+ * Brussels IV, European Certificate of Succession, forced heirship
+ */
+export type ExtensionEuSuccession = EuSuccession;
+/**
+ * Japanese succession — koseki, iryubun, yōshi, isan bunkatsu
+ */
+export type ExtensionJapan = Japan;
+/**
+ * PRC succession — forced heirship, hukou, notarised certificates
+ */
+export type ExtensionPrcChina = PrcChina;
+/**
+ * SG/MY — ISA, AMLA, CPF/EPF nominations, Distribution Act
+ */
+export type ExtensionSingaporeMalaysia = SingaporeMalaysia;
+/**
+ * Latin American succession — legítima, forced heirship, fourths system
+ */
+export type ExtensionLatinAmerica = LatinAmerica;
+/**
+ * Faraid — fixed shares, residuary, awl/radd, wasiyya, waqf
+ */
+export type ExtensionIslamic = Islamic;
+/**
+ * Halachic inheritance — bekhor, mezonot, kinyan
+ */
+export type ExtensionJewish = Jewish;
+/**
+ * Hindu succession — Mitakshara/Dayabhaga, HUF, stridhan
+ */
+export type ExtensionIndiaHindu = IndiaHindu;
+/**
+ * Customary succession — patrilineal/matrilineal, family council, lobola
+ */
+export type ExtensionAfricaCustomary = AfricaCustomary;
+export type ValidationResult = {
+    valid: boolean;
+    /**
+     * 0 = Invalid, 1 = Schema Valid, 2 = Referentially Intact,
+     * 3 = Jurisdiction Complete
+     *
+     */
+    conformanceLevel: 0 | 1 | 2 | 3;
+    errors: Array<{
+        path: string;
+        message: string;
+        level: 'error' | 'warning' | 'info';
+    }>;
+};
+/**
+ * Attestation
+ *
+ * Will execution formalities. Standalone — reused by estate, codicils, trusts, extensions. Supports written (E&W Wills Act s.9), oral (Islamic/customary), seal-based (Japanese inkan), kinyan-based (Jewish).
+ */
+export type Attestation2 = {
+    date?: string;
+    witnessPersonIds?: Array<string>;
+    method?: 'in_person' | 'video' | 'remote' | 'none' | 'kinyan_sudar' | 'kinyan_agav' | 'seal_based' | 'inkan_registered';
+    attestationType?: 'written_signed' | 'oral_witnessed' | 'oral_community' | 'seal_based';
+    solicitorSupervised?: boolean;
+    testatorSignedInPresenceOfWitnesses?: boolean;
+    witnessesSignedInPresenceOfTestator?: boolean;
+    witnessConflictCheck?: boolean;
+    witnessConflictCheckScope?: 'english_law' | 'halachic_broad' | 'shariah_standard' | 'civil_law_standard' | 'customary_oral' | 'community_testimony';
+    notes?: string;
+    [key: string]: unknown | string | Array<string> | 'in_person' | 'video' | 'remote' | 'none' | 'kinyan_sudar' | 'kinyan_agav' | 'seal_based' | 'inkan_registered' | 'written_signed' | 'oral_witnessed' | 'oral_community' | 'seal_based' | boolean | 'english_law' | 'halachic_broad' | 'shariah_standard' | 'civil_law_standard' | 'customary_oral' | 'community_testimony' | string | undefined;
+};
+/**
+ * Jurisdiction
+ *
+ * A legal jurisdiction identified by ISO 3166 codes.
+ */
+export type Jurisdiction2 = {
+    /**
+     * ISO 3166-1 alpha-2
+     */
+    country: string;
+    /**
+     * ISO 3166-2 subdivision code (e.g. GB-SCT, US-CA)
+     */
+    subdivision?: string;
+    legalSystem?: 'common_law' | 'civil_law' | 'mixed' | 'religious' | 'customary' | 'religious_islamic' | 'religious_jewish' | 'religious_hindu' | 'religious_canon' | 'plural';
+    /**
+     * Human-readable jurisdiction name (e.g. 'Scotland', 'California')
+     */
+    name?: string;
+};
+/**
+ * Money
+ *
+ * Monetary value in integer minor currency units with ISO 4217 code. Never floating point.
+ */
+export type Money2 = {
+    /**
+     * Value in smallest currency unit (e.g. 32500 = £325.00)
+     */
+    amount: number;
+    /**
+     * ISO 4217 three-letter code
+     */
+    currency: string;
+};
+export type TestamentaryCapacity = {
+    assessed?: boolean;
+    assessmentDate?: string;
+    assessorName?: string;
+    assessorRole?: string;
+    capacityConfirmed?: boolean;
+    goldenRuleComplied?: boolean;
+    notes?: string;
+};
+export type Codicil = {
+    id: string;
+    date: string;
+    description?: string;
+    attestation?: Attestation2;
+    documentId?: string;
+};
+export type ForcedHeirship = {
+    applies?: boolean;
+    reservedPortion?: number;
+    disposableQuota?: number;
+    jurisdiction?: Jurisdiction2;
+    claimNature?: 'property_share' | 'cash_claim' | 'usufruct' | 'court_discretion';
+    calculationBasis?: 'fixed' | 'per_child_sliding' | 'court_discretion' | 'conditional';
+    applicableTo?: 'children_only' | 'children_and_spouse' | 'all_descendants' | 'all_heirs';
+    deferralRule?: string;
+    effectiveDate?: string;
+    reformVersion?: string;
+    notes?: string;
+};
+export type AdjudicatingBody = {
+    type: 'secular_court' | 'religious_court' | 'beth_din' | 'shariah_court' | 'tribal_court' | 'family_court' | 'family_council' | 'community_elders' | 'partition_meeting' | 'karta_decision' | 'maori_land_court' | 'high_court';
+    name?: string;
+    jurisdiction?: Jurisdiction2;
+    caseReference?: string;
+    authoritative?: boolean;
+};
+export type ParallelDistribution = {
+    system: string;
+    jurisdiction?: Jurisdiction2;
+    description?: string;
+    notes?: string;
+};
+export type ProbateGrant = {
+    grantType?: string;
+    grantDate?: string;
+    grantReference?: string;
+    issuingCourt?: string;
+    jurisdiction?: Jurisdiction2;
+    notes?: string;
+};
+export type DeathRecord = {
+    dateOfDeath?: string;
+    placeOfDeath?: string;
+    deathCertificateRef?: string;
+    domicileAtDeath?: Jurisdiction2;
+    notes?: string;
+};
+export type SuccessionConflict = {
+    description: string;
+    systems?: Array<string>;
+    resolutionStatus?: 'unresolved' | 'resolved' | 'pending_court' | 'pending_arbitration';
+    notes?: string;
+};
+/**
+ * Estate
+ *
+ * The root estate record — will, intestacy, or trust-based succession plan. Contains testator details, jurisdiction, will formalities, forced heirship, probate grants, death record, multi-jurisdiction administration, and tax treaty positions.
+ */
+export type Estate2 = {
+    id: string;
+    testatorPersonId: string;
+    status: 'draft' | 'active' | 'locked' | 'archived';
+    jurisdiction: Jurisdiction2;
+    willType?: 'secular' | 'religious' | 'dual' | 'composite' | 'oral_witnessed' | 'oral_customary' | 'holographic' | 'notarised' | 'privileged_will';
+    extensionWillType?: string;
+    companionEstateId?: string;
+    primaryInstrument?: 'will' | 'revocable_trust' | 'both' | 'intestacy';
+    defaultPropertyRegime?: 'community_property' | 'separate_property' | 'equitable_distribution' | 'deferred_community' | 'universal_community' | 'participation_in_acquisitions' | 'islamic_dower';
+    totalEstimatedValue?: Money2;
+    attestation?: Attestation2;
+    testamentaryCapacity?: TestamentaryCapacity;
+    codicils?: Array<Codicil>;
+    revokesDocumentIds?: Array<string>;
+    revocationClause?: boolean;
+    forcedHeirship?: ForcedHeirship;
+    adjudicatingBodies?: Array<AdjudicatingBody>;
+    parallelDistributions?: Array<ParallelDistribution>;
+    probateGrant?: ProbateGrant;
+    deathRecord?: DeathRecord;
+    successionConflicts?: Array<SuccessionConflict>;
+    choiceOfLaw?: {
+        chosenLaw?: Jurisdiction2;
+        basis?: string;
+        documentRef?: string;
+    };
+    electiveShareRight?: {
+        available?: boolean;
+        electedAmount?: Money2;
+        statute?: string;
+        notes?: string;
+    };
+    priorMatrimonialClaim?: {
+        exists?: boolean;
+        description?: string;
+        claimantPersonId?: string;
+        notes?: string;
+    };
+    noContestClause?: {
+        present?: boolean;
+        enforceability?: string;
+        notes?: string;
+    };
+    pretermittedHeirClaims?: Array<{
+        claimantPersonId?: string;
+        status?: string;
+        notes?: string;
+    }>;
+    testamentaryPromises?: Array<{
+        claimantPersonId?: string;
+        promiseDescription?: string;
+        status?: string;
+        notes?: string;
+    }>;
+    judicialVariationPower?: {
+        available?: boolean;
+        statute?: string;
+        notes?: string;
+    };
+    commorientesRule?: {
+        applicable?: boolean;
+        rule?: string;
+        jurisdiction?: Jurisdiction2;
+        notes?: string;
+    };
+    ancillaryProbate?: Array<{
+        jurisdiction: Jurisdiction2;
+        fiduciaryPersonId?: string;
+        status?: 'not_started' | 'applied' | 'granted' | 'completed' | 'waived';
+        grantReference?: string;
+        localCounsel?: string;
+        notes?: string;
+    }>;
+    registrations?: Array<{
+        registry: string;
+        registrationNumber?: string;
+        jurisdictionScope?: string;
+        registrationDate?: string;
+    }>;
+    reportingCurrency?: string;
+    conversionRates?: Array<{
+        fromCurrency: string;
+        toCurrency: string;
+        rate: number;
+        rateDate: string;
+        source?: string;
+    }>;
+    taxTreatyPositions?: Array<{
+        treaty: string;
+        primaryTaxingJurisdiction?: Jurisdiction2;
+        claimedCredits?: string;
+        relevantArticle?: string;
+        notes?: string;
+    }>;
+    suggestedPractitionerNeeds?: Array<string>;
+    createdAt: string;
+    lastModifiedAt: string;
+    notes?: string;
+    [key: string]: unknown | string | 'draft' | 'active' | 'locked' | 'archived' | Jurisdiction2 | 'secular' | 'religious' | 'dual' | 'composite' | 'oral_witnessed' | 'oral_customary' | 'holographic' | 'notarised' | 'privileged_will' | string | 'will' | 'revocable_trust' | 'both' | 'intestacy' | 'community_property' | 'separate_property' | 'equitable_distribution' | 'deferred_community' | 'universal_community' | 'participation_in_acquisitions' | 'islamic_dower' | Money2 | Attestation2 | TestamentaryCapacity | Array<Codicil> | Array<string> | boolean | ForcedHeirship | Array<AdjudicatingBody> | Array<ParallelDistribution> | ProbateGrant | DeathRecord | Array<SuccessionConflict> | {
+        chosenLaw?: Jurisdiction2;
+        basis?: string;
+        documentRef?: string;
+    } | {
+        available?: boolean;
+        electedAmount?: Money2;
+        statute?: string;
+        notes?: string;
+    } | {
+        exists?: boolean;
+        description?: string;
+        claimantPersonId?: string;
+        notes?: string;
+    } | {
+        present?: boolean;
+        enforceability?: string;
+        notes?: string;
+    } | Array<{
+        claimantPersonId?: string;
+        status?: string;
+        notes?: string;
+    }> | Array<{
+        claimantPersonId?: string;
+        promiseDescription?: string;
+        status?: string;
+        notes?: string;
+    }> | {
+        available?: boolean;
+        statute?: string;
+        notes?: string;
+    } | {
+        applicable?: boolean;
+        rule?: string;
+        jurisdiction?: Jurisdiction2;
+        notes?: string;
+    } | Array<{
+        jurisdiction: Jurisdiction2;
+        fiduciaryPersonId?: string;
+        status?: 'not_started' | 'applied' | 'granted' | 'completed' | 'waived';
+        grantReference?: string;
+        localCounsel?: string;
+        notes?: string;
+    }> | Array<{
+        registry: string;
+        registrationNumber?: string;
+        jurisdictionScope?: string;
+        registrationDate?: string;
+    }> | string | Array<{
+        fromCurrency: string;
+        toCurrency: string;
+        rate: number;
+        rateDate: string;
+        source?: string;
+    }> | Array<{
+        treaty: string;
+        primaryTaxingJurisdiction?: Jurisdiction2;
+        claimedCredits?: string;
+        relevantArticle?: string;
+        notes?: string;
+    }> | Array<string> | string | undefined;
+};
+/**
+ * PostalAddress
+ *
+ * A physical address. Culturally neutral — supports any global addressing convention.
+ */
+export type Address2 = {
+    /**
+     * Street number and name
+     */
+    streetAddress?: string;
+    /**
+     * Flat, suite, building, floor
+     */
+    addressLine2?: string;
+    /**
+     * City, town, village, or ward
+     */
+    addressLocality?: string;
+    /**
+     * State, prefecture, province, county
+     */
+    addressRegion?: string;
+    postalCode?: string;
+    /**
+     * ISO 3166-1 alpha-2
+     */
+    addressCountry?: string;
+    latitude?: number;
+    longitude?: number;
+    landmark?: string;
+    directionNotes?: string;
+    addressOrder?: 'western' | 'japanese' | 'indian' | 'arabic' | 'custom';
+};
+/**
+ * Identifier
+ *
+ * A typed external identifier. Use 'system' to namespace (e.g. 'urn:hmrc:nino').
+ */
+export type Identifier2 = {
+    /**
+     * Namespace URI or name
+     */
+    system?: string;
+    /**
+     * The identifier value
+     */
+    value: string;
+    /**
+     * Type label (e.g. 'passport', 'national_insurance', 'charity_number')
+     */
+    type?: string;
+};
+/**
+ * Person
+ *
+ * A person involved in the estate. Schema.org name alignment. Any Unicode script. Supports CJK phonetic readings, chieftaincy titles, clan/lineage identifiers, dual legal personalities, and tax residency across multiple jurisdictions.
+ */
+export type Person2 = {
+    id: string;
+    /**
+     * First/given name (Schema.org: givenName)
+     */
+    givenName: string;
+    /**
+     * Last/family/surname (Schema.org: familyName)
+     */
+    familyName?: string;
+    /**
+     * Middle name(s) (Schema.org: additionalName)
+     */
+    additionalName?: string;
+    /**
+     * Name the person prefers to be called
+     */
+    preferredName?: string;
+    phoneticReading?: {
+        givenName?: string;
+        familyName?: string;
+        fullName?: string;
+    };
+    titles?: Array<{
+        title: string;
+        type?: 'chieftaincy' | 'traditional' | 'religious' | 'professional' | 'honorific' | 'clan' | 'academic' | 'military' | 'other';
+    }>;
+    clanOrLineage?: string;
+    /**
+     * ISO 8601 date of birth
+     */
+    dateOfBirth?: string;
+    /**
+     * ISO 8601 date of death (if deceased)
+     */
+    dateOfDeath?: string;
+    gender?: 'male' | 'female' | 'non_binary' | 'other' | 'prefer_not_to_say' | 'unknown';
+    domicile?: Jurisdiction2;
+    roles: Array<'testator' | 'beneficiary' | 'executor' | 'guardian' | 'trustee' | 'witness' | 'attorney' | 'proxy' | 'protector' | 'enforcer'>;
+    contact?: {
+        email?: string;
+        /**
+         * Phone number (E.164 recommended)
+         */
+        phone?: string;
+        address?: Address2;
+    };
+    /**
+     * External identifiers (passport, national ID, etc.)
+     */
+    identifiers?: Array<Identifier2>;
+    ritualName?: {
+        /**
+         * The full ritual/religious name
+         */
+        name: string;
+        /**
+         * Patronymic element (ben/bat, ibn/bint, etc.)
+         */
+        patronymic?: string;
+        /**
+         * Naming tradition: hebrew, arabic_nasab, hindu, buddhist, etc.
+         */
+        nameSystem?: string;
+    };
+    legalPersonalities?: Array<{
+        system: 'statutory' | 'customary' | 'religious' | 'traditional';
+        role: string;
+        jurisdiction?: Jurisdiction2;
+        notes?: string;
+    }>;
+    taxResidency?: Array<{
+        jurisdiction: Jurisdiction2;
+        taxpayerIdentifier?: string;
+        treatyPosition?: string;
+        fatcaStatus?: 'us_person' | 'non_us_person' | 'exempt' | 'unknown';
+    }>;
+    /**
+     * BCP 47 language tag for preferred language
+     */
+    language?: string;
+    notes?: string;
+    [key: string]: unknown | string | string | string | {
+        givenName?: string;
+        familyName?: string;
+        fullName?: string;
+    } | Array<{
+        title: string;
+        type?: 'chieftaincy' | 'traditional' | 'religious' | 'professional' | 'honorific' | 'clan' | 'academic' | 'military' | 'other';
+    }> | string | 'male' | 'female' | 'non_binary' | 'other' | 'prefer_not_to_say' | 'unknown' | Jurisdiction2 | Array<'testator' | 'beneficiary' | 'executor' | 'guardian' | 'trustee' | 'witness' | 'attorney' | 'proxy' | 'protector' | 'enforcer'> | {
+        email?: string;
+        /**
+         * Phone number (E.164 recommended)
+         */
+        phone?: string;
+        address?: Address2;
+    } | Array<Identifier2> | {
+        /**
+         * The full ritual/religious name
+         */
+        name: string;
+        /**
+         * Patronymic element (ben/bat, ibn/bint, etc.)
+         */
+        patronymic?: string;
+        /**
+         * Naming tradition: hebrew, arabic_nasab, hindu, buddhist, etc.
+         */
+        nameSystem?: string;
+    } | Array<{
+        system: 'statutory' | 'customary' | 'religious' | 'traditional';
+        role: string;
+        jurisdiction?: Jurisdiction2;
+        notes?: string;
+    }> | Array<{
+        jurisdiction: Jurisdiction2;
+        taxpayerIdentifier?: string;
+        treatyPosition?: string;
+        fatcaStatus?: 'us_person' | 'non_us_person' | 'exempt' | 'unknown';
+    }> | undefined;
+};
+/**
+ * Kinship
+ *
+ * A familial bond between two people. Essential for intestacy calculation — inheritance rules in every jurisdiction depend on parent-child, sibling, and other familial relationships. Direction: fromPersonId is the parent/elder, toPersonId is the child/younger (for parent-child types). Indian extensions may add PARENT_CHILD_COPARCENARY, KARTA_MEMBER. See extensions/india-hindu.json.
+ */
+export type Kinship2 = {
+    id: string;
+    type: 'PARENT_CHILD_BIOLOGICAL' | 'PARENT_CHILD_ADOPTED' | 'PARENT_CHILD_STEP' | 'PARENT_CHILD_FOSTER' | 'PARENT_CHILD_ACKNOWLEDGED' | 'SIBLING' | 'HALF_SIBLING_PATERNAL' | 'HALF_SIBLING_MATERNAL' | 'STEP_SIBLING' | 'GRANDPARENT_GRANDCHILD' | 'UNCLE_NEPHEW' | 'AUNT_NEPHEW';
+    /**
+     * Parent/elder person in the kinship (Person.id)
+     */
+    fromPersonId: string;
+    /**
+     * Child/younger person in the kinship (Person.id)
+     */
+    toPersonId: string;
+    /**
+     * Legal recognition status of this familial bond
+     */
+    legalStatus?: 'recognised' | 'contested' | 'pending' | 'unrecognised';
+    legitimacy?: 'legitimate' | 'illegitimate' | 'legitimated' | 'not_applicable';
+    /**
+     * Date of adoption order (for PARENT_CHILD_ADOPTED)
+     */
+    adoptionDate?: string;
+    /**
+     * Court order or adoption certificate reference
+     */
+    courtOrderRef?: string;
+    notes?: string;
+    [key: string]: unknown | string | 'PARENT_CHILD_BIOLOGICAL' | 'PARENT_CHILD_ADOPTED' | 'PARENT_CHILD_STEP' | 'PARENT_CHILD_FOSTER' | 'PARENT_CHILD_ACKNOWLEDGED' | 'SIBLING' | 'HALF_SIBLING_PATERNAL' | 'HALF_SIBLING_MATERNAL' | 'STEP_SIBLING' | 'GRANDPARENT_GRANDCHILD' | 'UNCLE_NEPHEW' | 'AUNT_NEPHEW' | 'recognised' | 'contested' | 'pending' | 'unrecognised' | 'legitimate' | 'illegitimate' | 'legitimated' | 'not_applicable' | string | string | undefined;
+};
+export type Partner = {
+    /**
+     * Reference to a Person.id
+     */
+    personId: string;
+    /**
+     * Optional non-gendered label (e.g. 'First Wife', 'Partner A')
+     */
+    displayLabel?: string;
+    /**
+     * Position in partner list (1-based)
+     */
+    ordinal: number;
+};
+export type RelationshipEvent = {
+    type: 'CEREMONY' | 'REGISTRATION' | 'ENGAGEMENT' | 'MARRIAGE_CONTRACT' | 'PROPERTY_REGIME_CHANGE' | 'SEPARATION_INFORMAL' | 'SEPARATION_LEGAL' | 'DIVORCE_FILED' | 'DIVORCE_FINALISED' | 'FINANCIAL_ORDER' | 'ANNULMENT' | 'DISSOLUTION' | 'DEATH_OF_PARTNER' | 'RECONCILIATION' | 'VOID_DECLARATION' | 'MAHR_PAYMENT' | 'LOBOLA_PAYMENT';
+    /**
+     * ISO 8601 date
+     */
+    date: string;
+    jurisdiction?: Jurisdiction2;
+    notes?: string;
+};
+export type JurisdictionalRecognition = {
+    jurisdiction: Jurisdiction2;
+    recognised: boolean;
+    /**
+     * What this jurisdiction recognises it as (if different)
+     */
+    recognisedAs?: string;
+    notes?: string;
+};
+export type FinancialInstrument = unknown & {
+    type: 'MAHR' | 'KETUBAH' | 'LOBOLA' | 'PRENUPTIAL_AGREEMENT' | 'POSTNUPTIAL_AGREEMENT' | 'MARRIAGE_SETTLEMENT';
+    value?: Money2;
+    status?: 'AGREED' | 'PAID' | 'PARTIALLY_PAID' | 'DEFERRED' | 'DISPUTED' | 'WAIVED';
+    description?: string;
+    /**
+     * Reference to a Document.id
+     */
+    documentRef?: string;
+    date?: string;
+    /**
+     * How this affects inheritance distribution
+     */
+    inheritanceImpact?: string;
+    maharDetails?: {
+        maharType?: 'prompt' | 'deferred' | 'combination';
+        recipientPersonId?: string;
+        linkedLiabilityId?: string;
+    };
+    ketubahDetails?: {
+        principalAmount?: Money2;
+        tosefetAmount?: Money2;
+        nedunya?: Money2;
+        brideStatus?: 'virgin' | 'widow' | 'divorcee';
+        witnessPersonIds?: Array<string>;
+        officiatingRabbi?: string;
+    };
+    lobolaDetails?: {
+        negotiatedWith?: string;
+        includesLivestock?: boolean;
+        livestockCount?: number;
+    };
+};
+/**
+ * Relationship
+ *
+ * Spousal/partnership relationship. N-partner support (no structural two-partner limit). Event-based timeline (status derived from events). No gendered role names. Financial instruments with MAHR/KETUBAH subtype validation. Cross-jurisdiction recognition for dual civil/religious status.
+ */
+export type Relationship2 = {
+    id: string;
+    type: 'MARRIAGE_CIVIL' | 'MARRIAGE_RELIGIOUS' | 'MARRIAGE_CUSTOMARY' | 'MARRIAGE_COMMON_LAW' | 'CIVIL_PARTNERSHIP' | 'CIVIL_UNION' | 'DOMESTIC_PARTNERSHIP' | 'DE_FACTO' | 'COHABITATION' | 'ENGAGEMENT';
+    religiousSubtype?: string;
+    /**
+     * How the parties themselves describe this relationship
+     */
+    selfDeclaredType?: string;
+    /**
+     * The people in this relationship. Minimum 2, no structural upper limit.
+     */
+    partners: Array<Partner>;
+    /**
+     * Chronological events determining relationship status
+     */
+    events?: Array<RelationshipEvent>;
+    currentStatus?: 'ACTIVE' | 'SEPARATED_INFORMAL' | 'SEPARATED_LEGAL' | 'DIVORCED' | 'ANNULLED' | 'DISSOLVED' | 'WIDOWED' | 'VOID' | 'PUTATIVE';
+    /**
+     * Primary jurisdiction where this relationship was formed
+     */
+    jurisdiction?: Jurisdiction2;
+    /**
+     * How other jurisdictions recognise (or don't) this relationship
+     */
+    jurisdictionalRecognition?: Array<JurisdictionalRecognition>;
+    /**
+     * Mahr, ketubah, lobola, prenuptial agreements, etc.
+     */
+    financialInstruments?: Array<FinancialInstrument>;
+    /**
+     * The marital property regime
+     */
+    propertyRegime?: 'COMMUNITY_OF_PROPERTY' | 'SEPARATION_OF_PROPERTY' | 'COMMUNITY_OF_ACQUESTS' | 'DEFERRED_COMMUNITY' | 'SEPARATE_AS_MODIFIED' | 'ISLAMIC_DOWER' | 'US_COMMUNITY_PROPERTY' | 'US_COMMUNITY_WITH_SURVIVORSHIP' | 'US_QUASI_COMMUNITY' | 'HINDU_SEPARATE';
+    notes?: string;
+    [key: string]: unknown | string | 'MARRIAGE_CIVIL' | 'MARRIAGE_RELIGIOUS' | 'MARRIAGE_CUSTOMARY' | 'MARRIAGE_COMMON_LAW' | 'CIVIL_PARTNERSHIP' | 'CIVIL_UNION' | 'DOMESTIC_PARTNERSHIP' | 'DE_FACTO' | 'COHABITATION' | 'ENGAGEMENT' | string | Array<Partner> | Array<RelationshipEvent> | 'ACTIVE' | 'SEPARATED_INFORMAL' | 'SEPARATED_LEGAL' | 'DIVORCED' | 'ANNULLED' | 'DISSOLVED' | 'WIDOWED' | 'VOID' | 'PUTATIVE' | Jurisdiction2 | Array<JurisdictionalRecognition> | Array<FinancialInstrument> | 'COMMUNITY_OF_PROPERTY' | 'SEPARATION_OF_PROPERTY' | 'COMMUNITY_OF_ACQUESTS' | 'DEFERRED_COMMUNITY' | 'SEPARATE_AS_MODIFIED' | 'ISLAMIC_DOWER' | 'US_COMMUNITY_PROPERTY' | 'US_COMMUNITY_WITH_SURVIVORSHIP' | 'US_QUASI_COMMUNITY' | 'HINDU_SEPARATE' | undefined;
+};
+/**
+ * Property
+ *
+ * Real estate. Supports individual ownership, communal/family property (Nigeria), HUF coparcenary (India), government-vested land (Land Use Act), US community property, and informal/unregistered holdings.
+ */
+export type Property2 = {
+    id: string;
+    /**
+     * Display name (e.g. 'Family Home', '42 Acacia Avenue')
+     */
+    name: string;
+    propertyType?: 'detached_house' | 'semi_detached_house' | 'terraced_house' | 'flat' | 'maisonette' | 'bungalow' | 'cottage' | 'farmhouse' | 'barn_conversion' | 'land' | 'commercial' | 'mixed_use' | 'houseboat' | 'mobile_home' | 'other';
+    address?: Address2;
+    estimatedValue?: Money2;
+    professionalValuation?: Money2;
+    valuationDate?: string;
+    valuationConfidence?: 'estimated' | 'professional' | 'probate' | 'unknown';
+    isPrimaryResidence?: boolean;
+    ownershipType?: 'sole' | 'joint_tenants' | 'tenants_in_common' | 'trust' | 'tenancy_by_entirety';
+    ownershipPercentage?: number;
+    ownershipModel?: 'individual' | 'joint' | 'communal_family' | 'huf_coparcenary' | 'tribal' | 'government_vested' | 'trust_held';
+    acquisitionType?: 'self_acquired' | 'ancestral_joint' | 'ancestral_severed' | 'inherited' | 'gifted' | 'stridhan' | 'communal' | 'waqf_endowed';
+    tenureType?: 'freehold' | 'leasehold' | 'certificate_of_occupancy' | 'customary_right_of_occupancy' | 'communal' | 'government_allocated' | 'traditional_authority_granted' | 'informal_unregistered';
+    registrationStatus?: 'formally_registered' | 'informally_held' | 'community_acknowledged' | 'disputed' | 'undocumented';
+    ownershipEvidence?: 'title_deed' | 'certificate_of_occupancy' | 'family_recognition' | 'community_testimony' | 'receipts_only' | 'none';
+    applicableSuccessionLaw?: {
+        jurisdiction: Jurisdiction2;
+        lawName?: string;
+        section?: string;
+    };
+    custodianPersonId?: string;
+    successionRule?: 'testamentary' | 'intestacy' | 'customary_eldest_son' | 'customary_family_council' | 'customary_matrilineal' | 'survivorship' | 'not_individually_bequeathable';
+    governmentConsentRequired?: boolean;
+    mobilityType?: 'immoveable' | 'moveable' | 'mixed';
+    mortgageOutstanding?: Money2;
+    characterClassification?: 'community' | 'separate' | 'quasi_community' | 'mixed' | 'not_applicable';
+    homesteadStatus?: {
+        isHomestead?: boolean;
+        exemptionAmount?: Money2;
+        exemptionUnlimited?: boolean;
+        deviseRestriction?: boolean;
+        notes?: string;
+    };
+    passesOutsideEstate?: boolean;
+    statutoryLifeEstate?: {
+        beneficiaryPersonId?: string;
+        basis?: string;
+        conditions?: string;
+    };
+    notes?: string;
+    [key: string]: unknown | string | string | 'detached_house' | 'semi_detached_house' | 'terraced_house' | 'flat' | 'maisonette' | 'bungalow' | 'cottage' | 'farmhouse' | 'barn_conversion' | 'land' | 'commercial' | 'mixed_use' | 'houseboat' | 'mobile_home' | 'other' | Address2 | Money2 | string | 'estimated' | 'professional' | 'probate' | 'unknown' | boolean | 'sole' | 'joint_tenants' | 'tenants_in_common' | 'trust' | 'tenancy_by_entirety' | number | 'individual' | 'joint' | 'communal_family' | 'huf_coparcenary' | 'tribal' | 'government_vested' | 'trust_held' | 'self_acquired' | 'ancestral_joint' | 'ancestral_severed' | 'inherited' | 'gifted' | 'stridhan' | 'communal' | 'waqf_endowed' | 'freehold' | 'leasehold' | 'certificate_of_occupancy' | 'customary_right_of_occupancy' | 'communal' | 'government_allocated' | 'traditional_authority_granted' | 'informal_unregistered' | 'formally_registered' | 'informally_held' | 'community_acknowledged' | 'disputed' | 'undocumented' | 'title_deed' | 'certificate_of_occupancy' | 'family_recognition' | 'community_testimony' | 'receipts_only' | 'none' | {
+        jurisdiction: Jurisdiction2;
+        lawName?: string;
+        section?: string;
+    } | 'testamentary' | 'intestacy' | 'customary_eldest_son' | 'customary_family_council' | 'customary_matrilineal' | 'survivorship' | 'not_individually_bequeathable' | 'immoveable' | 'moveable' | 'mixed' | 'community' | 'separate' | 'quasi_community' | 'mixed' | 'not_applicable' | {
+        isHomestead?: boolean;
+        exemptionAmount?: Money2;
+        exemptionUnlimited?: boolean;
+        deviseRestriction?: boolean;
+        notes?: string;
+    } | {
+        beneficiaryPersonId?: string;
+        basis?: string;
+        conditions?: string;
+    } | string | undefined;
+};
+export type Photo = {
+    url: string;
+    caption?: string;
+};
+/**
+ * Asset
+ *
+ * A non-property asset: financial accounts, personal property, vehicles, digital assets, business interests, Islamic finance instruments, etc.
+ */
+export type Asset2 = {
+    id: string;
+    /**
+     * Display name for this asset
+     */
+    name: string;
+    category: 'bank_account' | 'savings_account' | 'investment' | 'pension' | 'shares' | 'premium_bonds' | 'cryptocurrency' | 'insurance' | 'vehicle' | 'jewellery' | 'art' | 'antiques' | 'collectibles' | 'furniture' | 'electronics' | 'musical_instruments' | 'books' | 'clothing' | 'kitchenware' | 'sports_equipment' | 'firearms' | 'wine_and_spirits' | 'tools' | 'garden_and_outdoor' | 'business_interest' | 'intellectual_property' | 'domain_name' | 'social_media_account' | 'digital_subscription' | 'sukuk' | 'takaful' | 'islamic_deposit' | 'other';
+    subcategory?: string;
+    estimatedValue?: Money2;
+    professionalValuation?: Money2;
+    valuationDate?: string;
+    valuationConfidence?: 'estimated' | 'professional' | 'probate' | 'unknown';
+    condition?: 'excellent' | 'good' | 'fair' | 'poor' | 'unknown' | 'not_applicable';
+    quantity?: number;
+    /**
+     * Where this asset is stored or held
+     */
+    location?: string;
+    /**
+     * Reference to a Property.id if located at a property
+     */
+    propertyId?: string;
+    /**
+     * Serial numbers, account numbers, policy refs, etc.
+     */
+    identifiers?: Array<Identifier2>;
+    photos?: Array<Photo>;
+    possessionStatus?: 'possessed_at_death' | 'receivable' | 'contingent';
+    mobilityType?: 'immoveable' | 'moveable' | 'mixed';
+    acquisitionType?: 'self_acquired' | 'ancestral_joint' | 'ancestral_severed' | 'inherited' | 'gifted' | 'stridhan' | 'communal' | 'waqf_endowed';
+    registrationStatus?: 'formally_registered' | 'informally_held' | 'community_acknowledged' | 'disputed' | 'undocumented';
+    ownershipEvidence?: 'title_deed' | 'certificate_of_occupancy' | 'family_recognition' | 'community_testimony' | 'receipts_only' | 'none';
+    applicableSuccessionLaw?: {
+        jurisdiction: Jurisdiction2;
+        lawName?: string;
+        section?: string;
+    };
+    beneficiaryDesignation?: {
+        primaryBeneficiaryPersonIds?: Array<string>;
+        contingentBeneficiaryPersonIds?: Array<string>;
+        designationType?: 'retirement_account' | 'life_insurance' | 'superannuation' | 'pod_account' | 'other';
+        linkedNonprobateTransferId?: string;
+    };
+    digitalAccessConsent?: {
+        consentGiven?: boolean;
+        scope?: 'full_access' | 'limited_access' | 'no_access';
+        designatedRecipientPersonId?: string;
+        onlineToolDirective?: boolean;
+    };
+    passesOutsideEstate?: boolean;
+    notes?: string;
+    [key: string]: unknown | string | string | 'bank_account' | 'savings_account' | 'investment' | 'pension' | 'shares' | 'premium_bonds' | 'cryptocurrency' | 'insurance' | 'vehicle' | 'jewellery' | 'art' | 'antiques' | 'collectibles' | 'furniture' | 'electronics' | 'musical_instruments' | 'books' | 'clothing' | 'kitchenware' | 'sports_equipment' | 'firearms' | 'wine_and_spirits' | 'tools' | 'garden_and_outdoor' | 'business_interest' | 'intellectual_property' | 'domain_name' | 'social_media_account' | 'digital_subscription' | 'sukuk' | 'takaful' | 'islamic_deposit' | 'other' | string | Money2 | string | 'estimated' | 'professional' | 'probate' | 'unknown' | 'excellent' | 'good' | 'fair' | 'poor' | 'unknown' | 'not_applicable' | number | Array<Identifier2> | Array<Photo> | 'possessed_at_death' | 'receivable' | 'contingent' | 'immoveable' | 'moveable' | 'mixed' | 'self_acquired' | 'ancestral_joint' | 'ancestral_severed' | 'inherited' | 'gifted' | 'stridhan' | 'communal' | 'waqf_endowed' | 'formally_registered' | 'informally_held' | 'community_acknowledged' | 'disputed' | 'undocumented' | 'title_deed' | 'certificate_of_occupancy' | 'family_recognition' | 'community_testimony' | 'receipts_only' | 'none' | {
+        jurisdiction: Jurisdiction2;
+        lawName?: string;
+        section?: string;
+    } | {
+        primaryBeneficiaryPersonIds?: Array<string>;
+        contingentBeneficiaryPersonIds?: Array<string>;
+        designationType?: 'retirement_account' | 'life_insurance' | 'superannuation' | 'pod_account' | 'other';
+        linkedNonprobateTransferId?: string;
+    } | {
+        consentGiven?: boolean;
+        scope?: 'full_access' | 'limited_access' | 'no_access';
+        designatedRecipientPersonId?: string;
+        onlineToolDirective?: boolean;
+    } | boolean | undefined;
+};
+/**
+ * Liability
+ *
+ * A debt or financial obligation. Includes mortgages, loans, credit cards, and cultural obligations (mahr, ketubah debt, lobola) that are priority debts in certain jurisdictions.
+ */
+export type Liability2 = {
+    id: string;
+    type: 'mortgage' | 'personal_loan' | 'credit_card' | 'overdraft' | 'student_loan' | 'car_finance' | 'hire_purchase' | 'mahr' | 'ketubah_debt' | 'lobola' | 'tax_liability' | 'funeral_costs' | 'care_fees' | 'mezonot' | 'other';
+    /**
+     * Name of the creditor or institution
+     */
+    creditor?: string;
+    /**
+     * Outstanding balance
+     */
+    amount: Money2;
+    /**
+     * Reference to a Property.id or Asset.id this liability is secured against
+     */
+    securedAgainst?: string;
+    monthlyPayment?: Money2;
+    /**
+     * Annual interest rate as percentage (e.g. 4.5 = 4.5%)
+     */
+    interestRate?: number;
+    startDate?: string;
+    endDate?: string;
+    /**
+     * Account or reference number
+     */
+    accountReference?: string;
+    notes?: string;
+    [key: string]: unknown | string | 'mortgage' | 'personal_loan' | 'credit_card' | 'overdraft' | 'student_loan' | 'car_finance' | 'hire_purchase' | 'mahr' | 'ketubah_debt' | 'lobola' | 'tax_liability' | 'funeral_costs' | 'care_fees' | 'mezonot' | 'other' | string | Money2 | number | string | undefined;
+};
+export type BeneficiaryOrganisation = {
+    name: string;
+    type: 'charity' | 'company' | 'unincorporated_association' | 'trust' | 'other';
+    registrationNumber?: string;
+    jurisdiction?: Jurisdiction2;
+};
+export type LifeInterest = {
+    tenantForLifeId: string;
+    remaindermanId?: string;
+    remaindermanClassDefinition?: string;
+    interestType: 'use_and_income' | 'income_only' | 'use_only' | 'protective' | 'right_of_residence';
+};
+export type Substitution = {
+    beneficiaryId?: string;
+    classDefinition?: string;
+    beneficiaryOrganisation?: BeneficiaryOrganisation;
+    condition?: string;
+    perStirpes?: boolean;
+};
+export type PostDeathAction = {
+    type: 'disclaimer' | 'deed_of_variation' | 'appropriation' | 'assent';
+    date?: string;
+    description?: string;
+    documentId?: string;
+};
+export type InheritanceResponse = {
+    response: 'accepted' | 'renounced' | 'qualified_acceptance' | 'pending';
+    responseDate?: string;
+    responsePersonId?: string;
+    courtFiled?: boolean;
+    deadlineDate?: string;
+};
+/**
+ * Bequest
+ *
+ * A disposition of property or money in a will. Supports 7 core types (specific, pecuniary, demonstrative, general, residuary, life_interest, class) and extension types via extensionType (e.g. wasiyya, halachic_matanah).
+ */
+export type Bequest2 = unknown & {
+    id: string;
+    type: 'specific' | 'pecuniary' | 'demonstrative' | 'general' | 'residuary' | 'life_interest' | 'class';
+    extensionType?: string;
+    beneficiaryId?: string;
+    beneficiaryOrganisation?: BeneficiaryOrganisation;
+    classDefinition?: string;
+    lifeInterest?: LifeInterest;
+    amount?: Money2;
+    sharePercentage?: number;
+    description?: string;
+    sourceAssetId?: string;
+    conditions?: Array<string>;
+    substitutions?: Array<Substitution>;
+    hotchpot?: boolean;
+    distributionMethod?: 'per_capita' | 'per_stirpes' | 'modified_per_stirpes' | 'per_capita_at_each_generation' | 'halachic_yerusha';
+    predeceaseRule?: 'lapse' | 'per_stirpes' | 'substitution' | 'accrual' | 'statutory_default';
+    constrainedBy?: 'testamentary_freedom' | 'customary_rule' | 'forced_heirship' | 'religious_rule' | 'coparcenary_survivorship';
+    customaryOverride?: boolean;
+    postDeathActions?: Array<PostDeathAction>;
+    inheritanceResponse?: InheritanceResponse;
+    notes?: string;
+    [key: string]: unknown | string | 'specific' | 'pecuniary' | 'demonstrative' | 'general' | 'residuary' | 'life_interest' | 'class' | string | BeneficiaryOrganisation | LifeInterest | Money2 | number | Array<string> | Array<Substitution> | boolean | 'per_capita' | 'per_stirpes' | 'modified_per_stirpes' | 'per_capita_at_each_generation' | 'halachic_yerusha' | 'lapse' | 'per_stirpes' | 'substitution' | 'accrual' | 'statutory_default' | 'testamentary_freedom' | 'customary_rule' | 'forced_heirship' | 'religious_rule' | 'coparcenary_survivorship' | Array<PostDeathAction> | InheritanceResponse | undefined;
+};
+export type TrustAppointee = {
+    personId: string;
+    role: 'trustee' | 'protector' | 'enforcer';
+};
+export type TrustBeneficiary = {
+    personId?: string;
+    classDefinition?: string;
+    organisationName?: string;
+    interestType: 'income' | 'capital' | 'both' | 'discretionary';
+};
+/**
+ * Trust
+ *
+ * A trust instrument — testamentary or inter vivos. Covers discretionary, bare, life interest, charitable, nil rate band, waqf (Islamic endowment), and offshore structures with governance features (reserved powers, flee clauses, protector powers).
+ */
+export type Trust2 = {
+    id: string;
+    name: string;
+    type: 'discretionary' | 'life_interest' | 'bare' | 'accumulation_and_maintenance' | 'disabled_persons' | 'charitable' | 'nil_rate_band' | 'waqf' | 'other';
+    trustees: Array<TrustAppointee>;
+    beneficiaries: Array<TrustBeneficiary>;
+    settlor?: string;
+    isTestamentary?: boolean;
+    createdDate?: string;
+    creationType?: 'testamentary' | 'inter_vivos_revocable' | 'inter_vivos_irrevocable';
+    revocability?: 'revocable' | 'irrevocable' | 'perpetual';
+    perpetual?: boolean;
+    vestingAge?: number;
+    vestingDate?: string;
+    vestingConditions?: Array<string>;
+    contingentInterests?: Array<string>;
+    trustPeriod?: string;
+    governingLaw?: Jurisdiction2;
+    reservedPowers?: Array<{
+        powerType: 'investment' | 'distribution' | 'amendment' | 'revocation' | 'addition_of_beneficiaries' | 'removal_of_trustees' | 'change_of_governing_law';
+        heldByPersonId?: string;
+        conditions?: string;
+    }>;
+    fleeClause?: {
+        present?: boolean;
+        triggerEvents?: Array<string>;
+        destinationJurisdiction?: Jurisdiction2;
+        automaticOrDiscretionary?: 'automatic' | 'discretionary';
+    };
+    protectorPowers?: Array<{
+        powerType: 'consent_to_distribution' | 'remove_trustee' | 'appoint_trustee' | 'change_governing_law' | 'veto_investment' | 'add_beneficiary' | 'exclude_beneficiary' | 'enforce_purpose';
+        protectorPersonId: string;
+        exerciseConditions?: string;
+    }>;
+    jurisdictionalRecognition?: Array<{
+        jurisdiction: Jurisdiction2;
+        recognised: boolean;
+        recognisedAs?: string;
+        hagueTrustConventionApplies?: boolean;
+        notes?: string;
+    }>;
+    assetProtectionFeatures?: {
+        selfSettled?: boolean;
+        spendthriftClause?: boolean;
+        fraudulentTransferLookback?: string;
+        domesticationDate?: string;
+    };
+    notes?: string;
+    [key: string]: unknown | string | string | 'discretionary' | 'life_interest' | 'bare' | 'accumulation_and_maintenance' | 'disabled_persons' | 'charitable' | 'nil_rate_band' | 'waqf' | 'other' | Array<TrustAppointee> | Array<TrustBeneficiary> | boolean | string | 'testamentary' | 'inter_vivos_revocable' | 'inter_vivos_irrevocable' | 'revocable' | 'irrevocable' | 'perpetual' | number | Array<string> | Array<string> | Jurisdiction2 | Array<{
+        powerType: 'investment' | 'distribution' | 'amendment' | 'revocation' | 'addition_of_beneficiaries' | 'removal_of_trustees' | 'change_of_governing_law';
+        heldByPersonId?: string;
+        conditions?: string;
+    }> | {
+        present?: boolean;
+        triggerEvents?: Array<string>;
+        destinationJurisdiction?: Jurisdiction2;
+        automaticOrDiscretionary?: 'automatic' | 'discretionary';
+    } | Array<{
+        powerType: 'consent_to_distribution' | 'remove_trustee' | 'appoint_trustee' | 'change_governing_law' | 'veto_investment' | 'add_beneficiary' | 'exclude_beneficiary' | 'enforce_purpose';
+        protectorPersonId: string;
+        exerciseConditions?: string;
+    }> | Array<{
+        jurisdiction: Jurisdiction2;
+        recognised: boolean;
+        recognisedAs?: string;
+        hagueTrustConventionApplies?: boolean;
+        notes?: string;
+    }> | {
+        selfSettled?: boolean;
+        spendthriftClause?: boolean;
+        fraudulentTransferLookback?: string;
+        domesticationDate?: string;
+    } | undefined;
+};
+/**
+ * Executor
+ *
+ * A person appointed to administer an estate. Includes professional executors, administrators (intestacy), and administrators with will annexed.
+ */
+export type Executor2 = {
+    id: string;
+    /**
+     * Reference to a Person.id
+     */
+    personId: string;
+    role: 'primary' | 'secondary' | 'substitute' | 'administrator' | 'administrator_with_will_annexed';
+    isProfessional?: boolean;
+    /**
+     * Firm name if the executor is a professional (solicitor, accountant, trust corporation)
+     */
+    firmName?: string;
+    grantType?: 'grant_of_probate' | 'letters_of_administration' | 'letters_of_administration_with_will_annexed' | 'resealing' | 'european_certificate_of_succession';
+    grantDate?: string;
+    grantReference?: string;
+    issuingCourt?: string;
+    notes?: string;
+    [key: string]: unknown | string | 'primary' | 'secondary' | 'substitute' | 'administrator' | 'administrator_with_will_annexed' | boolean | string | 'grant_of_probate' | 'letters_of_administration' | 'letters_of_administration_with_will_annexed' | 'resealing' | 'european_certificate_of_succession' | string | undefined;
+};
+/**
+ * Guardian
+ *
+ * A guardian appointment for a minor child. Supports testamentary, court-appointed, shariah court, community-appointed, and religious court appointments. Guardianship structures include individual, collective, rotating, and family council determined.
+ */
+export type Guardian2 = {
+    id: string;
+    /**
+     * Reference to the guardian Person.id
+     */
+    guardianPersonId: string;
+    /**
+     * Reference to the child Person.id
+     */
+    childPersonId: string;
+    role: 'primary' | 'secondary' | 'substitute';
+    appointmentType: 'testamentary' | 'parental_responsibility' | 'court_appointed' | 'shariah_court_appointed' | 'community_appointed' | 'religious_court_appointed';
+    guardianshipStructure?: 'individual' | 'collective' | 'rotating' | 'family_council_determined';
+    familyCouncilDecisionRef?: string;
+    conditions?: string;
+    notes?: string;
+    [key: string]: unknown | string | 'primary' | 'secondary' | 'substitute' | 'testamentary' | 'parental_responsibility' | 'court_appointed' | 'shariah_court_appointed' | 'community_appointed' | 'religious_court_appointed' | 'individual' | 'collective' | 'rotating' | 'family_council_determined' | string | undefined;
+};
+/**
+ * Wish
+ *
+ * A non-binding (or culturally/religiously binding) wish — funeral, letter of wishes, care instructions, pet care, digital estate, distribution preferences.
+ */
+export type Wish2 = {
+    id: string;
+    type: 'funeral' | 'letter' | 'care' | 'distribution' | 'digital' | 'pets' | 'general';
+    title: string;
+    content?: string;
+    bindingNature?: 'non_binding' | 'culturally_obligatory' | 'religiously_obligatory' | 'legally_binding';
+    /**
+     * Person this wish is addressed to
+     */
+    addresseePersonId?: string;
+    /**
+     * Asset this wish relates to
+     */
+    relatedAssetId?: string;
+    notes?: string;
+    [key: string]: unknown | string | 'funeral' | 'letter' | 'care' | 'distribution' | 'digital' | 'pets' | 'general' | string | 'non_binding' | 'culturally_obligatory' | 'religiously_obligatory' | 'legally_binding' | undefined;
+};
+/**
+ * Document
+ *
+ * A document associated with an estate — wills, codicils, trust deeds, and religious documents (shtar_chov, ketubah_document, nikah_nama, etc.). Type is a free string (minLength 1) to accommodate jurisdiction-specific and religious document types.
+ */
+export type Document2 = {
+    id: string;
+    type: string;
+    title: string;
+    fileFormat?: string;
+    /**
+     * Storage reference (e.g. S3 URI, file path, or external system reference)
+     */
+    storageRef?: string;
+    fileSizeBytes?: number;
+    mimeType?: string;
+    createdDate?: string;
+    notes?: string;
+    [key: string]: unknown | string | string | string | number | string | undefined;
+};
+/**
+ * Nonprobate Transfer
+ *
+ * Assets that pass outside the probate estate — revocable trusts, TOD deeds, POD accounts, JTWROS, beneficiary designations, superannuation/CPF/EPF nominations.
+ */
+export type NonprobateTransfer2 = {
+    id: string;
+    type: 'revocable_trust' | 'tod_deed' | 'pod_account' | 'jtwros' | 'tenancy_by_entirety' | 'beneficiary_designation' | 'life_insurance_nomination' | 'superannuation_nomination' | 'cpf_nomination' | 'epf_nomination' | 'mandatory_savings_nomination';
+    designationType?: string;
+    description?: string;
+    trustId?: string;
+    propertyId?: string;
+    assetIds?: Array<string>;
+    beneficiaryPersonIds?: Array<string>;
+    contingentBeneficiaryPersonIds?: Array<string>;
+    survivingOwnerPersonIds?: Array<string>;
+    passesOutsideEstate: boolean;
+    bindingNomination?: boolean;
+    nominationExpiryDate?: string;
+    recordingReference?: string;
+    jurisdiction?: Jurisdiction2;
+    notes?: string;
+    [key: string]: unknown | string | 'revocable_trust' | 'tod_deed' | 'pod_account' | 'jtwros' | 'tenancy_by_entirety' | 'beneficiary_designation' | 'life_insurance_nomination' | 'superannuation_nomination' | 'cpf_nomination' | 'epf_nomination' | 'mandatory_savings_nomination' | string | Array<string> | Array<string> | Array<string> | Array<string> | boolean | string | Jurisdiction2 | undefined;
+};
+export type ConsentRecord = {
+    consentGiven: boolean;
+    consentDate?: string;
+    consentMethod?: 'in_person_verbal' | 'in_person_written' | 'video_recorded' | 'witnessed_verbal' | 'phone_recorded' | 'assumed_cultural_norm';
+    witnesses?: Array<{
+        personId: string;
+        role?: string;
+        witnessedDate?: string;
+    }>;
+    documentRef?: string;
+    notes?: string;
+};
+/**
+ * Proxy Authorisation
+ *
+ * Authorises a proxy to act on behalf of a testator — information gathering, communication, negotiation, or full decision-making. Includes consent record with cultural consent methods.
+ */
+export type ProxyAuthorisation2 = {
+    id: string;
+    proxyPersonId: string;
+    testatorPersonId: string;
+    scope: 'full' | 'information_gathering' | 'communication' | 'negotiation' | 'decision_making';
+    consentRecord: ConsentRecord;
+    dealerNegotiationPermitted?: boolean;
+    startDate?: string;
+    expiryDate?: string;
+    revocationDate?: string;
+    auditTrailEnabled?: boolean;
+    notes?: string;
+    [key: string]: unknown | string | 'full' | 'information_gathering' | 'communication' | 'negotiation' | 'decision_making' | ConsentRecord | boolean | string | string | undefined;
+};
+export type InterestedParty = {
+    personId?: string;
+    name: string;
+    type: 'art_dealer' | 'antique_dealer' | 'property_investor' | 'auction_house' | 'gallery' | 'private_collector' | 'museum' | 'institution' | 'charity' | 'developer' | 'fund_manager' | 'family_office' | 'estate_agent' | 'solicitor_firm' | 'other';
+    contactDetails?: string;
+};
+export type AssetInterestItem = {
+    assetId?: string;
+    propertyId?: string;
+    interestLevel?: 'exploratory' | 'moderate' | 'strong' | 'committed';
+};
+export type CollectionInterest = unknown & {
+    name?: string;
+    assetIds?: Array<string>;
+    propertyIds?: Array<string>;
+    notes?: string;
+};
+export type OfferDetails = {
+    amount?: Money2;
+    conditions?: Array<string>;
+    validUntil?: string;
+    offerDate?: string;
+    documentRef?: string;
+};
+/**
+ * Dealer Interest
+ *
+ * Level D data — records third-party interest in estate assets (art dealers, property investors, collectors). Privacy-controlled. Managed via proxy authorisation.
+ */
+export type DealerInterest2 = {
+    id: string;
+    interestedParty: InterestedParty;
+    assets?: Array<AssetInterestItem>;
+    collection?: CollectionInterest;
+    offerStatus: 'standing_interest' | 'verbal_offer' | 'written_offer' | 'formal_valuation' | 'conditional_offer' | 'accepted' | 'declined' | 'expired' | 'withdrawn';
+    offerDetails?: OfferDetails;
+    testatorDisposition?: 'willing_to_sell' | 'prefer_not_to_sell' | 'hold_for_executor' | 'deferred_to_family' | 'promised_to_institution' | 'undecided';
+    linkedBequestId?: string;
+    privacyLevel: 'testator_only' | 'proxy_visible' | 'executor_visible' | 'all_parties';
+    communicationInitiatedBy?: 'buyer' | 'testator' | 'proxy' | 'executor';
+    managedByProxyId?: string;
+    notes?: string;
+    [key: string]: unknown | string | InterestedParty | Array<AssetInterestItem> | CollectionInterest | 'standing_interest' | 'verbal_offer' | 'written_offer' | 'formal_valuation' | 'conditional_offer' | 'accepted' | 'declined' | 'expired' | 'withdrawn' | OfferDetails | 'willing_to_sell' | 'prefer_not_to_sell' | 'hold_for_executor' | 'deferred_to_family' | 'promised_to_institution' | 'undecided' | 'testator_only' | 'proxy_visible' | 'executor_visible' | 'all_parties' | 'buyer' | 'testator' | 'proxy' | 'executor' | string | undefined;
+};
+/**
+ * INHERIT v1 Root Schema
+ *
+ * Root entry point for an INHERIT v1 estate data interchange document. Contains a single estate and arrays of all entity types.
+ */
+export type Schema = {
+    inherit: 'https://openinherit.org/v1/schema.json';
+    version: 1;
+    exportedAt?: string;
+    exportedBy?: {
+        name?: string;
+        email?: string;
+        organisationName?: string;
+    };
+    generator?: {
+        name: string;
+        version?: string;
+        url?: string;
+    };
+    estate: Estate2;
+    people: Array<Person2>;
+    kinships: Array<Kinship2>;
+    relationships: Array<Relationship2>;
+    properties: Array<Property2>;
+    assets: Array<Asset2>;
+    liabilities: Array<Liability2>;
+    bequests: Array<Bequest2>;
+    trusts: Array<Trust2>;
+    executors: Array<Executor2>;
+    guardians: Array<Guardian2>;
+    wishes: Array<Wish2>;
+    documents: Array<Document2>;
+    nonprobateTransfers: Array<NonprobateTransfer2>;
+    proxyAuthorisations: Array<ProxyAuthorisation2>;
+    dealerInterests: Array<DealerInterest2>;
+    extensions?: Array<string>;
+    [key: string]: unknown | 'https://openinherit.org/v1/schema.json' | 1 | string | {
+        name?: string;
+        email?: string;
+        organisationName?: string;
+    } | {
+        name: string;
+        version?: string;
+        url?: string;
+    } | Estate2 | Array<Person2> | Array<Kinship2> | Array<Relationship2> | Array<Property2> | Array<Asset2> | Array<Liability2> | Array<Bequest2> | Array<Trust2> | Array<Executor2> | Array<Guardian2> | Array<Wish2> | Array<Document2> | Array<NonprobateTransfer2> | Array<ProxyAuthorisation2> | Array<DealerInterest2> | Array<string> | undefined;
+};
+/**
+ * TemporalRule
+ *
+ * A jurisdiction rule value with effective dates, legislative status, and change history.
+ */
+export type TemporalRule2 = {
+    /**
+     * The actual rule value. Can be a number (tax rate, threshold amount in minor units), boolean (rule applies/doesn't), string (enum value, fraction), or object (complex rule).
+     */
+    value: number | boolean | string | {
+        [key: string]: unknown;
+    };
+    /**
+     * ISO 8601 date when this value came/comes into effect
+     */
+    effectiveFrom: string;
+    /**
+     * ISO 8601 date when this value was/will be superseded. null = currently in effect.
+     */
+    effectiveUntil?: string | null;
+    status: 'enacted' | 'royal_assent' | 'bill_stage' | 'consultation' | 'announced';
+    /**
+     * The previous value of this rule, for computing deltas. null if this is the first known value.
+     */
+    predecessorValue?: number | boolean | string | {
+        [key: string]: unknown;
+    } | null;
+    legislativeReference?: string;
+    notes?: string;
+};
+/**
+ * UK England & Wales Extension
+ *
+ * IHT thresholds, intestacy rules, IFPA 1975 eligibility, and legislative changes for England & Wales estates. Temporal-rule wrapping on key values.
+ */
+export type UkEnglandWales = {
+    intestacyStatutoryLegacy?: TemporalRule2;
+    nilRateBand?: TemporalRule2;
+    residenceNilRateBand?: TemporalRule2;
+    transferableNilRateBand?: boolean;
+    transferableNilRateBandPercentage?: number;
+    inheritanceTaxRate?: TemporalRule2;
+    cohabitantRights?: {
+        applicable?: boolean;
+        statute?: string;
+        notes?: string;
+    };
+    ifpa1975Eligible?: Array<{
+        personId: string;
+        category: 'spouse' | 'former_spouse' | 'child' | 'child_of_family' | 'maintained_person' | 'cohabitant';
+        notes?: string;
+    }>;
+    legislativeChanges?: Array<{
+        description: string;
+        status: 'enacted' | 'royal_assent' | 'bill_stage' | 'consultation' | 'announced';
+        effectiveDate?: string;
+        notes?: string;
+    }>;
+    [key: string]: unknown | TemporalRule2 | boolean | number | {
+        applicable?: boolean;
+        statute?: string;
+        notes?: string;
+    } | Array<{
+        personId: string;
+        category: 'spouse' | 'former_spouse' | 'child' | 'child_of_family' | 'maintained_person' | 'cohabitant';
+        notes?: string;
+    }> | Array<{
+        description: string;
+        status: 'enacted' | 'royal_assent' | 'bill_stage' | 'consultation' | 'announced';
+        effectiveDate?: string;
+        notes?: string;
+    }> | undefined;
+};
+/**
+ * US Estate Extension
+ *
+ * US-specific estate planning: community/separate property regimes, elective share, homestead exemptions, per stirpes variants, no-contest clauses, pretermitted heir statutes, RUFADAA, and Louisiana forced heirship.
+ */
+export type UsEstate = {
+    state: string;
+    propertyRegime?: 'community_property' | 'community_property_with_survivorship' | 'separate_property' | 'quasi_community';
+    electiveShareDetails?: {
+        available?: boolean;
+        electedPercentage?: number;
+        augmentedEstateIncludes?: string;
+        statute?: string;
+        notes?: string;
+    };
+    homesteadExemptions?: Array<{
+        propertyId: string;
+        exemptionAmount?: Money2;
+        constitutional?: boolean;
+        notes?: string;
+    }>;
+    perStirpesVariant?: 'strict_per_stirpes' | 'modern_per_stirpes' | 'per_capita_at_each_generation';
+    noContestEnforceable?: boolean;
+    pretermittedHeirStatute?: string;
+    rufadaaAdopted?: boolean;
+    louisianaForcedHeirship?: {
+        applicable?: boolean;
+        eligibleChildren?: Array<{
+            personId?: string;
+            ageOrCondition?: string;
+        }>;
+        reservedPortion?: number;
+        basis?: 'fixed' | 'conditional';
+        notes?: string;
+    };
+    notes?: string;
+    [key: string]: unknown | string | 'community_property' | 'community_property_with_survivorship' | 'separate_property' | 'quasi_community' | {
+        available?: boolean;
+        electedPercentage?: number;
+        augmentedEstateIncludes?: string;
+        statute?: string;
+        notes?: string;
+    } | Array<{
+        propertyId: string;
+        exemptionAmount?: Money2;
+        constitutional?: boolean;
+        notes?: string;
+    }> | 'strict_per_stirpes' | 'modern_per_stirpes' | 'per_capita_at_each_generation' | boolean | string | {
+        applicable?: boolean;
+        eligibleChildren?: Array<{
+            personId?: string;
+            ageOrCondition?: string;
+        }>;
+        reservedPortion?: number;
+        basis?: 'fixed' | 'conditional';
+        notes?: string;
+    } | undefined;
+};
+export type QuebecPatrimony = {
+    applicable?: boolean;
+    patrimonyValue?: Money2;
+    equalisation?: string;
+    notes?: string;
+};
+export type OntarioEqualization = {
+    netFamilyProperty?: Money2;
+    equalizationPayment?: Money2;
+    canBeNegative?: boolean;
+    notes?: string;
+};
+export type BcwesaVariation = {
+    variationApplied?: boolean;
+    courtReference?: string;
+    notes?: string;
+};
+export type AlbertaDower = {
+    dowerRight: boolean;
+    spousePersonId?: string;
+    propertyId?: string;
+    consentGiven?: boolean;
+    notes?: string;
+};
+export type IndigenousLandDetails = {
+    propertyId: string;
+    reserveName?: string;
+    treatyNumber?: string;
+    landType: 'reserve' | 'treaty' | 'fee_simple_on_reserve' | 'certificate_of_possession';
+    successionRestrictions?: string;
+    notes?: string;
+};
+/**
+ * Canada Extension
+ *
+ * Provincial succession rules for Canada: Quebec patrimony, Ontario equalization, BC WESA variation, Alberta dower rights, and Indigenous land succession details.
+ */
+export type Canada = {
+    province: string;
+    quebecPatrimony?: QuebecPatrimony;
+    ontarioEqualization?: OntarioEqualization;
+    bcWesaVariation?: BcwesaVariation;
+    albertaDower?: AlbertaDower;
+    indigenousLandDetails?: Array<IndigenousLandDetails>;
+    notes?: string;
+    [key: string]: unknown | string | QuebecPatrimony | OntarioEqualization | BcwesaVariation | AlbertaDower | Array<IndigenousLandDetails> | string | undefined;
+};
+export type SuperannuationNomination = {
+    assetId: string;
+    fundType?: 'smsf' | 'industry' | 'retail' | 'public_sector' | 'corporate';
+    nominationType: 'bdbn_lapsing' | 'bdbn_non_lapsing' | 'non_binding' | 'reversionary_pension';
+    binding?: boolean;
+    expiryDate?: string;
+    expiryRule?: string;
+    trusteeDiscretion?: boolean;
+    nominatedPersonIds?: Array<string>;
+    taxableComponent?: Money2;
+    taxFreeComponent?: Money2;
+    notes?: string;
+};
+export type FamilyProvisionClaim = {
+    claimantPersonId: string;
+    relationship?: string;
+    statute?: string;
+    eligibleUnderStatute?: boolean;
+    limitationPeriod?: string;
+    notionalEstateEngaged?: boolean;
+    claimFiled?: boolean;
+    filedDate?: string;
+    outcome?: 'pending' | 'upheld' | 'dismissed' | 'settled';
+    notes?: string;
+};
+export type AboriginalLandDetails = {
+    propertyId: string;
+    landType: 'native_title' | 'alra' | 'aboriginal_freehold' | 'ilua' | 'torres_strait';
+    nativeTitleDetermination?: string;
+    landCouncil?: string;
+    successionRestrictions?: string;
+    notes?: string;
+};
+export type NzPropertyRelationshipsAct = {
+    applicable?: boolean;
+    relationshipProperty?: Money2;
+    separateProperty?: Money2;
+    optingOutAgreement?: boolean;
+    notes?: string;
+};
+export type TestamentaryPromise = {
+    claimantPersonId: string;
+    promiseDescription?: string;
+    statute?: string;
+    status?: string;
+    notes?: string;
+};
+export type MaoriLandDetails = {
+    propertyId: string;
+    landBlockIdentifier?: string;
+    maoriLandCourtReference?: string;
+    successionUnderTeTureWhenua?: boolean;
+};
+/**
+ * Australia & New Zealand Extension
+ *
+ * Succession rules for AU and NZ: superannuation binding death benefit nominations, family provision claims, Aboriginal/Torres Strait Islander land, NZ Property (Relationships) Act, testamentary promises, and Maori land under Te Ture Whenua.
+ */
+export type AustraliaNz = {
+    jurisdiction: 'AU-NSW' | 'AU-VIC' | 'AU-QLD' | 'AU-WA' | 'AU-SA' | 'AU-TAS' | 'AU-ACT' | 'AU-NT' | 'NZ';
+    superannuationNominations?: Array<SuperannuationNomination>;
+    familyProvisionClaims?: Array<FamilyProvisionClaim>;
+    aboriginalLandDetails?: Array<AboriginalLandDetails>;
+    nzPRA?: NzPropertyRelationshipsAct;
+    testamentaryPromises?: Array<TestamentaryPromise>;
+    maoriLandDetails?: Array<MaoriLandDetails>;
+    notes?: string;
+    [key: string]: unknown | 'AU-NSW' | 'AU-VIC' | 'AU-QLD' | 'AU-WA' | 'AU-SA' | 'AU-TAS' | 'AU-ACT' | 'AU-NT' | 'NZ' | Array<SuperannuationNomination> | Array<FamilyProvisionClaim> | Array<AboriginalLandDetails> | NzPropertyRelationshipsAct | Array<TestamentaryPromise> | Array<MaoriLandDetails> | string | undefined;
+};
+export type BrusselsIvChoiceOfLaw = {
+    habitualResidence?: Jurisdiction2;
+    nationalityElection?: boolean;
+    electedNationality?: Jurisdiction2;
+    electionDate?: string;
+};
+export type EuropeanCertificateOfSuccession = {
+    issued?: boolean;
+    certificateReference?: string;
+    issuingAuthority?: string;
+    issueDate?: string;
+};
+export type SpanishRegionalRegime = {
+    region: 'common_civil' | 'catalan' | 'basque' | 'navarre' | 'aragon' | 'balearic' | 'galician';
+    forcedHeirshipRules?: string;
+    notes?: string;
+};
+export type ForcedHeirshipVariant = {
+    model: 'french_reserve' | 'german_pflichtteil' | 'scandinavian_laglott' | 'dutch_deferred' | 'polish_zachowek' | 'swiss_pflichtteil' | 'italian_legittima';
+    claimNature?: string;
+    reservedFraction?: string;
+    calculationNotes?: string;
+    effectiveDate?: string;
+    reformVersion?: string;
+    temporalRule?: TemporalRule2;
+};
+export type PostBrexitAssetHandling = {
+    ukAssetsSubjectToEURule?: boolean;
+    ukAssetsHandledUnder?: string;
+    notes?: string;
+};
+/**
+ * EU Succession Extension
+ *
+ * European succession rules: Brussels IV choice of law and European Certificate of Succession, Spanish regional regimes, forced heirship variants across civil law traditions, and post-Brexit UK asset handling.
+ */
+export type EuSuccession = {
+    memberState: string;
+    brusselsIV?: BrusselsIvChoiceOfLaw;
+    europeanCertificate?: EuropeanCertificateOfSuccession;
+    spanishRegionalRegime?: SpanishRegionalRegime;
+    forcedHeirshipVariant?: ForcedHeirshipVariant;
+    postBrexitHandling?: PostBrexitAssetHandling;
+    legislativeChanges?: Array<{
+        description: string;
+        status: 'enacted' | 'royal_assent' | 'bill_stage' | 'consultation' | 'announced';
+        effectiveDate?: string;
+        notes?: string;
+    }>;
+    notes?: string;
+    [key: string]: unknown | string | BrusselsIvChoiceOfLaw | EuropeanCertificateOfSuccession | SpanishRegionalRegime | ForcedHeirshipVariant | PostBrexitAssetHandling | Array<{
+        description: string;
+        status: 'enacted' | 'royal_assent' | 'bill_stage' | 'consultation' | 'announced';
+        effectiveDate?: string;
+        notes?: string;
+    }> | string | undefined;
+};
+export type KosekiRecord = {
+    personId: string;
+    honseki?: string;
+    kosekiHead?: string;
+    kosekiReference?: string;
+    registrationType?: string;
+};
+export type IryubunClaim = {
+    personId: string;
+    relationship?: string;
+    reservedFraction?: string;
+    targetAssetIds?: Array<string>;
+    targetPropertyIds?: Array<string>;
+    claimFiled?: boolean;
+    claimOutcome?: 'pending' | 'upheld' | 'dismissed' | 'settled' | 'waived';
+};
+export type YoshiAdoption = {
+    personId: string;
+    adoptionType: 'futsu_yoshi' | 'tokubetsu_yoshi';
+    adoptionDate?: string;
+    inheritanceScope?: 'both_families' | 'adoptive_only' | 'biological_only';
+};
+export type SpousesResidenceRight = {
+    propertyId: string;
+    spousePersonId: string;
+    rightType: 'short_term' | 'long_term';
+    duration?: string;
+    actuarialValue?: Money2;
+    registeredAtLegalAffairsBureau?: boolean;
+};
+/**
+ * Japan Extension
+ *
+ * Japanese succession law — koseki records, iryubun (reserved share) claims, yōshi (adoption), spousal residence right (2019 reform), isan bunkatsu (estate division), saishi succession, local will formalities.
+ */
+export type Japan = {
+    kosekiRecords?: Array<KosekiRecord>;
+    iryubunClaims?: Array<IryubunClaim>;
+    yoshiAdoptions?: Array<YoshiAdoption>;
+    spousesResidenceRight?: SpousesResidenceRight;
+    saishiSuccessor?: string;
+    localWillFormality?: 'jihi_shosho' | 'kosei_shosho' | 'himitsusho';
+    inkanVerified?: boolean;
+    isanBunkatsu?: {
+        type?: 'voluntary' | 'court_mediated' | 'court_adjudicated';
+        agreed?: boolean;
+        agreementDate?: string;
+        allHeirsConsented?: boolean;
+        participants?: Array<string>;
+        registeredAt?: string;
+        registrationDate?: string;
+        courtReference?: string;
+        documentRef?: string;
+    };
+    legislativeChanges?: Array<{
+        description: string;
+        status: 'enacted' | 'royal_assent' | 'bill_stage' | 'consultation' | 'announced';
+        effectiveDate?: string;
+        notes?: string;
+    }>;
+    notes?: string;
+    [key: string]: unknown | Array<KosekiRecord> | Array<IryubunClaim> | Array<YoshiAdoption> | SpousesResidenceRight | string | 'jihi_shosho' | 'kosei_shosho' | 'himitsusho' | boolean | {
+        type?: 'voluntary' | 'court_mediated' | 'court_adjudicated';
+        agreed?: boolean;
+        agreementDate?: string;
+        allHeirsConsented?: boolean;
+        participants?: Array<string>;
+        registeredAt?: string;
+        registrationDate?: string;
+        courtReference?: string;
+        documentRef?: string;
+    } | Array<{
+        description: string;
+        status: 'enacted' | 'royal_assent' | 'bill_stage' | 'consultation' | 'announced';
+        effectiveDate?: string;
+        notes?: string;
+    }> | string | undefined;
+};
+export type PrcForcedHeirship = {
+    firstOrderHeirs?: Array<{
+        personId: string;
+        relationship?: string;
+    }>;
+    secondOrderHeirs?: Array<{
+        personId: string;
+        relationship?: string;
+    }>;
+    mandatoryShareRule?: string;
+};
+export type HukouReference = {
+    personId: string;
+    hukouLocation?: string;
+    hukouType?: 'agricultural' | 'non_agricultural';
+};
+export type CrossBorderHkprc = {
+    hkAssets?: string;
+    prcAssets?: string;
+    applicableTreaty?: string;
+    notes?: string;
+};
+/**
+ * PRC China Extension
+ *
+ * People's Republic of China succession law — forced heirship (first/second order heirs), hukou registration, notarised succession certificates, cross-border HK/PRC asset handling.
+ */
+export type PrcChina = {
+    applicableLaw: 'prc_succession_law_1985' | 'prc_civil_code_2021';
+    forcedHeirship?: PrcForcedHeirship;
+    hukouReferences?: Array<HukouReference>;
+    notarisationRequired?: boolean;
+    notarisationDetails?: string;
+    crossBorderHandling?: CrossBorderHkprc;
+    notes?: string;
+    [key: string]: unknown | 'prc_succession_law_1985' | 'prc_civil_code_2021' | PrcForcedHeirship | Array<HukouReference> | boolean | string | CrossBorderHkprc | undefined;
+};
+export type SingaporeIsaDistribution = {
+    applicable?: boolean;
+    shareSchedule?: Array<{
+        relationship?: string;
+        share?: string;
+        notes?: string;
+    }>;
+    notes?: string;
+};
+export type SingaporeAmlaDistribution = {
+    applicable?: boolean;
+    school?: 'shafii' | 'hanafi';
+    faraidRef?: string;
+    notes?: string;
+};
+export type CpfNomination = {
+    accountId: string;
+    nominatedPersonIds?: Array<string>;
+    binding?: boolean;
+    nominationDate?: string;
+    notes?: string;
+};
+export type MalaysianDistributionAct = {
+    applicable?: boolean;
+    shareSchedule?: Array<{
+        relationship?: string;
+        share?: string;
+        notes?: string;
+    }>;
+    notes?: string;
+};
+export type MalaysianShariah = {
+    applicable?: boolean;
+    shariaCourtReference?: string;
+    notes?: string;
+};
+export type EpfNomination = {
+    accountId: string;
+    nominatedPersonIds?: Array<string>;
+    binding?: boolean;
+    nominationDate?: string;
+    notes?: string;
+};
+/**
+ * Singapore / Malaysia Extension
+ *
+ * Singapore and Malaysia succession law — ISA intestate distribution, AMLA Islamic distribution, CPF/EPF nominations, Malaysian Distribution Act, Shariah court jurisdiction.
+ */
+export type SingaporeMalaysia = {
+    country: 'SG' | 'MY';
+    singaporeISA?: SingaporeIsaDistribution;
+    singaporeAMLA?: SingaporeAmlaDistribution;
+    cpfNominations?: Array<CpfNomination>;
+    malaysianDistributionAct?: MalaysianDistributionAct;
+    malaysianShariah?: MalaysianShariah;
+    epfNominations?: Array<EpfNomination>;
+    notes?: string;
+    [key: string]: unknown | 'SG' | 'MY' | SingaporeIsaDistribution | SingaporeAmlaDistribution | Array<CpfNomination> | MalaysianDistributionAct | MalaysianShariah | Array<EpfNomination> | string | undefined;
+};
+export type BrazilianSuccession = {
+    legitimaFraction?: string;
+    necessaryHeirs?: Array<{
+        personId: string;
+        category: 'descendant' | 'ascendant' | 'spouse';
+    }>;
+    meacaoHerancaSplit?: boolean;
+    stableUnionRights?: boolean;
+    notes?: string;
+};
+export type ArgentineSuccession = {
+    legitimaDescendants?: string;
+    legitimaAscendants?: string;
+    porcionDisponible?: string;
+    collation?: boolean;
+    notes?: string;
+};
+export type ColombianSuccession = {
+    system?: 'fourths';
+    legitimaRigurosa?: string;
+    cuartaDeMejoras?: string;
+    cuartaDeLibreDisposicion?: string;
+    forcedHeirs?: Array<{
+        personId: string;
+        relationship?: string;
+    }>;
+    notes?: string;
+};
+export type VenezuelanSuccession = {
+    legitimaFraction?: string;
+    applicableLaw?: string;
+    notes?: string;
+};
+/**
+ * Latin America Extension
+ *
+ * Latin American succession law — Brazilian legítima and stable union rights, Argentine forced heirship with collation, Colombian fourths system, Venezuelan succession, and other civil-law jurisdictions.
+ */
+export type LatinAmerica = {
+    country: 'BR' | 'AR' | 'CO' | 'VE' | 'MX' | 'CL' | 'PE';
+    brazilianSuccession?: BrazilianSuccession;
+    argentineSuccession?: ArgentineSuccession;
+    colombianSuccession?: ColombianSuccession;
+    venezuelanSuccession?: VenezuelanSuccession;
+    notes?: string;
+    [key: string]: unknown | 'BR' | 'AR' | 'CO' | 'VE' | 'MX' | 'CL' | 'PE' | BrazilianSuccession | ArgentineSuccession | ColombianSuccession | VenezuelanSuccession | string | undefined;
+};
+export type HeirClassification = {
+    personId: string;
+    heirClass: 'son' | 'daughter' | 'father' | 'mother' | 'grandfather' | 'grandmother' | 'brother_full' | 'brother_paternal' | 'brother_maternal' | 'sister_full' | 'sister_paternal' | 'sister_maternal' | 'husband' | 'wife' | 'son_of_son' | 'daughter_of_son' | 'uncle_paternal';
+    fixedShareFraction?: string;
+    residuaryClass?: 'asaba_by_self' | 'asaba_with_other' | 'asaba_through_other' | 'none';
+    blocked?: boolean;
+    blockedBy?: string;
+    notes?: string;
+};
+export type WasiyyaRules = {
+    maxPortion?: number;
+    toNonHeirsOnly?: boolean;
+    requiresHeirConsent?: boolean;
+    notes?: string;
+};
+export type IddahPeriod = {
+    personId: string;
+    periodType: 'divorce' | 'death' | 'pregnancy';
+    startDate: string;
+    endDate?: string | null;
+    notes?: string;
+};
+export type WaqfDetail = {
+    waqfId: string;
+    waqfType: 'ahli' | 'khairi' | 'mushtarak';
+    dedicationDate?: string;
+    notes?: string;
+};
+export type PriorityDebt = {
+    description: string;
+    type: 'mahr' | 'kafan' | 'funeral_costs' | 'tax' | 'debts_of_deceased';
+    amount: Money2;
+    creditorPersonId?: string;
+    notes?: string;
+};
+/**
+ * Islamic Succession Extension
+ *
+ * Faraid (Islamic inheritance) rules: heir classification, fixed shares, residuary (asaba), awl/radd adjustments, wasiyya limits, iddah periods, waqf details, and priority debts including mahr.
+ */
+export type Islamic = {
+    school: 'hanafi' | 'shafii' | 'maliki' | 'hanbali' | 'jafari' | 'ibadi' | 'zahiri';
+    faraidApplies?: boolean;
+    heirClassifications?: Array<HeirClassification>;
+    awlApplied?: boolean;
+    raddApplied?: boolean;
+    wasiyyaRules?: WasiyyaRules;
+    iddahPeriods?: Array<IddahPeriod>;
+    waqfDetails?: Array<WaqfDetail>;
+    priorityDebts?: Array<PriorityDebt>;
+    hijriDates?: {
+        deathDateHijri?: string;
+        willDateHijri?: string;
+    };
+    islamicFormalities?: {
+        shariaCourtReference?: string;
+        muftiFatwReference?: string;
+        certifiedByScholar?: boolean;
+        scholarName?: string;
+        notes?: string;
+    };
+    notes?: string;
+    [key: string]: unknown | 'hanafi' | 'shafii' | 'maliki' | 'hanbali' | 'jafari' | 'ibadi' | 'zahiri' | boolean | Array<HeirClassification> | WasiyyaRules | Array<IddahPeriod> | Array<WaqfDetail> | Array<PriorityDebt> | {
+        deathDateHijri?: string;
+        willDateHijri?: string;
+    } | {
+        shariaCourtReference?: string;
+        muftiFatwReference?: string;
+        certifiedByScholar?: boolean;
+        scholarName?: string;
+        notes?: string;
+    } | string | undefined;
+};
+export type HalachicHeir = {
+    personId: string;
+    relationship: string;
+    heirOrder?: 'bechor' | 'regular';
+    halachicClass: 'ben' | 'bat' | 'av' | 'em' | 'ach' | 'achot' | 'ben_ben' | 'other';
+};
+export type MezonotDetails = {
+    eligible: boolean;
+    amount?: Money2;
+    duration?: string;
+    notes?: string;
+};
+export type BekhorRules = {
+    applies: boolean;
+    bekhorPersonId?: string;
+    doubleShareApplicable?: boolean;
+    notes?: string;
+};
+export type HebrewName = {
+    personId: string;
+    hebrewGivenName: string;
+    hebrewFamilyName?: string;
+    benOrBat: 'ben' | 'bat';
+};
+export type HalachicWitnessValidity = {
+    personId: string;
+    halachicallyValid: boolean;
+    disqualificationReason?: string;
+    notes?: string;
+};
+export type KinyanDetails = {
+    type: 'kinyan_sudar' | 'kinyan_agav' | 'kinyan_meshichah' | 'kinyan_hagbahah';
+    performed: boolean;
+    witnessPersonIds?: Array<string>;
+    notes?: string;
+};
+export type BequestClassification = {
+    type: 'matanah' | 'yerusha' | 'shtar_chov_gift';
+    bequestId: string;
+    notes?: string;
+};
+/**
+ * Jewish Law Extension
+ *
+ * Halachic inheritance rules including heir classification, bekhor (firstborn) double-share, mezonot (maintenance), kinyan (acquisition), and bequest classification under Jewish law.
+ */
+export type Jewish = {
+    denomination: 'orthodox' | 'conservative' | 'reform' | 'reconstructionist' | 'traditional' | 'unaffiliated';
+    halachicHeirs?: Array<HalachicHeir>;
+    mezonotDetails?: MezonotDetails;
+    halachicMechanism?: 'shtar_chov' | 'matnat_bari' | 'matnat_shechiv_mera' | 'matnat_bari_conditional';
+    bekhorRules?: BekhorRules;
+    hebrewNames?: Array<HebrewName>;
+    halachicWitnessValidity?: Array<HalachicWitnessValidity>;
+    kinyanDetails?: KinyanDetails;
+    bequestClassifications?: Array<BequestClassification>;
+    notes?: string;
+    [key: string]: unknown | 'orthodox' | 'conservative' | 'reform' | 'reconstructionist' | 'traditional' | 'unaffiliated' | Array<HalachicHeir> | MezonotDetails | 'shtar_chov' | 'matnat_bari' | 'matnat_shechiv_mera' | 'matnat_bari_conditional' | BekhorRules | Array<HebrewName> | Array<HalachicWitnessValidity> | KinyanDetails | Array<BequestClassification> | string | undefined;
+};
+export type Coparcener = {
+    personId: string;
+    relationship: string;
+    coparcenaryShareFraction?: string;
+};
+export type HufDetails = {
+    kartaPersonId: string;
+    coparceners: Array<Coparcener>;
+    panNumber?: string;
+};
+export type IndianHeirClassification = {
+    personId: string;
+    heirClass: 'class_I' | 'class_II' | 'agnate' | 'cognate';
+    scheduleParagraph?: string;
+    disputed?: boolean;
+    disputeDetails?: string;
+};
+export type StridhanAsset = {
+    assetId: string;
+    description: string;
+    notes?: string;
+};
+/**
+ * India Hindu Succession Extension
+ *
+ * Hindu succession law specifics: Mitakshara/Dayabhaga schools, HUF coparcenary, heir classifications under the Hindu Succession Act 1956, stridhan assets, agricultural land ceiling rules, and NRI complications.
+ */
+export type IndiaHindu = {
+    applicableLaw: 'hindu_succession_act_1956' | 'indian_succession_act_1925' | 'muslim_personal_law' | 'special_marriage_act' | 'parsi_succession' | 'goa_civil_code';
+    school?: 'mitakshara' | 'dayabhaga';
+    hufDetails?: HufDetails;
+    heirClassifications?: Array<IndianHeirClassification>;
+    stridhanAssets?: Array<StridhanAsset>;
+    agriculturalLand?: Array<{
+        propertyId: string;
+        state: string;
+        stateSuccessionLaw?: string;
+        ceilingApplies?: boolean;
+    }>;
+    nriComplications?: {
+        applicable?: boolean;
+        foreignJurisdiction?: Jurisdiction2;
+        taxImplications?: string;
+        notes?: string;
+    };
+    notes?: string;
+    [key: string]: unknown | 'hindu_succession_act_1956' | 'indian_succession_act_1925' | 'muslim_personal_law' | 'special_marriage_act' | 'parsi_succession' | 'goa_civil_code' | 'mitakshara' | 'dayabhaga' | HufDetails | Array<IndianHeirClassification> | Array<StridhanAsset> | Array<{
+        propertyId: string;
+        state: string;
+        stateSuccessionLaw?: string;
+        ceilingApplies?: boolean;
+    }> | {
+        applicable?: boolean;
+        foreignJurisdiction?: Jurisdiction2;
+        taxImplications?: string;
+        notes?: string;
+    } | string | undefined;
+};
+export type CustomarySuccessionRule = {
+    ethnicGroup: string;
+    successionSystem: 'patrilineal_primogeniture' | 'patrilineal_equal' | 'matrilineal' | 'bilateral' | 'ultimogeniture';
+    widowInheritanceRight?: 'full_inheritance' | 'usufruct_only' | 'levirate_marriage' | 'none' | 'statutory_override';
+    daughterInheritanceRight?: string;
+    constitutionalOverride?: boolean;
+    caseReference?: string;
+};
+export type FamilyCouncilDecision = {
+    decisionDate?: string;
+    decisionType: string;
+    decidedBy?: string;
+    participants?: Array<string>;
+    chairPersonId?: string;
+    outcome?: string;
+    constitutionalChallengeOutcome?: 'not_challenged' | 'upheld' | 'struck_down' | 'pending';
+    challengeable?: boolean;
+};
+export type CommunalPropertyDetail = {
+    propertyId: string;
+    communityName?: string;
+    tenureType?: string;
+    notes?: string;
+};
+export type WidowRights = {
+    personId: string;
+    customaryRight?: string;
+    statutoryRight?: string;
+    widowRitesRequired?: boolean;
+    widowRitesCompleted?: boolean;
+    ritesDescription?: string;
+    ritesCompletionDate?: string;
+    notes?: string;
+};
+/**
+ * Africa Customary Succession Extension
+ *
+ * Customary succession rules across African ethnic groups: patrilineal/matrilineal systems, family council decisions, communal property, widow rights, lobola, land tenure, and constitutional challenges.
+ */
+export type AfricaCustomary = {
+    ethnicGroup: string;
+    customaryRules?: Array<CustomarySuccessionRule>;
+    familyCouncilDecisions?: Array<FamilyCouncilDecision>;
+    communalPropertyDetails?: Array<CommunalPropertyDetail>;
+    widowRights?: Array<WidowRights>;
+    lobolaDetails?: {
+        totalAgreed?: Money2;
+        paidToDate?: Money2;
+        includesLivestock?: boolean;
+        livestockDetails?: string;
+        notes?: string;
+    };
+    landTenureDetails?: Array<{
+        propertyId: string;
+        tenureType?: string;
+        communityAuthority?: string;
+        notes?: string;
+    }>;
+    constitutionalChallenges?: Array<{
+        description: string;
+        caseReference?: string;
+        outcome?: 'not_challenged' | 'upheld' | 'struck_down' | 'pending';
+        notes?: string;
+    }>;
+    notes?: string;
+    [key: string]: unknown | string | Array<CustomarySuccessionRule> | Array<FamilyCouncilDecision> | Array<CommunalPropertyDetail> | Array<WidowRights> | {
+        totalAgreed?: Money2;
+        paidToDate?: Money2;
+        includesLivestock?: boolean;
+        livestockDetails?: string;
+        notes?: string;
+    } | Array<{
+        propertyId: string;
+        tenureType?: string;
+        communityAuthority?: string;
+        notes?: string;
+    }> | Array<{
+        description: string;
+        caseReference?: string;
+        outcome?: 'not_challenged' | 'upheld' | 'struck_down' | 'pending';
+        notes?: string;
+    }> | undefined;
+};
+export type ValidateDocumentData = {
+    body: Schema;
+    path?: never;
+    query?: never;
+    url: '/validate';
+};
+export type ValidateDocumentErrors = {
+    /**
+     * Invalid JSON payload
+     */
+    400: {
+        error?: string;
+    };
+};
+export type ValidateDocumentError = ValidateDocumentErrors[keyof ValidateDocumentErrors];
+export type ValidateDocumentResponses = {
+    /**
+     * Validation result
+     */
+    200: ValidationResult;
+};
+export type ValidateDocumentResponse = ValidateDocumentResponses[keyof ValidateDocumentResponses];
+//# sourceMappingURL=types.gen.d.ts.map