npm

credit-roles
TypeScript icon, indicating that this package has built-in type declarations

2.1.0 • Public • Published

credit-roles

credit-roles on npm MIT License CI

CRediT (Contributor Roles Taxonomy) is a high-level taxonomy, including 14 roles, that can be used to represent the roles typically played by contributors to research outputs. The roles describe each contributor’s specific contribution to the scholarly output. (https://credit.niso.org/)

A utility for validating CRT Contributor Roles in your application, building canonical URLs, and showing descriptions.

npm install credit-roles

The library has no dependencies, and is helpful in validating, normalizing and showing descriptions of CRediT roles.

Overview & Usage

import { credit, CreditRole, CreditDescriptions } from 'credit-roles';

// Validate that a string is a role
credit.validate('contributor'); // true

// Handles British spelling and capitalizations
credit.normalize('conceptualiSation'); // "Conceptualization"

// Handles different punctuation
credit.normalize('writing:  original draft'); // "Writing – original draft"

// Show the descriptions in your application
CreditDescriptions['Supervision']; // Oversight and leadership responsibility...

// An enum for easy access to the roles
CreditRole.WritingOriginalDraft;

Included Utilities

  • validate - Validates if a string to a CRediT role if it is valid, will take URLs and unformatted strings
  • normalize - Normalizes a CRediT string into the canonical string (including hyphens, capitalization and punctuation)
  • buildUrl - Builds a URL to https://credit.niso.org, includes normalization
  • CreditRole - an enum of the CRediT roles
  • CreditDescriptions - Official descriptions of the CRediT roles by NISO

Options

  • strict: only accept normalized CRediT roles when validating or building URLs

Alias

In addition to british english, incorrect case or punctuation, there are also a number of aliases that can be used for various roles:

Alias Official CRediT Role
writing Writing – original draft
editing Writing – review & editing
review Writing – review & editing
analysis Formal analysis
funding Funding acquisition
admin Project administration
administration Project administration

References


As of v2.0.0 this package is ESM only.


Made with love by Curvenote

Readme

Keywords

Package Sidebar

Install

npm i credit-roles

Weekly Downloads

465

Version

2.1.0

License

MIT

Unpacked Size

13.1 kB

Total Files

5

Last publish

Collaborators

  • rowanc1
  • stevejpurves