nuxt-ai-ready 2.5.3 → 3.0.0

package/node_modules/mdream/skills/mdream/SKILL.md

@@ -1,124 +0,0 @@
----
-name: mdream
-description: Convert HTML to Markdown, plain text, or safe HTML with mdream, the Rust engine for Node, edge, and the browser. Use when a task mentions mdream, htmlToMarkdown, streamHtmlToMarkdown, the minimal preset, frontmatter or extraction callbacks, tagOverrides, clean options, the mdream CLI, or errors such as "Custom hook plugins require @mdream/js" or ERR_PACKAGE_PATH_NOT_EXPORTED for mdream/plugins.
----
-
-# mdream
-
-This Skill covers `mdream` 2.0.0-beta.0. The package wraps a Rust converter: NAPI in Node, WASM on edge runtimes and in the browser.
-`@mdream/js` is a separate pure JS engine. It has hook plugins, the splitter, `llms.txt` generation, and content negotiation. Its option shape differs; see [Traps](#traps).
-
-## Setup
-
-```ts
-import { htmlToMarkdown } from 'mdream'
-
-const markdown = htmlToMarkdown('<main><h1>Docs</h1></main>', {
-  origin: 'https://example.com',
-  minimal: true,
-})
-```
-
-- `htmlToMarkdown` is synchronous in Node and on edge runtimes. It returns a string.
-- Set `origin` to make relative `href` and `src` values absolute. Without it, they stay relative.
-- If a bundler fails on the native binding, mark `mdream` as external. In Next.js, add it to `serverExternalPackages`. `@mdream/vite` does this for you.
-
-## Automatic behaviour
-
-Default output keeps everything: navigation, forms, footers, and text hidden with CSS classes.
-The `<title>` text never appears in the body. Read it with `frontmatter` or `extraction`.
-
-`minimal: true` turns on these options. Each one is off without it.
-
-| Option | Effect under `minimal` |
-|---|---|
-| `frontmatter` | YAML frontmatter from `<title>` and `<meta>`. |
-| `isolateMain` | Keeps `<main>`, else the content from the first heading to the first `<footer>`. |
-| `tailwind` | `font-bold` becomes `**bold**`. `hidden` and `absolute` content is dropped. |
-| `filter` | Excludes `form`, `fieldset`, `object`, `embed`, `footer`, `aside`, `iframe`, `input`, `textarea`, `select`, `button`, `nav`. |
-| `clean` | All cleanup: tracking parameters, `#` links, images without alt, and more. |
-
-To turn one off, pass it as `false`: `{ minimal: true, frontmatter: false, clean: false }`.
-A `filter` under `minimal` adds to the excludes above: `{ minimal: true, filter: { exclude: ['h1'] } }` drops `h1` and every default tag. `filter: false` keeps forms and `nav`.
-
-## Common tasks
-
-Read metadata and matched elements in one pass:
-
-```ts
-import { htmlToMarkdown } from 'mdream'
-
-const links: string[] = []
-let title = ''
-const markdown = htmlToMarkdown('<html><head><title>T</title></head><body><a href="/a">A</a></body></html>', {
-  frontmatter: (fm) => { title = fm.title ?? '' },
-  extraction: {
-    'a[href]': (el) => { links.push(el.attributes.href ?? '') },
-  },
-})
-```
-
-Stream a large response. The stream takes the same options, and the callbacks run once, after the last chunk is read:
-
-```ts
-import { streamHtmlToMarkdown } from 'mdream'
-
-const response = await fetch('https://example.com')
-let markdown = ''
-let title = ''
-for await (const chunk of streamHtmlToMarkdown(response.body, {
-  origin: 'https://example.com',
-  minimal: true,
-  frontmatter: (fm) => { title = fm.title ?? '' },
-})) {
-  markdown += chunk
-}
-```
-
-Render a custom element with Markdown semantics. Unknown tags output only their text.
-
-```ts
-import { htmlToMarkdown } from 'mdream'
-
-htmlToMarkdown('<x-heading>Title</x-heading><callout>Read this</callout>', {
-  tagOverrides: {
-    'x-heading': 'h2',
-    'callout': { enter: '> **Note:** ', exit: '', spacing: [2, 2] },
-  },
-})
-// ## Title\n\n> **Note:** Read this
-```
-
-Other output: `format: 'text'` gives plain text, `format: 'html'` gives allowlisted semantic HTML. `wrapWidth: 80` wraps prose only, never code, tables, or headings.
-
-CLI: `curl -s URL | mdream --origin URL --preset minimal`. It streams stdin to stdout. Flags: `--format`, `--text`, `--wrap-width`.
-
-## Traps
-
-- **Hook plugins are not in this package.** An array in `plugins` throws `Custom hook plugins require @mdream/js`. Use `@mdream/js` with `hooks: [createPlugin({...})]` from `@mdream/js/plugins`.
-- **`@mdream/js` nests options under `plugins`.** It throws a `TypeError` on `minimal`, `frontmatter`, `isolateMain`, `tailwind`, `filter`, `extraction`, or `tagOverrides` at the top level. Use `withMinimalPreset()` from `@mdream/js/preset/minimal`, or `{ plugins: { frontmatter: true } }`.
-- **Emphasis is `*`, not `_`.** Headings are ATX, bullets are `-`, rules are `---`. Only `tagOverrides` changes a delimiter, for example `em: { enter: '_', exit: '_', isInline: true }`.
-- **Filter selectors also drop inline `position: absolute` and `position: fixed` elements.**
-- **Browser and CDN entries are async.** Every entry takes the same options and produces the same string. The browser bundle and the CDN script return `Promise<string>`, so `await` them. Read [references/runtimes.md](references/runtimes.md) before you use `mdream` outside Node or a Cloudflare Worker.
-
-## Version limits
-
-Code from mdream 0.x fails on 1.x and 2.x. The subpaths `mdream/plugins`, `mdream/preset/minimal`, `mdream/splitter`, `mdream/llms-txt`, and `mdream/negotiate` throw `ERR_PACKAGE_PATH_NOT_EXPORTED`.
-
-```ts
-// Old (0.x):
-// import { htmlToMarkdown } from 'mdream'
-// import { withMinimalPreset } from 'mdream/preset/minimal'
-// htmlToMarkdown(html, withMinimalPreset({ origin }))
-
-import { htmlToMarkdown } from 'mdream'
-
-// New:
-htmlToMarkdown('<p>x</p>', { minimal: true, origin: 'https://example.com' })
-```
-
-The splitter, `llms.txt` generation, and `shouldServeMarkdown` moved to `@mdream/js/splitter`, `@mdream/js/llms-txt`, and `@mdream/js/negotiate`.
-
-## Config
-
-Options: `origin`, `minimal`, `clean` (`true` or per rule), `frontmatter`, `isolateMain`, `tailwind`, `filter`, `extraction`, `tagOverrides`, `wrapWidth`, `format`. Types: `MdreamOptions` in the [package README](https://github.com/harlan-zw/mdream/tree/main/packages/mdream#options).

package/node_modules/mdream/skills/mdream/references/runtimes.md

@@ -1,49 +0,0 @@
-# mdream outside Node
-
-`mdream` picks an entry by export condition. Every entry takes the same `MdreamOptions`: `minimal`, `frontmatter`, `filter`, `extraction`, `tagOverrides`, and the callbacks work everywhere. Every entry produces a Markdown string. Some return it in a Promise.
-
-| Import | Resolved by | Returns |
-|---|---|---|
-| `mdream` | Node | `string` |
-| `mdream` | `workerd`, `edge-light` | `string` |
-| `mdream` | `browser` | `Promise<string>` |
-| `mdream/worker` | direct import | `Promise<string>` |
-| `mdream/wasm` | direct import | `string`, after `init()` |
-| `dist/iife.js` (CDN) | script tag | `Promise<string>` |
-
-Each export condition ships its own types. TypeScript reads the `browser` types only when it resolves that condition, for example with `customConditions: ["browser"]` or a bundler that sets it. Otherwise it shows the Node types, a synchronous string.
-
-## Cloudflare Workers and Vercel Edge
-
-The `workerd` and `edge-light` conditions load the WASM build and instantiate it at import. The API matches Node.
-
-```ts
-import { htmlToMarkdown } from 'mdream'
-
-export default {
-  async fetch(request: Request): Promise<Response> {
-    const html = await request.text()
-    return new Response(htmlToMarkdown(html, { minimal: true }))
-  },
-}
-```
-
-A Rust panic becomes a normal `Error` with the message `mdream WASM panic, please report this at ...`. The instance stays usable, so catch it per request.
-
-## Browser bundles
-
-In a Vite, webpack, or esbuild client build, `import { htmlToMarkdown } from 'mdream'` resolves the `browser` entry. That entry fetches the WASM binary on first use and returns `Promise<string>`, so `await` it. The options and callbacks work as in Node.
-
-```ts
-import { htmlToMarkdown } from 'mdream'
-
-const markdown = await htmlToMarkdown(html, { minimal: true })
-```
-
-For browser code that wants a plain string with no WASM, `@mdream/js` is synchronous. Its options nest under `plugins`.
-
-## Web Worker, raw WASM, and CDN
-
-- `mdream/worker`: call `initWorker(wasmUrl)` first, then `await htmlToMarkdown(html, options)`. Call `terminateWorker()` when done. Options resolve on the main thread, and the callbacks run there.
-- `mdream/wasm`: the wasm-bindgen build. Await the default export `init({ module_or_path })` before the first `htmlToMarkdown(html, options)` call. Its `MarkdownStream` runs the callbacks in `finish()`.
-- `https://unpkg.com/mdream/dist/iife.js`: the WASM is inlined and ready at load. `window.mdream` has only `htmlToMarkdown`. There is no `init()`. The call returns `Promise<string>`, the same as the browser bundle.

package/node_modules/mdream/wasm/mdream_edge.d.ts

@@ -1,90 +0,0 @@
-/* tslint:disable */
-/* eslint-disable */
-
-export class MarkdownStream {
-    free(): void;
-    [Symbol.dispose](): void;
-    finish(): string;
-    constructor(options: any);
-    /**
-     * Byte chunk in, string out, skipping the transcode per chunk. A sequence
-     * split across chunks carries to the next call rather than decoding early,
-     * matching `TextDecoder({ stream: true })`; invalid bytes become U+FFFD.
-     */
-    processChunkBytes(chunk: Uint8Array): string;
-    /**
-     * A carried byte tail cannot be completed by a string chunk, so it is
-     * flushed first. Byte and string chunks may be mixed freely.
-     */
-    processChunk(chunk: string): string;
-    /**
-     * Frontmatter and extracted elements collected so far, as
-     * `{ frontmatter?, extracted? }`. Call after `finish()` for the complete
-     * data. Extracted elements drain on each call.
-     */
-    takeData(): any;
-}
-
-/**
- * Consumes the message of the panic that aborted the last export call.
- */
-export function __mdreamTakePanicMessage(): string | undefined;
-
-export function htmlToMarkdown(html: string, options: any): string;
-
-/**
- * Bytes in, string out: skips the transcode (~14% of a convert) for a
- * caller already holding UTF-8 bytes. Encoding a string to get here
- * measures 1-16% *slower* than [`html_to_markdown`] — only worth it when
- * the bytes are already in hand.
- */
-export function htmlToMarkdownBytes(html: Uint8Array, options: any): string;
-
-export function htmlToMarkdownResult(html: string, options: any): any;
-
-export function install_panic_hook(): void;
-
-export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
-
-export interface InitOutput {
-    readonly memory: WebAssembly.Memory;
-    readonly __mdreamTakePanicMessage: (a: number) => void;
-    readonly __wbg_markdownstream_free: (a: number, b: number) => void;
-    readonly htmlToMarkdown: (a: number, b: number, c: number, d: number) => void;
-    readonly htmlToMarkdownBytes: (a: number, b: number, c: number, d: number) => void;
-    readonly htmlToMarkdownResult: (a: number, b: number, c: number) => number;
-    readonly install_panic_hook: () => void;
-    readonly markdownstream_finish: (a: number, b: number) => void;
-    readonly markdownstream_new: (a: number) => number;
-    readonly markdownstream_processChunk: (a: number, b: number, c: number, d: number) => void;
-    readonly markdownstream_processChunkBytes: (a: number, b: number, c: number, d: number) => void;
-    readonly markdownstream_takeData: (a: number) => number;
-    readonly __wbindgen_export: (a: number, b: number) => number;
-    readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
-    readonly __wbindgen_export3: (a: number) => void;
-    readonly __wbindgen_add_to_stack_pointer: (a: number) => number;
-    readonly __wbindgen_export4: (a: number, b: number, c: number) => void;
-    readonly __wbindgen_start: () => void;
-}
-
-export type SyncInitInput = BufferSource | WebAssembly.Module;
-
-/**
- * Instantiates the given `module`, which can either be bytes or
- * a precompiled `WebAssembly.Module`.
- *
- * @param {{ module: SyncInitInput }} module - Passing `SyncInitInput` directly is deprecated.
- *
- * @returns {InitOutput}
- */
-export function initSync(module: { module: SyncInitInput } | SyncInitInput): InitOutput;
-
-/**
- * If `module_or_path` is {RequestInfo} or {URL}, makes a request and
- * for everything else, calls `WebAssembly.instantiate` directly.
- *
- * @param {{ module_or_path: InitInput | Promise<InitInput> }} module_or_path - Passing `InitInput` directly is deprecated.
- *
- * @returns {Promise<InitOutput>}
- */
-export default function __wbg_init (module_or_path?: { module_or_path: InitInput | Promise<InitInput> } | InitInput | Promise<InitInput>): Promise<InitOutput>;