@modootoday/pmcp 0.13.1 → 0.14.0

package/plugins/react-is-19/LICENSE

@@ -0,0 +1,93 @@
+Elastic License 2.0
+
+URL: https://www.elastic.co/licensing/elastic-license
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject to
+the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor’s trademarks is subject
+to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that
+organization. **control** means ownership of substantially all the assets of an
+entity, or the power to direct its management and policies by vote, contract, or
+otherwise. Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your licenses.
+
+**trademark** means trademarks, service marks, and similar rights.

package/plugins/react-is-19/NOTICE

@@ -0,0 +1,51 @@
+pmcp
+
+Copyright (c) 2026 modootoday. All rights reserved.
+
+Licensor: modootoday
+Licensed under the Elastic License 2.0; see LICENSE.
+
+The licensor is modootoday, the company, not any individual contributor. This
+file names the licensor because the Elastic License 2.0 defines that term rather
+than carrying a copyright line of its own; LICENSE is kept unmodified.
+
+What the licence permits, in short, without replacing the terms in LICENSE:
+
+  - Using this software inside your own company, on any scale.
+  - Embedding it in a product you sell, and modifying or forking it.
+  - Redistributing it, with these notices intact.
+  - Running it locally as an MCP server, which is what it is for. A host
+    process spawning it on your own machine is use, not a hosted service.
+
+What it does not permit:
+
+  - Offering this software to third parties as a hosted or managed service.
+    A remotely hosted MCP endpoint serving other people is the case this
+    forbids.
+  - Circumventing licence key functionality.
+  - Removing or obscuring these notices.
+
+The Elastic License 2.0 is source-available, not an OSI-approved open source
+licence. It grants a patent licence and ends that licence if you assert a patent
+claim against the software; see the Patents section of LICENSE.
+
+LICENSE governs. Where this summary and LICENSE differ, LICENSE is what applies.
+
+---
+
+This software depends on the following packages, which are distributed under
+their own terms and are not covered by the licence above.
+
+  @modelcontextprotocol/server   MIT   Copyright (c) Anthropic, PBC
+  @modelcontextprotocol/core     MIT   Copyright (c) Anthropic, PBC
+  zod                            MIT   Copyright (c) Colin McDonnell
+  semver                         ISC   See the dependency's LICENSE file.
+  smol-toml              BSD-3-Clause   Copyright (c) Squirrel Chat et al.
+  yaml                           ISC   Copyright Eemeli Aro
+
+Full licence texts and copyright notices ship with those packages. Their
+respective licence terms govern distribution of those dependencies.
+
+@huggingface/transformers is an optional peer dependency. It is never
+distributed with this package; a user who wants semantic ranking installs it
+themselves, under its own Apache-2.0 terms.

package/plugins/react-is-19/gemini-extension.json

@@ -0,0 +1 @@
+{ "name": "react-is-19", "version": "19.0.0" }

package/plugins/react-is-19/plugin.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "react-is-19",
+  "version": "19.0.0",
+  "description": "Use react-is 19 to identify React element brands and validate component types. Covers the React 19 export surface, the removal of React 18 async/concurrent aliases, and standalone checks that run without JSX, React, a DOM, or a test runner.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/react-is-19/skills/react-is/SKILL.md

