@ultraq/icu-message-formatter 0.15.0-beta.1 → 0.15.0

package/dist/icu-message-formatter.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"icu-message-formatter.cjs","sources":["../source/utilities.js","../source/MessageFormatter.js","../source/pluralTypeHandler.js","../source/selectTypeHandler.js"],"sourcesContent":["/*\n * Copyright 2019, Emanuel Rabina (http://www.ultraq.net.nz/)\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * @typedef ParseCasesResult\n * @property {string[]} args\n *   A list of prepended arguments.\n * @property {Record<string,string>} cases\n *   A map of all cases.\n */\n\n/**\n * Most branch-based type handlers are based around \"cases\".  For example,\n * `select` and `plural` compare compare a value to \"case keys\" to choose a\n * subtranslation.\n *\n * This util splits \"matches\" portions provided to the aforementioned handlers\n * into case strings, and extracts any prepended arguments (for example,\n * `plural` supports an `offset:n` argument used for populating the magic `#`\n * variable).\n *\n * @param {string} string\n * @return {ParseCasesResult}\n */\nexport function parseCases(string = '') {\n\tconst isWhitespace = ch => /\\s/.test(ch);\n\n\tconst args = [];\n\tconst cases = {};\n\n\tlet currTermStart = 0;\n\tlet latestTerm = null;\n\tlet inTerm = false;\n\n\tlet i = 0;\n\twhile (i < string.length) {\n\t\t// Term ended\n\t\tif (inTerm && (isWhitespace(string[i]) || string[i] === '{')) {\n\t\t\tinTerm = false;\n\t\t\tlatestTerm = string.slice(currTermStart, i);\n\n\t\t\t// We want to process the opening char again so the case will be properly registered.\n\t\t\tif (string[i] === '{') {\n\t\t\t\ti--;\n\t\t\t}\n\t\t}\n\n\t\t// New term\n\t\telse if (!inTerm && !isWhitespace(string[i])) {\n\t\t\tconst caseBody = string[i] === '{';\n\n\t\t\t// If there's a previous term, we can either handle a whole\n\t\t\t// case, or add that as an argument.\n\t\t\tif (latestTerm && caseBody) {\n\t\t\t\tconst branchEndIndex = findClosingBracket(string, i);\n\n\t\t\t\tif (branchEndIndex === -1) {\n\t\t\t\t\tthrow new Error(`Unbalanced curly braces in string: \"${string}\"`);\n\t\t\t\t}\n\n\t\t\t\tcases[latestTerm] = string.slice(i + 1, branchEndIndex);  // Don't include the braces\n\n\t\t\t\ti = branchEndIndex; // Will be moved up where needed at end of loop.\n\t\t\t\tlatestTerm = null;\n\t\t\t}\n\t\t\telse {\n\t\t\t\tif (latestTerm) {\n\t\t\t\t\targs.push(latestTerm);\n\t\t\t\t\tlatestTerm = null;\n\t\t\t\t}\n\n\t\t\t\tinTerm = true;\n\t\t\t\tcurrTermStart = i;\n\t\t\t}\n\t\t}\n\t\ti++;\n\t}\n\n\tif (inTerm) {\n\t\tlatestTerm = string.slice(currTermStart);\n\t}\n\n\tif (latestTerm) {\n\t\targs.push(latestTerm);\n\t}\n\n\treturn {\n\t\targs,\n\t\tcases\n\t};\n}\n\n/**\n * Finds the index of the matching closing curly bracket, including through\n * strings that could have nested brackets.\n *\n * @param {string} string\n * @param {number} fromIndex\n * @return {number}\n *   The index of the matching closing bracket, or -1 if no closing bracket\n *   could be found.\n */\nexport function findClosingBracket(string, fromIndex) {\n\tlet depth = 0;\n\tfor (let i = fromIndex + 1; i < string.length; i++) {\n\t\tlet char = string.charAt(i);\n\t\tif (char === '}') {\n\t\t\tif (depth === 0) {\n\t\t\t\treturn i;\n\t\t\t}\n\t\t\tdepth--;\n\t\t}\n\t\telse if (char === '{') {\n\t\t\tdepth++;\n\t\t}\n\t}\n\treturn -1;\n}\n\n/**\n * Split a `{key, type, format}` block into those 3 parts, taking into account\n * nested message syntax that can exist in the `format` part.\n *\n * @param {string} block\n * @return {string[]}\n *   An array with `key`, `type`, and `format` items in that order, if present\n *   in the formatted argument block.\n */\nexport function splitFormattedArgument(block) {\n\treturn split(block.slice(1, -1), ',', 3);\n}\n\n/**\n * Like `String.prototype.split()` but where the limit parameter causes the\n * remainder of the string to be grouped together in a final entry.\n *\n * @private\n * @param {string} string\n * @param {string} separator\n * @param {number} limit\n * @param {string[]} accumulator\n * @return {string[]}\n */\nfunction split(string, separator, limit, accumulator = []) {\n\tif (!string) {\n\t\treturn accumulator;\n\t}\n\tif (limit === 1) {\n\t\taccumulator.push(string);\n\t\treturn accumulator;\n\t}\n\tlet indexOfDelimiter = string.indexOf(separator);\n\tif (indexOfDelimiter === -1) {\n\t\taccumulator.push(string);\n\t\treturn accumulator;\n\t}\n\tlet head = string.substring(0, indexOfDelimiter).trim();\n\tlet tail = string.substring(indexOfDelimiter + separator.length + 1).trim();\n\taccumulator.push(head);\n\treturn split(tail, separator, limit - 1, accumulator);\n}\n","/*\n * Copyright 2019, Emanuel Rabina (http://www.ultraq.net.nz/)\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {findClosingBracket, splitFormattedArgument} from './utilities.js';\n\nimport {memoize} from '@ultraq/function-utils';\n\n/**\n * @typedef {Record<string,any>} FormatValues\n */\n\n/**\n * @callback ProcessFunction\n * @param {string} message\n * @param {FormatValues} [values={}]\n * @return {any[]}\n */\n\n/**\n * @callback TypeHandler\n * @param {any} value\n *   The object which matched the key of the block being processed.\n * @param {string} matches\n *   Any format options associated with the block being processed.\n * @param {string} locale\n *   The locale to use for formatting.\n * @param {FormatValues} values\n *   The object of placeholder data given to the original `format`/`process`\n *   call.\n * @param {ProcessFunction} process\n *   The `process` function itself so that sub-messages can be processed by type\n *   handlers.\n * @return {any | any[]}\n */\n\n/**\n * The main class for formatting messages.\n *\n * @author Emanuel Rabina\n */\nexport default class MessageFormatter {\n\n\t/**\n\t * Creates a new formatter that can work using any of the custom type handlers\n\t * you register.\n\t *\n\t * @param {string} locale\n\t * @param {Record<string,TypeHandler>} [typeHandlers]\n\t *   Optional object where the keys are the names of the types to register,\n\t *   their values being the functions that will return a nicely formatted\n\t *   string for the data and locale they are given.\n\t */\n\tconstructor(locale, typeHandlers = {}) {\n\n\t\tthis.locale = locale;\n\t\tthis.typeHandlers = typeHandlers;\n\t}\n\n\t/**\n\t * Formats an ICU message syntax string using `values` for placeholder data\n\t * and any currently-registered type handlers.\n\t *\n\t * @type {(message: string, values?: FormatValues) => string}\n\t */\n\tformat = memoize((message, values = {}) => {\n\n\t\treturn this.process(message, values).flat(Infinity).join('');\n\t});\n\n\t/**\n\t * Process an ICU message syntax string using `values` for placeholder data\n\t * and any currently-registered type handlers.  The result of this method is\n\t * an array of the component parts after they have been processed in turn by\n\t * their own type handlers.  This raw output is useful for other renderers,\n\t * eg: React where components can be used instead of being forced to return\n\t * raw strings.\n\t *\n\t * This method is used by {@link MessageFormatter#format} where it acts as a\n\t * string renderer.\n\t *\n\t * @param {string} message\n\t * @param {FormatValues} [values]\n\t * @return {any[]}\n\t */\n\tprocess(message, values = {}) {\n\n\t\tif (!message) {\n\t\t\treturn [];\n\t\t}\n\n\t\tlet blockStartIndex = message.indexOf('{');\n\t\tif (blockStartIndex !== -1) {\n\t\t\tlet blockEndIndex = findClosingBracket(message, blockStartIndex);\n\t\t\tif (blockEndIndex !== -1) {\n\t\t\t\tlet block = message.substring(blockStartIndex, blockEndIndex + 1);\n\t\t\t\tif (block) {\n\t\t\t\t\tlet result = [];\n\t\t\t\t\tlet head = message.substring(0, blockStartIndex);\n\t\t\t\t\tif (head) {\n\t\t\t\t\t\tresult.push(head);\n\t\t\t\t\t}\n\t\t\t\t\tlet [key, type, format] = splitFormattedArgument(block);\n\t\t\t\t\tlet body = values[key];\n\t\t\t\t\tif (body === null || body === undefined) {\n\t\t\t\t\t\tbody = '';\n\t\t\t\t\t}\n\t\t\t\t\tlet typeHandler = type && this.typeHandlers[type];\n\t\t\t\t\tresult.push(typeHandler ?\n\t\t\t\t\t\ttypeHandler(body, format, this.locale, values, this.process.bind(this)) :\n\t\t\t\t\t\tbody);\n\t\t\t\t\tlet tail = message.substring(blockEndIndex + 1);\n\t\t\t\t\tif (tail) {\n\t\t\t\t\t\tresult.push(this.process(tail, values));\n\t\t\t\t\t}\n\t\t\t\t\treturn result;\n\t\t\t\t}\n\t\t\t}\n\t\t\telse {\n\t\t\t\tthrow new Error(`Unbalanced curly braces in string: \"${message}\"`);\n\t\t\t}\n\t\t}\n\t\treturn [message];\n\t}\n}\n","/*\n * Copyright 2019, Emanuel Rabina (http://www.ultraq.net.nz/)\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {parseCases} from './utilities.js';\n\nlet pluralFormatter;\n\nlet keyCounter = 0;\n\n// All the special keywords that can be used in `plural` blocks for the various branches\nconst ONE   = 'one';\nconst OTHER = 'other';\n\n/**\n * @private\n * @param {string} caseBody\n * @param {number} value\n * @return {{caseBody: string, numberValues: object}}\n */\nfunction replaceNumberSign(caseBody, value) {\n\tlet i = 0;\n\tlet output = '';\n\tlet numBraces = 0;\n\tconst numberValues = {};\n\n\twhile (i < caseBody.length) {\n\t\tif (caseBody[i] === '#' && !numBraces) {\n\t\t\tlet keyParam = `__hashToken${keyCounter++}`;\n\t\t\toutput += `{${keyParam}, number}`;\n\t\t\tnumberValues[keyParam] = value;\n\t\t}\n\t\telse {\n\t\t\toutput += caseBody[i];\n\t\t}\n\n\t\tif (caseBody[i] === '{') {\n\t\t\tnumBraces++;\n\t\t}\n\t\telse if (caseBody[i] === '}') {\n\t\t\tnumBraces--;\n\t\t}\n\n\t\ti++;\n\t}\n\n\treturn {\n\t\tcaseBody: output,\n\t\tnumberValues\n\t};\n}\n\n/**\n * Handler for `plural` statements within ICU message syntax strings.  Returns\n * a formatted string for the branch that closely matches the current value.\n *\n * See https://formatjs.io/docs/core-concepts/icu-syntax#plural-format for more\n * details on how the `plural` statement works.\n *\n * @param {string} value\n * @param {string} matches\n * @param {string} locale\n * @param {import('./MessageFormatter.js').FormatValues} values\n * @param {import('./MessageFormatter.js').ProcessFunction} process\n * @return {any | any[]}\n */\nexport default function pluralTypeHandler(value, matches, locale, values, process) {\n\tconst {args, cases} = parseCases(matches);\n\n\tlet intValue = parseInt(value);\n\n\targs.forEach((arg) => {\n\t\tif (arg.startsWith('offset:')) {\n\t\t\tintValue -= parseInt(arg.slice('offset:'.length));\n\t\t}\n\t});\n\n\tconst keywordPossibilities = [];\n\n\tif ('PluralRules' in Intl) {\n\t\t// Effectively memoize because instantiation of `Int.*` objects is expensive.\n\t\tif (pluralFormatter === undefined || pluralFormatter.resolvedOptions().locale !== locale) {\n\t\t\tpluralFormatter = new Intl.PluralRules(locale);\n\t\t}\n\n\t\tconst pluralKeyword = pluralFormatter.select(intValue);\n\n\t\t// Other is always added last with least priority, so we don't want to add it here.\n\t\tif (pluralKeyword !== OTHER) {\n\t\t\tkeywordPossibilities.push(pluralKeyword);\n\t\t}\n\t}\n\tif (intValue === 1) {\n\t\tkeywordPossibilities.push(ONE);\n\t}\n\tkeywordPossibilities.push(`=${intValue}`, OTHER);\n\n\tfor (let i = 0; i < keywordPossibilities.length; i++) {\n\t\tconst keyword = keywordPossibilities[i];\n\t\tif (keyword in cases) {\n\t\t\tconst {caseBody, numberValues} = replaceNumberSign(cases[keyword], intValue);\n\t\t\treturn process(caseBody, {\n\t\t\t\t...values,\n\t\t\t\t...numberValues\n\t\t\t});\n\t\t}\n\t}\n\n\treturn value;\n}\n","/*\n * Copyright 2019, Emanuel Rabina (http://www.ultraq.net.nz/)\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {parseCases} from './utilities.js';\n\nconst OTHER = 'other';\n\n/**\n * Handler for `select` statements within ICU message syntax strings.  Returns\n * a formatted string for the branch that closely matches the current value.\n *\n * See https://formatjs.io/docs/core-concepts/icu-syntax#select-format for more\n * details on how the `select` statement works.\n *\n * @param {string} value\n * @param {string} matches\n * @param {string} locale\n * @param {import('./MessageFormatter.js').FormatValues} values\n * @param {import('./MessageFormatter.js').ProcessFunction} process\n * @return {any | any[]}\n */\nexport default function selectTypeHandler(value, matches, locale, values, process) {\n\tconst {cases} = parseCases(matches);\n\n\tif (value in cases) {\n\t\treturn process(cases[value], values);\n\t}\n\telse if (OTHER in cases) {\n\t\treturn process(cases[OTHER], values);\n\t}\n\n\treturn value;\n}\n"],"names":["memoize","OTHER"],"mappings":"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"}
+{"version":3,"file":"icu-message-formatter.cjs","sources":["../source/utilities.js","../source/MessageFormatter.js","../source/pluralTypeHandler.js","../source/selectTypeHandler.js"],"sourcesContent":["/*\n * Copyright 2019, Emanuel Rabina (http://www.ultraq.net.nz/)\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * @typedef ParseCasesResult\n * @property {string[]} args\n *   A list of prepended arguments.\n * @property {Record<string,string>} cases\n *   A map of all cases.\n */\n\n/**\n * Most branch-based type handlers are based around \"cases\".  For example,\n * `select` and `plural` compare compare a value to \"case keys\" to choose a\n * subtranslation.\n *\n * This util splits \"matches\" portions provided to the aforementioned handlers\n * into case strings, and extracts any prepended arguments (for example,\n * `plural` supports an `offset:n` argument used for populating the magic `#`\n * variable).\n *\n * @param {string} string\n * @return {ParseCasesResult}\n */\nexport function parseCases(string = '') {\n\tconst isWhitespace = ch => /\\s/.test(ch);\n\n\tconst args = [];\n\tconst cases = {};\n\n\tlet currTermStart = 0;\n\tlet latestTerm = null;\n\tlet inTerm = false;\n\n\tlet i = 0;\n\twhile (i < string.length) {\n\t\t// Term ended\n\t\tif (inTerm && (isWhitespace(string[i]) || string[i] === '{')) {\n\t\t\tinTerm = false;\n\t\t\tlatestTerm = string.slice(currTermStart, i);\n\n\t\t\t// We want to process the opening char again so the case will be properly registered.\n\t\t\tif (string[i] === '{') {\n\t\t\t\ti--;\n\t\t\t}\n\t\t}\n\n\t\t// New term\n\t\telse if (!inTerm && !isWhitespace(string[i])) {\n\t\t\tconst caseBody = string[i] === '{';\n\n\t\t\t// If there's a previous term, we can either handle a whole\n\t\t\t// case, or add that as an argument.\n\t\t\tif (latestTerm && caseBody) {\n\t\t\t\tconst branchEndIndex = findClosingBracket(string, i);\n\n\t\t\t\tif (branchEndIndex === -1) {\n\t\t\t\t\tthrow new Error(`Unbalanced curly braces in string: \"${string}\"`);\n\t\t\t\t}\n\n\t\t\t\tcases[latestTerm] = string.slice(i + 1, branchEndIndex);  // Don't include the braces\n\n\t\t\t\ti = branchEndIndex; // Will be moved up where needed at end of loop.\n\t\t\t\tlatestTerm = null;\n\t\t\t}\n\t\t\telse {\n\t\t\t\tif (latestTerm) {\n\t\t\t\t\targs.push(latestTerm);\n\t\t\t\t\tlatestTerm = null;\n\t\t\t\t}\n\n\t\t\t\tinTerm = true;\n\t\t\t\tcurrTermStart = i;\n\t\t\t}\n\t\t}\n\t\ti++;\n\t}\n\n\tif (inTerm) {\n\t\tlatestTerm = string.slice(currTermStart);\n\t}\n\n\tif (latestTerm) {\n\t\targs.push(latestTerm);\n\t}\n\n\treturn {\n\t\targs,\n\t\tcases\n\t};\n}\n\n/**\n * Finds the index of the matching closing curly bracket, including through\n * strings that could have nested brackets.\n *\n * @param {string} string\n * @param {number} fromIndex\n * @return {number}\n *   The index of the matching closing bracket, or -1 if no closing bracket\n *   could be found.\n */\nexport function findClosingBracket(string, fromIndex) {\n\tlet depth = 0;\n\tfor (let i = fromIndex + 1; i < string.length; i++) {\n\t\tlet char = string.charAt(i);\n\t\tif (char === '}') {\n\t\t\tif (depth === 0) {\n\t\t\t\treturn i;\n\t\t\t}\n\t\t\tdepth--;\n\t\t}\n\t\telse if (char === '{') {\n\t\t\tdepth++;\n\t\t}\n\t}\n\treturn -1;\n}\n\n/**\n * Split a `{key, type, format}` block into those 3 parts, taking into account\n * nested message syntax that can exist in the `format` part.\n *\n * @param {string} block\n * @return {string[]}\n *   An array with `key`, `type`, and `format` items in that order, if present\n *   in the formatted argument block.\n */\nexport function splitFormattedArgument(block) {\n\treturn split(block.slice(1, -1), ',', 3);\n}\n\n/**\n * Like `String.prototype.split()` but where the limit parameter causes the\n * remainder of the string to be grouped together in a final entry.\n *\n * @private\n * @param {string} string\n * @param {string} separator\n * @param {number} limit\n * @param {string[]} accumulator\n * @return {string[]}\n */\nfunction split(string, separator, limit, accumulator = []) {\n\tif (!string) {\n\t\treturn accumulator;\n\t}\n\tif (limit === 1) {\n\t\taccumulator.push(string);\n\t\treturn accumulator;\n\t}\n\tlet indexOfDelimiter = string.indexOf(separator);\n\tif (indexOfDelimiter === -1) {\n\t\taccumulator.push(string);\n\t\treturn accumulator;\n\t}\n\tlet head = string.substring(0, indexOfDelimiter).trim();\n\tlet tail = string.substring(indexOfDelimiter + separator.length + 1).trim();\n\taccumulator.push(head);\n\treturn split(tail, separator, limit - 1, accumulator);\n}\n","/*\n * Copyright 2019, Emanuel Rabina (http://www.ultraq.net.nz/)\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {findClosingBracket, splitFormattedArgument} from './utilities.js';\n\nimport {memoize} from '@ultraq/function-utils';\n\n/**\n * @typedef {Record<string,any>} FormatValues\n */\n\n/**\n * @callback ProcessFunction\n * @param {string} message\n * @param {FormatValues} [values={}]\n * @return {any[]}\n */\n\n/**\n * @callback TypeHandler\n * @param {any} value\n *   The object which matched the key of the block being processed.\n * @param {string} matches\n *   Any format options associated with the block being processed.\n * @param {string} locale\n *   The locale to use for formatting.\n * @param {FormatValues} values\n *   The object of placeholder data given to the original `format`/`process`\n *   call.\n * @param {ProcessFunction} process\n *   The `process` function itself so that sub-messages can be processed by type\n *   handlers.\n * @return {any | any[]}\n */\n\n/**\n * The main class for formatting messages.\n *\n * @author Emanuel Rabina\n */\nexport default class MessageFormatter {\n\n\t/**\n\t * Creates a new formatter that can work using any of the custom type handlers\n\t * you register.\n\t *\n\t * @param {string} locale\n\t * @param {Record<string,TypeHandler>} [typeHandlers]\n\t *   Optional object where the keys are the names of the types to register,\n\t *   their values being the functions that will return a nicely formatted\n\t *   string for the data and locale they are given.\n\t */\n\tconstructor(locale, typeHandlers = {}) {\n\n\t\tthis.locale = locale;\n\t\tthis.typeHandlers = typeHandlers;\n\t}\n\n\t/**\n\t * Formats an ICU message syntax string using `values` for placeholder data\n\t * and any currently-registered type handlers.\n\t *\n\t * @type {(message: string, values?: FormatValues) => string}\n\t */\n\tformat = memoize((message, values = {}) => {\n\n\t\treturn this.process(message, values).flat(Infinity).join('');\n\t});\n\n\t/**\n\t * Process an ICU message syntax string using `values` for placeholder data\n\t * and any currently-registered type handlers.  The result of this method is\n\t * an array of the component parts after they have been processed in turn by\n\t * their own type handlers.  This raw output is useful for other renderers,\n\t * eg: React where components can be used instead of being forced to return\n\t * raw strings.\n\t *\n\t * This method is used by {@link MessageFormatter#format} where it acts as a\n\t * string renderer.\n\t *\n\t * @param {string} message\n\t * @param {FormatValues} [values]\n\t * @return {any[]}\n\t */\n\tprocess(message, values = {}) {\n\n\t\tif (!message) {\n\t\t\treturn [];\n\t\t}\n\n\t\tlet blockStartIndex = message.indexOf('{');\n\t\tif (blockStartIndex !== -1) {\n\t\t\tlet blockEndIndex = findClosingBracket(message, blockStartIndex);\n\t\t\tif (blockEndIndex !== -1) {\n\t\t\t\tlet block = message.substring(blockStartIndex, blockEndIndex + 1);\n\t\t\t\tif (block) {\n\t\t\t\t\tlet result = [];\n\t\t\t\t\tlet head = message.substring(0, blockStartIndex);\n\t\t\t\t\tif (head) {\n\t\t\t\t\t\tresult.push(head);\n\t\t\t\t\t}\n\t\t\t\t\tlet [key, type, format] = splitFormattedArgument(block);\n\t\t\t\t\tlet body = values[key];\n\t\t\t\t\tlet typeHandler = type && this.typeHandlers[type];\n\t\t\t\t\tresult.push(typeHandler ?\n\t\t\t\t\t\ttypeHandler(body, format, this.locale, values, this.process.bind(this)) :\n\t\t\t\t\t\tbody);\n\t\t\t\t\tlet tail = message.substring(blockEndIndex + 1);\n\t\t\t\t\tif (tail) {\n\t\t\t\t\t\tresult.push(this.process(tail, values));\n\t\t\t\t\t}\n\t\t\t\t\treturn result;\n\t\t\t\t}\n\t\t\t}\n\t\t\telse {\n\t\t\t\tthrow new Error(`Unbalanced curly braces in string: \"${message}\"`);\n\t\t\t}\n\t\t}\n\t\treturn [message];\n\t}\n}\n","/*\n * Copyright 2019, Emanuel Rabina (http://www.ultraq.net.nz/)\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {parseCases} from './utilities.js';\n\nlet pluralFormatter;\n\nlet keyCounter = 0;\n\n// All the special keywords that can be used in `plural` blocks for the various branches\nconst ONE   = 'one';\nconst OTHER = 'other';\n\n/**\n * @private\n * @param {string} caseBody\n * @param {number} value\n * @return {{caseBody: string, numberValues: object}}\n */\nfunction replaceNumberSign(caseBody, value) {\n\tlet i = 0;\n\tlet output = '';\n\tlet numBraces = 0;\n\tconst numberValues = {};\n\n\twhile (i < caseBody.length) {\n\t\tif (caseBody[i] === '#' && !numBraces) {\n\t\t\tlet keyParam = `__hashToken${keyCounter++}`;\n\t\t\toutput += `{${keyParam}, number}`;\n\t\t\tnumberValues[keyParam] = value;\n\t\t}\n\t\telse {\n\t\t\toutput += caseBody[i];\n\t\t}\n\n\t\tif (caseBody[i] === '{') {\n\t\t\tnumBraces++;\n\t\t}\n\t\telse if (caseBody[i] === '}') {\n\t\t\tnumBraces--;\n\t\t}\n\n\t\ti++;\n\t}\n\n\treturn {\n\t\tcaseBody: output,\n\t\tnumberValues\n\t};\n}\n\n/**\n * Handler for `plural` statements within ICU message syntax strings.  Returns\n * a formatted string for the branch that closely matches the current value.\n *\n * See https://formatjs.io/docs/core-concepts/icu-syntax#plural-format for more\n * details on how the `plural` statement works.\n *\n * @param {string} value\n * @param {string} matches\n * @param {string} locale\n * @param {import('./MessageFormatter.js').FormatValues} values\n * @param {import('./MessageFormatter.js').ProcessFunction} process\n * @return {any | any[]}\n */\nexport default function pluralTypeHandler(value, matches, locale, values, process) {\n\tconst {args, cases} = parseCases(matches);\n\n\tlet intValue = parseInt(value);\n\n\targs.forEach((arg) => {\n\t\tif (arg.startsWith('offset:')) {\n\t\t\tintValue -= parseInt(arg.slice('offset:'.length));\n\t\t}\n\t});\n\n\tconst keywordPossibilities = [];\n\n\tif ('PluralRules' in Intl) {\n\t\t// Effectively memoize because instantiation of `Int.*` objects is expensive.\n\t\tif (pluralFormatter === undefined || pluralFormatter.resolvedOptions().locale !== locale) {\n\t\t\tpluralFormatter = new Intl.PluralRules(locale);\n\t\t}\n\n\t\tconst pluralKeyword = pluralFormatter.select(intValue);\n\n\t\t// Other is always added last with least priority, so we don't want to add it here.\n\t\tif (pluralKeyword !== OTHER) {\n\t\t\tkeywordPossibilities.push(pluralKeyword);\n\t\t}\n\t}\n\tif (intValue === 1) {\n\t\tkeywordPossibilities.push(ONE);\n\t}\n\tkeywordPossibilities.push(`=${intValue}`, OTHER);\n\n\tfor (let i = 0; i < keywordPossibilities.length; i++) {\n\t\tconst keyword = keywordPossibilities[i];\n\t\tif (keyword in cases) {\n\t\t\tconst {caseBody, numberValues} = replaceNumberSign(cases[keyword], intValue);\n\t\t\treturn process(caseBody, {\n\t\t\t\t...values,\n\t\t\t\t...numberValues\n\t\t\t});\n\t\t}\n\t}\n\n\treturn value;\n}\n","/*\n * Copyright 2019, Emanuel Rabina (http://www.ultraq.net.nz/)\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {parseCases} from './utilities.js';\n\nconst OTHER = 'other';\n\n/**\n * Handler for `select` statements within ICU message syntax strings.  Returns\n * a formatted string for the branch that closely matches the current value.\n *\n * See https://formatjs.io/docs/core-concepts/icu-syntax#select-format for more\n * details on how the `select` statement works.\n *\n * @param {string} value\n * @param {string} matches\n * @param {string} locale\n * @param {import('./MessageFormatter.js').FormatValues} values\n * @param {import('./MessageFormatter.js').ProcessFunction} process\n * @return {any | any[]}\n */\nexport default function selectTypeHandler(value, matches, locale, values, process) {\n\tconst {cases} = parseCases(matches);\n\n\tif (value in cases) {\n\t\treturn process(cases[value], values);\n\t}\n\telse if (OTHER in cases) {\n\t\treturn process(cases[OTHER], values);\n\t}\n\n\treturn value;\n}\n"],"names":["memoize","OTHER"],"mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,UAAU,CAAC,MAAM,GAAG,EAAE,EAAE;AACxC,CAAC,MAAM,YAAY,GAAG,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;;AAEzC,CAAC,MAAM,IAAI,GAAG,EAAE;AAChB,CAAC,MAAM,KAAK,GAAG,EAAE;;AAEjB,CAAC,IAAI,aAAa,GAAG,CAAC;AACtB,CAAC,IAAI,UAAU,GAAG,IAAI;AACtB,CAAC,IAAI,MAAM,GAAG,KAAK;;AAEnB,CAAC,IAAI,CAAC,GAAG,CAAC;AACV,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE;AAC3B;AACA,EAAE,IAAI,MAAM,KAAK,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,EAAE;AAChE,GAAG,MAAM,GAAG,KAAK;AACjB,GAAG,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC;;AAE9C;AACA,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE;AAC1B,IAAI,CAAC,EAAE;AACP,GAAG;AACH,EAAE;;AAEF;AACA,OAAO,IAAI,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE;AAChD,GAAG,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG;;AAErC;AACA;AACA,GAAG,IAAI,UAAU,IAAI,QAAQ,EAAE;AAC/B,IAAI,MAAM,cAAc,GAAG,kBAAkB,CAAC,MAAM,EAAE,CAAC,CAAC;;AAExD,IAAI,IAAI,cAAc,KAAK,EAAE,EAAE;AAC/B,KAAK,MAAM,IAAI,KAAK,CAAC,CAAC,oCAAoC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;AACtE,IAAI;;AAEJ,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,cAAc,CAAC,CAAC;;AAE5D,IAAI,CAAC,GAAG,cAAc,CAAC;AACvB,IAAI,UAAU,GAAG,IAAI;AACrB,GAAG;AACH,QAAQ;AACR,IAAI,IAAI,UAAU,EAAE;AACpB,KAAK,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;AAC1B,KAAK,UAAU,GAAG,IAAI;AACtB,IAAI;;AAEJ,IAAI,MAAM,GAAG,IAAI;AACjB,IAAI,aAAa,GAAG,CAAC;AACrB,GAAG;AACH,EAAE;AACF,EAAE,CAAC,EAAE;AACL,CAAC;;AAED,CAAC,IAAI,MAAM,EAAE;AACb,EAAE,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC;AAC1C,CAAC;;AAED,CAAC,IAAI,UAAU,EAAE;AACjB,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;AACvB,CAAC;;AAED,CAAC,OAAO;AACR,EAAE,IAAI;AACN,EAAE;AACF,EAAE;AACF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE;AACtD,CAAC,IAAI,KAAK,GAAG,CAAC;AACd,CAAC,KAAK,IAAI,CAAC,GAAG,SAAS,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;AACrD,EAAE,IAAI,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;AAC7B,EAAE,IAAI,IAAI,KAAK,GAAG,EAAE;AACpB,GAAG,IAAI,KAAK,KAAK,CAAC,EAAE;AACpB,IAAI,OAAO,CAAC;AACZ,GAAG;AACH,GAAG,KAAK,EAAE;AACV,EAAE;AACF,OAAO,IAAI,IAAI,KAAK,GAAG,EAAE;AACzB,GAAG,KAAK,EAAE;AACV,EAAE;AACF,CAAC;AACD,CAAC,OAAO,EAAE;AACV;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,sBAAsB,CAAC,KAAK,EAAE;AAC9C,CAAC,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;AACzC;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAAS,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,GAAG,EAAE,EAAE;AAC3D,CAAC,IAAI,CAAC,MAAM,EAAE;AACd,EAAE,OAAO,WAAW;AACpB,CAAC;AACD,CAAC,IAAI,KAAK,KAAK,CAAC,EAAE;AAClB,EAAE,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC;AAC1B,EAAE,OAAO,WAAW;AACpB,CAAC;AACD,CAAC,IAAI,gBAAgB,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;AACjD,CAAC,IAAI,gBAAgB,KAAK,EAAE,EAAE;AAC9B,EAAE,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC;AAC1B,EAAE,OAAO,WAAW;AACpB,CAAC;AACD,CAAC,IAAI,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,IAAI,EAAE;AACxD,CAAC,IAAI,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,gBAAgB,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE;AAC5E,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;AACvB,CAAC,OAAO,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,GAAG,CAAC,EAAE,WAAW,CAAC;AACtD;;AC7KA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;;AAMA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACe,MAAM,gBAAgB,CAAC;;AAEtC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,EAAE,EAAE;;AAExC,EAAE,IAAI,CAAC,MAAM,GAAG,MAAM;AACtB,EAAE,IAAI,CAAC,YAAY,GAAG,YAAY;AAClC,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA,CAAC,MAAM,GAAGA,qBAAO,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,EAAE,KAAK;;AAE5C,EAAE,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;AAC9D,CAAC,CAAC,CAAC;;AAEH;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,EAAE,EAAE;;AAE/B,EAAE,IAAI,CAAC,OAAO,EAAE;AAChB,GAAG,OAAO,EAAE;AACZ,EAAE;;AAEF,EAAE,IAAI,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC;AAC5C,EAAE,IAAI,eAAe,KAAK,EAAE,EAAE;AAC9B,GAAG,IAAI,aAAa,GAAG,kBAAkB,CAAC,OAAO,EAAE,eAAe,CAAC;AACnE,GAAG,IAAI,aAAa,KAAK,EAAE,EAAE;AAC7B,IAAI,IAAI,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,eAAe,EAAE,aAAa,GAAG,CAAC,CAAC;AACrE,IAAI,IAAI,KAAK,EAAE;AACf,KAAK,IAAI,MAAM,GAAG,EAAE;AACpB,KAAK,IAAI,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,eAAe,CAAC;AACrD,KAAK,IAAI,IAAI,EAAE;AACf,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;AACvB,KAAK;AACL,KAAK,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,sBAAsB,CAAC,KAAK,CAAC;AAC5D,KAAK,IAAI,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC;AAC3B,KAAK,IAAI,WAAW,GAAG,IAAI,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;AACtD,KAAK,MAAM,CAAC,IAAI,CAAC,WAAW;AAC5B,MAAM,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7E,MAAM,IAAI,CAAC;AACX,KAAK,IAAI,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,aAAa,GAAG,CAAC,CAAC;AACpD,KAAK,IAAI,IAAI,EAAE;AACf,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC7C,KAAK;AACL,KAAK,OAAO,MAAM;AAClB,IAAI;AACJ,GAAG;AACH,QAAQ;AACR,IAAI,MAAM,IAAI,KAAK,CAAC,CAAC,oCAAoC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AACtE,GAAG;AACH,EAAE;AACF,EAAE,OAAO,CAAC,OAAO,CAAC;AAClB,CAAC;AACD;;ACrIA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;;AAIA,IAAI,eAAe;;AAEnB,IAAI,UAAU,GAAG,CAAC;;AAElB;AACA,MAAM,GAAG,KAAK,KAAK;AACnB,MAAMC,OAAK,GAAG,OAAO;;AAErB;AACA;AACA;AACA;AACA;AACA;AACA,SAAS,iBAAiB,CAAC,QAAQ,EAAE,KAAK,EAAE;AAC5C,CAAC,IAAI,CAAC,GAAG,CAAC;AACV,CAAC,IAAI,MAAM,GAAG,EAAE;AAChB,CAAC,IAAI,SAAS,GAAG,CAAC;AAClB,CAAC,MAAM,YAAY,GAAG,EAAE;;AAExB,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE;AAC7B,EAAE,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE;AACzC,GAAG,IAAI,QAAQ,GAAG,CAAC,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;AAC9C,GAAG,MAAM,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,SAAS,CAAC;AACpC,GAAG,YAAY,CAAC,QAAQ,CAAC,GAAG,KAAK;AACjC,EAAE;AACF,OAAO;AACP,GAAG,MAAM,IAAI,QAAQ,CAAC,CAAC,CAAC;AACxB,EAAE;;AAEF,EAAE,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE;AAC3B,GAAG,SAAS,EAAE;AACd,EAAE;AACF,OAAO,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE;AAChC,GAAG,SAAS,EAAE;AACd,EAAE;;AAEF,EAAE,CAAC,EAAE;AACL,CAAC;;AAED,CAAC,OAAO;AACR,EAAE,QAAQ,EAAE,MAAM;AAClB,EAAE;AACF,EAAE;AACF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACe,SAAS,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE;AACnF,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC;;AAE1C,CAAC,IAAI,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC;;AAE/B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,KAAK;AACvB,EAAE,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE;AACjC,GAAG,QAAQ,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AACpD,EAAE;AACF,CAAC,CAAC,CAAC;;AAEH,CAAC,MAAM,oBAAoB,GAAG,EAAE;;AAEhC,CAAC,IAAI,aAAa,IAAI,IAAI,EAAE;AAC5B;AACA,EAAE,IAAI,eAAe,KAAK,SAAS,IAAI,eAAe,CAAC,eAAe,EAAE,CAAC,MAAM,KAAK,MAAM,EAAE;AAC5F,GAAG,eAAe,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;AACjD,EAAE;;AAEF,EAAE,MAAM,aAAa,GAAG,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC;;AAExD;AACA,EAAE,IAAI,aAAa,KAAKA,OAAK,EAAE;AAC/B,GAAG,oBAAoB,CAAC,IAAI,CAAC,aAAa,CAAC;AAC3C,EAAE;AACF,CAAC;AACD,CAAC,IAAI,QAAQ,KAAK,CAAC,EAAE;AACrB,EAAE,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC;AAChC,CAAC;AACD,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,EAAEA,OAAK,CAAC;;AAEjD,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,oBAAoB,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;AACvD,EAAE,MAAM,OAAO,GAAG,oBAAoB,CAAC,CAAC,CAAC;AACzC,EAAE,IAAI,OAAO,IAAI,KAAK,EAAE;AACxB,GAAG,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,GAAG,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC;AAC/E,GAAG,OAAO,OAAO,CAAC,QAAQ,EAAE;AAC5B,IAAI,GAAG,MAAM;AACb,IAAI,GAAG;AACP,IAAI,CAAC;AACL,EAAE;AACF,CAAC;;AAED,CAAC,OAAO,KAAK;AACb;;ACzHA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;;AAIA,MAAM,KAAK,GAAG,OAAO;;AAErB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACe,SAAS,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE;AACnF,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC;;AAEpC,CAAC,IAAI,KAAK,IAAI,KAAK,EAAE;AACrB,EAAE,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;AACtC,CAAC;AACD,MAAM,IAAI,KAAK,IAAI,KAAK,EAAE;AAC1B,EAAE,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;AACtC,CAAC;;AAED,CAAC,OAAO,KAAK;AACb;;;;;;;;;"}

