txt: ## dist_zef-guifa-Intl-Token-Number.md
  # Intl::Token::Number
  
  A regex token for detecting localized numbers
  
  To use, simply include the token `<local-number>` in anything interpreted as regex.
  
  ```
  use Intl::Token::Number;
  
  # (assuming English)
  if '15,859,333.41' ~~ /<local-number>/ {
      say ~$<local-number>;  # 15,859,333.41   <-- stringified
      say +$<local-number>;  # 15859333.41     <-- numerical
  }
  
  ```
  
  The `<local-number>` token defaults to using the language provided by `user-language`.
  This makes it quite useful for parsing CLI. Sometimes, though, you'll want / need to specify the language directly.
  Just include it after a colon:
  
  ```
  # Korean uses commas to separate thousands
  '1,234' ~~ /<local-number: 'ko'>/;
  say +$<local-number>; # 1234
  
  # Spanish uses commas to separate integers from fractionals
  '1,234' ~~ /<local-number: 'es'>/;
  say +$<local-number>; # 1.234
  
  ```
  
  Formats including percents, permilles, and exponential notation are supported:
  
  ```
  # Assuming English
  '90%' ~~ /<local-number>/;
  say +$<local-number>; # 0.9
  
  '1.23E3' ~~ /<local-number>/;
  say +$<local-number>; # 123
  
  ```
  
  For those interested in details about the match, the match object is introspectable:
  
  * `base-number`: the number matched, ignoring percent/exponential modifiers
  * `exponent`: the exponent used (defaults to 1 for non-exponential numbers)
  * `number-type`: any of `standard`, `percent`, `permille`, `exponential`
  
  ## To do
  
  * Add support for native/traditional/financial-style numbers
  * Add support for lenient parsing (e.g. accept any of `<,٫⹁︐﹐，>` for `,`).
    * This will be very important for languages like Finnish, which uses a non-breaking space, but is probably entered as a plain space by most people.
  * Enforce grouping digits? Present, *1,2,3,4* will parse as *1234*.
  * Additional formats like approximately, at least, etc.
  
  ## Version history
  
  * **v0.6**
    * Optimized grammar
    * Now uses RakuAST for generation.
    * Match role provides more introspection
    * Now prefer `User::Language` to `Intl::UserLanguage`
  * **v.0.5.0**
    * First published version as an independent module
    * Adapted to work with newest version of `Intl::CLDR`
    * Housekeeping
      * Cleaned up code, added documentation, improved tests
  * **v.0.4.2**
    * Renamed to **Intl::CLDR::Numbers**
  * **v.0.4.1**
    * Published as a part of `Intl::CLDR` (as `Intl::CLDR::Numbers::NumberFinder`)
    * Support for basic number parsing using default numeric systems
  