Our npm packages

IndieWeb Rule #3: make what you need.
IndieWeb Rule #4: use what you make.

Since 2015, we’ve been making npm packages for our projects and sharing them with the world.

Have a look, maybe you’ll find something useful for your next project!

Flagship Libraries

string-strip-html ^13.0.3

Strip HTML tags from strings. No parser, accepts mixed sources.

open playground

email-comb ^7.0.3

Remove unused CSS from email templates

open playground

html-crush ^6.0.3

Minify email templates

open playground

detergent ^9.0.3

Extract, clean, encode text and fix English style

open playground

↑ back to top

HTML Processing Libraries ^Σ=19

They all process HTML and CSS. Our speciality is so-called scanerless parsing algorithm — we don’t parse and then work on AST and then render. We aim to work on the source code directly while traversing it as a string.

The idea is, if you don’t parse the HTML, you can support broken or mixed code. Unless you write your parser, it becomes a bottleneck — parser throws here and there, and you can do nothing about it.

It is vital to support broken code because this allows us to make broken code-fixing programs.

Also, we often aim to support the processing of HTML mixed with other, known or unknown, source code (typically, programming or templating languages).

all-named-html-entities ^3.0.3

List of all named HTML entities

charcode-is-valid-xml-name-character ^3.0.3

Does a given character belong to XML spec’s “Production 4 OR 4a” type (is acceptable for XML element’s name)

color-shorthand-hex-to-six-digit ^5.0.3

Convert shorthand hex color codes into full

detect-is-it-html-or-xhtml ^6.0.3

Does the string resemble an HTML or XHTML (or neither)?

detect-templating-language ^4.0.3

Detects various templating languages present in string

generate-atomic-css ^3.0.3

Generate Atomic CSS

gulp-email-remove-unused-css ^5.0.3

Gulp plugin to remove unused CSS classes/id’s from styles in HTML HEAD and inline within BODY

html-all-known-attributes ^6.0.3

All HTML attributes known to the Humanity

html-entities-not-email-friendly ^0.8.3

All HTML entities which are not email template friendly

html-img-alt ^4.0.3

Adds missing alt attributes to img tags. Non-parsing.

html-table-patcher ^6.0.3

Visual helper to place templating code around table tags into correct places

is-char-suitable-for-html-attr-name ^4.0.3

Is given character suitable to be in an HTML attribute’s name?

is-html-attribute-closing ^4.0.3

Is a character on a given index a closing of an HTML attribute?

is-html-tag-opening ^4.0.3

Does an HTML tag start at given position?

is-language-code ^5.0.3

Is given string a language code (as per IANA)

open playground

is-media-descriptor ^5.0.3

Is given string a valid media descriptor (including media query)?

is-relative-uri ^5.0.3

Is given string a relative URI?

stristri ^5.0.3

Extracts or deletes HTML, CSS, text and/or templating tags from string

↑ back to top

Range Libraries ^Σ=13

We needed a way to compose multiple string amendment operations. We started to mark each operation as an array, for example, [1, 5] means “delete from string index 1 to 5”.

If you wish to put something after deletion as well, it goes as the third element in the array.

All these packages process arrays of range arrays in various ways.

ranges-apply ^7.0.3

Take an array of string index ranges, delete/replace the string according to them

ranges-crop ^6.0.3

Crop array of ranges when they go beyond the reference string’s length

ranges-ent-decode ^6.0.3

Recursive HTML entity decoding for Ranges workflow

ranges-invert ^6.0.3

Invert string index ranges

ranges-is-index-within ^4.0.3

Checks if index is within any of the given string index ranges

ranges-iterate ^4.0.3

Iterate a string and any changes within given string index ranges

ranges-merge ^9.0.3

Merge and sort string index ranges

ranges-offset ^4.0.3

Increment or decrement each index in every range

ranges-process-outside ^6.0.3

Iterate string considering ranges, as if they were already applied

ranges-push ^7.0.3

Gather string index ranges

ranges-regex ^6.0.3

Integrate regex operations into Ranges workflow

ranges-sort ^6.0.3

Sort string index ranges

string-range-expander ^4.0.3

Expands string index ranges within whitespace boundaries until letters are met

↑ back to top

String Processing Libraries ^Σ=31

They process string inputs, which might be text, code or something else as long as it is of a string-type.

arrayiffy-if-string ^5.0.3