package/dist/icu-message-formatter.d.cts

@@ -0,0 +1,153 @@
+export type ParseCasesResult = {
+    /**
+     *   A list of prepended arguments.
+     */
+    args: string[];
+    /**
+     *   A map of all cases.
+     */
+    cases: Record<string, string>;
+};
+export type FormatValues = Record<string, any>;
+export type ProcessFunction = (message: string, values?: FormatValues) => any[];
+export type TypeHandler = (value: any, matches: string, locale: string, values: FormatValues, process: ProcessFunction) => any | any[];
+/**
+ * @typedef {Record<string,any>} FormatValues
+ */
+/**
+ * @callback ProcessFunction
+ * @param {string} message
+ * @param {FormatValues} [values={}]
+ * @return {any[]}
+ */
+/**
+ * @callback TypeHandler
+ * @param {any} value
+ *   The object which matched the key of the block being processed.
+ * @param {string} matches
+ *   Any format options associated with the block being processed.
+ * @param {string} locale
+ *   The locale to use for formatting.
+ * @param {FormatValues} values
+ *   The object of placeholder data given to the original `format`/`process`
+ *   call.
+ * @param {ProcessFunction} process
+ *   The `process` function itself so that sub-messages can be processed by type
+ *   handlers.
+ * @return {any | any[]}
+ */
+/**
+ * The main class for formatting messages.
+ *
+ * @author Emanuel Rabina
+ */
+export class MessageFormatter {
+    /**
+     * Creates a new formatter that can work using any of the custom type handlers
+     * you register.
+     *
+     * @param {string} locale
+     * @param {Record<string,TypeHandler>} [typeHandlers]
+     *   Optional object where the keys are the names of the types to register,
+     *   their values being the functions that will return a nicely formatted
+     *   string for the data and locale they are given.
+     */
+    constructor(locale: string, typeHandlers?: Record<string, TypeHandler>);
+    locale: string;
+    typeHandlers: Record<string, TypeHandler>;
+    /**
+     * Formats an ICU message syntax string using `values` for placeholder data
+     * and any currently-registered type handlers.
+     *
+     * @type {(message: string, values?: FormatValues) => string}
+     */
+    format: (message: string, values?: FormatValues) => string;
+    /**
+     * Process an ICU message syntax string using `values` for placeholder data
+     * and any currently-registered type handlers.  The result of this method is
+     * an array of the component parts after they have been processed in turn by
+     * their own type handlers.  This raw output is useful for other renderers,
+     * eg: React where components can be used instead of being forced to return
+     * raw strings.
+     *
+     * This method is used by {@link MessageFormatter#format} where it acts as a
+     * string renderer.
+     *
+     * @param {string} message
+     * @param {FormatValues} [values]
+     * @return {any[]}
+     */
+    process(message: string, values?: FormatValues): any[];
+}
+/**
+ * Finds the index of the matching closing curly bracket, including through
+ * strings that could have nested brackets.
+ *
+ * @param {string} string
+ * @param {number} fromIndex
+ * @return {number}
+ *   The index of the matching closing bracket, or -1 if no closing bracket
+ *   could be found.
+ */
+export function findClosingBracket(string: string, fromIndex: number): number;
+/**
+ * @typedef ParseCasesResult
+ * @property {string[]} args
+ *   A list of prepended arguments.
+ * @property {Record<string,string>} cases
+ *   A map of all cases.
+ */
+/**
+ * Most branch-based type handlers are based around "cases".  For example,
+ * `select` and `plural` compare compare a value to "case keys" to choose a
+ * subtranslation.
+ *
+ * This util splits "matches" portions provided to the aforementioned handlers
+ * into case strings, and extracts any prepended arguments (for example,
+ * `plural` supports an `offset:n` argument used for populating the magic `#`
+ * variable).
+ *
+ * @param {string} string
+ * @return {ParseCasesResult}
+ */
+export function parseCases(string?: string): ParseCasesResult;
+/**
+ * Handler for `plural` statements within ICU message syntax strings.  Returns
+ * a formatted string for the branch that closely matches the current value.
+ *
+ * See https://formatjs.io/docs/core-concepts/icu-syntax#plural-format for more
+ * details on how the `plural` statement works.
+ *
+ * @param {string} value
+ * @param {string} matches
+ * @param {string} locale
+ * @param {import('./MessageFormatter.js').FormatValues} values
+ * @param {import('./MessageFormatter.js').ProcessFunction} process
+ * @return {any | any[]}
+ */
+export function pluralTypeHandler(value: string, matches: string, locale: string, values: any, process: any): any | any[];
+/**
+ * Handler for `select` statements within ICU message syntax strings.  Returns
+ * a formatted string for the branch that closely matches the current value.
+ *
+ * See https://formatjs.io/docs/core-concepts/icu-syntax#select-format for more
+ * details on how the `select` statement works.
+ *
+ * @param {string} value
+ * @param {string} matches
+ * @param {string} locale
+ * @param {import('./MessageFormatter.js').FormatValues} values
+ * @param {import('./MessageFormatter.js').ProcessFunction} process
+ * @return {any | any[]}
+ */
+export function selectTypeHandler(value: string, matches: string, locale: string, values: any, process: any): any | any[];
+/**
+ * Split a `{key, type, format}` block into those 3 parts, taking into account
+ * nested message syntax that can exist in the `format` part.
+ *
+ * @param {string} block
+ * @return {string[]}
+ *   An array with `key`, `type`, and `format` items in that order, if present
+ *   in the formatted argument block.
+ */
+export function splitFormattedArgument(block: string): string[];

