compromise

modest natural language processing

npm install compromise

_{by Spencer Kelly and many contributors}

_{french • german • italian • spanish}

compromise tries its best to turn text into data.
it makes limited and sensible decisions.
_{it's not as smart as you'd think.}

import nlp from 'compromise'

let doc = nlp('she sells seashells by the seashore.')
doc.verbs().toPastTense()
doc.text()
// 'she sold seashells by the seashore.'

if (doc.has('simon says #Verb')) {
  return true
}

let doc = nlp(entireNovel)
doc.match('the #Adjective of times').text()
// "the blurst of times?"

and get data:

import plg from 'compromise-speech'
nlp.extend(plg)

let doc = nlp('Milwaukee has certainly had its share of visitors..')
doc.compute('syllables')
doc.places().json()
/*
[{
  "text": "Milwaukee",
  "terms": [{
    "normal": "milwaukee",
    "syllables": ["mil", "wau", "kee"]
  }]
}]
*/

avoid the problems of brittle parsers:

let doc = nlp("we're not gonna take it..")

doc.has('gonna') // true
doc.has('going to') // true (implicit)

// transform
doc.contractions().expand()
doc.text()
// 'we are not going to take it..'

and whip stuff around like it's data:

let doc = nlp('ninety five thousand and fifty two')
doc.numbers().add(20)
doc.text()
// 'ninety five thousand and seventy two'

_{-because it actually is-}

let doc = nlp('the purple dinosaur')
doc.nouns().toPlural()
doc.text()
// 'the purple dinosaurs'

Use it on the client-side:

<script src="https://unpkg.com/compromise"></script>
<script>
  var doc = nlp('two bottles of beer')
  doc.numbers().minus(1)
  document.body.innerHTML = doc.text()
  // 'one bottle of beer'
</script>

or likewise:

import nlp from 'compromise'

var doc = nlp('London is calling')
doc.verbs().toNegative()
// 'London is not calling'

compromise is ~250kb (minified):

it's pretty fast. It can run on keypress:

it works mainly by conjugating all forms of a basic word list.

The final lexicon is ~14,000 words:

you can read more about how it works, here. it's weird.

_{okay -}

compromise/one

A tokenizer of words, sentences, and punctuation.

import nlp from 'compromise/one'

let doc = nlp("Wayne's World, party time")
let data = doc.json()
/* [{
  normal:"wayne's world party time",
    terms:[{ text: "Wayne's", normal: "wayne" },
      ...
      ]
  }]
*/

compromise/one splits your text up, wraps it in a handy API,

_{and does nothing else -}

/one is quick - most sentences take a 10th of a millisecond.

It can do ~1mb of text a second - or 10 wikipedia pages.

Infinite jest takes 3s.

compromise/two

A part-of-speech tagger, and grammar-interpreter.

import nlp from 'compromise/two'

let doc = nlp("Wayne's World, party time")
let str = doc.match('#Possessive #Noun').text()
// "Wayne's World"

_{this is more useful than people sometimes realize.}

Light grammar helps you write cleaner templates, and get closer to the information.

compromise has 83 tags, arranged in a handsome graph.

#FirstName → #Person → #ProperNoun → #Noun

you can see the grammar of each word by running doc.debug()

you can see the reasoning for each tag with nlp.verbose('tagger').

if you prefer Penn tags, you can derive them with:

let doc = nlp('welcome thrillho')
doc.compute('penn')
doc.json()

compromise/three

Phrase and sentence tooling.

import nlp from 'compromise/three'

let doc = nlp("Wayne's World, party time")
let str = doc.people().normalize().text()
// "wayne"

compromise/three is a set of tooling to zoom into and operate on parts of a text.

.numbers() grabs all the numbers in a document, for example - and extends it with new methods, like .subtract().

When you have a phrase, or group of words, you can see additional metadata about it with .json()

let doc = nlp('four out of five dentists')
console.log(doc.fractions().json())
/*[{
    text: 'four out of five',
    terms: [ [Object], [Object], [Object], [Object] ],
    fraction: { numerator: 4, denominator: 5, decimal: 0.8 }
  }
]*/

let doc = nlp('$4.09CAD')
doc.money().json()
/*[{
    text: '$4.09CAD',
    terms: [ [Object] ],
    number: { prefix: '$', num: 4.09, suffix: 'cad'}
  }
]*/

API

Compromise/one

Output

• .text() - return the document as text
• .json() - return the document as data
• .debug() - pretty-print the interpreted document
• .out() - a named or custom output
• .html({}) - output custom html tags for matches
• .wrap({}) - produce custom output for document matches

Utils

• .found [getter] - is this document empty?
• .docs [getter] get term objects as json
• .length [getter] - count the # of characters in the document (string length)
• .isView [getter] - identify a compromise object
• .compute() - run a named analysis on the document
• .clone() - deep-copy the document, so that no references remain
• .termList() - return a flat list of all Term objects in match
• .cache({}) - freeze the current state of the document, for speed-purposes
• .uncache() - un-freezes the current state of the document, so it may be transformed
• .freeze({}) - prevent any tags from being removed, in these terms
• .unfreeze({}) - allow tags to change again, as default

Accessors

• .all() - return the whole original document ('zoom out')
• .terms() - split-up results by each individual term
• .first(n) - use only the first result(s)
• .last(n) - use only the last result(s)
• .slice(n,n) - grab a subset of the results
• .eq(n) - use only the nth result
• .firstTerms() - get the first word in each match
• .lastTerms() - get the end word in each match
• .fullSentences() - get the whole sentence for each match
• .groups() - grab any named capture-groups from a match
• .wordCount() - count the # of terms in the document
• .confidence() - an average score for pos tag interpretations

Match

(match methods use the match-syntax.)

• .match('') - return a new Doc, with this one as a parent
• .not('') - return all results except for this
• .matchOne('') - return only the first match
• .if('') - return each current phrase, only if it contains this match ('only')
• .ifNo('') - Filter-out any current phrases that have this match ('notIf')
• .has('') - Return a boolean if this match exists
• .before('') - return all terms before a match, in each phrase
• .after('') - return all terms after a match, in each phrase
• .union() - return combined matches without duplicates
• .intersection() - return only duplicate matches
• .complement() - get everything not in another match
• .settle() - remove overlaps from matches
• .growRight('') - add any matching terms immediately after each match
• .growLeft('') - add any matching terms immediately before each match
• .grow('') - add any matching terms before or after each match
• .sweep(net) - apply a series of match objects to the document
• .splitOn('') - return a Document with three parts for every match ('splitOn')
• .splitBefore('') - partition a phrase before each matching segment
• .splitAfter('') - partition a phrase after each matching segment
• .join() - merge any neighbouring terms in each match
• .joinIf(leftMatch, rightMatch) - merge any neighbouring terms under given conditions
• .lookup([]) - quick find for an array of string matches
• .autoFill() - create type-ahead assumptions on the document

