open-index/open-npm huggingface dataset:
npm package: @itsbede/guided-tour
Description: A simple Stimulus controller that enables you to show a guided tour overlay on your website.
Author: Benjamin Deutscher
Latest version: 1.0.1

# Guided Tour

A simple Stimulus controller that enables you to show a guided tour overlay on your website. It requires Bootstrap to be installed and have Popover loaded.

This package has a corresponding ruby gem. See [guided_tour](https://github.com/its-bede/guided_tour) repo.

## Installation

```bash
npm install @itsbede/guided-tour
```

## Usage

```javascript
// In your application
import GuidedTourController from '@itsbede/guided-tour'
application.register('guided-tour', GuidedTourController)
```

```html
<!-- modify to your gusto -->
<div class="guided-tour--wrapper"
     data-controller="guided-tour--tour"
     data-guided-tour-next-btn-text-value="Next"
     data-guided-tour-prev-btn-text-value="Previous"
     data-guided-tour-done-btn-text-value="Done"
     data-guided-tour-step-line-text-value="Step">

  <div class="guided-tour--starter-btn-wrapper">
    <button type="button" class="btn btn-primary ms-auto" id="guidedTourStarterBtn">
      <i class="bi bi-lightbulb"></i>
      &nbsp;
      Start Tour
    </button>
  </div>

  <div class="guided-tour--overlay"
       data-guided-tour__tour-target="overlay"
       data-bs-container="body"
       data-bs-toggle="popover"
       data-bs-placement="bottom"
       data-bs-content="">
  </div>

  <ol class="d-none">
    <li data-guided-tour__tour-target="explanation"
        data-target-element="step1">
      This is the first step of the tour
    </li>
    <li data-guided-tour__tour-target="explanation"
        data-target-element="step2">
      This is the second step of the tour
    </li>
    <li data-guided-tour__tour-target="explanation"
        data-target-element="step3">
      This is the final step of the tour
    </li>
  </ol>
</div>
```
npm package: @itsbjoern/roost
Description: Roost CLI - local HTTPS reverse proxy with automatic cert management
Author: Björn Friedrichs
Latest version: 0.1.12

## @itsbjoern/roost

CLI and JavaScript API for Roost (local HTTPS reverse proxy with automatic cert management).

### Install

```bash
npm install -g @itsbjoern/roost
```

### Usage

```bash
roost init          # after global install
npx roost init      # without installing (npm)
```

If `roost` is not found after a global install, add your package manager's global bin to `PATH` (e.g. `export PATH="$PATH:$(npm config get prefix)/bin"` for npm, or `export PATH="$PATH:$HOME/.bun/bin"` for Bun).

### JavaScript API

Use the package as a library to get cert/key **contents** (or paths) for HTTPS config. Use `getDomainCerts` for build tools—returns literal PEM strings, no file reads:

```js
const { getDomainCerts } = require('@itsbjoern/roost');

const { cert, key } = await getDomainCerts('api.local', { generate: true });
// Pass cert and key directly to https.createServer or Vite server.https
```

See the [main README](https://github.com/itsbjoern/roost#javascript-api) for full API docs and examples.
npm package: @itsbr0dyy/vanillascript
Description: VanillaScript - A simpler, sweeter JavaScript
Author: VanillaScript Team
Latest version: 0.1.5

# VanillaScript

**A simpler, sweeter JavaScript**

VanillaScript is a programming language that compiles to JavaScript, designed to be easier and more intuitive than JavaScript while maintaining full compatibility.

## Features

- **Simpler Syntax** - No semicolons, cleaner function declarations
- **Easy to Learn** - Perfect for beginners
- **Compiles to JS** - Works anywhere JavaScript works
- **Type Inference** - Smart type checking without TypeScript complexity
- **Modern Features** - All the good parts, none of the confusing parts

## Installation

```bash
npm install -g @itsbr0dyy/vanillascript
```

## Quick Start

Create a file `hello.van`:

```vanilla
print "Hello, World!"

let name = "Alice"
print "Hello, " + name

func greet(person)
  print "Nice to meet you, " + person
end

greet(name)
```

Compile and run:

```bash
vanilla run hello.van
```

Or compile to JavaScript:

```bash
vanilla build hello.van -o hello.js
```

## Syntax Examples

### Variables
```vanilla
let x = 10
let name = "John"
let isActive = true
```

### Functions
```vanilla
func add(a, b)
  return a + b
end

func greet(name)
  print "Hello, " + name
end
```

### Conditionals
```vanilla
if x > 10
  print "x is large"
else
  print "x is small"
end
```

### Loops
```vanilla
loop i from 0 to 10
  print i
end

while x < 100
  x = x + 1
end
```

### Arrays
```vanilla
let numbers = [1, 2, 3, 4, 5]
let first = numbers[0]
```

### Objects
```vanilla
let person = {
  name: "Alice",
  age: 30
}

print person.name
```

## Project Structure

```
vanillascript/
├── src/
│   ├── lexer/       # Tokenization
│   ├── parser/      # AST generation
│   ├── ast/         # AST node definitions
│   ├── codegen/     # Code generation
│   ├── semantic/    # Semantic analysis
│   ├── optimizer/   # Code optimization
│   ├── runtime/     # Runtime support
│   ├── stdlib/      # Standard library
│   ├── errors/      # Error handling
│   └── utils/       # Utilities
├── tests/           # Test suites
├── examples/        # Example programs
├── docs/            # Documentation
└── bin/             # CLI tools
```

## Documentation

- [Language Guide](docs/language-guide.md)
- [API Reference](docs/api-reference.md)
- [Contributing](docs/contributing.md)

## License

MIT
npm package: @itsbroly/biome-config
Description: ## What is Biome?
Author: itsbroly
Latest version: 1.2.1


# Biome Config

## What is Biome?

Biome is a performant toolchain for web projects that replaces both ESLint and Prettier. It's written in Rust and extremely fast.

## Installation

1. First, install Biome in your project:

    ```bash
    bun add -D @biomejs/biome
    ```

2. Install this configuration package:
   ```bash
   bun add -D @itsbroly/biome-config
   ```

3. Initialize Biome in your project:
    ```bash
    bunx biome init
    ```

4. Extend your `biome.json` file:
    ```json
    "extends": ["@itsbroly/biome-config"],
    ```


## Usage

### Using with VS Code

1. Install the Biome VS Code extension
2. Enable the extension in your workspace
3. The configuration will be automatically applied to your project

### Using from Command Line

Format your code:
```bash
npx biome format ./src
```

Lint your code:
```bash
npx biome lint ./src
```

Check formatting:
```bash
npx biome check ./src
```

## Configuration Details

This configuration includes:

- Standardized formatting rules
- Consistent code style guidelines
- Best practices for TypeScript development
- Custom rules specific to RayPeatLibrary repos

## Contributing

If you want to suggest changes to this configuration:

1. Fork the repository
2. Create a feature branch
3. Submit a Pull Request

## License

MIT

## Support

For issues or questions specific to this configuration, please open an issue in the repository.
npm package: @itsbth/eliza-as-promised
Description: Eliza psychotherapist in Node.js as a promised based AI
Author: Nate Lewis
Latest version: 0.0.3

# eliza-as-promised

Adaptation of http://www.masswerk.at/elizabot/ to a promised based node.js module.

elizabot.js v.1.1 - ELIZA JS library (N.Landsteiner 2005) Eliza is a mock Rogerian psychotherapist. Original program by Joseph Weizenbaum in MAD-SLIP for "Project MAC" at MIT. cf: Weizenbaum, Joseph "ELIZA - A Computer Program For the Study of Natural Language Communication Between Man and Machine" in: Communications of the ACM; Volume 9 , Issue 1 (January 1966): p 36-45. JavaScript implementation by Norbert Landsteiner 2005; http://www.masserk.at

## Usage

```javascript
const Eliza = require('eliza-as-promised');

var eliza = new Eliza();

// start an Eliza conversation
console.log('>> ' + eliza.getInitial());

// tell Eliza something
let statement = 'I need some help';
console.log('<< ' + statement);

// let Eliza respond
// will respond with response.final if you're done
// will respond with response.reply if you still need more therapy
eliza.getResponse(statement)
  .then((response) => {
    if (response.reply) {
      console.log('>> ' + response.reply);
    }
    if (response.final) {
      console.log('>> ' + response.final);
      process.exit(0);
    }
  });

// repeat getResponse() over and over till response.final is defined
```
npm package: @itsdiogo912/eco.js
Description: Economy package for Discord bot
Author: ItsDiogo912
Latest version: 1.0.2-snapshot

# eco.js
A Simple Package for an Economy system to Discord.js Bots!

<div align="center">
    <p>
    <a href="https://npmjs.com/package/@itsdiogo912/eco.js"><img src="https://nodei.co/npm/@itsdiogo912/eco.js.png?downloads=true&stars=false"/></a>
    <br>
    </p>
</div>

NOTE: This Package is still in development, please report any issue or bug on [this](https://github.com/VaryBot/Economy.js/issues) site

## Installation
```
npm install @itsdiogo912/eco.js
```

## Usage
```js
const Economy = require("@itsdiogo912/eco.js"); //Import Economy package

const eco = new Economy('1000'); //NOTE : 1000 on this line is the default balance

eco.fetchBalance('userID').then(money => { //Fetches balance from an userID
    console.log(money); //log the money
});

eco.updateBalance('userID', 5000).then(newBalance => { //note : .then(newBalance => { is optional
    console.log(newBalance);
});
```
npm package: @itservtechnology/mail-listener
Description: Mail listener library for node.js. Get notification when new email arrived.
Author: Ömer HAMZA
Latest version: 1.0.1

# Overview

Mail-listener library for node.js. Get notification when new email arrived to inbox or when message metadata (e.g. flags) changes externally. Uses IMAP protocol.

## Use

Install

`npm install @itservtechnology/mail-listener`

JavaScript Code:

```javascript

const MailListener = require("@itservtechnology/mail-listener");

const mailListener = new MailListener({
  username: "imap-username",
  password: "imap-password",
  host: "imap-host",
  port: 993, // imap port
  tls: true,
  connTimeout: 10000, // Default by node-imap
  authTimeout: 5000, // Default by node-imap,
  debug: console.log, // Or your custom function with only one incoming argument. Default: null
  tlsOptions: { rejectUnauthorized: false },
  mailbox: "INBOX", // mailbox to monitor
  searchFilter: ["ALL"], // the search filter being used after an IDLE notification has been retrieved
  markSeen: true, // all fetched email willbe marked as seen and not fetched next time
  fetchUnreadOnStart: true, // use it only if you want to get all unread email on lib start. Default is `false`,
  attachments: true, // download attachments as they are encountered to the project directory
  attachmentOptions: { directory: "attachments/" } // specify a download directory for attachments
});

// start listening
mailListener.start();

// stop listening
// mailListener.stop();

mailListener.on("server:connected", function(){
  console.log("imapConnected");
});

mailListener.on("mailbox", function(mailbox){
  // this field in mailbox gives the total number of emails
  console.log("Total number of mails: ", mailbox.messages.total);
});

mailListener.on("server:disconnected", function(){
  console.log("imapDisconnected");
});

mailListener.on("error", function(err){
  console.log(err);
});

mailListener.on("headers", function(headers, seqno){
  // do something with mail headers
});

mailListener.on("body", function(body, seqno){
  // do something with mail body
})

mailListener.on("attachment", function(attachment, path, seqno){
  // do something with attachment
});

mailListener.on("mail", function(mail, seqno) {
  // do something with the whole email as a single object
})

// it's possible to access imap object from node-imap library for performing additional actions. E.x.
mailListener.imap.move(:msguids, :mailboxes, function(){})

```

## Attachments

Attachments in this version are buffered. This feature is based on how [mailparser](https://github.com/andris9/mailparser#attachments)'s simpleParser function handles attachments.
Setting `attachments: true` will download attachments as buffer objects by default to the project directory.
A specific download directory may be specified by setting `attachmentOptions: { directory: "attachments/"}`.
The `"attachment"` event will be fired every time an attachment is encountered.
npm package: @itsfan/changelogithub
Description: Generate changelog for GitHub.
Author: FAN
Latest version: 1.0.1

# changelogithub

[![NPM version](https://img.shields.io/npm/v/changelogithub?color=a1b858&label=)](https://www.npmjs.com/package/changelogithub)

Generate changelog for GitHub releases from [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/), powered by [changelogen](https://github.com/unjs/changelogen).

[👉 Changelog example](https://github.com/unocss/unocss/releases/tag/v0.39.0)

## Features

- Support exclamation mark as breaking change, e.g. `chore!: drop node v10`
- Grouped scope in changelog
- Create the release note, or update the existing one
- List contributors

## Usage

In GitHub Actions:

```yml
# .github/workflows/release.yml

name: Release

permissions:
  contents: write

on:
  push:
    tags:
      - 'v*'

jobs:
  release:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Set node
        uses: actions/setup-node@v4
        with:
          registry-url: https://registry.npmjs.org/
          node-version: lts/*

      - run: npx changelogithub # or changelogithub@0.12 to ensure a stable result
        env:
          GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}}
```

It will be trigged whenever you push a tag to GitHub that starts with `v`.

## Configuration

You can put a configuration file in the project root, named as `changelogithub.config.{json,ts,js,mjs,cjs}`, `.changelogithubrc` or use the `changelogithub` field in `package.json`.

## Preview Locally

```bash
npx changelogithub --dry
```

## Why?

I used to use [`conventional-github-releaser`](https://github.com/conventional-changelog/releaser-tools/tree/master/packages/conventional-github-releaser) for almost all my projects. Until I found that it [does NOT support using exclamation marks for breaking changes](https://github.com/conventional-changelog/conventional-changelog/issues/648) - hiding those important breaking changes in the changelog without the awareness from maintainers.

## License

[MIT](./LICENSE) License © 2022 [Anthony Fu](https://github.com/antfu)
npm package: @itsflexnet/npm
Description: The official NPM Module for itsflex.net
Latest version: 1.0.1

### Package to make api.itsflex.net easier to use!

## Installation

```bash
  npm install @itsflexnet/npm
```
    
## Usage/Examples

```javascript
const flex = require("@itsflexnet/npm")

await flex.getDJName("YOUR_API_KEY")
await flex.getCurrentSong("YOUR_API_KEY")
await flex.getListeners("YOUR_API_KEY")
await flex.getImage("YOUR_API_KEY")

//Optional: flex.getImage("YOUR_API_KEY", "image") (images include: "djAvatar", "djBanner", "songCover")
```
npm package: @itsflower/cli
Description: 🌸 flower CLI — scaffold structured development workflows
Latest version: 0.1.4

# @itsflower/cli

🌸 Scaffold structured development workflows in your project.

## Usage

```bash
# With npx (Node.js)
npx @itsflower/cli init

# With bunx (Bun)
bunx @itsflower/cli init
```

## Commands

### `flower init`

Initializes flower in your project by copying workflow templates to `.flower/templates/`:

- `requirement.md` — Define the problem, scope, and acceptance criteria
- `plan.md` — Break down work into ordered tasks with ACs
- `journal.md` — Log decisions and discoveries during implementation
- `review.md` — Post-implementation quality checklist and learnings

## License

MIT
npm package: @itsfuad/fragmentbuilder
Description: Builds a document fragment from a javascript object representing HTML.
Author: Fuad Hasan
Latest version: 1.0.2

# Javascript object to HTML fragment

Json to HTML is a function that converts a JSON object to HTML document fragment. This fragment then can be directly used inside innerHTML.

 example
 ```js
 const obj = {
  tag: 'div',
  text: 'Hello, World!',
  attr: {
   class: 'container',
   id: 'main'
  },
  childs: [
  {
   tag: 'h1',
   text: 'Hello, World!'
   },
  ]
 }
 const fragment = fragmentBuilder(obj);
 ```
npm package: @itsfuad/multipart-form-reader
Description: Multipart form reader
Author: Fuad Hasan
Latest version: 1.0.4

# Multipart form parser

This is a TypeScript module that provides functions to parse a multipart body buffer and extract its parts based on the provided boundary. It also includes utility functions to extract the boundary string from the Content-Type header and generate sample demo data for testing.

## Table of Contents

- [Installation](#installation)
- [Usage](#usage)
- [API](#api)
- [Demo Data](#demo-data)
- [Contributing](#contributing)
- [License](#license)


## Installation

This module is written in TypeScript and can be added to your project using npm:

```bash
npm install multipart-form-reader
```


## Usage

```js
import { readForm, setMaxFileSize } from 'multipart-form-reader';
import express from 'express';
import fs from 'fs';

const app = express();
const router = express.Router();
//10MB
const SIZE = 10 * 1024 * 1024;

setMaxFileSize(SIZE);

app.get('/', (req, res) => {
    res.send('Hello World!');
});

router.post('/', readForm, (req, res) => {
    console.log('File upload request received');
    //console.log('req.files', req.files);
    //console.log('req.body', req.body);
    //write the file to disk
    //create upload directory if it doesn't exist
    if (!fs.existsSync('./uploads')) {
        fs.mkdirSync('./uploads');
    }
    //write the file to disk
    fs.writeFileSync('./uploads/' + req.files[0].filename, req.files[0].data);
    res.send('File uploaded');
});

app.use('/test', router);

app.listen(3000, () => {
    console.log('Example app listening on port 3000!');
});
```