@@ -0,0 +1,131 @@
+---
+name: react-is
+description: Use react-is 19 to identify React element brands and validate component types. Covers the React 19 export surface, the removal of React 18 async/concurrent aliases, and standalone checks that run without JSX, React, a DOM, or a test runner.
+---
+
+Verified against react-is@19.2.8 on 2026-09-08. 2 of 2 examples executed.
+
+# react-is 19
+
+`react-is` provides brand checks for arbitrary values and React element types. Import the package namespace:
+
+```ts
+import * as ReactIs from "react-is";
+```
+
+## React 19 exports
+
+React 19 exposes these validation functions:
+
+- `isValidElementType`
+- `isElement`
+- `isFragment`
+- `isPortal`
+- `isStrictMode`
+- `isContextConsumer`
+- `isContextProvider`
+- `isForwardRef`
+- `isLazy`
+- `isMemo`
+- `isProfiler`
+- `isSuspense`
+- `isSuspenseList`
+
+It also exposes `typeOf`, which returns the React type brand for a React-created value, and these type-brand constants:
+
+- `Element`
+- `Fragment`
+- `Portal`
+- `StrictMode`
+- `ContextConsumer`
+- `ContextProvider`
+- `ForwardRef`
+- `Lazy`
+- `Memo`
+- `Profiler`
+- `Suspense`
+- `SuspenseList`
+
+## Validate component types
+
+`isValidElementType` accepts a host element name such as `"div"` and component functions. It is a check for a value that React can use as an element type, not a check that a value is already an element.
+
+```ts pmcp-example
+import * as assert from "node:assert/strict";
+import * as ReactIs from "react-is";
+
+function Component() {
+  return null;
+}
+
+assert.equal(ReactIs.isValidElementType("div"), true);
+assert.equal(ReactIs.isValidElementType(Component), true);
+assert.equal(ReactIs.isValidElementType(null), false);
+assert.equal(ReactIs.isValidElementType({}), false);
+```
+
+## Check arbitrary values without React or JSX
+
+All element predicates safely reject unrelated values. This makes them usable in a plain script, although a positive result generally requires a value created by React or ReactDOM.
+
+```ts pmcp-example
+import * as assert from "node:assert/strict";
+import * as ReactIs from "react-is";
+
+const value = {};
+
+assert.equal(ReactIs.isElement(value), false);
+assert.equal(ReactIs.isFragment(value), false);
+assert.equal(ReactIs.isPortal(value), false);
+assert.equal(ReactIs.isStrictMode(value), false);
+assert.equal(ReactIs.isContextConsumer(value), false);
+assert.equal(ReactIs.isContextProvider(value), false);
+assert.equal(ReactIs.isForwardRef(value), false);
+assert.equal(ReactIs.isLazy(value), false);
+assert.equal(ReactIs.isMemo(value), false);
+assert.equal(ReactIs.isProfiler(value), false);
+assert.equal(ReactIs.isSuspense(value), false);
+assert.equal(ReactIs.isSuspenseList(value), false);
+```
+
+## React-created values
+
+With React available, use `typeOf` and the predicates against values created by React:
+
+- `typeOf(<div />) === Element` and `isElement(<div />)` identify an element.
+- `typeOf(<></>) === Fragment` and `isFragment(<></>)` identify a fragment.
+- `isStrictMode(<React.StrictMode />)` and `typeOf(...) === StrictMode` identify strict mode.
+- `isContextConsumer(<ThemeContext.Consumer />)` and `isContextProvider(<ThemeContext.Provider />)` identify context values. Their brands are `ContextConsumer` and `ContextProvider`.
+
+These forms require React and JSX (or equivalent calls to React APIs), so they are not standalone `bun example.ts` examples under this skill's execution constraints.
+
+## Portals
+
+Portal checks require both ReactDOM and a DOM container:
+
+```js
+const div = document.createElement("div");
+const portal = ReactDOM.createPortal(<div />, div);
+ReactIs.isPortal(portal); // true
+ReactIs.typeOf(portal) === ReactIs.Portal; // true
+```
+
+This requires a browser-like `document`, ReactDOM, and a React-created element; it cannot run in the standalone no-DOM example environment.
+
+## React 18 compatibility trap
+
+Do not copy the older React 18 API shape into React 19 code:
+
+- React 19 does not export `isAsyncMode` or `isConcurrentMode`.
+- The corresponding `AsyncMode` and `ConcurrentMode` aliases from the older implementation are not part of the React 19 stable export list.
+- React 18 documentation showed `isValidElementType(React.createFactory("div"))`; that example is not included in the React 19 documentation.
+
+React 19 also has feature-aware handling for context consumer and provider brands. Use the exported `ContextConsumer` and `ContextProvider` constants and the matching predicates rather than assuming the older internal context symbols.
+
+## TypeScript
+
+The researched package metadata identifies `@types/react-is` as the separately published TypeScript declaration package. The package itself is not documented in the researched sources as shipping TypeScript declarations.
+
+## Not covered
+
+This skill does not cover React rendering, JSX compilation, ReactDOM setup, browser DOM setup, creation of portals, creation of contexts, or construction of forward-ref, lazy, memo, profiler, suspense, or suspense-list values. It also does not cover undocumented internal symbol shapes, bundler configuration, or the separately published declaration package beyond noting its existence.

package/plugins/react-markdown-10/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "react-markdown-10",
+  "version": "10.0.0",
+  "description": "Use react-markdown ^10.0.0 correctly as an ESM-only React 18+ component, including synchronous, asynchronous, plugin, filtering, URL, and migration guidance.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/react-markdown-10/LICENSE

@@ -0,0 +1,93 @@
+Elastic License 2.0
+
+URL: https://www.elastic.co/licensing/elastic-license
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject to
+the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor’s trademarks is subject
+to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that
+organization. **control** means ownership of substantially all the assets of an
+entity, or the power to direct its management and policies by vote, contract, or
+otherwise. Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your licenses.
+
+**trademark** means trademarks, service marks, and similar rights.

