open-index/open-npm huggingface dataset:
npm package: @macklinu/chord-diagram
Description: React components for rendering SVG guitar chord diagrams
Author: Macklin Underdown
Latest version: 1.0.1

# @macklinu/chord-diagram

> React components for rendering SVG guitar chord diagrams

## Getting started

Install the package.

```bash
pnpm add @macklinu/chord-diagram
```

It's also required to use [Tailwind](https://tailwindcss.com/) with this component.

```bash
pnpm add tailwindcss @tailwindcss/vite -D
```

Wherever you will be using the chord diagram component, make sure to include this library's styles as a [Tailwind source](https://tailwindcss.com/docs/detecting-classes-in-source-files#explicitly-registering-sources)

```css
@import 'tailwindcss';
@source "../node_modules/@macklinu/chord-diagram";
```

Then render the guitar chord diagram using `note-note-note-note-note-note`, where `note` is either the literal `x` (muted string) or a numeric value (0-24) to indicate which fret should be played. For example, C Major (open) would look like this:

```tsx
import { GuitarChordDiagram } from '@macklinu/chord-diagram'

const MyComponent = () => {
  return <GuitarChordDiagram chord='x-3-2-0-1-0' />
}
```
npm package: @macklinu/cx
Description: A utility for creating className strings
Author: Macklin Underdown
Latest version: 3.0.0

# @macklinu/cx

> A utility for creating className strings

## Installation

```sh
pnpm add @macklinu/cx
```

## Usage

This is a combination of two libraries that I always use with Tailwind:

