open-index/open-npm huggingface dataset:
npm package: @mkusaka/eslint-plugin-prefer-type-annotate
Description: Prefer add annotate for check `any` inferred point eslint rule.
Author: mkusaka
Latest version: 0.0.14

# eslint-plugin-prefer-type-annotate

Prefer add annotate for check `any` inferred point eslint rule.

## install

type anotate

```bash
npm install --save-dev @mkusaka/eslint-plugin-prefer-type-annotate
```

```bash
yarn add -D @mkusaka/eslint-plugin-prefer-type-annotate
```

## config
.eslintrc.js
```js
module.exports = {
  parser: "@typescript-eslint/parser",
  parserOptions: {
    ecmaVersion: 2020,
    sourceType: "module",
    project: "tsconfig.json", // these rules require type infomation
  },
  extends: [
    // "plugin:@mkusaka/prefer-type-annotaten/all-error-rules", // include all rule as error
    "plugin:@mkusaka/prefer-type-annotate/all-warn-rules", // include all rule as error
  ],
  plugins: [
    "@mkusaka/prefer-type-annotate",
  ],
  rules: {
    // you can also manually enable specific rule and disable it.
    // "@mkusaka/prefer-type-annotate/arrow-function-expression": "off"
  },
};
```


## Motivation

In cases when the noInplicitAny CompileOption off ts environment, function or variable declaration are sometime inferred to `any` type.

Since `any` type is very dangerous (it brake TypeScript typesystem..), most of TypeScript developer want to enable `noImplicitAny` compiler option.

So, some project, like gradually converting from js to ts all project files, must annotate implicit any `before` noImplicitAny to true.

But, implicit any detection are sometime too difficult.