package/dist/icu-message-formatter.d.ts

@@ -1,3 +1,16 @@
+export type ParseCasesResult = {
+    /**
+     *   A list of prepended arguments.
+     */
+    args: string[];
+    /**
+     *   A map of all cases.
+     */
+    cases: Record<string, string>;
+};
+export type FormatValues = Record<string, any>;
+export type ProcessFunction = (message: string, values?: FormatValues) => any[];
+export type TypeHandler = (value: any, matches: string, locale: string, values: FormatValues, process: ProcessFunction) => any | any[];
 /**
  * @typedef {Record<string,any>} FormatValues
  */
@@ -28,7 +41,7 @@
  *
  * @author Emanuel Rabina
  */
-declare class MessageFormatter {
+export class MessageFormatter {
     /**
      * Creates a new formatter that can work using any of the custom type handlers
      * you register.
@@ -66,10 +79,38 @@ declare class MessageFormatter {
      */
     process(message: string, values?: FormatValues): any[];
 }
-type FormatValues = Record<string, any>;
-type ProcessFunction = (message: string, values?: FormatValues) => any[];
-type TypeHandler = (value: any, matches: string, locale: string, values: FormatValues, process: ProcessFunction) => any | any[];
-
+/**
+ * Finds the index of the matching closing curly bracket, including through
+ * strings that could have nested brackets.
+ *
+ * @param {string} string
+ * @param {number} fromIndex
+ * @return {number}
+ *   The index of the matching closing bracket, or -1 if no closing bracket
+ *   could be found.
+ */
+export function findClosingBracket(string: string, fromIndex: number): number;
+/**
+ * @typedef ParseCasesResult
+ * @property {string[]} args
+ *   A list of prepended arguments.
+ * @property {Record<string,string>} cases
+ *   A map of all cases.
+ */
+/**
+ * Most branch-based type handlers are based around "cases".  For example,
+ * `select` and `plural` compare compare a value to "case keys" to choose a
+ * subtranslation.
+ *
+ * This util splits "matches" portions provided to the aforementioned handlers
+ * into case strings, and extracts any prepended arguments (for example,
+ * `plural` supports an `offset:n` argument used for populating the magic `#`
+ * variable).
+ *
+ * @param {string} string
+ * @return {ParseCasesResult}
+ */
+export function parseCases(string?: string): ParseCasesResult;
 /**
  * Handler for `plural` statements within ICU message syntax strings.  Returns
  * a formatted string for the branch that closely matches the current value.
@@ -84,8 +125,7 @@ type TypeHandler = (value: any, matches: string, locale: string, values: FormatV
  * @param {import('./MessageFormatter.js').ProcessFunction} process
  * @return {any | any[]}
  */
-declare function pluralTypeHandler(value: string, matches: string, locale: string, values: FormatValues, process: ProcessFunction): any | any[];
-
+export function pluralTypeHandler(value: string, matches: string, locale: string, values: any, process: any): any | any[];
 /**
  * Handler for `select` statements within ICU message syntax strings.  Returns
  * a formatted string for the branch that closely matches the current value.
@@ -100,40 +140,7 @@ declare function pluralTypeHandler(value: string, matches: string, locale: strin
  * @param {import('./MessageFormatter.js').ProcessFunction} process
  * @return {any | any[]}
  */
-declare function selectTypeHandler(value: string, matches: string, locale: string, values: FormatValues, process: ProcessFunction): any | any[];
-
-/**
- * @typedef ParseCasesResult
- * @property {string[]} args
- *   A list of prepended arguments.
- * @property {Record<string,string>} cases
- *   A map of all cases.
- */
-/**
- * Most branch-based type handlers are based around "cases".  For example,
- * `select` and `plural` compare compare a value to "case keys" to choose a
- * subtranslation.
- *
- * This util splits "matches" portions provided to the aforementioned handlers
- * into case strings, and extracts any prepended arguments (for example,
- * `plural` supports an `offset:n` argument used for populating the magic `#`
- * variable).
- *
- * @param {string} string
- * @return {ParseCasesResult}
- */
-declare function parseCases(string?: string): ParseCasesResult;
-/**
- * Finds the index of the matching closing curly bracket, including through
- * strings that could have nested brackets.
- *
- * @param {string} string
- * @param {number} fromIndex
- * @return {number}
- *   The index of the matching closing bracket, or -1 if no closing bracket
- *   could be found.
- */
-declare function findClosingBracket(string: string, fromIndex: number): number;
+export function selectTypeHandler(value: string, matches: string, locale: string, values: any, process: any): any | any[];
 /**
  * Split a `{key, type, format}` block into those 3 parts, taking into account
  * nested message syntax that can exist in the `format` part.
@@ -143,16 +150,4 @@ declare function findClosingBracket(string: string, fromIndex: number): number;
  *   An array with `key`, `type`, and `format` items in that order, if present
  *   in the formatted argument block.
  */
-declare function splitFormattedArgument(block: string): string[];
-type ParseCasesResult = {
-    /**
-     *   A list of prepended arguments.
-     */
-    args: string[];
-    /**
-     *   A map of all cases.
-     */
-    cases: Record<string, string>;
-};
-
-export { MessageFormatter, findClosingBracket, parseCases, pluralTypeHandler, selectTypeHandler, splitFormattedArgument };
+export function splitFormattedArgument(block: string): string[];