npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@diplodoc/cut-extension

v1.1.1

Published

Cut extension for Diplodoc platform

Downloads

23,380

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

rndnmrndnmrobot-dataui-npmrobot-dataui-npmalexey_w100alexey_w1003y33y3martyanov-avmartyanov-avvseshvseshmakhnatkinmakhnatkinseparatrixseparatrix

Keywords

Readme

NPM version

@diplodoc/cut-extension

Extension for the Diplodoc platform that enables collapsible sections (cuts) in documentation. Provides both a MarkdownIt transform plugin for processing cut directives and a runtime component for interactive behavior.

Features

  • Collapsible sections — Create expandable/collapsible content blocks in documentation
  • MarkdownIt plugin — Transform cut directives during markdown processing
  • Runtime component — Interactive cut behavior with keyboard navigation
  • Grouped cuts — Support for mutually exclusive cut groups
  • URL hash navigation — Direct linking to specific cuts via URL hash
  • Accessibility — ARIA attributes and keyboard navigation support
  • SCSS styles — Customizable styling for cut components

Installation

npm install @diplodoc/cut-extension

Usage

Quickstart

Attach the plugin to the transformer:

import cutExtension from '@diplodoc/cut-extension';
import transform from '@diplodoc/transform';

const {result} = await transform(
  `
{% cut "Cut title" %}

Cut content

{% endcut %}
`,
  {
    plugins: [cutExtension.transform({bundle: false})],
  },
);

Prepared runtime

It is necessary to add runtime scripts to make cuts interactive on your page. You can add assets files which were generated by the MarkdownIt transform plugin.

<html>
  <head>
    <!-- Read more about '_assets/cut-extension.js' and '_assets/cut-extension.css' in 'Transform plugin' section -->
    <script src="_assets/cut-extension.js" async></script>
    <link rel="stylesheet" href="_assets/cut-extension.css" />
  </head>
  <body>
    ${result.html}
  </body>
</html>

Or you can just include runtime's source code in your bundle.

import '@diplodoc/cut-extension/runtime';
import '@diplodoc/cut-extension/runtime/styles.css';

MarkdownIt transform plugin

Plugin for @diplodoc/transform package.

Options:

  • runtime.script - name on runtime script which will be exposed in results script section. Default: _assets/cut-extension.js

  • runtime.style - name on runtime css file which will be exposed in results style section. (Default: _assets/cut-extension.css)

  • bundle - boolean flag to enable/disable copying of bundled runtime to target directory. Where target directory is <transformer output option>/<plugin runtime option> Default: true

Development

Setup

# Install dependencies
npm install

# Build the package
npm run build

# Run tests
npm test

# Type check
npm run typecheck

# Lint code
npm run lint

Documentation

For detailed information about architecture, development, and contributing, see AGENTS.md.

License

MIT