import type { Bilingual } from '../types.js'
import type { ArcStep, Upachara } from './types.js'

// The disclaimer every puja in this module carries. The seven pujas are
// documented as one widely-kept *home* form, not any single sampradaya's
// authoritative rite — see each module's SOURCES.md.
export const PUJA_DISCLAIMER: Bilingual = {
  en: 'This is one widely-kept home form of the puja. Regional, sampradaya, and family traditions vary in the samagri, the order of the steps, and where the emphasis falls. For any major ceremony, follow the guidance of a qualified pandit — this content does not replace a priest.',
  hi: 'यह पूजा का एक प्रचलित गृह-रूप है। सामग्री, चरणों का क्रम एवं किस अंग पर बल दिया जाए — यह क्षेत्र, सम्प्रदाय एवं परिवार की परम्परा के अनुसार भिन्न होता है। किसी भी बड़े अनुष्ठान के लिए योग्य पंडित जी के मार्गदर्शन का अनुसरण करें — यह सामग्री पुरोहित का स्थान नहीं लेती।',
}

// The 16-upachara Shodashopachara template — the classical sixteen offerings
// of a home puja, in order, with a plain-language instruction per step.
//
// Each puja parameterises this template: it spreads `STANDARD_UPACHARAS` and
// overrides only the steps where its tradition diverges (the substances at
// `snana`, the deity-specific mantra recited at `pushpa-archana`, the bhog at
// `naivedya`, and so on). The template carries instruction `line`s only — a
// puja attaches its own `mantra` to a step when it overrides it.
//
// The sixteen names and their order are stable across the major puja-vidhi
// sources (see SOURCES.md); `dhyana-avahana` folds meditation and invocation
// into the opening step and `neerajanam-aarti` folds the camphor offering
// into the closing aarti, which is the common household enumeration that
// keeps the count at sixteen.
export const STANDARD_UPACHARAS: readonly Upachara[] = [
  {
    slug: 'dhyana-avahana',
    name: { sanskrit: 'ध्यान · आवाहन', en: 'Meditation & Invocation', hi: 'ध्यान एवं आवाहन' },
    line: {
      en: 'Sit before the image and meditate on the form of the deity (dhyāna). Then, with the palms joined and the thumbs folded inward in the āvāhana mudrā, invoke their living presence into the image (āvāhana).',
      hi: 'मूर्ति अथवा चित्र के सम्मुख बैठकर देवता के स्वरूप का ध्यान करें (ध्यान)। फिर दोनों हथेलियाँ जोड़कर, अंगूठों को भीतर की ओर मोड़कर — आवाहन मुद्रा में — उनकी सजीव उपस्थिति का मूर्ति में आवाहन करें।',
    },
  },
  {
    slug: 'asana',
    name: { sanskrit: 'आसन', en: 'Seat', hi: 'आसन' },
    line: {
      en: 'Offer a seat — symbolically, a few akshat (unbroken rice grains) or flowers placed before the image, requesting the deity to be seated.',
      hi: 'आसन अर्पित करें — प्रतीक रूप में कुछ अक्षत (अखंडित चावल) अथवा पुष्प मूर्ति के सम्मुख रखकर देवता से विराजने का अनुरोध करें।',
    },
  },
  {
    slug: 'padya',
    name: { sanskrit: 'पाद्य', en: 'Water for the feet', hi: 'पाद्य' },
    line: {
      en: 'Offer pādya — a few drops of clean water at the feet of the image, as water to wash the feet of an honoured guest.',
      hi: 'पाद्य अर्पित करें — मूर्ति के चरणों में स्वच्छ जल की कुछ बूँदें, मानो किसी आदरणीय अतिथि के चरण-प्रक्षालन हेतु।',
    },
  },
  {
    slug: 'arghya',
    name: { sanskrit: 'अर्घ्य', en: 'Arghya', hi: 'अर्घ्य' },
    line: {
      en: 'Offer arghya — water mixed with akshat and a flower, poured from a small vessel or conch as a respectful offering for the hands.',
      hi: 'अर्घ्य अर्पित करें — अक्षत एवं पुष्प मिला हुआ जल, छोटे पात्र अथवा शंख से अर्पित — हाथों के लिए सम्मान-सूचक अर्पण।',
    },
  },
  {
    slug: 'achamana',
    name: { sanskrit: 'आचमन', en: 'Water to sip', hi: 'आचमन' },
    line: {
      en: 'Offer ācamanīya — a small spoonful of clean water, as water for the deity to sip.',
      hi: 'आचमनीय अर्पित करें — स्वच्छ जल की एक छोटी चम्मच, देवता के आचमन (मुख-शुद्धि) हेतु।',
    },
  },
  {
    slug: 'madhuparka',
    name: { sanskrit: 'मधुपर्क', en: 'Honey-curd-ghee', hi: 'मधुपर्क' },
    line: {
      en: 'Offer madhuparka — a small portion of honey, curd, and ghee mixed together, the traditional sweet welcome for a revered guest.',
      hi: 'मधुपर्क अर्पित करें — शहद, दही एवं घी का मिश्रण — पूज्य अतिथि के लिए परम्परागत मधुर स्वागत।',
    },
  },
  {
    slug: 'snana',
    name: { sanskrit: 'स्नान', en: 'Bathing', hi: 'स्नान' },
    line: {
      en: 'Bathe the image with clean water. For an extended puja, first bathe it with panchāmṛta (milk, curd, ghee, honey, sugar) and then again with clean water.',
      hi: 'मूर्ति को स्वच्छ जल से स्नान कराएँ। विस्तृत पूजा में पहले पंचामृत (दूध, दही, घी, शहद, शक्कर) से, फिर पुनः स्वच्छ जल से स्नान कराएँ।',
    },
  },
  {
    slug: 'vastra',
    name: { sanskrit: 'वस्त्र', en: 'Vesture', hi: 'वस्त्र' },
    line: {
      en: 'Offer fresh cloth — a small clean piece of cotton or cloth placed at the base of the image.',
      hi: 'नवीन वस्त्र अर्पित करें — स्वच्छ सूती वस्त्र का एक छोटा खंड मूर्ति के चरणों में रखें।',
    },
  },
  {
    slug: 'yajnopavita',
    name: { sanskrit: 'यज्ञोपवीत', en: 'Sacred thread', hi: 'यज्ञोपवीत' },
    line: {
      en: 'Offer a fresh sacred thread (yajñopavīta), placed across the shoulder of the image — customarily offered to male deities.',
      hi: 'नवीन यज्ञोपवीत अर्पित करें — मूर्ति के कंधे पर रखें; सामान्यतः पुरुष देवताओं को अर्पित किया जाता है।',
    },
  },
  {
    slug: 'gandha',
    name: { sanskrit: 'गन्ध', en: 'Sandalwood paste', hi: 'गन्ध' },
    line: {
      en: 'Apply gandha — fragrant sandalwood paste — as a small mark on the forehead of the image, with the ring finger.',
      hi: 'गन्ध अर्पित करें — सुगंधित चन्दन का तिलक अनामिका अंगुली से मूर्ति के मस्तक पर लगाएँ।',
    },
  },
  {
    slug: 'pushpa-archana',
    name: { sanskrit: 'पुष्प · अर्चना', en: 'Flowers & Name-archana', hi: 'पुष्प एवं अर्चना' },
    line: {
      en: 'Offer flowers, one at a time, while reciting the names of the deity — the Aṣṭottara-śatanāmāvalī (108 names) or, for extended worship, the Sahasranāma (1008 names).',
      hi: 'एक-एक करके पुष्प अर्पित करें तथा साथ ही देवता के नामों का पाठ करें — अष्टोत्तर-शतनामावली (108 नाम) अथवा विस्तृत पूजा में सहस्रनाम (1008 नाम)।',
    },
  },
  {
    slug: 'dhupa',
    name: { sanskrit: 'धूप', en: 'Incense', hi: 'धूप' },
    line: {
      en: 'Light incense (dhūpa or an agarbatti) and offer it, circling it gently before the image.',
      hi: 'धूप अथवा अगरबत्ती जलाकर मूर्ति के सम्मुख कोमलता से घुमाते हुए अर्पित करें।',
    },
  },
  {
    slug: 'deepa',
    name: { sanskrit: 'दीप', en: 'Lamp', hi: 'दीप' },
    line: {
      en: 'Light a ghee or oil lamp and offer it before the image, then set it to the right.',
      hi: 'घी अथवा तेल का दीपक प्रज्वलित कर मूर्ति के सम्मुख अर्पित करें, फिर उसे दाहिनी ओर रख दें।',
    },
  },
  {
    slug: 'naivedya',
    name: { sanskrit: 'नैवेद्य', en: 'Food offering', hi: 'नैवेद्य' },
    line: {
      en: 'Offer bhog — fruit and a sweet on a clean dish. Sprinkle a little water around the plate and offer it with folded hands.',
      hi: 'नैवेद्य अर्पित करें — स्वच्छ थाली में फल एवं मिष्ठान्न। थाली के चारों ओर थोड़ा जल छिड़ककर हाथ जोड़कर अर्पित करें।',
    },
  },
  {
    slug: 'tambula',
    name: { sanskrit: 'ताम्बूल', en: 'Betel & areca', hi: 'ताम्बूल' },
    line: {
      en: 'Offer tāmbūla — betel leaves with a piece of areca nut, a clove, and a cardamom.',
      hi: 'ताम्बूल अर्पित करें — पान के पत्ते, सुपारी का एक टुकड़ा, एक लौंग एवं एक इलायची।',
    },
  },
  {
    slug: 'neerajanam-aarti',
    name: { sanskrit: 'नीराजन · आरती', en: 'Camphor Aarti', hi: 'नीराजन एवं आरती' },
    line: {
      en: 'Conclude the worship with the aarti — light camphor, circle it clockwise before the image, and sing the deity\'s aarti. The puja proper ends here; what follows is the closing.',
      hi: 'पूजा का समापन आरती से करें — कपूर जलाकर मूर्ति के सम्मुख दक्षिणावर्त घुमाएँ एवं देवता की आरती गाएँ। मुख्य पूजा यहीं संपन्न होती है; आगे समापन-क्रम है।',
    },
  },
]