Tag

• .tag('') - Give all terms the given tag
• .tagSafe('') - Only apply tag to terms if it is consistent with current tags
• .unTag('') - Remove this term from the given terms
• .canBe('') - return only the terms that can be this tag

Case

• .toLowerCase() - turn every letter of every term to lower-cse
• .toUpperCase() - turn every letter of every term to upper case
• .toTitleCase() - upper-case the first letter of each term
• .toCamelCase() - remove whitespace and title-case each term

Whitespace

• .pre('') - add this punctuation or whitespace before each match
• .post('') - add this punctuation or whitespace after each match
• .trim() - remove start and end whitespace
• .hyphenate() - connect words with hyphen, and remove whitespace
• .dehyphenate() - remove hyphens between words, and set whitespace
• .toQuotations() - add quotation marks around these matches
• .toParentheses() - add brackets around these matches

Loops

• .map(fn) - run each phrase through a function, and create a new document
• .forEach(fn) - run a function on each phrase, as an individual document
• .filter(fn) - return only the phrases that return true
• .find(fn) - return a document with only the first phrase that matches
• .some(fn) - return true or false if there is one matching phrase
• .random(fn) - sample a subset of the results

Insert

• .replace(match, replace) - search and replace match with new content
• .replaceWith(replace) - substitute-in new text
• .remove() - fully remove these terms from the document
• .insertBefore(str) - add these new terms to the front of each match (prepend)
• .insertAfter(str) - add these new terms to the end of each match (append)
• .concat() - add these new things to the end
• .swap(fromLemma, toLemma) - smart replace of root-words,using proper conjugation

Transform

• .sort('method') - re-arrange the order of the matches (in place)
• .reverse() - reverse the order of the matches, but not the words
• .normalize({}) - clean-up the text in various ways
• .unique() - remove any duplicate matches

Lib

(these methods are on the main nlp object)

• nlp.tokenize(str) - parse text without running POS-tagging
• nlp.lazy(str, match) - scan through a text with minimal analysis
• nlp.plugin({}) - mix in a compromise-plugin
• nlp.parseMatch(str) - pre-parse any match statements into json
• nlp.world() - grab or change library internals
• nlp.model() - grab all current linguistic data
• nlp.methods() - grab or change internal methods
• nlp.hooks() - see which compute methods run automatically
• nlp.verbose(mode) - log our decision-making for debugging

• nlp.version - current semver version of the library

• nlp.addWords(obj, isFrozen?) - add new words to the lexicon

• nlp.addTags(obj) - add new tags to the tagSet
• nlp.typeahead(arr) - add words to the auto-fill dictionary
• nlp.buildTrie(arr) - compile a list of words into a fast lookup form
• nlp.buildNet(arr) - compile a list of matches into a fast match form

compromise/two:

Contractions

• .contractions() - things like "didn't"
• .contractions().expand() - things like "didn't"
• .contract() - things like "didn't"

compromise/three:

Nouns

• .nouns() - return any subsequent terms tagged as a Noun
  • .nouns().json() - overloaded output with noun metadata
  • .nouns().parse() - get tokenized noun-phrase
  • .nouns().isPlural() - return only plural nouns
  • .nouns().isSingular() - return only singular nouns
  • .nouns().toPlural() - 'football captain' → 'football captains'
  • .nouns().toSingular() - 'turnovers' → 'turnover'
  • .nouns().adjectives() - get any adjectives describing this noun

Verbs

• .verbs() - return any subsequent terms tagged as a Verb
  • .verbs().json() - overloaded output with verb metadata
  • .verbs().parse() - get tokenized verb-phrase
  • .verbs().subjects() - what is doing the verb action
  • .verbs().adverbs() - return the adverbs describing this verb.
  • .verbs().isSingular() - return singular verbs like 'spencer walks'
  • .verbs().isPlural() - return plural verbs like 'we walk'
  • .verbs().isImperative() - only instruction verbs like 'eat it!'
  • .verbs().toPastTense() - 'will go' → 'went'
  • .verbs().toPresentTense() - 'walked' → 'walks'
  • .verbs().toFutureTense() - 'walked' → 'will walk'
  • .verbs().toInfinitive() - 'walks' → 'walk'
  • .verbs().toGerund() - 'walks' → 'walking'
  • .verbs().toPastParticiple() - 'drive' → 'had driven'
  • .verbs().conjugate() - return all conjugations of these verbs
  • .verbs().isNegative() - return verbs with 'not', 'never' or 'no'
  • .verbs().isPositive() - only verbs without 'not', 'never' or 'no'
  • .verbs().toNegative() - 'went' → 'did not go'
  • .verbs().toPositive() - "didn't study" → 'studied'

Numbers

• .numbers() - grab all written and numeric values
  • .numbers().parse() - get tokenized number phrase
  • .numbers().get() - get a simple javascript number
  • .numbers().json() - overloaded output with number metadata
  • .numbers().toNumber() - convert 'five' to 5
  • .numbers().toLocaleString() - add commas, or nicer formatting for numbers
  • .numbers().toText() - convert '5' to five
  • .numbers().toOrdinal() - convert 'five' to fifth or 5th
  • .numbers().toCardinal() - convert 'fifth' to five or 5
  • .numbers().isOrdinal() - return only ordinal numbers
  • .numbers().isCardinal() - return only cardinal numbers
  • .numbers().isEqual(n) - return numbers with this value
  • .numbers().greaterThan(min) - return numbers bigger than n
  • .numbers().lessThan(max) - return numbers smaller than n
  • .numbers().between(min, max) - return numbers between min and max
  • .numbers().isUnit(unit) - return only numbers in the given unit, like 'km'
  • .numbers().set(n) - set number to n
  • .numbers().add(n) - increase number by n
  • .numbers().subtract(n) - decrease number by n
  • .numbers().increment() - increase number by 1
  • .numbers().decrement() - decrease number by 1
• .money() - things like '$2.50'
  • .money().get() - retrieve the parsed amount(s) of money
  • .money().json() - currency + number info
  • .money().currency() - which currency the money is in
