{"version":3,"file":"index.mjs","names":["React","LocaleContext","getTranslator","LocaleProvider","props","locales","children","concatenatedLocales","Array","isArray","join","useLocales","localesConcat","useContext","useMemo","split","useI18n","book","i18n","throwPromise","Translate","id","renderInElement","params","extractComponents","length","fillComponentKeys","translator","interpolator","getInterpolator","translatedChildren","translateWithComponents","cloneElement","Dynamic","Todo","node","state","isValidElement","key","child","value","Object","entries","keys","generateKey","hasOwn","defineProperty","writable","configurable","enumerable","test","collect","submessages","wrap","component","message","newKey","o","s","prototype","hasOwnProperty","call"],"sources":["../src/index.tsx"],"sourcesContent":["import React from \"react\";\nimport { LocaleContext } from \"@hi18n/react-context\";\nimport {\n Book,\n VocabularyBase,\n TranslationId,\n TranslatorObject,\n MessageArguments,\n getTranslator,\n InstantiateComponentTypes,\n ComponentInterpolator,\n} from \"@hi18n/core\";\n\nexport { LocaleContext } from \"@hi18n/react-context\";\n\n/**\n * Renders the children with the specified locale.\n *\n * @since 0.1.0 (`@hi18n/react`)\n *\n * @example\n * ```tsx\n * ReactDOM.render(\n * root,\n * \n * \n * \n * );\n * ```\n */\nexport const LocaleProvider: React.FC<{\n children?: React.ReactNode;\n /**\n * A list of locales in the order of preference.\n */\n locales: string | string[];\n}> = (props) => {\n const { locales, children } = props;\n const concatenatedLocales = Array.isArray(locales)\n ? locales.join(\"\\n\")\n : locales;\n return (\n \n {children}\n \n );\n};\n/**\n * Returns the locales from the context.\n *\n * @returns A list of locales in the order of preference.\n *\n * @since 0.1.2 (`@hi18n/react`)\n *\n * @example\n * ```tsx\n * const Greeting: React.FC = () => {\n * const { t } = useI18n(book);\n * return (\n *
\n *

{t(\"example/greeting\")}

\n * {\n * messages.length > 0 &&\n *

{t(\"example/messages\", { count: messages.length })}

\n * }\n *
\n * );\n * };\n * ```\n */\nexport function useLocales(): string[] {\n const localesConcat = React.useContext(LocaleContext);\n const locales = React.useMemo(\n () => (localesConcat === \"\" ? [] : localesConcat.split(\"\\n\")),\n [localesConcat]\n );\n return locales;\n}\n\n/**\n * Retrieves translation helpers, using the locale from the context.\n *\n * If the catalog is not loaded yet, it suspends the component being\n * rendered. This is an **experimental API** which relies on React's\n * undocumented API for suspension.\n * To avoid this behavior,\n * initialize the Book statically or use preloadCatalog from @hi18n/core\n * to ensure the catalog is loaded before using this function.\n *\n * @param book A \"book\" object containing translated messages\n * @returns An object containing functions necessary for translation\n *\n * @since 0.1.0 (`@hi18n/react`)\n *\n * @example\n * ```tsx\n * const Greeting: React.FC = () => {\n * const { t } = useI18n(book);\n * return (\n *
\n *

{t(\"example/greeting\")}

\n * {\n * messages.length > 0 &&\n *

{t(\"example/messages\", { count: messages.length })}

\n * }\n *
\n * );\n * };\n * ```\n */\nexport function useI18n(\n book: Book\n): TranslatorObject {\n const locales = useLocales();\n const i18n = React.useMemo(\n () => getTranslator(book, locales, { throwPromise: true }),\n [book, locales]\n );\n return i18n;\n}\n\nexport type BaseTranslateProps<\n Vocabulary extends VocabularyBase,\n // TODO: restrict to string\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n K extends keyof any\n> = {\n /**\n * The book to look up in for the translation.\n *\n * @since 0.1.0 (`@hi18n/react`)\n */\n book: Book;\n /**\n * The translation id.\n *\n * @since 0.1.0 (`@hi18n/react`)\n */\n id: K;\n /**\n * The children. hi18n searches for elements in the node and names each one in the following way:\n *\n * - If it has a `key` prop, use the value.\n * - Otherwise, give it a number in the order of occurrence of the opening tags starting with 0.\n *\n * They are merged into the props as the parameters for the translation.\n *\n * @since 0.1.0 (`@hi18n/react`)\n */\n children?: React.ReactNode | undefined;\n /**\n * When given, the results are wrapped in the element given.\n *\n * Note that you don't need to use the prop in most cases.\n * You can just wrap the `` element in whatever wrapper components.\n *\n * One valid use case would be to pass a component that analyzes the texts or elements within the component,\n * such as one that splits texts using `Intl.Segmenter` for better word-wrapping experience.\n *\n * @since 0.1.2 (`@hi18n/react`)\n *\n * @example\n * ```tsx\n * }>\n * \n * ```\n */\n renderInElement?: React.ReactElement | undefined;\n};\n\nexport type TranslateProps<\n M extends VocabularyBase,\n // TODO: restrict to string\n K extends keyof M\n> = BaseTranslateProps &\n PartialForComponents>;\n\ntype PartialForComponents = Partial & Omit>;\ntype ComponentKeys = K extends unknown\n ? T[K] extends React.ReactElement\n ? K\n : never\n : never;\n\n/**\n * Renders the translated message, possibly interleaved with the elements you provide.\n *\n * If the catalog is not loaded yet, it suspends the component being\n * rendered. This is an **experimental API** which relies on React's\n * undocumented API for suspension.\n * To avoid this behavior,\n * initialize the Book statically or use preloadCatalog from @hi18n/core\n * to ensure the catalog is loaded before rendering this component.\n *\n * @since 0.1.0 (`@hi18n/react`)\n *\n * @example\n * ```tsx\n * \n * {\n * // These elements are inserted into the translation.\n * }\n * \n * \n * \n * ```\n *\n * @example You can add a placeholder for readability.\n * ```tsx\n * \n * You need to sign in or sign up to continue.\n * \n * ```\n *\n * @example Naming the elements\n * ```tsx\n * \n * \n * \n * \n * ```\n *\n * @example to supply non-component parameters, you can:\n * ```tsx\n * \n * ```\n *\n * This is almost equivalent to the following:\n * ```tsx\n * const { t } = useI18n(book);\n * return t(\"example/greeting\", { name });\n * ```\n */\nexport function Translate(\n props: TranslateProps\n): React.ReactElement | null {\n const { book, id, children, renderInElement, ...params } = props;\n extractComponents(children, params, { length: 0 });\n fillComponentKeys(params);\n const translator = useI18n(book);\n const interpolator = getInterpolator();\n const translatedChildren = translator.translateWithComponents<\n React.ReactNode,\n React.ReactElement,\n K\n >(\n id,\n interpolator,\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n params as any\n );\n if (renderInElement) {\n return React.cloneElement(renderInElement, {}, <>{translatedChildren});\n } else {\n return <>{translatedChildren};\n }\n}\n\nexport type DynamicTranslateProps<\n Vocabulary extends VocabularyBase,\n Args\n> = BaseTranslateProps> &\n PartialForComponents>;\n\n/**\n * A variant of {@link Translate} for dynamic translation keys\n *\n * @since 0.1.1 (`@hi18n/react`)\n *\n * @example\n * ```tsx\n * const id = translationId(book, \"example/signin\");\n * \n * \n * \n * \n * ```\n */\n// eslint-disable-next-line @typescript-eslint/ban-types\nTranslate.Dynamic = Translate as (\n props: DynamicTranslateProps\n) => React.ReactElement | null;\n\nexport type TodoTranslateProps =\n BaseTranslateProps & {\n [key: string]: unknown;\n };\n\n/**\n * A variant of {@link Translate} for translation bootstrap.\n *\n * At runtime, it just renders a TODO text.\n *\n * @since 0.1.1 (`@hi18n/react`)\n *\n * @example\n * ```tsx\n * \n * \n * ```\n */\nTranslate.Todo = function Todo(\n props: TodoTranslateProps\n): React.ReactElement | null {\n return <>[TODO: {props.id}];\n};\n\n// foo bar => { 0: , 1: }\n// => { 0: , 1: }\n//