To detect no implicit any and destroy it gradually, eslint is best solution of that. But, there is no good rule for this problem. (typedef rule can't detect inferred type information.)

## Rule Details

Examples of **incorrect** code for this rule:

```ts
let a;

const b = (c, d) => c + d

function e(f, g) {
  return f / g
}
```

Examples of **correct** code for this rule:

```ts
let a: string

const b = (c: number, d: number) => c + d

function e(f: number, g: number) {
  return f / g
}
```

## TODO
Add test for each rule.
npm package: @mkusaka/mcp-server-o4-search
Description: MCP server for web search using OpenAI models (o4-mini, gpt-5, etc.)
Author: @mkusaka
Latest version: 0.0.4

# @mkusaka/o4-search-mcp

An MCP (Model Context Protocol) server that provides web search capabilities using OpenAI models. The `o4-search` tool accepts text queries and returns AI-powered search results with advanced reasoning capabilities.

> Note: This is a personal fork of [yoshiko-pg/o3-search-mcp](https://github.com/yoshiko-pg/o3-search-mcp) maintained for my own use. The original author is not involved with this repository, its releases, or support.

## Supported Models

- `o4-mini` (default)
- `gpt-5`
- Any other OpenAI model that supports the responses API with web search tools

## Installation

### Using npx (Recommended)

Claude Code:

```
$ claude mcp add search -s user \
  -e OPENAI_API_KEY=your-api-key \
  -e OPENAI_MODEL=o4-mini \
  -e SEARCH_CONTEXT_SIZE=high \
  -e REASONING_EFFORT=high \
  -- npx @mkusaka/mcp-server-o4-search
```

json:

```json
{
  "mcpServers": {
    "o4-search": {
      "command": "npx",
      "args": ["@mkusaka/mcp-server-o4-search"],
      "env": {
        "OPENAI_API_KEY": "your-api-key",
        // Optional: o4-mini, gpt-5, etc. (default: o4-mini)
        "OPENAI_MODEL": "o4-mini",
        // Optional: low, medium, high (default: high)
        "SEARCH_CONTEXT_SIZE": "high",
        "REASONING_EFFORT": "high"
      }
    }
  }
}
```

### Local Development Setup

If you want to download and run the code locally:

```bash
# setup
git clone git@github.com:mkusaka/o4-search-mcp.git
cd o4-search-mcp
pnpm install
pnpm build
```

Claude Code:

```
$ claude mcp add search -s user \
  -e OPENAI_API_KEY=your-api-key \
  -e OPENAI_MODEL=o4-mini \
  -e SEARCH_CONTEXT_SIZE=high \
  -e REASONING_EFFORT=high \
  -- node /path/to/o4-search-mcp/build/index.js
```

json:

```json
{
  "mcpServers": {
    "o4-search": {
      "command": "node",
      "args": ["/path/to/o4-search-mcp/build/index.js"],
      "env": {
        "OPENAI_API_KEY": "your-api-key",
        // Optional: o4-mini, gpt-5, etc. (default: o4-mini)
        "OPENAI_MODEL": "o4-mini",
        // Optional: low, medium, high (default: high)
        "SEARCH_CONTEXT_SIZE": "high",
        "REASONING_EFFORT": "high"
      }
    }
  }
}
```
npm package: @mkusaka/md-ref-list
Description: Glob all list of links inside markdown & fetch its title & generate markdown list.
Author: mkusaka
Latest version: 0.0.4

# md-ref-list
Glob all list of links inside markdown & fetch its title & generate markdown list.

# install

npm
```bash
npm i -g @mkuska/md-ref-list
```

yarn
```bash
yarn global add @mkuska/md-ref-list
```

# usage
```bash
mrl "target file path"
```
npm package: @mkusaka/npmpackage_tutorial
Description: push test
Author: mkusaka
Latest version: 1.1.0

# npmpackage_tutorial
[![Build Status](https://travis-ci.org/mkusaka/npmpackage_tutorial.svg?branch=master)](https://travis-ci.org/mkusaka/npmpackage_tutorial)

# install

```bash
npm install --save @mkusaka/npmpackage_tutorial
```

# useage

index.js
```js
import { IsNullOrEmpty } from "@mkusaka/npmpackage_tutorial";

console.log(IsNullOrEmpty(""));
console.log(IsNullOrEmpty(null));
console.log(IsNullOrEmpty([]));
```

```bash
node index.js
# => true
#    true
#    true
```

more usecase has impremented in [test case](./test/index.ts).

# publish memo
```bash
npm version patch
npm publish
```

cf. https://efcl.info/2015/04/08/npm-publish-pattern/

# refer
- [Build an npm package with TypeScript in 10 minutes by Nilay Vishwakarma](https://medium.com/@nilayvishwakarma/build-an-npm-package-with-typescript-by-nilay-vishwakarma-f303d7072f80)
npm package: @mkusaka/reproduce
Description: install
Author: mkusaka
Latest version: 0.0.3
Deprecated: This package is no longer maintained.

# @mkusaka/reproduce

install

npm
```
npm install @mkusaka/reproduce ---save
```

yarn
```
yarn add @mkusaka/reproduce
```

# usage

```ts
import { reproduce } from "@mkusaka/reproduce"

const reducer = (state: {
  age: number,
  name: string
}, action) => {
  switch (action.type) {
    case "increment":
      // returns new object.
      // reproduce avoid to modify argument directly.
      // just as Immer's produce.
      return reproduce(state, (state) => {
        state.age++
      })
    default:
      return state
  }
}
```
npm package: @mkusaka/sitemap-crawler
Description: Extract content from sitemap URLs and save as markdown files
Author: mkusaka
Latest version: 0.0.1

# Sitemap Crawler

A command-line tool to extract content from sitemap URLs and save as markdown files.

## Features

- Extract URLs from a sitemap
- Process each URL with Mozilla's Readability to extract main content
- Convert content to markdown using Turndown
- Save each page as a markdown file in a specified output directory

## Installation

```bash
# Install globally from npm
npm install -g @mkusaka/sitemap-crawler

# Or use with npx
npx @mkusaka/sitemap-crawler <command>

# Alternatively, clone the repository
git clone https://github.com/mkusaka/sitemap-crawler.git
cd sitemap-crawler

# Install dependencies
pnpm install

# Build the project
pnpm run build
```

## Usage

```bash
# Basic usage
@mkusaka/sitemap-crawler crawl <sitemap-url> <output-directory>

# Example
@mkusaka/sitemap-crawler crawl https://example.com/sitemap.xml ./output

# With options
@mkusaka/sitemap-crawler crawl https://example.com/sitemap.xml ./output --continue --rate-limit 2
```

### Options

- `--debug`: Enable debug mode
- `--continue`: Continue processing even if a URL fails
- `-r, --retries <number>`: Number of retry attempts for failed URLs (default: 3)
- `-d, --retry-delay <number>`: Initial delay between retries in milliseconds (default: 1000)
- `-l, --rate-limit <number>`: Maximum number of requests per second (default: 1, 0 to disable)

## Output Format

Each URL is processed and saved as a markdown file with YAML frontmatter containing metadata:

```markdown
---
title: Page Title
url: https://example.com/page
siteName: Example Site
excerpt: A brief excerpt from the page
wordCount: 1234
---

# Page Title

Content converted to markdown...
```

## License

MIT
npm package: @mkushka/dell-brightness-sync
Description: A zero-dependency CLI tool to automatically sync an external Dell monitor's brightness with the Mac's built-in display using m1ddc on Apple Silicon.
Author: Misha Kushka
Latest version: 1.0.3

# Dell Monitor Brightness Sync

## TL;DR Automatic Setup
Just want it to work instantly? Run this script in your terminal to automatically install prerequisites, the package globally, and set it up to run in the background forever using PM2:

```bash
bash <(curl -sL https://raw.githubusercontent.com/kushkamisha/dell-brightness-sync/main/install.sh)
```

## Overview

A lightweight, **zero-dependency** Node.js CLI tool that automatically synchronizes the brightness of your external Dell monitor with your MacBook's built-in display. Built specifically for Apple Silicon Macs.

It runs quietly in the background, checking your built-in screen's brightness. When you adjust your MacBook's brightness using the keyboard, the external monitor will smoothly transition to match it!

## Prerequisites

This tool relies on macOS's native `corebrightnessdiag` for sensing the built-in display and `m1ddc` for controlling the Dell display via hardware DDC/CI commands.

1. **Apple Silicon Mac** (M1/M2/M3/M4)
2. **[Homebrew](https://brew.sh/)** installed
3. **m1ddc** installed via Homebrew:
   ```bash
   brew install m1ddc
   ```

## Manual Installation

You can run this directly without installing it globally, or install it on your system for continuous background use.

### Option 1: Run via npx (No install required)
```bash
npx @mkushka/dell-brightness-sync
```

### Option 2: Install Globally
```bash
npm install -g @mkushka/dell-brightness-sync
```
Then run simply:
```bash
dell-brightness-sync
```

## Manual Background Daemon Setup (PM2)

If you didn't use the TL;DR script, we recommend using PM2 to keep it running silently at all times:

```bash
# Start the background sync daemon
npx pm2 start dell-brightness-sync --name "dell-brightness-sync"

# Stop the daemon
npx pm2 stop dell-brightness-sync

# Make it auto-start whenever your Mac reboots
npx pm2 startup && npx pm2 save
```

## How It Works

1. Identifies your external Dell monitor via `m1ddc` display lists.
2. Polls your internal Mac screen's real brightness directly from Apple's `/usr/libexec/corebrightnessdiag` sensor every 1 second.
3. Automatically triggers a smooth, non-jarring easing transition to fade your external Dell screen brightness to perfectly match the internal screen.

## Testing

Due to the script's heavy dependency on direct local macOS hardware communication and connected physical displays, automated CI tests are not practical. The recommended testing methodology is manual execution. A smoke test is provided to verify code syntax:
```bash
npm test
```

## License

MIT