// The standard pre-arc — purification and Sankalpa — performed before every
// named puja in this module. A puja appends its own pre-steps (Kalash
// Sthapana, Ganesh Smarana, Prana Pratishtha) after these.
export const STANDARD_PRE_ARC: readonly ArcStep[] = [
  {
    slug: 'purification',
    name: { sanskrit: 'शुद्धि', en: 'Purification', hi: 'शुद्धि' },
    line: {
      en: 'Bathe and wear clean clothes. Sit on an āsana facing east or north, with the puja space wiped clean. Sprinkle a little water over the samagri and over yourself, do ācamana (sip water three times), and steady the breath before beginning.',
      hi: 'स्नान कर स्वच्छ वस्त्र धारण करें। पूजा-स्थल को स्वच्छ कर, आसन पर पूर्व अथवा उत्तर दिशा की ओर मुख करके बैठें। सामग्री पर एवं स्वयं पर थोड़ा जल छिड़कें, आचमन करें (तीन बार जल का आचमन) एवं आरंभ से पूर्व श्वास को स्थिर करें।',
    },
  },
  {
    slug: 'sankalpa',
    name: { sanskrit: 'संकल्प', en: 'Sankalpa', hi: 'संकल्प' },
    line: {
      en: 'Take a little akshat and water in the right palm and silently make the Sankalpa — the dedication of the puja: your gotra and name, the place, today\'s tithi and nakshatra, and the intention for which the puja is performed. Release the water at the close of the dedication.',
      hi: 'दाहिनी हथेली में थोड़ा अक्षत एवं जल लेकर मन-ही-मन संकल्प करें — पूजा का समर्पण: अपना गोत्र एवं नाम, स्थान, आज की तिथि एवं नक्षत्र, तथा जिस अभिप्राय से पूजा की जा रही है वह कामना। संकल्प के अंत में जल छोड़ दें।',
    },
  },
]