• .fractions() - like '2/3rds' or 'one out of five'
  • .fractions().parse() - get tokenized fraction
  • .fractions().get() - simple numerator, denominator data
  • .fractions().json() - json method overloaded with fractions data
  • .fractions().toDecimal() - '2/3' -> '0.66'
  • .fractions().normalize() - 'four out of 10' -> '4/10'
  • .fractions().toText() - '4/10' -> 'four tenths'
  • .fractions().toPercentage() - '4/10' -> '40%'
• .percentages() - like '2.5%'
  • .percentages().get() - return the percentage number / 100
  • .percentages().json() - json overloaded with percentage information
  • .percentages().toFraction() - '80%' -> '8/10'

Sentences

• .sentences() - return a sentence class with additional methods
  • .sentences().json() - overloaded output with sentence metadata
  • .sentences().toPastTense() - he walks -> he walked
  • .sentences().toPresentTense() - he walked -> he walks
  • .sentences().toFutureTense() -- he walks -> he will walk
  • .sentences().toInfinitive() -- verb root-form he walks -> he walk
  • .sentences().toNegative() - - he walks -> he didn't walk
  • .sentences().isQuestion() - return questions with a ?
  • .sentences().isExclamation() - return sentences with a !
  • .sentences().isStatement() - return sentences without ? or !

Adjectives

• .adjectives() - things like 'quick'
  • .adjectives().json() - get adjective metadata
  • .adjectives().conjugate() - return all inflections of these adjectives
  • .adjectives().adverbs() - get adverbs describing this adjective
  • .adjectives().toComparative() - 'quick' -> 'quicker'
  • .adjectives().toSuperlative() - 'quick' -> 'quickest'
  • .adjectives().toAdverb() - 'quick' -> 'quickly'
  • .adjectives().toNoun() - 'quick' -> 'quickness'

Misc selections

• .clauses() - split-up sentences into multi-term phrases
• .chunks() - split-up sentences noun-phrases and verb-phrases
• .hyphenated() - all terms connected with a hyphen or dash like 'wash-out'
• .phoneNumbers() - things like '(939) 555-0113'
• .hashTags() - things like '#nlp'
• .emails() - things like `'hi@compromise.cool'`
• .emoticons() - things like :)
• .emojis() - things like 💋
• .atMentions() - things like '@nlp_compromise'
• .urls() - things like 'compromise.cool'
• .pronouns() - things like 'he'
• .conjunctions() - things like 'but'
• .prepositions() - things like 'of'
• .abbreviations() - things like 'Mrs.'
• .people() - names like 'John F. Kennedy'
  • .people().json() - get person-name metadata
  • .people().parse() - get person-name interpretation
• .places() - like 'Paris, France'
• .organizations() - like 'Google, Inc'
• .topics() - people() + places() + organizations()
• .adverbs() - things like 'quickly'
  • .adverbs().json() - get adverb metadata
• .acronyms() - things like 'FBI'
  • .acronyms().strip() - remove periods from acronyms
  • .acronyms().addPeriods() - add periods to acronyms
• .parentheses() - return anything inside (parentheses)
  • .parentheses().strip() - remove brackets
• .possessives() - things like "Spencer's"
  • .possessives().strip() - "Spencer's" -> "Spencer"
• .quotations() - return any terms inside paired quotation marks
  • .quotations().strip() - remove quotation marks
• .slashes() - return any terms grouped by slashes
  • .slashes().split() - turn 'love/hate' into 'love hate'

.extend():

This library comes with a considerate, common-sense baseline for english grammar.

You're free to change, or lay-waste to any settings - which is the fun part actually.

the easiest part is just to suggest tags for any given words:

let myWords = {
  kermit: 'FirstName',
  fozzie: 'FirstName',
}
let doc = nlp(muppetText, myWords)

or make heavier changes with a compromise-plugin.

import nlp from 'compromise'
nlp.extend({
  // add new tags
  tags: {
    Character: {
      isA: 'Person',
      notA: 'Adjective',
    },
  },
  // add or change words in the lexicon
  words: {
    kermit: 'Character',
    gonzo: 'Character',
  },
  // change inflections
  irregulars: {
    get: {
      pastTense: 'gotten',
      gerund: 'gettin',
    },
  },
  // add new methods to compromise
  api: View => {
    View.prototype.kermitVoice = function () {
      this.sentences().prepend('well,')
      this.match('i [(am|was)]').prepend('um,')
      return this
    }
  },
})

Docs:

gentle introduction:

• #1) Input → output
• #2) Match & transform
• #3) Making a chat-bot

Documentation:

Talks:

• Language as an Interface - by Spencer Kelly
• Coding Chat Bots - by KahWee Teng
• On Typing and data - by Spencer Kelly

Articles:

• Geocoding Social Conversations with NLP and JavaScript - by Microsoft
• Microservice Recipe - by Eventn
• Adventure Game Sentence Parsing with Compromise
• Building Text-Based Games - by Matt Eland
• Fun with javascript in BigQuery - by Felipe Hoffa
• Natural Language Processing... in the Browser? - by Charles Landau

Some fun Applications:

• Automated Bechdel Test - by The Guardian
• Story generation framework - by Jose Phrocca
• Tumbler blog of lists - horse-ebooks-like lists - by Michael Paulukonis
• Video Editing from Transcription - by New Theory
• Browser extension Fact-checking - by Alexander Kidd
• Siri shortcut - by Michael Byrns
• Amazon skill - by Tajddin Maghni
• Tasking Slack-bot - by Kevin Suh [see more]

Comparisons

• Compromise and Spacy
• Compromise and NLTK

---

Plugins:

These are some helpful extensions:

Dates

npm install compromise-dates

• .dates() - find dates like June 8th or 03/03/18
  • .dates().get() - simple start/end json result
  • .dates().json() - overloaded output with date metadata
  • .dates().format('') - convert the dates to specific formats
  • .dates().toShortForm() - convert 'Wednesday' to 'Wed', etc
  • .dates().toLongForm() - convert 'Feb' to 'February', etc
• .durations() - 2 weeks or 5mins
  • .durations().get() - return simple json for duration
  • .durations().json() - overloaded output with duration metadata
• .times() - 4:30pm or half past five
  • .times().get() - return simple json for times
  • .times().json() - overloaded output with time metadata

Stats

npm install compromise-stats

• .tfidf({}) - rank words by frequency and uniqueness

• .ngrams({}) - list all repeating sub-phrases, by word-count

• .unigrams() - n-grams with one word
• .bigrams() - n-grams with two words
• .trigrams() - n-grams with three words
• .startgrams() - n-grams including the first term of a phrase
• .endgrams() - n-grams including the last term of a phrase
• .edgegrams() - n-grams including the first or last term of a phrase

Speech

npm install compromise-syllables