package/plugins/react-markdown-10/NOTICE

@@ -0,0 +1,51 @@
+pmcp
+
+Copyright (c) 2026 modootoday. All rights reserved.
+
+Licensor: modootoday
+Licensed under the Elastic License 2.0; see LICENSE.
+
+The licensor is modootoday, the company, not any individual contributor. This
+file names the licensor because the Elastic License 2.0 defines that term rather
+than carrying a copyright line of its own; LICENSE is kept unmodified.
+
+What the licence permits, in short, without replacing the terms in LICENSE:
+
+  - Using this software inside your own company, on any scale.
+  - Embedding it in a product you sell, and modifying or forking it.
+  - Redistributing it, with these notices intact.
+  - Running it locally as an MCP server, which is what it is for. A host
+    process spawning it on your own machine is use, not a hosted service.
+
+What it does not permit:
+
+  - Offering this software to third parties as a hosted or managed service.
+    A remotely hosted MCP endpoint serving other people is the case this
+    forbids.
+  - Circumventing licence key functionality.
+  - Removing or obscuring these notices.
+
+The Elastic License 2.0 is source-available, not an OSI-approved open source
+licence. It grants a patent licence and ends that licence if you assert a patent
+claim against the software; see the Patents section of LICENSE.
+
+LICENSE governs. Where this summary and LICENSE differ, LICENSE is what applies.
+
+---
+
+This software depends on the following packages, which are distributed under
+their own terms and are not covered by the licence above.
+
+  @modelcontextprotocol/server   MIT   Copyright (c) Anthropic, PBC
+  @modelcontextprotocol/core     MIT   Copyright (c) Anthropic, PBC
+  zod                            MIT   Copyright (c) Colin McDonnell
+  semver                         ISC   See the dependency's LICENSE file.
+  smol-toml              BSD-3-Clause   Copyright (c) Squirrel Chat et al.
+  yaml                           ISC   Copyright Eemeli Aro
+
+Full licence texts and copyright notices ship with those packages. Their
+respective licence terms govern distribution of those dependencies.
+
+@huggingface/transformers is an optional peer dependency. It is never
+distributed with this package; a user who wants semantic ranking installs it
+themselves, under its own Apache-2.0 terms.

package/plugins/react-markdown-10/gemini-extension.json

@@ -0,0 +1 @@
+{ "name": "react-markdown-10", "version": "10.0.0" }

package/plugins/react-markdown-10/plugin.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "react-markdown-10",
+  "version": "10.0.0",
+  "description": "Use react-markdown ^10.0.0 correctly as an ESM-only React 18+ component, including synchronous, asynchronous, plugin, filtering, URL, and migration guidance.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/react-markdown-10/skills/react-markdown/SKILL.md