// The standard closing arc — Pradakshina and Kshama-prarthana — performed at
// the end of every puja in this module. A puja inserts its own post-steps
// (havan, katha-paatha, visarjana) before or after this arc.
//
// Both mantras here are deity-neutral and shared by all seven pujas. The
// Devanagari is taken from a cited source (see SOURCES.md); the IAST is a
// provisional scholarly transliteration pending a human reviewer, hence
// `reviewPending: true`.
export const STANDARD_CLOSING_ARC: readonly ArcStep[] = [
  {
    slug: 'pradakshina',
    name: { sanskrit: 'प्रदक्षिणा', en: 'Pradakshina', hi: 'प्रदक्षिणा' },
    line: {
      en: 'Circumambulate the image clockwise three times, holding a flower — or, if the image is large and fixed, turn yourself clockwise in place. Then bow.',
      hi: 'हाथ में पुष्प लेकर मूर्ति की दक्षिणावर्त तीन प्रदक्षिणा करें — अथवा यदि मूर्ति बड़ी एवं अचल हो तो स्वयं अपने स्थान पर दक्षिणावर्त घूम जाएँ। फिर प्रणाम करें।',
    },
    mantra: {
      jaapSlug: null,
      devanagari:
        'यानि कानि च पापानि जन्मान्तरकृतानि च ।\nतानि तानि विनश्यन्तु प्रदक्षिणपदे पदे ॥',
      iast:
        'yāni kāni ca pāpāni janmāntara-kṛtāni ca |\ntāni tāni vinaśyantu pradakṣiṇa-pade pade ||',
      meaning: {
        en: 'Whatever sins have been committed, in this birth or in former births — may they all be destroyed, step by step, with every circumambulation.',
        hi: 'इस जन्म अथवा पूर्व-जन्मों में जो भी पाप किए गए हों — प्रदक्षिणा के प्रत्येक पद के साथ वे सब नष्ट हो जाएँ।',
      },
    },
  },
  {
    slug: 'kshama-prarthana',
    name: { sanskrit: 'क्षमा-प्रार्थना', en: 'Kshama-prarthana', hi: 'क्षमा-प्रार्थना' },
    line: {
      en: 'Bow with folded hands and offer the Kshama-prarthana — a request that the deity forgive any shortfall of mantra, of rite, or of devotion during the puja, and accept it as complete.',
      hi: 'हाथ जोड़कर प्रणाम करें एवं क्षमा-प्रार्थना करें — पूजा में मन्त्र, क्रिया अथवा भक्ति की जो भी न्यूनता रही हो उसके लिए क्षमा-याचना, तथा पूजा को पूर्ण रूप में स्वीकार करने की प्रार्थना।',
    },
    mantra: {
      jaapSlug: null,
      devanagari:
        'मन्त्रहीनं क्रियाहीनं भक्तिहीनं सुरेश्वर ।\nयत्पूजितं मया देव परिपूर्णं तदस्तु मे ॥',
      iast:
        'mantrahīnaṃ kriyāhīnaṃ bhaktihīnaṃ sureśvara |\nyat pūjitaṃ mayā deva paripūrṇaṃ tad astu me ||',
      meaning: {
        en: 'O Lord of the gods — whatever I have worshipped here lacking in mantra, lacking in proper rite, lacking in devotion — let it, O Lord, become complete by your grace.',
        hi: 'हे देवेश्वर — मन्त्र से रहित, क्रिया से रहित, भक्ति से रहित जो भी पूजन मैंने किया है — हे देव, वह आपकी कृपा से पूर्ण हो जाए।',
      },
    },
  },
]