{"_id":"string-mask","_rev":"15-5ebb398bdda61233bdfb1f3cb2dcd184","name":"string-mask","description":"A string formatter and validator based on masks","dist-tags":{"latest":"0.3.0","0.1.1":"0.1.1"},"versions":{"0.0.0":{"name":"string-mask","version":"0.0.0","description":"A string formatter and validator based on masks","id":"/string-mask","main":"src/string-mask.js","repository":{"type":"git","url":"https://github.com/the-darc/string-mask.git"},"bugs":{"url":"https://github.com/the-darc/string-mask/issues"},"scripts":{"test":"gulp test"},"keywords":["mask","formatter","string","validator","validation"],"author":{"name":"Daniel Campos","email":"darc.tec@gmail.com"},"license":"MIT","dependencies":{},"devDependencies":{"gulp":"^3.7.0","gulp-jshint":"^1.6.1","gulp-spawn-mocha":"^0.1.4","jshint-stylish":"^0.2.0","should":"^4.0.1"},"homepage":"https://github.com/the-darc/string-mask","_id":"string-mask@0.0.0","_shasum":"ada2c0e4f6779ba79bffa1477169b224536a5642","_from":".","_npmVersion":"1.4.9","_npmUser":{"name":"the-darc","email":"darc.tec@gmail.com"},"maintainers":[{"name":"the-darc","email":"darc.tec@gmail.com"}],"dist":{"shasum":"ada2c0e4f6779ba79bffa1477169b224536a5642","tarball":"https://registry.npmjs.org/string-mask/-/string-mask-0.0.0.tgz","integrity":"sha512-ZalglKkWJurDloAoFUwHSI44PIDzk49ESSSg1U5uR8dJ1baydXbOCTctKeuifeKhza1h6vhZYHEMXkM0epitBQ==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIBNHswnmEe9I/g+pT9lSQTWa8icOI/bqgquG/Hz2avdvAiA37rqnJ3gjIMRxocrSxit7NetFAfK6yzwf3YI5hXdjCw=="}]}},"0.0.1":{"name":"string-mask","version":"0.0.1","description":"A string formatter and validator based on masks","id":"/string-mask","main":"src/string-mask.js","repository":{"type":"git","url":"https://github.com/the-darc/string-mask.git"},"bugs":{"url":"https://github.com/the-darc/string-mask/issues"},"scripts":{"test":"gulp test"},"keywords":["mask","formatter","string","validator","validation"],"author":{"name":"Daniel Campos","email":"darc.tec@gmail.com"},"license":"MIT","dependencies":{},"devDependencies":{"gulp":"^3.7.0","gulp-jshint":"^1.6.1","gulp-spawn-mocha":"^0.1.4","jshint-stylish":"^0.2.0","should":"^4.0.1"},"homepage":"https://github.com/the-darc/string-mask","_id":"string-mask@0.0.1","_shasum":"ea8c3655470d425cbef3a0b524ca00508baa69f8","_from":".","_npmVersion":"1.4.9","_npmUser":{"name":"the-darc","email":"darc.tec@gmail.com"},"maintainers":[{"name":"the-darc","email":"darc.tec@gmail.com"}],"dist":{"shasum":"ea8c3655470d425cbef3a0b524ca00508baa69f8","tarball":"https://registry.npmjs.org/string-mask/-/string-mask-0.0.1.tgz","integrity":"sha512-URPQGBifmug92eg8Q/mVHifoH2WJkmDGnqTkjughGly+q+BYEYLE+MKNjzmuzlcpVNmaKwGsDl0KEIaY0em9xQ==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDN+g7PsxzP7d7qo599AaGj+AWvhrf2wix4PaCMZ2hvvQIhAJ3G/0ecrmV+0gqAQb9MiMOAkBKUAu8xwwPODV0bn7Nc"}]}},"0.1.1":{"name":"string-mask","version":"0.1.1","description":"A string formatter and validator based on masks","id":"/string-mask","main":"src/string-mask.js","repository":{"type":"git","url":"https://github.com/the-darc/string-mask.git"},"bugs":{"url":"https://github.com/the-darc/string-mask/issues"},"scripts":{"test":"gulp test"},"keywords":["mask","formatter","string","validator","validation"],"author":{"name":"Daniel Campos","email":"darc.tec@gmail.com"},"license":"MIT","dependencies":{},"devDependencies":{"gulp":"^3.7.0","gulp-jshint":"^1.6.1","gulp-spawn-mocha":"^0.1.4","jshint-stylish":"^0.2.0","should":"^4.0.1"},"homepage":"https://github.com/the-darc/string-mask","_id":"string-mask@0.1.1","_shasum":"adcc96cc297183246274da26eedf45e9bc375827","_from":"./","_npmVersion":"1.4.9","_npmUser":{"name":"the-darc","email":"darc.tec@gmail.com"},"maintainers":[{"name":"the-darc","email":"darc.tec@gmail.com"}],"dist":{"shasum":"adcc96cc297183246274da26eedf45e9bc375827","tarball":"https://registry.npmjs.org/string-mask/-/string-mask-0.1.1.tgz","integrity":"sha512-6qK3aAh9QGwSNd32w8GLosh2FmH2uFS7krjv/Fypki5wHGChzPgSnmND3Xru6VQCN7r4kPU50DVy8UxMIzcYKQ==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCICpla6bN2l9t6b464LyvSEJ9GfNThQoW0xFna19wjQJ0AiAtAAq+otoOd9uXzURzHvfVl9f7HzbLcAvBnxCJqRRkhQ=="}]}},"0.2.0":{"name":"string-mask","version":"0.2.0","description":"A string formatter and validator based on masks","id":"/string-mask","main":"src/string-mask.js","repository":{"type":"git","url":"https://github.com/the-darc/string-mask.git"},"bugs":{"url":"https://github.com/the-darc/string-mask/issues"},"scripts":{"test":"gulp test"},"keywords":["mask","formatter","string","validator","validation"],"author":{"name":"Daniel Campos","email":"darc.tec@gmail.com"},"license":"MIT","dependencies":{},"devDependencies":{"gulp":"^3.7.0","gulp-jshint":"^1.6.1","gulp-spawn-mocha":"^0.1.4","jshint-stylish":"^0.2.0","should":"^4.0.1"},"homepage":"https://github.com/the-darc/string-mask","_id":"string-mask@0.2.0","_shasum":"8648ab5561d4e63848160792e54d799a3f109d49","_from":".","_npmVersion":"1.4.9","_npmUser":{"name":"the-darc","email":"darc.tec@gmail.com"},"maintainers":[{"name":"the-darc","email":"darc.tec@gmail.com"}],"dist":{"shasum":"8648ab5561d4e63848160792e54d799a3f109d49","tarball":"https://registry.npmjs.org/string-mask/-/string-mask-0.2.0.tgz","integrity":"sha512-N3PvCR+NeI8iFoXofQmtP9dpP/36ZLQ/rFJDrTgDaNqQErbdGLEiVpOrCNT4Bl0aK1PP+YyPGFSe2YFzOyDL6A==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIF5CsOKrmwE+ZWzWmarRQlQ9n2phLxKX3CG1xqnnK2FAAiA/u8WMBw/o73gVWeC1FJv3Kzxo6aL/ZVjPd4PhG7NyXQ=="}]}},"0.2.1":{"name":"string-mask","version":"0.2.1","description":"A string formatter and validator based on masks","id":"/string-mask","main":"src/string-mask.js","repository":{"type":"git","url":"https://github.com/the-darc/string-mask.git"},"bugs":{"url":"https://github.com/the-darc/string-mask/issues"},"scripts":{"test":"gulp test"},"keywords":["mask","formatter","string","validator","validation"],"author":{"name":"Daniel Campos","email":"darc.tec@gmail.com"},"license":"MIT","dependencies":{},"devDependencies":{"gulp":"^3.7.0","gulp-jshint":"^1.6.1","gulp-spawn-mocha":"^0.1.4","jshint-stylish":"^0.2.0","should":"^4.0.1"},"gitHead":"6f555714f8e0c282d9e3c958c4b9111ad44febb3","homepage":"https://github.com/the-darc/string-mask","_id":"string-mask@0.2.1","_shasum":"e86ddfc786e56208ba42afc934156d7f36abfbfe","_from":".","_npmVersion":"2.7.4","_nodeVersion":"0.10.28","_npmUser":{"name":"the-darc","email":"darc.tec@gmail.com"},"maintainers":[{"name":"the-darc","email":"darc.tec@gmail.com"}],"dist":{"shasum":"e86ddfc786e56208ba42afc934156d7f36abfbfe","tarball":"https://registry.npmjs.org/string-mask/-/string-mask-0.2.1.tgz","integrity":"sha512-G4a/olwXeX2Q+3AeE+VCtnNnjZQVMH5DsXPNnWIfyznfrrrF0peQ3tHEcAiRtjv8kKnAVNpnyvrjSIP0/Wfemw==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDSYBioBWTr7tqi6Vk/pxPb/HqA9rs/H2jtfAU6GIifLwIhALIWQfN0MXYp8KlxJusxl4/XkPa46ErzpIgANkcVtURJ"}]}},"0.3.0":{"name":"string-mask","version":"0.3.0","description":"A string formatter and validator based on masks","id":"/string-mask","main":"src/string-mask.js","repository":{"type":"git","url":"git+https://github.com/the-darc/string-mask.git"},"bugs":{"url":"https://github.com/the-darc/string-mask/issues"},"scripts":{"test":"gulp test-coverage","release":"conventional-changelog -p angular -i CHANGELOG.md -s"},"keywords":["mask","formatter","string","validator","validation"],"author":{"name":"Daniel Campos","email":"darc.tec@gmail.com"},"license":"MIT","dependencies":{},"devDependencies":{"gulp":"^3.7.0","gulp-coveralls":"^0.1.4","gulp-istanbul":"^0.9.0","gulp-istanbul-enforcer":"^1.0.3","gulp-jscs":"^3.0.2","gulp-jshint":"^2.0.0","gulp-load-plugins":"^0.10.0","gulp-mocha":"^2.0.1","jshint-stylish":"^0.2.0","should":"^4.0.1"},"gitHead":"3c51e47fe5a029ec7f921113d3ec3e8fbd3b100f","homepage":"https://github.com/the-darc/string-mask#readme","_id":"string-mask@0.3.0","_shasum":"9e7244b87bb2f6f9647e2ac98f96fa1a57c21198","_from":".","_npmVersion":"2.14.18","_nodeVersion":"4.3.1","_npmUser":{"name":"the-darc","email":"darc.tec@gmail.com"},"dist":{"shasum":"9e7244b87bb2f6f9647e2ac98f96fa1a57c21198","tarball":"https://registry.npmjs.org/string-mask/-/string-mask-0.3.0.tgz","integrity":"sha512-YR93J2lCJyA9GYDHoPk2Yzykw6zc/A2KkcRchSMuLo9tTKDfawqrU/sGf2kxGelPyYTAgQ4j5MLWob/7tJ68bg==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDg7h5p0RygUXKiPZ7iB0B1k1vkYS3+Liddj57vdue+2wIgKZMe82jU9BXAO4o8UA4z2HjMLpgoZQWmS2vQPefFlag="}]},"maintainers":[{"name":"the-darc","email":"darc.tec@gmail.com"}],"_npmOperationalInternal":{"host":"packages-12-west.internal.npmjs.com","tmp":"tmp/string-mask-0.3.0.tgz_1459566372698_0.14211641415022314"}}},"readme":"#string-mask\n[![npm version](https://badge.fury.io/js/string-mask.svg)](http://badge.fury.io/js/string-mask)\n[![Bower version](https://badge.fury.io/bo/string-mask.svg)](http://badge.fury.io/bo/string-mask)\n[![Build Status](https://travis-ci.org/the-darc/string-mask.svg?branch=master)](https://travis-ci.org/the-darc/string-mask)\n[![Coverage Status](https://coveralls.io/repos/the-darc/string-mask/badge.svg)](https://coveralls.io/r/the-darc/string-mask)\n\nA string formatter and validator based on masks.\n\n## INSTALLATION\n\n**With npm:**\n\n```javascript\nnpm install --save string-mask\n```\n\n**With bower:**\n\n```javascript\nbower install --save string-mask\n```\n## SPECIAL MASK CHARACTERS\n\nCharacter | Description\n--- | ---\n`0` | Any numbers\n`9` | Any numbers (Optional)\n`#` | Any numbers (recursive)\n`A` | Any alphanumeric character\n`a` | Any alphanumeric character (Optional) __Not implemented yet__\n`S` | Any letter\n`U` | Any letter (All lower case character will be mapped to uppercase)\n`L` | Any letter (All upper case character will be mapped to lowercase)\n`$` | Escape character, used to escape any of the special formatting characters.\n\n### Special characters types\n\n - **Optional characters:** Used to parse characters that cold exist in the source string or not. See [Date and time](#date-and-time).\n\n - **Recursive characters:** Used to parse patterns that repeat in the end or in the start of the source string. See [Two decimal number with thousands separators](#two-decimal-number-with-thousands-separators)\n\n> _Note: Any character of the mask positioned after a recursive character will be handled as a non special character._\n\n## USAGE\n\n **Use it creating an mask instance with the StringMask contructor:**\n\n```javascript\n/**\n * - optionsObject parameter is optional in the constructor\n * - apply will return the a masked string value\n * - validate will return `true` if the string matchs the mask\n */\nvar mask = new StringMask('some mask', optionsObject); //optionsObject is optional\nvar maskedValue = mask.apply('some value string');\nvar isValid = mask.validate('some value string to validate');\n```\n\n**Or by the static interface:**\n\n```javascript\n/**\n * - optionsObject parameter is optional in all methods\n * - apply will return the a masked string value\n * - validate will return `true` if the string matchs the mask\n * - process will return a object: {result: <maskedValue>, valid: <isValid>}\n */\nvar maskedValue = StringMask.apply('some value string', 'some mask', optionsObject); \nvar isValid = StringMask.validate('some value string', 'some mask', optionsObject);\nvar result = StringMask.process('some value string', 'some mask', optionsObject);\n```\n\n\n### Some masks examples\n\n#### Number\n\n```javascript\n\tvar formatter = new StringMask('#0');\n\tvar result = formatter.apply('123'); // 123\n```\n\n#### Two decimal number with thousands separators\n\n```javascript\n\tvar formatter = new StringMask('#.##0,00', {reverse: true});\n\tvar result = formatter.apply('100123456'); // 1.001.234,56\n\tresult = formatter.apply('6'); // 0,06\n```\n\n#### Phone number\n\n```javascript\n\tvar formatter = new StringMask('+00 (00) 0000-0000');\n\tvar result = formatter.apply('553122222222'); // +55 (31) 2222-2222\n```\n\n#### Percentage\n\n```javascript\n\tvar formatter = new StringMask('#0,00%');\n\tvar result = formatter.apply('001'); // 0,01%\n```\n\n#### Brazilian CPF number\n\n```javascript\n\tvar formatter = new StringMask('000.000.000-00');\n\tvar result = formatter.apply('12965815620'); // 129.658.156-20\n```\n\n#### Date and time\n\n```javascript\n\tvar formatter = new StringMask('90/90/9900');\n\tvar result = formatter.apply('1187'); // 1/1/87\n```\n\n#### Convert Case\n\n```javascript\n\tvar formatter = new StringMask('UUUUUUUUUUUUU');\n\tvar result = formatter.apply('To Upper Case'); // TO UPPER CASE\n```\n\n```javascript\n\tvar formatter = new StringMask('LLLLLLLLLLLLL');\n\tvar result = formatter.apply('To Lower Case'); // to lower case\n```\n\n#### International Bank Number\n\n```javascript\n\tvar formatter = new StringMask('UUAA AAAA AAAA AAAA AAAA AAAA AAA');\n\tvar result = formatter.apply('FR761111900069410000AA33222');\n\t// result: FR76 1111 BBBB 6941 0000 AA33 222\n```\n\n## CONTRIBUTING\n\nWe'd love for you to contribute to our source code! We just ask to: \n\n - Write tests for the new feature or bug fix that you are solving\n - Ensure all tests pass before send the pull-request (Use: `$ gulp pre-push`)\n - Use commit messages following the commit conventions of [angular.js Git Commit Guidelines](https://github.com/angular/angular.js/blob/master/CONTRIBUTING.md#commit)\n - Pull requests will not be merged if:\n   - has not unit tests\n   - reduce the code coverage\n   - not passing in the `$gulp pre-push` task\n\n## LICENSE\n\nCopyright (c) 2016 Daniel Campos\n\nLicensed under the MIT license.\n  \n  \n\n","maintainers":[{"name":"the-darc","email":"darc.tec@gmail.com"}],"time":{"modified":"2022-06-27T01:01:58.883Z","created":"2014-06-09T20:41:14.966Z","0.0.0":"2014-06-09T20:41:14.966Z","0.0.1":"2014-06-09T20:44:21.254Z","0.1.1":"2014-11-20T13:37:58.923Z","0.2.0":"2014-12-15T21:22:36.879Z","0.2.1":"2015-05-11T14:29:07.830Z","0.3.0":"2016-04-02T03:06:15.118Z"},"homepage":"https://github.com/the-darc/string-mask#readme","keywords":["mask","formatter","string","validator","validation"],"repository":{"type":"git","url":"git+https://github.com/the-darc/string-mask.git"},"author":{"name":"Daniel Campos","email":"darc.tec@gmail.com"},"bugs":{"url":"https://github.com/the-darc/string-mask/issues"},"license":"MIT","readmeFilename":"README.md","users":{"the-darc":true,"xian":true}}