@@ -0,0 +1,163 @@
+---
+name: react-markdown
+description: Use react-markdown ^10.0.0 correctly as an ESM-only React 18+ component, including synchronous, asynchronous, plugin, filtering, URL, and migration guidance.
+---
+
+Verified against react-markdown@10.1.0 on 2026-09-08. 3 of 3 examples executed.
+
+# react-markdown
+
+## Version and runtime
+
+This skill targets `react-markdown` `^10.0.0`, meaning the 10.x release line.
+
+- The package is ESM-only.
+- Node.js 16+ and React 18+ are required.
+- The default export is `Markdown`.
+- Named exports include `MarkdownAsync`, `MarkdownHooks`, and `defaultUrlTransform`.
+- Type exports include `AllowElement`, `Components`, `ExtraProps`, `HooksOptions`, `Options`, and `UrlTransform`.
+
+Import it with ESM syntax:
+
+```ts pmcp-example
+import assert from 'node:assert/strict'
+import React from 'react'
+import Markdown, {defaultUrlTransform} from 'react-markdown'
+
+const element = Markdown({children: '# Hello'})
+
+assert.equal(React.isValidElement(element), true)
+assert.equal(typeof defaultUrlTransform, 'function')
+```
+
+`react-markdown` is a React component, not a standalone Markdown-to-string converter. In an application, render it through React, for example with `createRoot(...).render(...)`. A direct script can still call the component function and inspect that it produces a React element, as in the example above; it does not produce HTML text.
+
+## Basic rendering
+
+Pass Markdown as the `children` option:
+
+```tsx
+<Markdown>{'# Hi, *Pluto*!'}</Markdown>
+```
+
+The documented component signature is `Markdown(options: Options): ReactElement`.
+
+## Options and plugins
+
+`Options` includes:
+
+- `children`
+- `components`
+- `remarkPlugins`
+- `rehypePlugins`
+- `allowedElements`
+- `disallowedElements`
+- `skipHtml`
+- `unwrapDisallowed`
+- `remarkRehypeOptions`
+- `urlTransform`
+
+Plugins are supplied as React props. GitHub-Flavored Markdown is not built in; add `remark-gfm` through `remarkPlugins` when needed:
+
+```tsx
+import Markdown from 'react-markdown'
+import remarkGfm from 'remark-gfm'
+
+<Markdown remarkPlugins={[remarkGfm]}>{'Just a link: www.nasa.gov.'}</Markdown>
+```
+
+`components` maps rendered element names to another tag or to a component. For example, an `h1` can be rendered as `h2`, and an `em` renderer receives props including `node`:
+
+```tsx
+<Markdown
+  components={{
+    h1: 'h2',
+    em(props) {
+      const {node, ...rest} = props
+      return <i style={{color: 'red'}} {...rest} />
+    }
+  }}
+/>
+```
+
+Raw HTML requires the separate `rehype-raw` plugin and a trusted environment. Without that plugin, HTML is escaped or ignored when `skipHtml` is enabled.
+
+## URL handling
+
+The package exports `defaultUrlTransform(url: string): string`. Pass a custom URL transform with the `urlTransform` option when URL handling needs to differ from the default.
+
+```ts pmcp-example
+import assert from 'node:assert/strict'
+import {defaultUrlTransform} from 'react-markdown'
+
+assert.equal(typeof defaultUrlTransform, 'function')
+assert.equal(typeof defaultUrlTransform('https://example.com'), 'string')
+```
+
+## Asynchronous processing
+
+Use `MarkdownAsync` when remark or rehype processing is asynchronous. Its signature is `MarkdownAsync(options: Options): Promise<ReactElement>`.
+
+```ts pmcp-example
+import assert from 'node:assert/strict'
+import React from 'react'
+import {MarkdownAsync} from 'react-markdown'
+
+const element = await MarkdownAsync({children: '# Hi'})
+
+assert.equal(React.isValidElement(element), true)
+```
+
+The package also documents a subpath import:
+
+```ts
+import MarkdownAsync from 'react-markdown/async'
+
+const result = await MarkdownAsync({children: '# Hi'})
+```
+
+`MarkdownAsync` supports async plugins through `async`/`await`. Components returning promises are supported on the server.
+
+For client-side async support, use `MarkdownHooks`. It uses `useEffect` and `useState`, runs on the client, and does not immediately render processed content. Its `fallback` option is shown while processing:
+
+```tsx
+import {MarkdownHooks} from 'react-markdown'
+
+<MarkdownHooks fallback={<p>Loading…</p>} remarkPlugins={[asyncPlugin]}>
+  {markdown}
+</MarkdownHooks>
+```
+
+`fallback` belongs to `HooksOptions` and `MarkdownHooks`; it is not an option for regular `Markdown`.
+
+A direct `bun example.ts` script is not a React renderer, so it cannot exercise `MarkdownHooks`' client hook lifecycle. Render it inside a React application instead.
+
+## v10 migration mistakes
+
+### Do not pass `className` to `Markdown`
+
+Version 10 removed the `className` prop. Wrap the component explicitly instead:
+
+```tsx
+<div className="markdown-body">
+  <Markdown>{markdown}</Markdown>
+</div>
+```
+
+This also lets the caller choose the wrapper tag and its other props.
+
+### Do not use pre-v9 URL transform names
+
+Older examples may use `transformImageUri` or `transformLinkUri`. Those were replaced by the single `urlTransform` option.
+
+### Do not assume the old package/runtime shape
+
+Older code may assume CommonJS, older Node or React minimums, or imports that do not follow the package's newer exports. Version 10 is ESM-only, targets Node.js 16+, and requires React 18+ and `@types/react` 18+.
+
+## What this skill does not cover
+
+- The detailed behavior of individual Markdown constructs or URL transformations.
+- The API or configuration of third-party plugins such as `remark-gfm` or `rehype-raw`.
+- Authoring async remark or rehype plugins.
+- React DOM setup, server rendering setup, or client hook lifecycle execution.
+- The exact React element tree or generated HTML after a renderer processes the returned element.

package/plugins/react-router-8/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "react-router-8",
+  "version": "8.0.0",
+  "description": "Use react-router ^8.0.0 APIs correctly, including v8 import boundaries, pure path helpers, and the parts that require a React or framework runtime.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}