Put non-empty strings into arrays, turn empty-ones into empty arrays. Bypass everything else.

bitbucket-slug ^4.0.3

Generate BitBucket readme header anchor slug URLs. Unofficial, covers whole ASCII and a bit beyond.

easy-replace ^6.0.3

Replace strings with optional lookarounds, but without regexes

edit-package-json ^0.8.3

Edit package.json without parsing, as string, to keep the formatting intact

email-all-chars-within-ascii ^5.0.3

Scans all characters within a string and checks are they within ASCII range

js-row-num ^7.0.3

Update all row numbers in all console.logs in JS code

line-column-mini ^3.0.3

Convert string index to line-column position

str-indexes-of-plus ^5.0.3

Like indexOf but returns array and counts per-grapheme

string-apostrophes ^4.0.3

Comprehensive, HTML-entities-aware tool to typographically-correct the apostrophes and single/double quotes

string-bionic-split ^2.0.3

Calculate a word string split position index for later highlighting

string-character-is-astral-surrogate ^3.0.3

Tells, is given character a part of astral character, specifically, a high and low surrogate

string-collapse-leading-whitespace ^7.0.3

Collapse the leading and trailing whitespace of a string

string-collapse-white-space ^11.0.3

Replace chunks of whitespace with a single spaces

string-convert-indexes ^6.0.3

Convert between native JS string character indexes and grapheme-count-based indexes

string-extract-class-names ^8.0.3

Extracts CSS class/id names from a string

string-extract-sass-vars ^4.0.3

Parse SASS variables file into a plain object of CSS key-value pairs

string-find-heads-tails ^6.0.3

Finds where are arbitrary templating marker heads and tails located

string-find-malformed ^4.0.3

Search for a malformed string. Think of Levenshtein distance but in search.

string-fix-broken-named-entities ^7.0.3

Finds and fixes common and not so common broken named HTML entities, returns ranges array of fixes

string-left-right ^6.0.3

Looks up the first non-whitespace character to the left/right of a given index

string-match-left-right ^9.0.3

Match substrings on the left or right of a given index, ignoring whitespace

string-overlap-one-on-another ^4.0.3

Lay one string on top of another, with an optional offset

string-process-comma-separated ^4.0.3

Extracts chunks from possibly comma or whatever-separated string

string-remove-duplicate-heads-tails ^7.0.3

Detect and (recursively) remove head and tail wrappings around the input string

string-remove-thousand-separators ^7.0.3

Detects and removes thousand separators (dot/comma/quote/space) from string-type digits

string-remove-widows ^4.0.3

Helps to prevent widow words in a text

string-split-by-whitespace ^4.0.3

Split string into array by chunks of whitespace

string-trim-spaces-only ^5.0.3

Like String.trim() but you can choose granularly what to trim

string-truncator ^2.0.3

Over-engineered string truncation for web UI’s

string-uglify ^3.0.3

Shorten sets of strings deterministically, to be git-friendly

string-unfancy ^6.0.3

Replace all n/m dashes, curly quotes with their simpler equivalents

↑ back to top

Plain Object or Array Libraries ^Σ=17

Usually, plain objects come from JSON files, and often they are deeply nested. The following libraries help us to traverse them, set and delete keys and compare objects.

Array-processing libraries deal with tasks like sorting, deletion or conversion to other structures.

array-group-str-omit-num-char ^6.0.3

Groups array of strings by omitting number characters

array-includes-with-glob ^5.0.3

Like _.includes but with wildcards

array-of-arrays-into-ast ^4.0.3

Turns an array of arrays of data into a nested tree of plain objects

array-of-arrays-sort-by-col ^5.0.3

Sort array of arrays by column, rippling the sorting outwards from that column

array-pull-all-with-glob ^7.0.3

Like _.pullAll but with globs (wildcards)

json-comb-core ^8.0.3

The inner core of json-comb

json-variables ^12.0.3

Resolves custom-marked, cross-referenced paths in parsed JSON

object-all-values-equal-to ^4.0.3

Does the AST/nested-plain-object/array/whatever contain only one kind of value?

object-boolean-combinations ^6.0.3

Consumes a defaults object with booleans, generates all possible variations of it

object-delete-key ^4.0.3

Delete keys from all arrays or plain objects, nested within anything, by key or by value or by both, and clean up afterwards. Accepts wildcards.

