npmpackage.info

Gathering detailed insights and metrics for @emmetio/abbreviation

Other packages similar to @emmetio/abbreviation

@emmetio/css-abbreviation

2.1.8

Parses Emmet CSS abbreviation into AST tree

@emmetio/extract-abbreviation

0.2.0

Extracts Emmet abbreviation from string

@emmetio/expand-abbreviation

0.7.3

Reference implementation of Emmet abbreviation expander

@emmetio/node

0.1.2

Emmet abbreviation node

@emmetio/abbreviation

The essential toolkit for web-developers

2.3.3

4,493

MIT

TypeScript

160.03 kB

35,414,574 3.6

Installations

npm install @emmetio/abbreviation

Developer Guide

BETA

Typescript

Yes

Module System

ESM

Node Version

16.16.0

NPM Version

lerna/6.5.1/node@v16.16.0+x64 (darwin)

Score

99.7

Supply Chain

92.8

Quality

78.5

Maintenance

100

Vulnerability

100

License

Pull Requests

Open

3

Total

155

Closed

57

Merged

95

Issues

Open

77

Total

584

Closed

507

Releases

JSX support

v1.3.0

Updated on Apr 01, 2015

View All 1 releases

Contributors

Unable to fetch Contributors

View All 50 Contributors

Languages

TypeScript

JavaScript

TypeScript (99.39%)

JavaScript (0.61%)

Love this project? Help keep it running — sponsor us today! 🚀

Developer

emmetio

Download Statistics

Total Downloads

35,414,574

Last Day

19,097

Last Week

332,481

Last Month

1,329,350

Last Year

15,383,055

GitHub Statistics

MIT License

4,493 Stars

280 Commits

522 Forks

155 Watchers

3 Branches

50 Contributors

Updated on Feb 18, 2025

Maintainers

Package Meta Information

Latest Version

2.3.3

Package Id

@emmetio/abbreviation@2.3.3

Unpacked Size

160.03 kB

Size

33.83 kB

File Count

NPM Version

lerna/6.5.1/node@v16.16.0+x64 (darwin)

Node Version

16.16.0

Published on

May 10, 2023

Total Downloads

Cumulative downloads

Total Downloads

35,414,574

Last Day

-3.1%

19,097

Compared to previous day

Last Week

4.5%

332,481

Compared to previous week

Last Month

27.3%

1,329,350

Compared to previous month

Last Year

51.4%

15,383,055

Compared to previous year

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

@emmetio/scanner

Dev Dependencies

@rollup/plugin-typescript @types/mocha @types/node mocha rimraf rollup ts-node typescript

Emmet markup abbreviation parser

Parses given Emmet markup abbreviation into AST. Parsing is performed in two steps: first it tokenizes given abbreviation (useful for syntax highlighting in editors) and then tokens are analyzed and converted into AST nodes as plain, JSON-serializable objects.

Note that AST tree in most cases cannot be used directly for output: for example, AST node produced from .foo.bar element misses element name and contains two class attributes with foo and bar values (not a single class with foo bar value).

Usage

You can install it via npm:

1npm install @emmetio/abbreviation

Then add it into your project:

1import parse from '@emmetio/abbreviation';
2
3const tree = parse('div#foo>span.bar*3');
4/* {
5    type: 'Abbreviation',
6    children: [{
7        type: 'AbbreviationNode',
8        name: 'div',
9        attributes: [...],
10        children: [...]
11    }]
12} */
13

The returned tree contains AbbreviationNode items: a node with name, attributes and/or text content. E.g. an element that can be represented somehow. Repeated and grouped nodes like a>(b+c)*3 are automatically converted and duplicated as distinct AbbreviationNode with distinct .repeat property which identifies node in repeating sequence.

Abbreviation syntax

Emmet abbreviation element has the following basic parts:

name.class#id[attributes?, ...]{text value}*repeater/

name — element name, like div, span etc. Stored as node.name property.
[attributes] — list of attributes. Each attribute is stored as AbbreviationAttribute instance and can be accessed by node.getAttribute(name). Each attribute can be written in different formats:
- attr — attribute with empty value.
- attr=value — attribute with value. The value may contain any character except space or ].
- attr="value" or attr='value' — attribute with value in quotes. Quotes are automatically removed. Expression values like attr={value} are supported and can be identified by valueType: "expression" property.
- attr. — boolean attribute, e.g. attribute without value, like required in <input>.
- !attr – implicit attribute, will be outputted if its value is not empty. Used as a placeholder to preserve attribute order in output.
- ./non/attr/value — value for default attribute. In other words, anything that doesn’t match a attribute name characters. Can be a single- or double-quotted as well. Default attribute is stored with null as name and should be used later, for example, to resolve predefined attributes.
.class — shorthand for class attribute. Note that an element can have multiple classes, like .class1.class2.class3.
#id — shorthand for id attribute.
{text} — node’s text content
*N — element repeater, tells parser to create N copies of given node.
/ — optional self-closing operator. Marks element with node.selfClosing = true.

Operators

Each element of abbreviation must be separated with any of these operators:

elem1+elem2>elem3

+ — sibling operator, adds next element as a next sibling of current element in tree.
> — child operator, adds next element as a child of current element.
^ — climb-up operator, adds next element as a child of current element’s parent node. Multiple climb-up operators are allowed, each operator moves one level up by tree.

Groups

A set of elements could be grouped using (), mostly for repeating and for easier elements nesting:

a>(b>c+d)*4+(e+f)

Groups can be optionally concatenated with + operator.

No vulnerabilities found.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

License

Determines if the project has defined a license.

6

Maintained

Determines if the project is "actively maintained".

4

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

3

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Security-Policy

Determines if the project has published a security policy.

0

Fuzzing

Determines if the project uses fuzzing.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

SAST

Determines if the project uses static code analysis.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Score

3.6

/10

Last Scanned on 2025-02-10

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More