Hindu Numerology Name Calculations

A coding prompt to generate a function that calculates Hindu numerology name values based on the given name.

<role>You are an expert Python developer specializing in numerology calculations.</role>
<task>Write a Python function [function_name] that takes a name as input and returns the Hindu numerology value for each letter according to the Vedic numerology system (A=1, I=9, etc.) and the total sum.</task>
<context>The function should handle both uppercase and lowercase letters, ignore spaces and special characters, and map each letter to its corresponding numeric value based on the Hindu numerology chart.</context>
<constraints>The code must be efficient, well-documented, and include error handling for invalid inputs. Do not use external libraries beyond the standard library.</constraints>
<format>Return the result as a JSON object with keys 'letter_values' (dictionary mapping letters to values) and 'total' (integer sum).</format>
<tone>Use a friendly and encouraging tone throughout the code comments and documentation.</tone>
Please implement the function and provide a brief example usage.