object-fill-missing-keys ^11.0.3

Add missing keys into plain objects, according to a reference object

object-flatten-all-arrays ^7.0.3

Merge and flatten any arrays found in all values within plain objects

object-flatten-referencing ^7.0.3

Flatten complex nested objects according to a reference objects

object-merge-advanced ^14.0.3

Deeply merge JSON-like data structures

object-no-new-keys ^5.0.3

Check, does a plain object (AST/JSON) has any unique keys, not present in a reference object (another AST/JSON)

object-set-all-values-to ^6.0.3

Recursively walk the input and set all found values in plain objects to something

test-mixer ^4.1.0

Test helper to generate function opts object variations

↑ back to top

AST Libraries ^Σ=12

AST stands for Abstract Syntax Tree, it’s a fancy name for nested output of a parser. Typically, it’s an array or a plain object with many layers of nested elements.

ast-compare ^4.0.3

Compare anything: AST, objects, arrays, strings and nested thereof

ast-contains-only-empty-space ^4.0.3

Does AST contain only empty space?

ast-deep-contains ^5.0.3

Like t.same assert on array of objects, where element order doesn’t matter.

ast-delete-object ^4.0.3

Delete all plain objects in AST if they contain a certain key/value pair

ast-get-object ^4.0.3

Getter/setter for nested parsed HTML AST’s, querying objects by key/value pairs

ast-get-values-by-key ^5.0.3

Extract values and paths from AST by keys OR set them by keys

ast-is-empty ^4.0.3

Find out, is nested array/object/string/AST tree is empty

ast-loose-compare ^4.0.3

Compare anything: AST, objects, arrays and strings

ast-monkey ^9.0.3

Traverse and edit AST

ast-monkey-traverse ^4.0.3

Utility library to traverse AST

ast-monkey-traverse-with-lookahead ^4.0.3

Utility library to traverse AST, reports upcoming values

ast-monkey-util ^3.0.3

Utility library of AST helper functions

↑ back to top

Lerna Libraries ^Σ=4

While maintaining our monorepo we found that some essential tools were missing, so we created them!

lerna-clean-changelogs ^5.0.3

Removes frivolous entries from commitizen generated changelogs

lerna-clean-changelogs-cli ^3.0.3

CLI application to cleanse the lerna/commitizen-generated changelogs

lerna-link-dep ^3.0.3

Like lerna add but does just the symlinking, works on CLI bins too

update-versions ^6.0.3

Like npm-check-updates but supports Lerna monorepos and enforces strict semver values

↑ back to top

CLI Apps ^Σ=6

All the following libraries are command-line applications. You install them using -g flag via npm, for example, npm i -g json-sort-cli. Often a package/library/program would have its CLI counterpart: you can use a package programmatically, inside your programs, or you can use its CLI in the terminal, as a standalone program.

For example, csv-sort package is string-in, string-out function. It’s meant to be used by websites, CLIs and Node programs.csv-sort-cli “taps it” and adds file I/O layer and lets you read/write/sort files directly, via a command line.

csv-sort-cli ^3.0.3

Command line app to sort double-entry CSVs coming from internet banking statements

email-all-chars-within-ascii-cli ^3.0.3

Command line app to scan email templates, are all their characters within ASCII range

generate-atomic-css-cli ^3.0.3

Generates and updates all HTML templates’ atomic CSS

js-row-num-cli ^3.0.3

Update all row numbers in all console.logs in given files

json-comb ^0.8.3

Command line app to manage sets of JSON files

json-sort-cli ^3.0.3

Command line app to deep sort JSON files, retains package.json special key order

↑ back to top

Miscellaneous Libraries ^Σ=22

That’s all programs which don’t belong to any of the categories above. Here we have programs doing everything, from CSV sorting to Tap output parsing; from regexes to converting colour hex codes.

check-types-mini ^8.0.3

Validate options object

codsen-parser ^0.14.3

Parser aiming at broken or mixed code, especially HTML & CSS

codsen-tokenizer ^7.0.3

HTML and CSS lexer aimed at code with fatal errors, accepts mixed coding languages

codsen-utils ^1.0.1

Various utility functions

csv-sort ^7.0.3

Sort double-entry bookkeeping CSV from internet banking

csv-split-easy ^7.0.3

Splits the CSV string into array of arrays, each representing a row of columns