• .syllables() - split each term by its typical pronunciation
• .soundsLike() - produce a estimated pronunciation

Wikipedia

npm install compromise-wikipedia

• .wikipedia() - compressed article reconciliation

---

Typescript

we're committed to typescript/deno support, both in main and in the official-plugins:

import nlp from 'compromise'
import stats from 'compromise-stats'

const nlpEx = nlp.extend(stats)

nlpEx('This is type safe!').ngrams({ min: 1 })

Limitations:

• slash-support: We currently split slashes up as different words, like we do for hyphens. so things like this don't work: nlp('the koala eats/shoots/leaves').has('koala leaves') //false

• inter-sentence match: By default, sentences are the top-level abstraction. Inter-sentence, or multi-sentence matches aren't supported without a plugin: nlp("that's it. Back to Winnipeg!").has('it back')//false

• nested match syntax: the danger beauty of regex is that you can recurse indefinitely. Our match syntax is much weaker. Things like this are not (yet) possible: doc.match('(modern (major|minor))? general') complex matches must be achieved with successive .match() statements.

• dependency parsing: Proper sentence transformation requires understanding the syntax tree of a sentence, which we don't currently do. We should! Help wanted with this.

FAQ

<summary>☂️ Isn't javascript too...</summary>

yeah it is!
it wasn't built to compete with NLTK, and may not fit every project.
string processing is synchronous too, and parallelizing node processes is weird.
See here for information about speed & performance, and here for project motivations

<summary>💃 Can it run on my arduino-watch?</summary>

Only if it's water-proof!
Read quick start for running compromise in workers, mobile apps, and all sorts of funny environments.

<summary>🌎 Compromise in other Languages?</summary>

we've got work-in-progress forks for German, French, Spanish, and Italian in the same philosophy.
and need some help.

<summary>✨ Partial builds?</summary>