- [clsx](https://github.com/lukeed/clsx)
- [tailwind-merge](https://github.com/dcastil/tailwind-merge)

```ts
import { cx } from "@macklinu/cx";

cx("foo", "bar"); // "foo bar"

// say state === "loading"
cx("bg-red", "text-white", state === "loading" && "is-loading"); // "bg-red text-white is-loading"

cx(); // ""
```
npm package: @macklinu/effect-jscodeshift
Description: Helpers for jscodeshift + effect
Latest version: 0.1.0

# @macklinu/effect-jscodeshift

> Helpers for jscodeshift + effect

## Installation

```sh
pnpm add jscodeshift effect @macklinu/effect-jscodeshift
```

## Usage

```ts
import * as Node from '@macklinu/effect-jscodeshift'
import * as j from 'jscodeshift'

declare const node: j.Node
if (Node.is(node, 'Literal')) {
  node // j.Literal
}
```
npm package: @macklinu/effect-web
Description: Common services used when bridging web frameworks with Effect
Author: Mackie Underdown
Latest version: 0.2.0

# @macklinu/effect-web

> Common services used when bridging web frameworks with Effect

## Installation

```sh
pnpm add @macklinu/effect-web
```

## Usage

There are 3 main web Effect services (`Context.Tag`) that you can implement for your web framework of choice:

- `RequestParams`: the parameters found in the file path for a framework with file based routing
- `ServerRequest`: the incoming request for an SSR framework
- `ServerResponse`: the outgoing response for an SSR framework

Anyone can then inject the service into an `Effect.Effect` in order to help bridge the gap between your web framework of choice and your Effect domain. For example:

```ts
import { Effect, Schema } from 'effect'

import { RequestParams } from '@macklinu/effect-web'

const requestHandler = Effect.gen(function* () {
  const { slug } = yield* RequestParams.pipe(
    Schema.decodeUnknown(Schema.Struct({ slug: Schema.String }))
  )

  // ...
})

const result = await Effect.runPromiseExit(
  requestHandler.pipe(Effect.provide(SomeImplementation.layer))
)
```

Notice that `SomeImplementation.layer` is provided on a per-request basis. This import isn't real but is a placeholder for the framework implementation of your choice. I maintain the following implementations:

- `@macklinu/effect-web-astro`: bindings for the [Astro](https://astro.build/) framework
npm package: @macklinu/effect-web-astro
Description: Astro implementation for @macklinu/effect-web
Author: Mackie Underdown
Latest version: 2.1.0

# @macklinu/effect-web-astro

> Astro implementation for `@macklinu/effect-web`

## Installation

```sh
pnpm add @macklinu/effect-web-astro
```

Also ensure you install the required peer dependencies:

- `@macklinu/effect-web`
- `astro`
- `effect`
- `@effect/platform`

## Usage

```ts
import { Effect, Schema } from 'effect'

import { RequestParams } from '@macklinu/effect-web'
import { EffectWebAstro } from '@macklinu/effect-web-astro'

const requestHandler = Effect.gen(function* () {
  const { slug } = yield* RequestParams.pipe(
    Schema.decodeUnknown(Schema.Struct({ slug: Schema.String }))
  )

  // ...
})

const result = await Effect.runPromiseExit(
  requestHandler.pipe(
    // Provide the Astro global/context to your Effect
    EffectWebAstro.provideService(Astro)
  )
)
```

More docs to come as I implement this into projects and have better examples.
npm package: @macklinu/eslint-config
Description: My personal ESLint configuration
Author: Mackie Underdown
Latest version: 0.4.2

# @macklinu/eslint-config

> My personal ESLint configuration

## Installation

```bash
pnpm add -D @macklinu/eslint-config eslint
```

## Usage

Use the new ESLint v9 flat configuration format and create a `eslint.config.js` file in the root of your project:

```js
import config from '@macklinu/eslint-config'

export default [...config]
```

If you are using React and Vitest, you can add those configurations as well:

```js
import config from '@macklinu/eslint-config'
import react from '@macklinu/eslint-config/react'
import vitest from '@macklinu/eslint-config/vitest'

export default [...config, ...react, ...vitest]
```

### VSCode

I recommend enabling auto-fix on save by adding the following to your VSCode settings:

```json
{
  "editor.codeActionsOnSave": {
    "source.fixAll": "explicit"
  }
}
```
npm package: @macklinu/jest-environment-jsdom-fifteen
Description: A modification of jest-environment-dom to support jsdom@15
Latest version: 0.2.0

# @macklinu/jest-environment-jsdom-fifteen

> A modification of [jest-environment-dom](https://github.com/facebook/jest/tree/v24.8.0/packages/jest-environment-jsdom) to support jsdom@15

:warning: This is experimental! Use at your own risk! :warning:

## Install

```sh
$ yarn add @macklinu/jest-environment-jsdom-fifteen --dev
```

## Usage

Update your Jest configuration's `testEnvironment` option.

```json
{
  "jest": {
    "testEnvironment": "@macklinu/jest-environment-jsdom-fifteen"
  }
}
```
npm package: @macklinu/neverthrow
Description: A collection of utilities used alongside neverthrow
Author: Macklin Underdown
Latest version: 0.2.0

# @macklinu/neverthrow

> A collection of utilities used alongside [neverthrow](https://github.com/supermacro/neverthrow)

## Installation

```sh
pnpm add neverthrow @macklinu/neverthrow
```

## Usage

This library is grouped into various modules by scope or library.

### `/zod`

If using this module, ensure you have [`zod`](https://zod.dev/) installed.

```sh
pnpm add zod
```

#### `zodParse()`

A wrapper around zod/v4's schema parsing functionality to convert it into a `Result`.

```ts
import { zodParse } from '@macklinu/neverthrow/zod'
import { z } from 'zod/v4'

const Schema = z.string()

zodParse(Schema, 'hello') // => ok('hello')
zodParse(Schema, 1) // => err(z.ZodError)
```
npm package: @macklinu/prettier-config
Description: My personal Prettier configuration
Author: Mackie Underdown
Latest version: 0.1.0

# @macklinu/prettier-config

> My personal [Prettier](https://prettier.io) configuration

## Installation

```bash
pnpm install -D @macklinu/prettier-config prettier
```

## Usage

This package requires ES Modules, so make sure to add `"type": "module"` to your `package.json`.

To use the configuration, add a `.prettierrc` file with the following content:

```json
"@macklinu/prettier-config"
```

If you need to override specific options or add `plugins`, use a `prettier.config.js` file instead.

```js
// prettier.config.js
import config from '@macklinu/prettier-config'

export default {
  ...config,
  plugins: ['prettier-plugin-tailwindcss'],
}
```
npm package: @macknolandev/clerk-zod
Description: Zod Schema for Clerk JSON
Author: Mackenzie Nolan
Latest version: 1.0.10

# @macknolandev/clerk-zod

Zod schemas for Clerk's JSON models. This package provides type-safe validation for Clerk's API responses and webhook payloads.

## Installation

```bash
pnpm add @macknolandev/clerk-zod
```

## Usage

```ts
import { ClerkUserJSONSchema } from "@macknolandev/clerk-zod";

const user = ClerkUserJSONSchema.parse({
  id: "user_123",
  email: "test@test.com",
});
```
npm package: @macknolandev/marianatek-node
Description: A Node.js client for the Mariana Tek API
Author: Mackenzie Nolan
Latest version: 0.2.4

# Mariana Tek Node.js SDK

[![npm version](https://img.shields.io/npm/v/@macknolandev/marianatek-node)](https://www.npmjs.com/package/@macknolandev/marianatek-node)
[![License](https://img.shields.io/github/license/mackenzienolan/marianatek-node)](LICENSE)

An unofficial Node.js SDK for Mariana Tek's APIs. This library provides convenient access to Mariana Tek's fitness studio management API for applications written in JavaScript and TypeScript.

## Installation

```sh
npm install @macknolandev/marianatek-node
# or
yarn add @macknolandev/marianatek-node
# or
pnpm add @macknolandev/marianatek-node
```

## Features

- Full TypeScript support
- Easy authentication with API keys
- Simplified access to Mariana Tek's endpoints
- Promise-based API for cleaner asynchronous code

## Usage

### Importing the SDK

```typescript
import { createMarianaTekClient } from "@macknolandev/marianatek-node";
```

### Initializing the SDK

```typescript
const mt = createMarianaTekClient({
  token: "your_access_token_here",
  subdomain: "your_subdomain_here",
});
```

## API Reference

### `createMarianaTekClient(options)`

Creates a new instance of the SDK.

#### Options

- `token` (string, required): Your Mariana Tek access token.
- `subdomain` (string, required): Your Mariana Tek subdomain.

### Methods

## 🤝 How to Contribute

We're open to all community contributions!

## 📝 License

This project is licensed under the **MIT license**.

See [LICENSE](https://github.com/mackenzienolan/marianatek-node/blob/main/LICENSE) for more information.

## Disclaimer

This SDK is unofficial and not affiliated with Mariana Tek. Use at your own risk.
npm package: @mackody/align-ui-kit
Description: A shadcn-compatible component library based on AlignUI design system
Author: Cody
Latest version: 0.1.0

# @align-ui/kit

A shadcn/ui-compatible component library based on the AlignUI design system. Built with TypeScript, Tailwind CSS, and Radix UI primitives.

## =� Features

- **shadcn/ui Compatible**: Drop-in replacement with CLI support
- **Zero Hardcoding**: All values use semantic design tokens
- **Full Tailwind Integration**: Customizable via Tailwind configuration
- **TypeScript First**: Complete type safety with proper IntelliSense
- **Next.js Themes**: Built-in dark mode support
- **Semantic Tokens**: Production-ready color system
- **Accessibility**: WCAG 2.1 AA compliant components
- **Tree Shakeable**: Import only what you need

## =� Installation

```bash
npm install @align-ui/kit
# or
yarn add @align-ui/kit
# or
pnpm add @align-ui/kit
```

## =� Setup

### 1. Configure Tailwind CSS

Add the AlignUI theme to your `tailwind.config.js`:

```javascript
import { designTokens } from '@align-ui/kit/tokens'

export default {
  // ... your existing config
  content: [
    // ... your existing content paths
    './node_modules/@align-ui/kit/src/**/*.{js,ts,jsx,tsx}',
  ],
  theme: {
    extend: {
      fontSize: designTokens.typography,
      boxShadow: designTokens.shadows,
      borderRadius: designTokens.borderRadius,
      // ... other token extensions
    },
  },
}
```

### 2. Add CSS Variables

Import the theme CSS in your global CSS file:

```css
@import '@align-ui/kit/styles';
```

Or in your Next.js `_app.tsx`:

```typescript
import '@align-ui/kit/styles'
```

## <� Usage

### Basic Example

```typescript
import { Button, Card, CardHeader, CardTitle, CardContent } from '@align-ui/kit'

function MyComponent() {
  return (
    <Card>
      <CardHeader>
        <CardTitle>Welcome to AlignUI Kit</CardTitle>
      </CardHeader>
      <CardContent>
        <Button variant="default" size="medium">
          Get Started
        </Button>
      </CardContent>
    </Card>
  )
}
```

## >� Available Components

- **Button** - Multiple variants and sizes
- **Input** - Form input with error states
- **Label** - Accessible form labels
- **Card** - Content containers

More components coming soon!

## =O Credits

Built on top of the exceptional AlignUI design system by [Doukan �avu_](https://github.com/alignui).
npm package: @macksterino/esportal-wrapper
Description: A node.js wrapper for the Esportal API.
Author: macksterino
Latest version: 1.0.4

# @macksterino/esportal-wrapper

A simple node.js wrapper for the Esportal API. It provides a simple interface for easy interaction.

## Usage
### Installation
`$ npm install --save-dev @macksterino/esportal-wrapper`

### Methods
*Returns all available information for the specified user. The identifier can be either the user id or username.*
- `fetchUserProfile(identifier: string | number): Promise<UserProfile>`

*Returns all available information for the specified team. The identifier can be either the team id or name.*
- `fetchTeamProfile(identifier: string | number): Promise<TeamProfile>`

*Returns all available information for the specified match. The id is the match lobby id.*
- `fetchMatch(id: number): Promise<Match>`

*Returns all available information for the specified gather. The id is the gather lobby id.*
- `fetchGather(id: number): Promise<Gather>`

### Examples
For TypeScript:
```
import { Esportal } from "@macksterino/esportal-wrapper";

const esportal = new Esportal();

(async () => {
	const user = await esportal.fetchUserProfile("mankan");
	console.log(user);
})();
```

For JavaScript:
```
const libesportal = require("@macksterino/esportal-wrapper");

const esportal = new libesportal.Esportal();

(async () => {
	const user = await esportal.fetchUserProfile("mankan");
	console.log(user);
})();
```

Using filters/excludes:
```
import { Esportal, EsportalOptions } from "@macksterino/esportal-wrapper";

// this will exclude friends from the query when fetching a userprofile
const options: EsportalOptions = {
	exclude: {
		friends: true
	}
}

const esportal = new Esportal(options);

(async () => {
	const user = await esportal.fetchUserProfile("mankan");
	console.log(user);
})();
```
npm package: @macnishio/windsurf-mcp-server
Description: AWSベースのClaude Desktop MCPサーバー
Author: MacNishio
Latest version: 0.4.22

# WindsurfMCP360

Claude Desktop用のAWSベースMCPサーバー

## 概要

WindsurfMCP360は、Claude Desktopと連携する高性能なModel Context Protocol (MCP) サーバーです。AWSのサーバーレスアーキテクチャを活用し、WebSocketを通じて安定した通信を実現します。

## 特徴

- **AWSサーバーレスアーキテクチャ**: Lambda、API Gateway、DynamoDBを活用
- **安定したWebSocket通信**: Claude Desktopとの信頼性の高い接続
- **簡単な設定**: 設定ファイルの自動生成
- **デプロイツール内蔵**: AWS環境への簡単なデプロイ

## インストール

```bash
# グローバルインストール
npm install -g windsurf-mcp-server

# または、npxを使用
npx windsurf-mcp-server
```

## 使用方法

### 基本的な起動

```bash
# グローバルインストールした場合
windsurf-mcp-server start

# または、npxを使用
npx windsurf-mcp-server start
```

### AWSインフラストラクチャのデプロイ

```bash
# AWSプロファイルを指定してデプロイ
windsurf-mcp-server deploy --profile your-aws-profile

# リージョンとステージを指定
windsurf-mcp-server deploy --profile your-aws-profile --region ap-northeast-1 --stage prod
```

### Claude Desktop用の設定の生成

```bash
# 設定JSONを表示
windsurf-mcp-server config

# 特定ステージ用の設定を表示
windsurf-mcp-server config --stage dev
```

## Claude Desktop設定

以下の設定をClaude Desktopの設定ファイルに追加してください：

```json
{
  "mcpServers": {
    "windsurf-mcp-server": {
      "command": "npx",
      "args": ["windsurf-mcp-server", "start"],
      "env": {
        "FASTMCP_LOG_LEVEL": "INFO",
        "AWS_PROFILE": "your-aws-profile"
      },
      "autoApprove": []
    }
  }
}
```

## AWS環境変数

- `AWS_PROFILE`: AWS CLIプロファイル名
- `AWS_REGION`: AWSリージョン（デフォルト: ap-northeast-1）
- `STAGE`: デプロイステージ（デフォルト: prod）
- `WEBSOCKET_ENDPOINT`: WebSocketエンドポイントのURL
- `CONNECTION_TABLE_NAME`: DynamoDBテーブル名

## uvxを使用する方法

uvxコマンドを使用して実行することもできます：

```json
{
  "mcpServers": {
    "macnishio.windsurf-mcp-server": {
      "command": "uvx",
      "args": ["macnishio.windsurf-mcp-server@latest"],
      "env": {
        "FASTMCP_LOG_LEVEL": "INFO",
        "AWS_PROFILE": "your-aws-profile"
      },
      "autoApprove": []
    }
  }
}
```

## ログ

ログは以下の場所に保存されます：

- デフォルト: `./logs/windsurf-mcp.log`
- カスタム: 環境変数 `LOG_DIR` と `LOG_FILE` で指定

## ライセンス

MIT

## 作者

MacNishio
npm package: @macnishio/zoho-mcp-server
Description: Zoho API integration server for Model Context Protocol
Author: macnishio
Latest version: 1.2.26

# Zoho MCP Server

Zoho APIのためのModel Context Protocol統合サーバー。このサーバーはZoho CRM、Zoho Desk、Zoho Booksとの統合を提供します。

## 機能

- Zoho CRM、Desk、Booksとの連携
- HTTPおよび標準入出力（stdio）トランスポートのサポート
- Server-Sent Events (SSE)によるリアルタイム通信
- 自動トークン更新
- 詳細なログ出力

## インストール

### グローバルインストール

```bash
npm install -g @macnishio/zoho-mcp-server
```

### ローカルインストール

```bash
npm install @macnishio/zoho-mcp-server
```

## 使用方法

### グローバルインストール後

```bash
zoho-mcp-server
```

### ローカルインストール後

```bash
npx zoho-mcp-server
```

または`package.json`に以下を追加:

```json
"scripts": {
  "zoho-mcp": "zoho-mcp-server"
}
```

その後:

```bash
npm run zoho-mcp
```

## 設定

サーバーを利用するには、Zoho APIのクライアントIDとクライアントシークレットが必要です。これらは環境変数または設定ファイルで指定できます。

### 環境変数

```
ZOHO_CRM_CLIENT_ID=your_crm_client_id
ZOHO_CRM_CLIENT_SECRET=your_crm_client_secret
ZOHO_DESK_CLIENT_ID=your_desk_client_id
ZOHO_DESK_CLIENT_SECRET=your_desk_client_secret
ZOHO_BOOKS_CLIENT_ID=your_books_client_id
ZOHO_BOOKS_CLIENT_SECRET=your_books_client_secret
```

### トランスポートタイプ

標準入出力（デフォルト）またはHTTPを使用してサーバーを実行できます:

```
MCP_TRANSPORT_TYPE=stdio # デフォルト
# または
MCP_TRANSPORT_TYPE=http
MCP_HTTP_PORT=3005 # デフォルトのHTTPポート
```

## APIドキュメント

以下のZoho APIエンドポイントが実装されています:

- `getConnectionStatus` - Zoho各サービスとの接続状態を確認
- `getInvoices` - Zoho Booksから請求書データを取得

## 開発

```bash
# 依存関係のインストール
npm install

# 開発サーバーの起動
npm run dev

# ビルド
npm run build

# テスト
npm test
```

## 公開手順

パッケージの公開手順については、[PUBLISHING.md](./PUBLISHING.md)を参照してください。

## 変更履歴

各バージョンでの変更点については、[CHANGELOG.md](./CHANGELOG.md)を参照してください。

## ライセンス

MIT

## 作者

macnishio