we do offer a tokenize-only build, which has the POS-tagger pulled-out.
but otherwise, compromise isn't easily tree-shaken.
the tagging methods are competitive, and greedy, so it's not recommended to pull things out.
Note that without a full POS-tagging, the contraction-parser won't work perfectly. ((spencer's cool) vs. (spencer's house))
It's recommended to run the library fully.

See Also:

•   en-pos - very clever javascript pos-tagger by Alex Corvi
•   naturalNode - fancier statistical nlp in javascript
•   winkJS - POS-tagger, tokenizer, machine-learning in javascript
•   dariusk/pos-js - fastTag fork in javascript
•   compendium-js - POS and sentiment analysis in javascript
•   nodeBox linguistics - conjugation, inflection in javascript
•   reText - very impressive text utilities in javascript
•   superScript - conversation engine in js

•   jsPos - javascript build of the time-tested Brill-tagger

•   spaCy - speedy, multilingual tagger in C/python

•   Prose - quick tagger in Go by Joseph Kato
•   TextBlob - python tagger

MIT

compromise uses semver, and pushes to npm and github frequently

• Major is a breaking api change - method or response changes that can cause runtime errors.
• Minor is a behaviour change - Tagging or grammar changes.
• Patch is an obvious, non-controversial bugfix.

While all Major releases should be reviewed, our only large releases are v6 in 2016 v12 in 2019 and v14 in 2022. Others have been mostly incremental.

14.14.4 [Jan 2025]

• [fix] - TypeScript & esm resolution #1165

14.14.3 [Dec 2024]

• [fix] - another runtime error in punctuation replace #1150
• [update] - dependencies

14.14.2 [Oct 2024]

• [fix] - runtime error in punctuation replace #1150

14.14.1 [Oct 2024]

• [update] - compromise-dates 3.7.0
• [fix] - runtime error in number parser #1145
• [update] - dependencies

14.14.0 [July 2024]

• [new] - .slashes() and .slashes().split() methods #1100
• [fix] - multiple contraction issue #1128
• [fix] - toNumbers() return values #1113
• [fix] - (plugins/wikipedia) - fix hard-coded path for #1116
• [fix] - (plugins/dates) - limit values in mm/dd format
• [fix] - (plugins/dates) params mutation #1109
• [change] - split people names by commas #1111
• [change] - typescript export update #1104
• [update] - eslint config format
• [update] - github actions
• [update] - dependencies

14.13.0 [Apr 2024]

• [new] - .compute('freeze')
• [new] - .debug('freeze')
• [change] - allow 3-slashes in a word

14.12.0 [Feb 2024]

• [new] - .payload() plugin
• [new] - .numbers().isUnit() method #1089
• [change] - update github workflow (thanks FDawgs!)
• [fix] - README issues (thanks track0x1!)
• [fix] - .has() inconsistency
• [new] - support adding debug methods via plugins
• [change] - remove deprecated .debug(object) support
• [fix] - parentheses() match issue
• [fix] - tokenization issue #1085
• [new] - dates().isBefore(), dates().isBefore() methods
• [new] - .debug('dates') method
• [fix] - lazy join() issue
• [update] - dependencies

14.11.2 [Jan 2024]

• [new] - support for frozen lex in plugin object #1080
• [fix] - toggling options in .json()
• [new] - .join() and .joinIf() methods
• [new] - support freeze in sweep
• [change] - internal typescript improvements
• [fix] - tagging issues
• [change] - @hasEllipses must be following the word
• [update] - dependencies

14.11.1 [Jan 2024]

• [fix] - missing words in html output (thanks ryan!)
• [change] - better #Possessive tagging for #1074
• [change] - improved is/has contraction classifier #1074
• [change] - fixes to subordinate clause identification #1072
• [update] - dependencies

14.11.0 [Dec 2023]

• [new] - tagging .freeze() and .unfreeze() feature
• [change] - stronger deferal to internal lexicon
• [change] - support any-length phrases in lexicon
• [fix] - prevent missed overlapping lexicon phrases
• [update] - dependencies

14.10.1 [Nov 2023]

• [fix] - abbreviation checks for sentence-tokenizer #1061
• [change] - improve person tagger #1059
• [change] - add #FutureTense tag
• [fix] - .out() runtime error #1056
• [fix] - punctuation loss in .not() #1022
• [update] - dependencies

14.10.0 [Aug 2023]

• [fix] - verb conjugation fixes
• [fix] - tagger fixes
• [change] - align package.json with ESM module #1023
• [fix] - .splitBefore() bugfix
• [fix] - typescript+docs fixes #1023
• [fix] - subtle changes to .text() and .isFull()
• [update] - dependencies

14.9.0 [May 2023]

• [new] - .verbs().toPastParticiple() method
• [new] - .normalize({ debullet: true }) #1004
• [change] - typescript path changes (thanks @rotemdan !)
• [fix] - suffix tagging issues
• [fix] - match syntax issue #997
• [change] - keep possessive in replace #1011
• [change] - major improvements to adj.toNoun() conjugator
• [fix] - parsematch bug #997
• [fix] - "there's been" contraction
• [new] - .conjugate() methods on Noun/Adverb/Adjective classes
• [new] - add Gerund and PastParticiple to .verbs().conjugate() results
• [new] - option to keep possessives in .replace() #1011
• [fix] - tagger fix #998
• [update] - dependencies

14.8.2 [Feb 2023]

• [change] - #Actor tagging - in advance of #565
• [change] - .noun() lumping changes - in advance of #565
• [new] - support japanese full-stop
• [fix] - number tagging #992
• [update] - dependencies

14.8.1 [Dec 2022]

• [fix] - tagging fixes
• [change] - allow #Plural acronyms
• [fix] - allow root matches in fastOr
• [fix] - more flexible PhrasalVerb tagging

14.8.0 [Dec 2022]

• [fix] - tagging fixes
• [new] - add Person .presumedMale(), .presumedFemale() methods
• [new] - add Pronoun class, .refersTo()
• [new] - add Noun.references()
• [new] - .nouns('spencer') shorthand as an if-match
• [change] - "[do] you .." etc now #QuestionWord
• [new] - add #Hyphenated tag
• [fix] - improved Auxiliary verb tagging
• [update] - dependencies

14.7.1 [Nov 2022]

• [fix] - concat fix
• [change] - tagging fixes
• [change] - {word/tag/sense} sense-match syntax

14.7.0 [Nov 2022]

• [new] - match term id
• [change] - tag text by default on .concat('')
• [change] - allow modifying term prePunctuation
• [new] - .wrap() method
• [new] - .isFull() method
• [new] - support full notIf matches on sweep
• [fix] - text params for #953
• [fix] - nouns().isSingular() missing
• [change] - one-character w/ dash tokenization #977
• [change] - allow setting model.one.prePunctuation + postPunctuation
• [fix] - compromise-paragraphs plugin

14.6.0 [Oct 2022]

• [change] - move internal conjugation methods
• [update] - github scripts
• [change] - fixes to .clauses() parser
• [change] - an astrix is not a word
• [new] - @hasColon method
• [new] - @hasDash supports two dashes
• [new] - #Passive verb tag
• [new] - existential #There tag
• [new] - add tense info to sentence json
• [fix] - verb tokenization issues
• [fix] - .replace() issues
• [update] - dependencies

14.5.2 [Oct 2022]

• [fix] - runtime error #965
• [fix] - misc possessive tagging issues
• [update] - dependencies

14.5.1 [Oct 2022]

• [fix] - .remove() fixes
• [change] - support « angle quotes »
• [update] - dependencies

14.5.0 [August 2022]

• [fix] - possible runtime error in setTag method
• [change] - make #Honorific always a #Person #951
• [new] - manually change conjugations/inflections from plugin #949
• [new] - .adjectives().conjugate() method
• [update] - dependencies

14.4.5 [August 2022]

• [fix] - fix logic for greedy-negative matches - #936
• [fix] - fix tagging for 3-digit year iso dates - #868
• [update] - dependencies

14.4.4 [August 2022]

• [fix] - support {root} matches without compromise/two

14.4.3 [August 2022]

• [fix] - guard for toRoot methods in root match
• [update] - compromise-stats

14.4.2 [July 2022]

• [fix] - hotfix for sentence tokenization issue #935

14.4.1 [July 2022]

• [change] - improvements to negative-optional match logic - !foo?
• [change] - support short sentences embedded in quotes+parentheses
• [change] - faster sentence tokenizer
• [change] - ° symbol is not punctuation
• [new] - implement .swap() for comparative/superlative adjectives
• [fix] - sentence.toFuture() conjugation rules
• [update] - dependencies

14.4.0 [July 2022]

• [change] - support root matches like '{walk}' work without doing .compute('root')
• [change] - split numbers+units '12km' as contraction - #919
• [new] - .lazy(txt, match) fast-scan method 1
• [fix] - support apostrophes in lexicon #932
• [fix] - support unTag property in sweep
• [change] - keep sentence caches, when still valid
• [change] - alias nlp.compile() to .buildTrie()
• [fix] - tagging fixes
• [update] - dependencies plugin-releases: dates, speed, de-compromise

14.3.1 [June 2022]

• [fix] - missed caches in .sweep()
• [new] - .out('hash') and .json({hash:true})

14.3.0 [June 2022]

• [fix] - unwanted logging in compromise/one
• [fix] - dependency export path for react-native builds #928
• [change] - split hyphenated words in match syntax 'foo-bar'
• [change] - support 4-digit number-ranges (when not a phone number) plugin-releases: dates

14.2.1 [June 2022]

• [fix] - double-contraction issue #925
• [fix] - .not() memleak #926

14.2.0 [June 2022]

• [fix] - speed improvements
• [fix] - bug with fast-or possessive matches
• [fix] - bug with slow-or end-matches
• [change] - no-longer attempt 's contractions in compromise/one
• [new] - flag novel tags in world.one.tagSet
• [new] - .sweep() and nlp.buildNet() methods
• [new] - some typescript support in plugins #918
• [fix] - better unicode support with Unicode property escapes
• [fix] - problems matching on cached documents
• [fix] - typescript fixes
• [fix] - suffix tagging issues
• [fix] - uncached matches missing in .sweep()
• [fix] - non-empty results when pointer is first repaired
• [fix] - nouns().toPlural() fix for #921
• [fix] - drop deprecated .subst() method internally
• [new] - some support for .numbers().units() again #919

14.1.2 [April 2022]

• [new] - add .harden() .soften() undocumented methods
• [fix] - support pre-parsed matches in .has() .if() and .not()
• [fix] - contraction OR match issue
• [fix] - match-syntax min-max issue
• [fix] - normalized printout of abbreviations
• [update] - date plugin release
• [update] - dependencies

14.1.1 [April 2022]

• [fix] - main property in package.json #911

14.1.0 [April 2022]

• [fix] - client-side export format for plugins
• [new] - more adjective transformation methods
• [new] - emoji + emoticon tagger
• [new] - case-sensitive match option - {caseSensitive:true}

🚨 14.0.0 🚨   [March 2022]

Major release - see Release Notes for full details

• [breaking] - remove .parent() and .parents() chain - (use .all() instead)
• [breaking] - remove @titleCase alias (use @isTitleCase)
• [breaking] - remove '.get()' alias - use '.eq()'
• [breaking] - remove .json(0) shorthand - use .json()[0]
• [breaking] - remove .tagger() - use .compute('tagger')
• [breaking] - remove .export() -> .load() - use .json() -> nlp(json)
• [breaking] - remove nlp.clone()
• [breaking] - remove .join() deprecated
• [breaking] - remove .lists() deprecated
• [breaking] - remove .segment() deprecated
• [breaking] - remove .sententences().toParticiple() & .verbs().toParticiple()
• [breaking] - remove .nouns().toPossessive() & .nouns().hasPlural()
• [breaking] - remove array support in match methods - (use .match().match() instead)
• [breaking] - refactor .out('freq') output format - (uses .compute('freq').terms().unique().json() instead)
• [breaking] - change .json() result format for subsets
• [change] merge re-used capture-group names in one match
• [change] drop support for undocumented empty '.split()' methods - which used to split the parent
• [change] subtle changes to .text('fmt') formats
• [change] @hasContraction is no-longer secretly-greedy. use @hasContraction{2}
• [change] .and() now does a set 'union' operation of results (no overlaps)
• [change] bestTag is now .compute('tagRank')
• [change] .sort() is no longer in-place (its now immutable)
• [change] drop undocumented options param to .replaceWith() method
• [change] add match-group as 2nd param to split methods
• [change] remove #FutureTense tag - which is not really a thing in english
• [change] .unique() no-longer mutates parent
• [change] .normalize() inputs cleanup
• [change] drop agreement parameters in .numbers() methods
• [change] - less-magical money parsing - nlp('50 cents').money().get() is no-longer 0.5
• [change] - .find() does not return undefined on an empty result anymore
• [change] - fuzzy matches must now be wrapped in tildes, like ~this~
• [new] .union(), .intersection(), .difference() and .complement() methods
• [new] .confidence() method - approximate tagging confidence score for arbitrary selections
• [new] .settle() - remove overlaps in matches
• [new] .isDoc() - helper-method for comparing two views
• [new] .none() - helper-method for returning an empty view of the document
• [new] .toView() method - drop back to a normal Class instance
• [new] .grow() .growLeft() and .growRight() methods
• [new] add punctuation match support via pre/post params
• [new] add ambiguous empty .map() state as 2nd param

13.11.3 [June 2021]

• [fix] - regex backtracing issue #847 (thanks @srubin)
• misc tagging fixes update deps

13.11.2 [May 2021]

• [fix] - verbphrase conjugation fixes
• [fix] - verbphrase tagger fixes
• [fix] - url tagging regex improvements (thanks Axay!) update deps plugin-releases: dates

13.11.1 [April 2021]

• [fix] - obscure runtime error in capture-groups update deps plugin-releases: typeahead

13.11.0 [April 2021]

• [change] - use babel default build target (drop ie11 polyfill)
• [change] - dont compile esm build w/ babel anymore
• [fix] - sentence conjugation fixes
• [fix] - improvements to phrasal verbs
• [change] - keep tokenization for some more dashed suffixes like 'snail-like' plugin-releases: dates, numbers, sentences

13.10.7 [April 2021]

• [change] - tokenize '2 - 5' as NumerRange, like '2-5' is
• [fix] - edge-cases for URLs with numbers
• [fix] - some sentences.toPastTense() fixes
• [fix] - 'n weekends from now' math in plugin-date plugin-releases: dates, sentences

13.10.6 [April 2021]

• [fix] - support more time-ranges plugin-releases: dates@2.0.2

13.10.5 [March 2021]

• [new] - support Time-range like '3pm-4pm'
• [change] - cleanup some unicode regexes plugin-releases: dates

13.10.4 [March 2021]

• [fix] - match syntax tokenization fix
• [change] - improved performance monitoring

13.10.3 [March 2021]

• [fix] - support complicated regular-expressions in match syntax
• improved performance testing

13.10.2 [March 2021]

• [fix] - support matching implicit terms in (or|blocks)
• [change] - add #Timezone tag (from date-plugin)
• [change] - add many more cities and regions

13.10.1 [March 2021]

• [change] - #Date terms can still be a #Conjunction
• [new] - #Imperative tag and .verbs().isImperative() method
• [fix] - some tagger issues
• update deps plugin-releases: dates

13.10.0 [Feb 2021]

• [new] - #Fraction tag and improved fraction support (thanks Jakeii!)
• [fix] - edge-case match issues with ! syntax
• [change] - update deps
• updates for `compromise-dates@1.4.0,compromise-numbers@1.2.0`

13.9.3 [Feb 2021]

• [fix] - fix weird ordering issue with named exports #815

13.9.2 [Feb 2021]

• [fix] - typescript issue

13.9.1 [Feb 2021]

• [fix] - matches over a contraction
• [new] - add 'implicit' text output

13.9.0 [Feb 2021]

• [new] - World.addConjugations() method
• [new] - World.addPlurals() method
• [new] - start compromise-penn-tags plugin
• [new] - add fuzzy option to match commands
• [new] - support multiple-word matches in OR matches (a|b|foo bar|c)
• [change] (internal) - rename 'oneOf' match syntax to 'fastOr'
• [change] - use new export maps format
• [fix] - conjugations fixes #800
• [fix] - tokenization fixes #801

13.8.0 [Dec 2020]

• [change] improved support for fractions in numbers-plugin #793
• [change] remove zero-width characters in normalized output #759
• [change] improved Person tagging with particles #794
• [change] improved i18n Person names
• [change] tagger+tokenization fixes
• [change] remove empty results from .out('array') #795
• [change] .tokenize() runs any postProcess() scripts from plugins
• [change] improved support for lowercase acronyms
• [change] - support years like '97
• [change] - change tokenizer for '20-aug'
• [change] - update deps of all plugins
• [fix] - NumberRange tagging issue #795
• [fix] - improved support for ordinal number ranges
• [fix] - improved regex support in match-syntax
• [fix] - improved support for ~soft~ match syntax #797
• [fix] - better handling of {0,n} match syntax
• [new] - new plugin strict-match
• [new] - set NounPhrase, VerbPhrase tags in nlp-sentences plugin
• [new] - .phrases() method in nlp-sentences plugin
• [new] - support .apppend(doc) and .prepend(doc)
• [new] - values.normalize() method

13.7.0 [Oct 2020]

• [change] many misc tagging fixes
  • 'if' is now a #Preposition
  • possessive pronouns are #Pronoun and #Possessive
  • more phrasal verbs
  • make #Participle tag #PastTense
  • favor #PastTense over #Participle interpretation in tagger
• [change] @hasHyphen returns false for sentence dashes
• a lot more testing

13.6.0 [Oct 2020]

• [new] first-attempt at verbs().subject() method
• [change] avoid conjugating imperative tense - 'please close the door'
• [change] misc tagging fixes #786
• [change] .nouns() results split on quotations #783
• [change] NumberRange must be < 4 digits #735
• [change] reduction in #Person tag false-positives

13.5.0 [Sep 2020]

• [new] add .parseMatch() method for pre-parsing match statements

13.4.0 [Sep 2020]

• [change] stop including adverbs and some auxiliaries in .conjugate() results
• [change] .append() and .prepend() on an empty doc now creates a new doc
• [new] add verbs().toParticiple() method (add to observables/verb)
• [new] add sentences().toParticiple() method (add to observables/verb)
• [fix] some verb-tagging issues
• [fix] contractions issue in .clone()
• [fix] try harder to retain modal-verbs in conjugation - 'i should drive' no-longer becomes 'i will drive'

13.3.2 [Aug 2020]

• fix for offset issue #771
• fix for {min,max} syntax #767
• typescript fixes
• update deps

13.3.1 [June 2020]

-support unicode spaces for #759

• major improvements to compromise-plugin-dates (1.0.0)

13.3.0 [June 2020]

• bugfixes (conjugation and tagging) 752, 737, 725, 751, 743 748, 755, 758, 706, 761
• support tokenized array as input
• update deps
• bugfix updates to plugin-sentences, and plugin-dates

13.2.0 [May 2020]

• deprecate .money() and favour overloaded method in compromise-numbers plugin
• add .percentages() and .fractions() to compromise-numbers plugin
• add .hasAfter() and .hasBefore() methods
• change handling of slashes
• add .world() method to constructor
• add more abbreviations
• fix regex backtracking #739
• tokenize build:
• • remove conjugation and inflection data
• • remove conjugation and inflection functions
• remove sourcemap from build process (too big)
• improvements to .numbers().units()
• fix for linked-list runtime error #744 with contractions

13.1.1

• fix verbs.json() runtime-error
• improve empty .lists() methods
• allow custom tag colors
• test new github action workflow

13.1.0

• significant (~30%) speed up of parsing
• change sensitivity of input in .lookup() for major speed improvements.
• improved typescript types
• subtle changes to internal caching
• adds 'oneOf' match syntax param
• fixes [word?] syntax parsing

13.0.0 [Feb 2020]

major changes to .export() and [capture] group match-syntax.

• [breaking] move .export() and .load() methods to plugin (compromise-export)
• • change .export() format - this hasn't worked properly since v12. (mis-parsed contractions) see #669
• [breaking] split compromise-output into compromise-html and compromise-hash plugins
• [breaking] .match('foo [bar]') no-longer returns 'bar'. (use .match('foo [bar]', 0))
• [breaking] capture groups are no longer merged. .match('[foo] [bar]') returns two groups accessible with the new .groups() function
• [breaking] change .sentences() method to return only full-sentences of matches (use .all() instead)

modifications:

• [fix] - nlp.clone() - hasn't worked properly, since v12. (@Drache93)
• [fix] - issues with greedy capture [*] and [.+] -(@Drache93) 💛
• add whitespace properties (pre+post) to default json output (suppress with .json({ whitespace: false }))
• .lookup({ key: val }) with an object now returns an object back ({val: Doc})
• add nlp constructor as a third param to .extend()
• support lexicon object param in tokenize - .tokenize('my word', { word: 'tag' })
• clean-up of scripts and tooling
• improved typescript types
• add support for some french contractions like j'aime -> je aime
• allow null results in .map() function
• better typescript support
• allow longer acronyms
• [fix] - offset length issue
• [new] - add new named-match syntax, with .groups() method (@Drache93)
• [new] - add nlp.fromJSON() method
• [new] - add a new compromise-tokenize.js build, without the tagger, or data included.

12.3.0 [Jan 2020]

• prefer @titleCase instead of #TitleCase tag
• update dependencies
• fix case-sensitive paths
• fix greedy-start match condition regression #651
• fix single period sentence runtime error
• fix potentially-unsafe regexes
• improved tagging for '-ed' verbs (#616)
• improve support for auxilary-pastTense ('was lifted') verb-phrases
• more robust number-tagging regexes
• setup typescript types for plugins #661 (thanks @Drache93!)
• verb conjugation and tagger bugfixes
• disambiguate between acronyms & yelling

12.2.1 [Dec 2019]

• fix 'aint' contraction
• make Doc.world writable
• update deps
• more tests
• fix shared period with acronym at end of sentence
• fix some mis-classification of contraction
• fix over-active emoji regex
• tag 'cookin', 'hootin' as Gerund
• support unicode single-quote symbols in contractions

12.2.0 [Dec 2019]

• improved splitting in .nouns()
• add .nouns().adjectives() method
• add concat param to .pre() and .post()
• allow ellipses at start of term "....so" in @hasEllipses
• fix matches with optional-end foo?$ match syntax
• add typescript types for subsets

12.1.0 [Nov 2019]

• add 'sideEffect:false' flag to build
• considerable speedup (20%) in tagger
• ensure trimming of whitespace for root/clean/reduced text formats
• fix client-side logging
• more flexible params to replace() and replaceWith()

12.0.0   :postal_horn: [Nov 2019]

• see Release Notes

11.13.0

• support singular units in .value()

11.11.0

• .quotations() no-longer return repeated results for nested quotes
• simplify quotation tagset
• .out('normal') no longer includes quotes or trailing-possessives
• improve .debug() on client-side

11.10.0

• better honorific support, add honorifics feature to .normalize()
• elipses bugfixes
• replace unicode chars in .normalize() now by default
• acronyms().stripPeriods() and acronyms().addPeriods()

11.9.0

• tag professions as #Actor
• add more behaviours to .normalize()
• support match-results as inputs to .match() and .not()
• support some us-state abbreviations like 'Phoeniz AZ'

11.8.0

• add nouns().toPossessive()
• ngrams now remove empty-terms in contractions - fixes counting issue #476

11.7.0

• expose internal sentences().isQuestion() method
• .join() as an alias for .flatten()
• slightly different behavior for wildcards in capture-groups pull/472
• .possessives() subset + #Possessive tagging fixes
• hide massive world output for console.log of a term

11.6.0

• improve quotations() method
• add .parentheses() method
• add 'nickname' support to .people()
• 'will be #Adjective' now tagged as Copula
• include adverbs in verb conjugation (more) consistently
• sentences().toContinuous() and verbs().toGerund()
• some more aliases for jquery-like methods api
• move getPunctuation, setPunctuation from .sentence to main Text method
• rename internal endPunctuation to getPunctuation
• more consistent cardinal/ordinal tagging for values

11.5.0

• add #Abbreviation tag
• add #ProperNoun tag
• fixes for noun inflection

11.4.1

• include old ending punctuation in a .replace() cmd

11.3.1

• almost-double the support for first-names
• changes to bestTag method

11.2.1

• rolls-back some aggressive JustesonKatz stuff
• better support for emdash numberRange
• 'can't' contraction bugfix
• fix for dates().toShortForm()

11.1.0

• add #Multiple Values tag, and changes to how invalid numbers like 'sixty fifteen hundred' are understood
• better em-dash/en-dash support
• better conjugate implicit verbs inside contractions - "i'm", "we've"
• nouns().articles() method
• neighborhoods as #Place
• support more complex noun-phrases with JustesonKatz in .nouns()

v11

• support for persistent lexicon/tagset changes
• addTags, addWords, addRegs, addPlurals, addConjugations methods to extend native data
• • .plugin() method to wrap all of these into one
• • (removal of .packWords() method)
• more .organizations() matches
• regex-support in .match() - nlp('it is waaaay cool').match('/aaa/').out()//'waaaay'
• improved apostrophe-s disambiguation
• support whitespace before sentence boundary
• improved QuestionWord tagging, some .questions() without a question-mark
• phrasalVerb conjugation
• new #Activity tag for Gerunds as nouns 'walking is fun'
• change ngram params to an object {size:int, max:int}
• implement '[]' capture-group syntax in .match()
• bring-back map, filter, foreach and reduce methods
• set .words() as alias for .terms()
• people().firstNames(), people().lastNames()
• split-out comma-separated adverbs

10.7.2

• fix for '.watch' reserved word in efrt

10.7.0

• improved places() parsing
• improved {min,max} match syntax
• new .out('match') method
• quiet addition of .pack() and .unpack() for owen

10.6.0

• move internal lexicon around, to support new format in v11
• added states & provinces as #Region
• added #Comparable tag for adjectives that conjugate

10.5.0

• add increment/decrement/add/subtract methods to .values()
• add units(), noUnits() methods to .values()
• 'uncountable' nouns are no longer assumed to be singular
• money tag is no longer always a value

10.4.0

• improved tagging of VerbPhrase and Condition
• fixes to contractions in sentence-changes - "i'm going -> i went"
• several verb conjugation fixes
• accept Terms & Result objects in .match() and .replace()

10.3.0

• new Percent tag
• lump more units in with .values()

10.2.0

• .trim() method,
• adjective tagging fixes
• some new .out() methods

10.1.0

• fix return format of .isPlural(), so it acts like a match filter
• less-greedy date tagging & ambiguous month fixes

v10

• cleanup & rename some .value() methods
• change lumping behaviour of lexicon terms with multiple words
• keep more former tags after a term replace method
• new .random() method
• new .lessThan(), .greaterThan(), .equalTo() methods
• new prefix/suffix/infix matches with _ffix syntax
• tag() supports a sequence of tags for a sequence of terms
• .match 'range' queries now use a real match - #Adverb{2,4}
• new .before() and .after() match methods
• removes .lexicon() method for many-lexicons concept
• changes params of .replaceWith() method to a 'keyTags' boolean
• improved .debug() and logging on client-side

9.1.0

• pretty-real filesize reduction by swapping es6 classes for es5 inheritance

v9.0.0

• rename Term.tag object to Term.tags so the .tag() method can work throughout more-consistently
• fix 'Auxillary' tag typo to 'Auxiliary'
• optimisation of .match(), and tagset - significant speedup!
• adds .tagger() method and cleanup extra params
• adds wordStart and wordEnd offsets to .out('offset') for whitespace+punctuation
• new .has() method for faster lookups

8.2.0

• add nlp.out('index') method, 12 bugs

8.1.0

• add nlp.tokenize() method for disabling pos-tagging of input

v8.0.0

• less-ambitious date-parsing of nl-date forms
• filesize reduction using efrt data structure (254k -> 214k)

7.0.15

• fix for IE9

v7   :postal_horn:

• weee! big change! npm package rename

6.5.0

• builds now using browserify + derequire()

6.4.0

• re-written term-lumper logic

6.3.0

• new nlp.lexicon({word:'POS'}) flow

v6

• be consistent with text.normal(), term.all_forms(), text.word_count(). text.normal() includes sentence-terminators, like periods etc.

5.2.0

• airport codes support, helper methods for specific POS

5.1.0

• newlines split sentences

v5

• Text methods now return this, instead of array of sentences

4.12.0

• more-sensible responses for invalid, non-string inputs

4.11.0

• 14 PRs, with fixes for currencies, pluralization, conjugation

4.10.0

• Value.to_text() new method, fix "Posessive" POS typo

4.9.0

• return of the text.spot() method (Re:#107)

4.8.0

• more aggressive lumping of dates, like 'last week of february'

4.7.0

• whitespace reproduction in .text() methods

4.6.0

• move negate from sentence to verb & statement

4.2.0

• rename 'implicit' to 'expansion' for smarter contractions

4.1.3

• added readable-compression to adj, verbs (121kb -> 117kb)

4.1.0

• hyphenated words are normalized into spaces

v4.0.0

• grammar-aware match & replace functions

3.0.2

• Statement & Question classes

v3.0.0 Feb 2016

• split ngram, locale, and syllables into plugins in seperate repo

2.0.0 - Nov 2015

• es6 classes, babel building
• better test coverage
• ngram uses term tokenization, so that 'Tony Hawk' us one term, and not two
• more organized pos rules
• Pos tagging is done implicitly now once nlp.Text is run
• Entity spotting is split into .people(), .place(), .organisations()
• unicode normalisation is killed
• opaque two-letter tags are gone
• plugin support
• passive tense detection
• lexicon can be augmented third-party
• date parsing results are different

1.1.0 - May 2015

• smarter handling of ambiguous contractions ("he's" -> ["he is", "he has"])

v1.0.0 - May 2015

• added name genders and beginning of co-reference resolution ('Tony' -> 'he') API.
• small breaking change on Noun.is_plural and Noun.is_entity, affording significant pos() speedup. Bumped Major version for these changes.

0.5.2 - May 2015

• Phrasal verbs ('step up'), firstnames and .people()

0.4.0 - May 2015

• Major file-size reduction through refactoring

0.3.0 - Jan 2015

• New NER choosing algorithm, better capitalisation logic, consolidated tests

0.2.0 - Nov 2014

• Sentence class methods, client-side demos