From c8cb9fa9a540b88d0c7d8220b809a7f4656d5bfd Mon Sep 17 00:00:00 2001 From: Urata Daiki <7nohe@users.noreply.github.com> Date: Sun, 15 Nov 2026 10:27:56 +0900 Subject: [PATCH] docs: improve how search engines and LLMs find and read the site Search engines: - add robots.txt pointing at the sitemap - give the home page its own instead of the site name twice - describe the software in JSON-LD on the home page, and each other page as a TechArticle with a breadcrumb - rewrite the page descriptions that only repeated the page title - fix the heading level of --initialPageParam in the CLI options LLMs and coding agents: - build llms.txt from the pages with starlight-llms-txt, which adds llms-full.txt, llms-small.txt and one file per topic. The handwritten llms.txt had fallen behind (it did not list the benchmarks). - serve every page as Markdown at its own address plus .md, and link it from the page with rel="alternate" - keep the Markdown copies out of search results with X-Robots-Tag hast-util-to-mdast resolves to 10.1.2: 10.1.3 was published less than seven days ago. --- docs/astro.config.mjs | 89 +++- docs/package.json | 1 + docs/public/llms.txt | 35 -- docs/public/robots.txt | 4 + docs/src/content/docs/examples/nextjs.md | 2 +- .../src/content/docs/examples/react-router.md | 2 +- .../content/docs/examples/tanstack-router.md | 2 +- docs/src/content/docs/examples/vite-react.md | 2 +- .../src/content/docs/guides/ci-and-agents.mdx | 2 +- docs/src/content/docs/guides/cli-options.mdx | 4 +- docs/src/content/docs/guides/introduction.mdx | 2 +- .../content/docs/guides/migrating-to-v3.mdx | 2 +- .../content/docs/guides/migrating-to-v4.mdx | 2 +- docs/src/content/docs/guides/usage.mdx | 2 +- docs/src/content/docs/index.mdx | 13 +- docs/src/pages/[...slug].md.ts | 27 ++ docs/src/routeData.ts | 57 +++ docs/vercel.json | 21 + pnpm-lock.yaml | 387 +++++++++++++++++- 19 files changed, 602 insertions(+), 54 deletions(-) delete mode 100644 docs/public/llms.txt create mode 100644 docs/public/robots.txt create mode 100644 docs/src/pages/[...slug].md.ts create mode 100644 docs/src/routeData.ts create mode 100644 docs/vercel.json diff --git a/docs/astro.config.mjs b/docs/astro.config.mjs index cdb5fabc..b1f85f77 100644 --- a/docs/astro.config.mjs +++ b/docs/astro.config.mjs @@ -2,10 +2,27 @@ import { satteri } from "@astrojs/markdown-satteri"; import starlight from "@astrojs/starlight"; // @ts-check import { defineConfig } from "astro/config"; +import starlightLlmsTxt from "starlight-llms-txt"; const site = "https://orqc.7nohe.dev"; const ogUrl = new URL("og.jpg", site).href; const ogImageAlt = "OpenAPI React Query Codegen"; +const repo = "https://github.com/7nohe/openapi-react-query-codegen"; + +// What a model reads first in /llms.txt, before it decides which of the +// documentation sets below to fetch. +const llmsDescription = + "`@7nohe/openapi-react-query-codegen` is a CLI (`orqc`; `openapi-rq` also works) that generates TanStack Query v5 (React Query) hooks from an OpenAPI 3.0/3.1 specification. It generates a TypeScript HTTP client (fetch or axios) in `<output>/requests/`, then generates typed `useQuery`, `useSuspenseQuery`, `useInfiniteQuery` and `useMutation` hooks, `queryOptions` factories, `prefetchQuery` / `ensureQueryData` helpers and query key functions in `<output>/queries/`."; + +const llmsDetails = `Key facts for agents: + +- Install: \`npm install -D @7nohe/openapi-react-query-codegen@beta\` (v4 is in beta; without \`@beta\` npm installs v3) and \`npm install @tanstack/react-query\`. Only the scoped package belongs to this project. +- Run: \`orqc -i ./openapi.yaml -o ./src/openapi\`. Keep the flags in a package.json script and always pass the same ones. +- Do not edit generated files. Change the spec or the flags and regenerate. +- \`--check\` changes no existing file and exits 1 when the committed output is out of date, which makes it a CI drift check. +- \`--json\` prints failures as one line of JSON on stderr: \`{"code","message","details"}\`. Exit codes: 0 ok, 1 out of date, 2 error. +- The npm package ships an \`AGENTS.md\` with the full flag table, the generated layout, naming conventions and error codes. +- Every page of the documentation is also served as Markdown: drop the trailing slash of its address and add \`.md\`, as in https://orqc.7nohe.dev/guides/usage.md.`; // https://astro.build/config export default defineConfig({ @@ -22,6 +39,7 @@ export default defineConfig({ integrations: [ starlight({ title: "OpenAPI React Query Codegen", + routeMiddleware: "./src/routeData.ts", customCss: [ "@fontsource-variable/ibm-plex-sans/wght.css", "@fontsource/ibm-plex-mono/400.css", @@ -32,12 +50,69 @@ export default defineConfig({ Banner: "./src/components/Banner.astro", Hero: "./src/components/Hero.astro", }, - social: [ - { - icon: "github", - label: "GitHub", - href: "https://github.com/7nohe/openapi-react-query-codegen", - }, + social: [{ icon: "github", label: "GitHub", href: repo }], + plugins: [ + // Builds /llms.txt, /llms-full.txt and /llms-small.txt from the pages, + // so they cannot fall behind the documentation. + starlightLlmsTxt({ + description: llmsDescription, + details: llmsDetails, + customSets: [ + { + label: "Getting started and usage", + description: + "install, first run, the generated layout, using the generated hooks and queryOptions factories, every CLI option, CI checks and coding agents", + paths: [ + "guides/introduction", + "guides/usage", + "guides/cli-options", + "guides/ci-and-agents", + ], + }, + { + label: "Examples", + description: + "Vite + React, Next.js, TanStack Router and React Router", + paths: ["examples/**"], + }, + { + label: "Migration guides", + description: + "from v2 to v3, from v3 to v4, and from openapi-typescript + openapi-react-query", + paths: ["guides/migrating-*"], + }, + { + label: "Benchmarks", + description: + "generation time, install size and type errors compared with other generators, and what a coding agent spends", + paths: ["guides/benchmarks"], + }, + ], + promote: [ + "index*", + "guides/introduction", + "guides/usage", + "guides/cli-options", + "guides/ci-and-agents", + ], + demote: ["guides/migrating-to-v3", "contributing", "license"], + exclude: ["guides/migrating-to-v3", "contributing", "license"], + // The link Starlight puts next to every heading. + customSelectors: { all: [".sl-anchor-link"] }, + optionalLinks: [ + { + label: "AGENTS.md", + url: `${repo}/blob/main/AGENTS.md`, + description: + "agent guide, also at `node_modules/@7nohe/openapi-react-query-codegen/AGENTS.md`", + }, + { label: "Source code", url: repo }, + { + label: "npm package", + url: "https://www.npmjs.com/package/@7nohe/openapi-react-query-codegen", + }, + ], + }), ], head: [ { @@ -48,6 +123,8 @@ export default defineConfig({ tag: "meta", attrs: { property: "og:image:alt", content: ogImageAlt }, }, + { tag: "meta", attrs: { property: "og:image:width", content: "1415" } }, + { tag: "meta", attrs: { property: "og:image:height", content: "743" } }, ], sidebar: [ { diff --git a/docs/package.json b/docs/package.json index c330b9c9..0d0dbb7b 100644 --- a/docs/package.json +++ b/docs/package.json @@ -17,6 +17,7 @@ "@fontsource/ibm-plex-mono": "5.3.0", "astro": "~7.4.5", "sharp": "^0.35.5", + "starlight-llms-txt": "0.12.0", "typescript": "^5.6.3" } } diff --git a/docs/public/llms.txt b/docs/public/llms.txt deleted file mode 100644 index 6f2bf0d2..00000000 --- a/docs/public/llms.txt +++ /dev/null @@ -1,35 +0,0 @@ -# OpenAPI React Query Codegen - -> `@7nohe/openapi-react-query-codegen` is a CLI (`orqc`; `openapi-rq` also works) that generates TanStack Query v5 (React Query) hooks from an OpenAPI 3.0/3.1 specification. It generates a TypeScript HTTP client (fetch or axios) in `<output>/requests/`, then generates typed `useQuery`, `useSuspenseQuery`, `useInfiniteQuery` and `useMutation` hooks, `queryOptions` factories, `prefetchQuery` / `ensureQueryData` helpers and query key functions in `<output>/queries/`. - -Key facts for agents: - -- Install: `npm install -D @7nohe/openapi-react-query-codegen@beta` (v4 is in beta; without `@beta` npm installs v3) and `npm install @tanstack/react-query`. Only the scoped package belongs to this project. -- Run: `orqc -i ./openapi.yaml -o ./src/openapi`. Keep the flags in a package.json script and always pass the same ones. -- Do not edit generated files. Change the spec or the flags and regenerate. -- `--check` changes no existing file and exits 1 when the committed output is out of date, which makes it a CI drift check. -- `--json` prints failures as one line of JSON on stderr: `{"code","message","details"}`. Exit codes: 0 ok, 1 out of date, 2 error. -- The npm package ships an `AGENTS.md` with the full flag table, the generated layout, naming conventions and error codes. - -## Docs - -- [Introduction](https://orqc.7nohe.dev/guides/introduction/): install, first run, generated layout, client setup -- [Usage](https://orqc.7nohe.dev/guides/usage/): using the generated query, suspense, mutation, infinite, prefetch and ensureQueryData exports -- [CLI Options](https://orqc.7nohe.dev/guides/cli-options/): every flag with defaults -- [CI and Coding Agents](https://orqc.7nohe.dev/guides/ci-and-agents/): `--check`, `--json`, exit codes, error codes, AGENTS.md -- [AGENTS.md](https://github.com/7nohe/openapi-react-query-codegen/blob/main/AGENTS.md): agent guide, also at `node_modules/@7nohe/openapi-react-query-codegen/AGENTS.md` - -## Examples - -- [Vite + React](https://orqc.7nohe.dev/examples/vite-react/) -- [Next.js](https://orqc.7nohe.dev/examples/nextjs/) -- [TanStack Router](https://orqc.7nohe.dev/examples/tanstack-router/) -- [React Router](https://orqc.7nohe.dev/examples/react-router/) - -## Optional - -- [Migrating to v3](https://orqc.7nohe.dev/guides/migrating-to-v3/) -- [Migrating to v4](https://orqc.7nohe.dev/guides/migrating-to-v4/) -- [Migrating from openapi-react-query](https://orqc.7nohe.dev/guides/migrating-from-openapi-react-query/) -- [Contributing](https://orqc.7nohe.dev/contributing/) -- [Source code](https://github.com/7nohe/openapi-react-query-codegen) diff --git a/docs/public/robots.txt b/docs/public/robots.txt new file mode 100644 index 00000000..ea7bede1 --- /dev/null +++ b/docs/public/robots.txt @@ -0,0 +1,4 @@ +User-agent: * +Allow: / + +Sitemap: https://orqc.7nohe.dev/sitemap-index.xml diff --git a/docs/src/content/docs/examples/nextjs.md b/docs/src/content/docs/examples/nextjs.md index 9aff9788..e26529cd 100644 --- a/docs/src/content/docs/examples/nextjs.md +++ b/docs/src/content/docs/examples/nextjs.md @@ -1,6 +1,6 @@ --- title: Next.js Example -description: A simple example of using Next.js with OpenAPI React Query Codegen. +description: A Next.js App Router example that prefetches on the server and hydrates TanStack Query hooks generated from an OpenAPI document. --- Example of using Next.js can be found in the [`examples/nextjs-app`](https://github.com/7nohe/openapi-react-query-codegen/tree/main/examples/nextjs-app) directory of the repository. diff --git a/docs/src/content/docs/examples/react-router.md b/docs/src/content/docs/examples/react-router.md index 4bb8c649..cf4584e0 100644 --- a/docs/src/content/docs/examples/react-router.md +++ b/docs/src/content/docs/examples/react-router.md @@ -1,6 +1,6 @@ --- title: React Router Example -description: A simple example of using React Router 8 (framework mode) with OpenAPI React Query Codegen. +description: A React Router 8 (framework mode) example that loads data with TanStack Query code generated from an OpenAPI document. --- Example of using React Router 8 in framework mode can be found in the [`examples/react-router-app`](https://github.com/7nohe/openapi-react-query-codegen/tree/main/examples/react-router-app) directory of the repository. diff --git a/docs/src/content/docs/examples/tanstack-router.md b/docs/src/content/docs/examples/tanstack-router.md index 7b09dbb2..9f3e4f91 100644 --- a/docs/src/content/docs/examples/tanstack-router.md +++ b/docs/src/content/docs/examples/tanstack-router.md @@ -1,6 +1,6 @@ --- title: TanStack Router Example -description: Using TanStack Router with OpenAPI React Query Codegen for data loading and prefetching. +description: Use TanStack Router loaders with the generated ensureQueryData and prefetch functions to load and prefetch data from an OpenAPI API. --- Example of using TanStack Router can be found in the [`examples/tanstack-router-app`](https://github.com/7nohe/openapi-react-query-codegen/tree/main/examples/tanstack-router-app) directory of the repository. diff --git a/docs/src/content/docs/examples/vite-react.md b/docs/src/content/docs/examples/vite-react.md index 2188c3c0..0c7c3c93 100644 --- a/docs/src/content/docs/examples/vite-react.md +++ b/docs/src/content/docs/examples/vite-react.md @@ -1,6 +1,6 @@ --- title: Vite + React Example -description: A simple example of using Vite with React. +description: A Vite + React example app that calls an API through TanStack Query hooks generated from an OpenAPI document. --- Example of using Vite with React can be found in the [`examples/react-app`](https://github.com/7nohe/openapi-react-query-codegen/tree/main/examples/react-app) directory of the repository. diff --git a/docs/src/content/docs/guides/ci-and-agents.mdx b/docs/src/content/docs/guides/ci-and-agents.mdx index bab56279..7f95a223 100644 --- a/docs/src/content/docs/guides/ci-and-agents.mdx +++ b/docs/src/content/docs/guides/ci-and-agents.mdx @@ -128,4 +128,4 @@ The block goes into the instructions file at the root because that is what an ag ## Coding agents: AGENTS.md and llms.txt - The npm package ships an [`AGENTS.md`](https://github.com/7nohe/openapi-react-query-codegen/blob/main/AGENTS.md). After installing, it is at `node_modules/@7nohe/openapi-react-query-codegen/AGENTS.md`. It covers installation, every CLI flag, the generated file layout, naming conventions for the generated hooks, and the error codes above. You can point your project's own `AGENTS.md` or `CLAUDE.md` at it. -- This site serves an [`llms.txt`](/llms.txt) with a short project summary and links to these docs. +- This site serves an [`llms.txt`](/llms.txt) with a short project summary, and the whole documentation as Markdown in one file: [`llms-full.txt`](/llms-full.txt), or [`llms-small.txt`](/llms-small.txt) without the pages few projects need. Every page is also served as Markdown at its own address with `.md` in place of the trailing slash, such as [`/guides/usage.md`](/guides/usage.md). diff --git a/docs/src/content/docs/guides/cli-options.mdx b/docs/src/content/docs/guides/cli-options.mdx index bc2780a3..51d46e49 100644 --- a/docs/src/content/docs/guides/cli-options.mdx +++ b/docs/src/content/docs/guides/cli-options.mdx @@ -1,6 +1,6 @@ --- title: CLI Options -description: CLI options for OpenAPI React Query Codegen. +description: "Every orqc command line option with its default: input and output, infinite query pagination, fetch or axios client, enums, dates, schemas, --check, --json, --agentsMd and the exit codes." --- ## Options @@ -21,7 +21,7 @@ Name of the query parameter used for pagination (infinite query). The default va Name of the response parameter used for next page. The default value is `nextPage`. -## --initialPageParam \<value\> +### --initialPageParam \<value\> Initial page value to infinite query. The default value is `1`. diff --git a/docs/src/content/docs/guides/introduction.mdx b/docs/src/content/docs/guides/introduction.mdx index 8dc88a48..2d40cba9 100644 --- a/docs/src/content/docs/guides/introduction.mdx +++ b/docs/src/content/docs/guides/introduction.mdx @@ -1,6 +1,6 @@ --- title: Introduction -description: OpenAPI React Query Codegen is a code generator for creating React Query (also known as TanStack Query) hooks based on your OpenAPI schema. +description: Install OpenAPI React Query Codegen, generate TanStack Query (React Query) hooks and a typed fetch or axios client from an OpenAPI 3 (Swagger) document, and call your first endpoint. --- import { Code, Tabs, TabItem, FileTree } from '@astrojs/starlight/components'; diff --git a/docs/src/content/docs/guides/migrating-to-v3.mdx b/docs/src/content/docs/guides/migrating-to-v3.mdx index f18fadf2..d6821655 100644 --- a/docs/src/content/docs/guides/migrating-to-v3.mdx +++ b/docs/src/content/docs/guides/migrating-to-v3.mdx @@ -1,6 +1,6 @@ --- title: Migrating to v3 -description: Migration guide from v2 to v3 of OpenAPI React Query Codegen. +description: "Upgrade OpenAPI React Query Codegen from v2 to v3: queryOptions factories, error responses that reject, and the breaking changes to infinite queries." --- v3 is a full rewrite of the code generator on top of a ts-morph pipeline, but the generated output is intentionally kept compatible with v2. For most projects, migrating means updating the package and regenerating — no code changes. diff --git a/docs/src/content/docs/guides/migrating-to-v4.mdx b/docs/src/content/docs/guides/migrating-to-v4.mdx index a0187c5c..fb868656 100644 --- a/docs/src/content/docs/guides/migrating-to-v4.mdx +++ b/docs/src/content/docs/guides/migrating-to-v4.mdx @@ -1,6 +1,6 @@ --- title: Migrating to v4 -description: Migration guide from v3 to v4 of OpenAPI React Query Codegen. +description: "Upgrade OpenAPI React Query Codegen from v3 to v4: the generator's own TypeScript client replaces @hey-api/openapi-ts, with what changes in naming, types, dates and dependencies." --- v4 replaces `@hey-api/openapi-ts` with a client generator that ships inside this package. The generated **hooks are unchanged** — same names, same signatures, same query keys — so for most projects migrating means updating the package, regenerating, and checking the handful of differences below. diff --git a/docs/src/content/docs/guides/usage.mdx b/docs/src/content/docs/guides/usage.mdx index d6556e64..0a7ff9d6 100644 --- a/docs/src/content/docs/guides/usage.mdx +++ b/docs/src/content/docs/guides/usage.mdx @@ -1,6 +1,6 @@ --- title: Usage -description: Usage of OpenAPI React Query Codegen. +description: How to use the generated useQuery, useSuspenseQuery, useMutation and useInfiniteQuery hooks, the queryOptions factories and the query keys in a React app. --- After generating the React Query hooks and functions, you can start using them in your React application. diff --git a/docs/src/content/docs/index.mdx b/docs/src/content/docs/index.mdx index 998918f6..86231bdc 100644 --- a/docs/src/content/docs/index.mdx +++ b/docs/src/content/docs/index.mdx @@ -1,7 +1,18 @@ --- title: OpenAPI React Query Codegen -description: Generate TanStack Query hooks, query options and a typed client from an OpenAPI document with one command. +description: Generate TanStack Query (React Query) hooks, queryOptions factories and a typed fetch or axios client from an OpenAPI document with one command. template: splash +head: + - tag: title + content: "OpenAPI React Query Codegen (orqc): TanStack Query hooks from OpenAPI" + - tag: meta + attrs: + property: og:type + content: website + - tag: script + attrs: + type: application/ld+json + content: '{"@context":"https://schema.org","@graph":[{"@type":"WebSite","@id":"https://orqc.7nohe.dev/#website","url":"https://orqc.7nohe.dev/","name":"OpenAPI React Query Codegen","alternateName":"orqc"},{"@type":"SoftwareApplication","@id":"https://orqc.7nohe.dev/#software","name":"OpenAPI React Query Codegen","alternateName":["orqc","@7nohe/openapi-react-query-codegen"],"description":"Generate TanStack Query (React Query) hooks, queryOptions factories and a typed fetch or axios client from an OpenAPI document with one command.","url":"https://orqc.7nohe.dev/","applicationCategory":"DeveloperApplication","operatingSystem":"Node.js","license":"https://opensource.org/license/mit","isAccessibleForFree":true,"offers":{"@type":"Offer","price":"0","priceCurrency":"USD"},"downloadUrl":"https://www.npmjs.com/package/@7nohe/openapi-react-query-codegen","author":{"@type":"Person","name":"Daiki Urata","url":"https://github.com/7nohe"},"sameAs":["https://github.com/7nohe/openapi-react-query-codegen","https://www.npmjs.com/package/@7nohe/openapi-react-query-codegen"]}]}' hero: title: Your OpenAPI document, as TanStack Query hooks tagline: One command turns every operation into typed hooks, query options and prefetch helpers, together with the client they call. diff --git a/docs/src/pages/[...slug].md.ts b/docs/src/pages/[...slug].md.ts new file mode 100644 index 00000000..001b7369 --- /dev/null +++ b/docs/src/pages/[...slug].md.ts @@ -0,0 +1,27 @@ +import { type CollectionEntry, getCollection } from "astro:content"; +import type { APIRoute, GetStaticPaths } from "astro"; +// The plugin does not export its page-to-Markdown conversion, and it is the +// same one that builds /llms-full.txt. The plugin version is pinned, so a +// release that moves this file fails the build instead of changing the output. +import { entryToSimpleMarkdown } from "../../node_modules/starlight-llms-txt/entryToSimpleMarkdown"; + +export const prerender = true; + +/** Every page as Markdown at its own address plus `.md`, for agents. */ +export const getStaticPaths: GetStaticPaths = async () => { + const docs = await getCollection("docs", (doc) => !doc.data.draft); + return docs.map((doc) => ({ params: { slug: doc.id }, props: { doc } })); +}; + +export const GET: APIRoute<{ doc: CollectionEntry<"docs"> }> = async ( + context, +) => { + const { doc } = context.props; + const segments = [`# ${doc.data.hero?.title || doc.data.title}`]; + const description = doc.data.hero?.tagline || doc.data.description; + if (description) segments.push(`> ${description}`); + segments.push(await entryToSimpleMarkdown(doc, context, false)); + return new Response(`${segments.join("\n\n")}\n`, { + headers: { "Content-Type": "text/markdown; charset=utf-8" }, + }); +}; diff --git a/docs/src/routeData.ts b/docs/src/routeData.ts new file mode 100644 index 00000000..12b4c21a --- /dev/null +++ b/docs/src/routeData.ts @@ -0,0 +1,57 @@ +import { defineRouteMiddleware } from "@astrojs/starlight/route-data"; + +const siteName = "OpenAPI React Query Codegen"; + +/** + * Adds to every page a link to its Markdown version and, except on the home + * page (which describes the software in its frontmatter), structured data + * that says which site the page belongs to. + */ +export const onRequest = defineRouteMiddleware((context) => { + const { entry, head } = context.locals.starlightRoute; + const site = context.site; + // The 404 page has no Markdown version and nothing to describe. + if (!site || entry.id === "404") return; + + // Starlight gives the home page an empty id. + const id = entry.id || "index"; + const isHome = id === "index"; + const page = new URL(isHome ? "/" : `/${id}/`, site).href; + head.push({ + tag: "link", + attrs: { + rel: "alternate", + type: "text/markdown", + href: new URL(`/${id}.md`, site).href, + }, + }); + if (isHome) return; + + const home = new URL("/", site).href; + head.push({ + tag: "script", + attrs: { type: "application/ld+json" }, + content: JSON.stringify({ + "@context": "https://schema.org", + "@graph": [ + { + "@type": "TechArticle", + "@id": `${page}#article`, + headline: entry.data.title, + description: entry.data.description, + url: page, + inLanguage: "en", + isPartOf: { "@id": `${home}#website` }, + about: { "@id": `${home}#software` }, + }, + { + "@type": "BreadcrumbList", + itemListElement: [ + { "@type": "ListItem", position: 1, name: siteName, item: home }, + { "@type": "ListItem", position: 2, name: entry.data.title }, + ], + }, + ], + }), + }); +}); diff --git a/docs/vercel.json b/docs/vercel.json new file mode 100644 index 00000000..910b5667 --- /dev/null +++ b/docs/vercel.json @@ -0,0 +1,21 @@ +{ + "$schema": "https://openapi.vercel.sh/vercel.json", + "headers": [ + { + "source": "/(.*)\\.md", + "headers": [{ "key": "X-Robots-Tag", "value": "noindex" }] + }, + { + "source": "/llms-full\\.txt", + "headers": [{ "key": "X-Robots-Tag", "value": "noindex" }] + }, + { + "source": "/llms-small\\.txt", + "headers": [{ "key": "X-Robots-Tag", "value": "noindex" }] + }, + { + "source": "/_llms-txt/(.*)", + "headers": [{ "key": "X-Robots-Tag", "value": "noindex" }] + } + ] +} diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml index 1f8b583c..d1d07d5c 100644 --- a/pnpm-lock.yaml +++ b/pnpm-lock.yaml @@ -117,6 +117,9 @@ importers: sharp: specifier: ^0.35.5 version: 0.35.5(@types/node@24.19.2) + starlight-llms-txt: + specifier: 0.12.0 + version: 0.12.0(@astrojs/markdown-satteri@0.4.7)(@astrojs/starlight@0.42.10(astro@7.4.7(@types/node@24.19.2)(esbuild@0.28.2)(jiti@2.7.0)(terser@5.34.1)(tsx@4.23.12)(yaml@2.9.1))(typescript@5.6.3))(astro@7.4.7(@types/node@24.19.2)(esbuild@0.28.2)(jiti@2.7.0)(terser@5.34.1)(tsx@4.23.12)(yaml@2.9.1)) typescript: specifier: ^5.6.3 version: 5.6.3 @@ -1935,6 +1938,9 @@ packages: '@tybys/wasm-util@0.10.3': resolution: {integrity: sha512-F3fo1MYrRJYL3zER0OUOmkutjr1Vp23m7OsSgp7nq4SP6OqX6C/56XFIPAl5bt3zaBRjmW7SGz3u/6LwFpYcOg==} + '@types/braces@3.0.5': + resolution: {integrity: sha512-SQFof9H+LXeWNz8wDe7oN5zu7ket0qwMu5vZubW4GCJ8Kkeh6nBWUz87+KTz/G3Kqsrp0j/W253XJb3KMEeg3w==} + '@types/chai@5.2.3': resolution: {integrity: sha512-Mw558oeA9fFbv65/y4mHtXDs9bPnFMZAL/jxdPFUpOHHIXX91mcgEHbS5Lahr+pwZFR8A7GQleRWeI6cGFC2UA==} @@ -1968,6 +1974,9 @@ packages: '@types/mdast@4.0.4': resolution: {integrity: sha512-kGaNbPh1k7AFzgpud/gMdvIm5xuECykRR+JnWKQno9TAXVa6WIVCGTPvYGekIDL4uwCZQSYbUxNBSb1aUo79oA==} + '@types/micromatch@4.0.10': + resolution: {integrity: sha512-5jOhFDElqr4DKTrTEbnW8DZ4Hz5LRUEmyrGpCMrD/NphYv3nUnaF08xmSLx1rGGnyEs/kFnhiw6dCgcDqMr5PQ==} + '@types/ms@0.7.34': resolution: {integrity: sha512-nG96G3Wp6acyAgJqGasjODb+acrI7KltPiRxzHPXnP3NgI28bpQDRv53olbqGXbfcgF5aiiHmO3xpwEpS5Ld9g==} @@ -2608,6 +2617,10 @@ packages: resolution: {integrity: sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw==} engines: {node: '>=0.12'} + entities@9.0.0: + resolution: {integrity: sha512-oJFNDJg3kTPwAD1cNn2+WmUq4wFoo09npc3Ydf1D7ED4smRiWrsKnaLxykrTWgyGEcusc87P5dxlAleol9kpkg==} + engines: {node: '>=20.19.0'} + error-ex@1.3.2: resolution: {integrity: sha512-7dFHNmqeFSEt2ZBsCriorKnn3Z2pj+fd9kmI6QoWw4//DL+icEBfc0U7qJCisqrTsKTjw4fNFy2pW9OqStD84g==} @@ -2653,6 +2666,10 @@ packages: resolution: {integrity: sha512-vbRorB5FUQWvla16U8R/qgaFIya2qGzwDrNmCZuYKrbdSUMG6I1ZCGQRefkRVhuOkIGVne7BQ35DSfo1qvJqFg==} engines: {node: '>=0.8.0'} + escape-string-regexp@5.0.0: + resolution: {integrity: sha512-/veY75JbMK4j1yjvuUxuVsiS/hr/4iHs9FTT6cgTexxdE0Ly/glccBAkloH/DofkjRbZU3bnoj38mOmhkZ0lHw==} + engines: {node: '>=12'} + esprima@4.0.1: resolution: {integrity: sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==} engines: {node: '>=4'} @@ -2884,6 +2901,12 @@ packages: hast-util-format@1.1.0: resolution: {integrity: sha512-yY1UDz6bC9rDvCWHpx12aIBGRG7krurX0p0Fm6pT547LwDIZZiNr8a+IHDogorAdreULSEzP82Nlv5SZkHZcjA==} + hast-util-from-html@2.1.0: + resolution: {integrity: sha512-873p9AuH93gBnATbH8rU3YvjTKxyrIeWd/M9tiLMzn3G82Os0xhQurctfnbYUSrDXoyjbJGpJ2qmTpefMw7ZaQ==} + + hast-util-from-parse5@8.0.4: + resolution: {integrity: sha512-Yq7XlXor0Cpb71sI2E0zpv8QxQ5a6rfhDEETk4bcgrFX2SvJAY2PHocWwFtL6U9qyfiyByW3wZ6sZEfP2kW81g==} + hast-util-has-property@3.0.0: resolution: {integrity: sha512-MNilsvEKLFpV604hwfhVStK0usFY/QmM5zX16bo7EjnAEGofr5YyI37kzopBlZJkHD4t887i+q/C8/tr5Q94cA==} @@ -2908,6 +2931,9 @@ packages: hast-util-to-html@9.0.6: resolution: {integrity: sha512-1SZUxCN3TtJAE7e2BQN2MBHsoZ1gnmi9GoCP5Di59CSWptIezSAW09yDZyVbanb78V9eCwrKqdQsjtfVTxYHWA==} + hast-util-to-mdast@10.1.2: + resolution: {integrity: sha512-FiCRI7NmOvM4y+f5w32jPRzcxDIz+PUqDwEqn1A+1q2cdp3B8Gx7aVrXORdOKjMNDQsD1ogOr896+0jJHW1EFQ==} + hast-util-to-string@3.0.1: resolution: {integrity: sha512-XelQVTDWvqcl3axRfI0xSeoVKzyIFPwsAGSLIsKdJKQMXDYJS4WYrBNF/8J7RdhIcFI2BOHgAifggsvsxp/3+A==} @@ -3290,6 +3316,9 @@ packages: magicast@0.5.5: resolution: {integrity: sha512-UicdXN8zQ3JHlxVq+28afMXPr1z7WNY6+7EJnzTdQWkTAlMLF5fNCCKxJHBQwGaNGR11581EiQmQzx73+MvszA==} + markdown-table@3.1.0: + resolution: {integrity: sha512-xpeSCdM+B+6P3ncfgaB7FoDbtJ30xAe6Z18TGT7AgXJsHqCElCICZovQqdRMm7kHgpTyYv36EupqewoFFSB8vw==} + math-intrinsics@1.1.0: resolution: {integrity: sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==} engines: {node: '>= 0.4'} @@ -3297,9 +3326,30 @@ packages: mdast-util-directive@3.1.0: resolution: {integrity: sha512-I3fNFt+DHmpWCYAT7quoM6lHf9wuqtI+oCOfvILnoicNIqjh5E3dEJWiXuYME2gNe8vl1iMQwyUHa7bgFmak6Q==} + mdast-util-find-and-replace@3.0.4: + resolution: {integrity: sha512-z4B5c6jrnJ1ltOQemhWYPBSAo6y42Z8Gt2yEgfgNTMcLSU59B8bfj8Z8AnAlJrBGLnqkdAUZ7jdDEqQw3KuipQ==} + mdast-util-from-markdown@2.0.1: resolution: {integrity: sha512-aJEUyzZ6TzlsX2s5B4Of7lN7EQtAxvtradMMglCQDyaTFgse6CmtmdJ15ElnVRlCg1vpNyVtbem0PWzlNieZsA==} + mdast-util-gfm-autolink-literal@2.1.0: + resolution: {integrity: sha512-Jx6QSK8wDo558Bcf7q+1pe0v81g2PVs09Hlvu9xJHmCFRF3sAPW7vXFVIAwBncs3sde92WbsVqNxwdqViA2XnQ==} + + mdast-util-gfm-footnote@2.1.0: + resolution: {integrity: sha512-sqpDWlsHn7Ac9GNZQMeUzPQSMzR6Wv0WKRNvQRg0KqHh02fpTz69Qc1QSseNX29bhz1ROIyNyxExfawVKTm1GQ==} + + mdast-util-gfm-strikethrough@2.0.1: + resolution: {integrity: sha512-OuJHqvr455pwu2OaOrir7dbzqs4jlWKOtlu9L6GjcIjjQwNyw02VntQsr/Ek6/A13vgnXfUhBekWRUP1OkNivw==} + + mdast-util-gfm-table@2.0.1: + resolution: {integrity: sha512-fiIjPrAy4kz68/eFbPHhsiWDGHhqUSVoU1XsfLM5DsEPXw7MxgiVVyulUggFRckVWeT1KXQXkg5vm3kv4oMSOA==} + + mdast-util-gfm-task-list-item@2.0.1: + resolution: {integrity: sha512-jXVO1hvB2hs82g1esi7I9nIJDqiijbQLIyH2jDUb5s7jIAZMr/79h0VHSq7XHKTqpLARRm+DDNjduB7S9+6XZA==} + + mdast-util-gfm@3.1.0: + resolution: {integrity: sha512-0ulfdQOM3ysHhCJ1p06l0b0VKlhU0wuQs3thxZQagjcjPrlFRqY215uZGHHJan9GEAXd9MbfPjFJz+qMkVR6zQ==} + mdast-util-phrasing@4.1.0: resolution: {integrity: sha512-TqICwyvJJpBwvGAMZjj4J2n0X8QWp21b9l0o7eXyVJ25YNWYbJDVIyD1bZXE6WtV6RmKJVYmQAKWa0zWOABz2w==} @@ -3344,6 +3394,27 @@ packages: micromark-extension-directive@4.0.0: resolution: {integrity: sha512-/C2nqVmXXmiseSSuCdItCMho7ybwwop6RrrRPk0KbOHW21JKoCldC+8rFOaundDoRBUWBnJJcxeA/Kvi34WQXg==} + micromark-extension-gfm-autolink-literal@2.1.0: + resolution: {integrity: sha512-oOg7knzhicgQ3t4QCjCWgTmfNhvQbDDnJeVu9v81r7NltNCVmhPy1fJRX27pISafdjL+SVc4d3l48Gb6pbRypw==} + + micromark-extension-gfm-footnote@2.1.0: + resolution: {integrity: sha512-/yPhxI1ntnDNsiHtzLKYnE3vf9JZ6cAisqVDauhp4CEHxlb4uoOTxOCJ+9s51bIB8U1N1FJ1RXOKTIlD5B/gqw==} + + micromark-extension-gfm-strikethrough@2.1.0: + resolution: {integrity: sha512-ADVjpOOkjz1hhkZLlBiYA9cR2Anf8F4HqZUO6e5eDcPQd0Txw5fxLzzxnEkSkfnD0wziSGiv7sYhk/ktvbf1uw==} + + micromark-extension-gfm-table@2.1.2: + resolution: {integrity: sha512-pRzm4kDTu0MjlmBkxmS9yYhw60nncfcEwu9NNdPFSQEFXS95ZKyIIyTSHu/o3ReBUrLKYEq+7YaXCRn/bPB4MA==} + + micromark-extension-gfm-tagfilter@2.0.0: + resolution: {integrity: sha512-xHlTOmuCSotIA8TW1mDIM6X2O1SiX5P9IuDtqGonFhEK0qgRI4yeC6vMxEV2dgyr2TiD+2PQ10o+cOhdVAcwfg==} + + micromark-extension-gfm-task-list-item@2.1.0: + resolution: {integrity: sha512-qIBZhqxqI6fjLDYFTBIa4eivDMnP+OZqsNwmQ3xNLE4Cxwc+zfQEfbs6tzAo2Hjq+bh6q5F+Z8/cksrLFYWQQw==} + + micromark-extension-gfm@3.0.0: + resolution: {integrity: sha512-vsKArQsicm7t0z2GugkCKtZehqUm31oeGBV/KVSorWSy8ZlNAv7ytjFhvaryUiCUJYqs+NoE6AFhpQvBTM6Q4w==} + micromark-factory-destination@2.0.0: resolution: {integrity: sha512-j9DGrQLm/Uhl2tCzcbLhy5kXsgkHUrjJHg4fFAeoMRwJmJerT9aw4FEhIbZStWN8A3qMwOp1uzHr4UL8AInxtA==} @@ -3404,6 +3475,10 @@ packages: micromark@4.0.0: resolution: {integrity: sha512-o/sd0nMof8kYff+TqcDx3VSrgBTcZpSvYcAHIfHhv5VAuNmisCxjhx6YmxS8PFEpb9z5WKWKPdzf0jM23ro3RQ==} + micromatch@4.0.8: + resolution: {integrity: sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==} + engines: {node: '>=8.6'} + mime-db@1.52.0: resolution: {integrity: sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==} engines: {node: '>= 0.6'} @@ -3616,6 +3691,9 @@ packages: parse-prefer-header@1.0.0: resolution: {integrity: sha512-+WJ3ncCrKOExuxF06XyKWS8bLkLttnlm6YPMZIFIUXNd09Xy0N2JISudxCaY+luDm43yTnHMHVU3zte4G2gN4g==} + parse5@8.1.1: + resolution: {integrity: sha512-EcR/6WDcU7b2N3vQSxKALCk9lXGtUMQxXio008OEMBE0kavu/7JLfBEeFPzi43nMqVDSbEn3QCK+BMCc9zO//w==} + parseurl@1.3.3: resolution: {integrity: sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==} engines: {node: '>= 0.8'} @@ -3809,9 +3887,27 @@ packages: rehype-expressive-code@0.44.1: resolution: {integrity: sha512-+VZgs7Evw4LXRN3owpoBNSTpYuW6GeOdjqcUT1TuY8o/4MGPtbd0EU7Bgrju7X8KrQ6SslOBAuGWJ5fV5TriJQ==} + rehype-minify-whitespace@6.0.2: + resolution: {integrity: sha512-Zk0pyQ06A3Lyxhe9vGtOtzz3Z0+qZ5+7icZ/PL/2x1SHPbKao5oB/g/rlc6BCTajqBb33JcOe71Ye1oFsuYbnw==} + + rehype-parse@9.0.1: + resolution: {integrity: sha512-ksCzCD0Fgfh7trPDxr2rSylbwq9iYDkSn8TCDmEJ49ljEUBxDVCzCHv7QNzZOfODanX4+bWQ4WZqLCRWYLfhag==} + + rehype-remark@10.0.1: + resolution: {integrity: sha512-EmDndlb5NVwXGfUa4c9GPK+lXeItTilLhE6ADSaQuHr4JUlKw9MidzGzx4HpqZrNCt6vnHmEifXQiiA+CEnjYQ==} + remark-directive@4.0.0: resolution: {integrity: sha512-7sxn4RfF1o3izevPV1DheyGDD6X4c9hrGpfdUpm7uC++dqrnJxIZVkk7CoKqcLm0VUMAuOol7Mno3m6g8cfMuA==} + remark-gfm@4.0.1: + resolution: {integrity: sha512-1quofZ2RQ9EWdeN34S79+KExV1764+wCUGop5CPL1WGdD0ocPpu91lzPGbwWMECpEpd42kJGQwzRfyov9j4yNg==} + + remark-parse@11.0.0: + resolution: {integrity: sha512-FCxlKLNGknS5ba/1lmpYijMUzX2esxW5xQqjWxw2eHFfS2MSdaHVINFmhjo+qN1WhZhNimq0dZATN9pH0IDrpA==} + + remark-stringify@11.0.0: + resolution: {integrity: sha512-1OSmLd3awB/t8qdoEOMazZkNsfVTeY4fTsgzcQFdXNq8ToTN4ZGwrMnlda4K6smTFKD+GRV6O48i6Z4iKgPPpw==} + remove-accents@0.5.0: resolution: {integrity: sha512-8g3/Otx1eJaVD12e31UbJj1YzdtVvzH85HV7t+9MJYk/u3XmkOUJ5Ys9wQrf9PCPK8+xn4ymzqYCiZl6QWKn+A==} @@ -4018,6 +4114,12 @@ packages: sprintf-js@1.0.3: resolution: {integrity: sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g==} + starlight-llms-txt@0.12.0: + resolution: {integrity: sha512-ya4c0ZoiPUXuHDzd3AYCKh78Y3II3EToSE9Yp6uVN0c2UUKoNpqTjijhW86W/4toZzSUhWSnxeYs7QBcXNIPGg==} + peerDependencies: + '@astrojs/starlight': '>=0.41.0' + astro: ^7.0.0 + statuses@2.0.2: resolution: {integrity: sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw==} engines: {node: '>= 0.8'} @@ -4140,6 +4242,9 @@ packages: trim-lines@3.0.1: resolution: {integrity: sha512-kRj8B+YHZCc9kQYdWfJB2/oUl9rA99qbowYYBtr4ui4mZyAQ2JpvVBd/6U2YloATfqBhBTSMhTpgBHtU0Mf3Rg==} + trim-trailing-lines@2.1.0: + resolution: {integrity: sha512-5UR5Biq4VlVOtzqkm2AZlgvSlDJtME46uV0br0gENbwN4l5+mMKT4b9gJKqWtuL2zAIqajGJGuvbCbcAJUZqBg==} + trough@2.2.0: resolution: {integrity: sha512-tmMpK00BjZiUyVyvrBK7knerNgmgvcV/KLVyuma/SC+TQN167GrMRciANTz09+k3zW8L8t60jWO1GpfkZdjTaw==} @@ -4217,12 +4322,18 @@ packages: unist-util-position@5.0.0: resolution: {integrity: sha512-fucsC7HjXvkB5R3kTCO7kUjRdrS0BJt3M/FPxmHMBOm8JQi2BsHAHFsy27E0EolP8rp0NzXsJ+jNPyDWvOJZPA==} + unist-util-remove@4.0.0: + resolution: {integrity: sha512-b4gokeGId57UVRX/eVKej5gXqGlc9+trkORhFJpu9raqZkZhU0zm8Doi05+HaiBsMEIJowL+2WtQ5ItjsngPXg==} + unist-util-stringify-position@4.0.0: resolution: {integrity: sha512-0ASV06AAoKCDkS2+xw5RXJywruurpbC4JZSm7nr7MOt1ojAzvyyaO+UxZf18j8FCF6kmzCZKcAgN/yu2gm2XgQ==} unist-util-visit-parents@6.0.2: resolution: {integrity: sha512-goh1s1TBrqSqukSc8wrjwWhL0hiJxgA8m4kFxGlQ+8FYQ3C/m11FcTs4YYem7V664AhHVvgoQLk890Ssdsr2IQ==} + unist-util-visit-parents@6.1.0: + resolution: {integrity: sha512-vKXxz6O38sKDj1mtx/k2cWvkkFBuYGx6uGrlzBkVeWCRF/F8sdI0j3Wbkz/5rVNRRuVc8UrgRdbCxNhmYXgP3w==} + unist-util-visit@5.1.0: resolution: {integrity: sha512-m+vIdyeCOpdr/QeQCu2EzxX/ohgS8KbnPDgFni4dQsfSCtpz8UqDyY5GjRru8PDKuYn7Fq19j1CQ+nJSsGKOzg==} @@ -4391,6 +4502,9 @@ packages: resolution: {integrity: sha512-u4J1hr6Y+C/hit34GwL3eIcUf3wngT8TlYUjK7tk0jxydKLAq3sYvifjdTDA6U3KCKRcQCQDGf/srjxfZF3l7g==} engines: {node: '>=18.12.0'} + vfile-location@5.0.4: + resolution: {integrity: sha512-vEvxatYZCIpNvzGk2UD+u4I/sZkSKoOsdRCbkOIsN73QpJbriJ1qvvBAL1PeI0y55Leoqf7pORbaSPpG/smmOg==} + vfile-message@4.0.2: resolution: {integrity: sha512-jRDZ1IMLttGj41KcZvlrYAaI3CfqpLpfpf+Mfig13viT6NKvRzWZ+lXz0Y5D60w6uJIBAOGq9mSHf0gktF0duw==} @@ -4464,7 +4578,7 @@ packages: '@vitest/ui': 5.1.0 happy-dom: '*' jsdom: '*' - vite: 8.3.6 + vite: ^6.4.0 || ^7.0.0 || ^8.0.0 peerDependenciesMeta: '@edge-runtime/vm': optional: true @@ -4584,6 +4698,9 @@ packages: vscode-uri@3.2.0: resolution: {integrity: sha512-m2gXo3bn0G1kT9InzMf07fTbqMbGtyckj3bH5ktLO+1Ssv+yiATZ4dhwaQv9UZWxJh6E9IFGnQyjgWVDWVBDrg==} + web-namespaces@2.0.1: + resolution: {integrity: sha512-bKr1DkiNa2krS7qxNtdrtHAmzuYGFQLiQ13TsorsdT6ULTkPLKuu5+GsFpDlg6JFjUTwX2DyhMPG2be8uPrqsQ==} + webidl-conversions@3.0.1: resolution: {integrity: sha512-2JAn3z8AR6rjK8Sm8orRC0h/bcl/DqL7tRPdGZ4I1CjdF+EaMLmYxBHyXuKL849eucPFhvBoxMsflfOb8kxaeQ==} @@ -6243,6 +6360,8 @@ snapshots: dependencies: tslib: 2.8.1 + '@types/braces@3.0.5': {} + '@types/chai@5.2.3': dependencies: '@types/deep-eql': 4.0.2 @@ -6279,6 +6398,10 @@ snapshots: dependencies: '@types/unist': 3.0.3 + '@types/micromatch@4.0.10': + dependencies: + '@types/braces': 3.0.5 + '@types/ms@0.7.34': {} '@types/nlcst@2.0.3': @@ -6963,6 +7086,8 @@ snapshots: entities@4.5.0: {} + entities@9.0.0: {} + error-ex@1.3.2: dependencies: is-arrayish: 0.2.1 @@ -7024,6 +7149,8 @@ snapshots: escape-string-regexp@1.0.5: {} + escape-string-regexp@5.0.0: {} + esprima@4.0.1: {} estree-walker@3.0.3: @@ -7271,6 +7398,26 @@ snapshots: html-whitespace-sensitive-tag-names: 3.0.1 unist-util-visit-parents: 6.0.2 + hast-util-from-html@2.1.0: + dependencies: + '@types/hast': 3.0.5 + devlop: 1.1.0 + hast-util-from-parse5: 8.0.4 + parse5: 8.1.1 + vfile: 6.0.3 + vfile-message: 4.0.2 + + hast-util-from-parse5@8.0.4: + dependencies: + '@types/hast': 3.0.5 + '@types/unist': 3.0.3 + devlop: 1.1.0 + hastscript: 9.0.1 + property-information: 7.2.0 + vfile: 6.0.3 + vfile-location: 5.0.4 + web-namespaces: 2.0.1 + hast-util-has-property@3.0.0: dependencies: '@types/hast': 3.0.5 @@ -7335,6 +7482,23 @@ snapshots: stringify-entities: 4.0.4 zwitch: 2.0.4 + hast-util-to-mdast@10.1.2: + dependencies: + '@types/hast': 3.0.5 + '@types/mdast': 4.0.4 + '@ungap/structured-clone': 1.2.0 + hast-util-phrasing: 3.0.1 + hast-util-to-html: 9.0.6 + hast-util-to-text: 4.0.2 + hast-util-whitespace: 3.0.0 + mdast-util-phrasing: 4.1.0 + mdast-util-to-hast: 13.2.1 + mdast-util-to-string: 4.0.0 + rehype-minify-whitespace: 6.0.2 + trim-trailing-lines: 2.1.0 + unist-util-position: 5.0.0 + unist-util-visit: 5.1.0 + hast-util-to-string@3.0.1: dependencies: '@types/hast': 3.0.5 @@ -7663,6 +7827,8 @@ snapshots: '@babel/types': 7.29.8 source-map-js: 1.2.2 + markdown-table@3.1.0: {} + math-intrinsics@1.1.0: {} mdast-util-directive@3.1.0: @@ -7679,6 +7845,13 @@ snapshots: transitivePeerDependencies: - supports-color + mdast-util-find-and-replace@3.0.4: + dependencies: + '@types/mdast': 4.0.4 + escape-string-regexp: 5.0.0 + unist-util-is: 6.0.0 + unist-util-visit-parents: 6.1.0 + mdast-util-from-markdown@2.0.1: dependencies: '@types/mdast': 4.0.4 @@ -7696,6 +7869,65 @@ snapshots: transitivePeerDependencies: - supports-color + mdast-util-gfm-autolink-literal@2.1.0: + dependencies: + '@types/mdast': 4.0.4 + ccount: 2.0.1 + devlop: 1.1.0 + mdast-util-find-and-replace: 3.0.4 + micromark-util-character: 2.1.0 + + mdast-util-gfm-footnote@2.1.0: + dependencies: + '@types/mdast': 4.0.4 + devlop: 1.1.0 + mdast-util-from-markdown: 2.0.1 + mdast-util-to-markdown: 2.1.2 + micromark-util-normalize-identifier: 2.0.0 + transitivePeerDependencies: + - supports-color + + mdast-util-gfm-strikethrough@2.0.1: + dependencies: + '@types/mdast': 4.0.4 + mdast-util-from-markdown: 2.0.1 + mdast-util-to-markdown: 2.1.2 + transitivePeerDependencies: + - supports-color + + mdast-util-gfm-table@2.0.1: + dependencies: + '@types/mdast': 4.0.4 + devlop: 1.1.0 + markdown-table: 3.1.0 + mdast-util-from-markdown: 2.0.1 + mdast-util-to-markdown: 2.1.2 + mdast-util-to-string: 4.0.0 + unist-util-visit: 5.1.0 + transitivePeerDependencies: + - supports-color + + mdast-util-gfm-task-list-item@2.0.1: + dependencies: + '@types/mdast': 4.0.4 + devlop: 1.1.0 + mdast-util-from-markdown: 2.0.1 + mdast-util-to-markdown: 2.1.2 + transitivePeerDependencies: + - supports-color + + mdast-util-gfm@3.1.0: + dependencies: + mdast-util-from-markdown: 2.0.1 + mdast-util-gfm-autolink-literal: 2.1.0 + mdast-util-gfm-footnote: 2.1.0 + mdast-util-gfm-strikethrough: 2.0.1 + mdast-util-gfm-table: 2.0.1 + mdast-util-gfm-task-list-item: 2.0.1 + mdast-util-to-markdown: 2.1.2 + transitivePeerDependencies: + - supports-color + mdast-util-phrasing@4.1.0: dependencies: '@types/mdast': 4.0.4 @@ -7774,6 +8006,64 @@ snapshots: micromark-util-types: 2.0.0 parse-entities: 4.0.1 + micromark-extension-gfm-autolink-literal@2.1.0: + dependencies: + micromark-util-character: 2.1.0 + micromark-util-sanitize-uri: 2.0.0 + micromark-util-symbol: 2.0.0 + micromark-util-types: 2.0.0 + + micromark-extension-gfm-footnote@2.1.0: + dependencies: + devlop: 1.1.0 + micromark-core-commonmark: 2.0.1 + micromark-factory-space: 2.0.0 + micromark-util-character: 2.1.0 + micromark-util-normalize-identifier: 2.0.0 + micromark-util-sanitize-uri: 2.0.0 + micromark-util-symbol: 2.0.0 + micromark-util-types: 2.0.0 + + micromark-extension-gfm-strikethrough@2.1.0: + dependencies: + devlop: 1.1.0 + micromark-util-chunked: 2.0.0 + micromark-util-classify-character: 2.0.0 + micromark-util-resolve-all: 2.0.0 + micromark-util-symbol: 2.0.0 + micromark-util-types: 2.0.0 + + micromark-extension-gfm-table@2.1.2: + dependencies: + devlop: 1.1.0 + micromark-factory-space: 2.0.0 + micromark-util-character: 2.1.0 + micromark-util-symbol: 2.0.0 + micromark-util-types: 2.0.0 + + micromark-extension-gfm-tagfilter@2.0.0: + dependencies: + micromark-util-types: 2.0.0 + + micromark-extension-gfm-task-list-item@2.1.0: + dependencies: + devlop: 1.1.0 + micromark-factory-space: 2.0.0 + micromark-util-character: 2.1.0 + micromark-util-symbol: 2.0.0 + micromark-util-types: 2.0.0 + + micromark-extension-gfm@3.0.0: + dependencies: + micromark-extension-gfm-autolink-literal: 2.1.0 + micromark-extension-gfm-footnote: 2.1.0 + micromark-extension-gfm-strikethrough: 2.1.0 + micromark-extension-gfm-table: 2.1.2 + micromark-extension-gfm-tagfilter: 2.0.0 + micromark-extension-gfm-task-list-item: 2.1.0 + micromark-util-combine-extensions: 2.0.0 + micromark-util-types: 2.0.0 + micromark-factory-destination@2.0.0: dependencies: micromark-util-character: 2.1.0 @@ -7888,6 +8178,11 @@ snapshots: transitivePeerDependencies: - supports-color + micromatch@4.0.8: + dependencies: + braces: 3.0.3 + picomatch: 2.3.2 + mime-db@1.52.0: {} mime-db@1.54.0: {} @@ -8094,6 +8389,10 @@ snapshots: dependencies: lodash.camelcase: 4.3.0 + parse5@8.1.1: + dependencies: + entities: 9.0.0 + parseurl@1.3.3: {} path-browserify@1.0.1: {} @@ -8266,6 +8565,25 @@ snapshots: dependencies: expressive-code: 0.44.1 + rehype-minify-whitespace@6.0.2: + dependencies: + '@types/hast': 3.0.5 + hast-util-minify-whitespace: 1.0.1 + + rehype-parse@9.0.1: + dependencies: + '@types/hast': 3.0.5 + hast-util-from-html: 2.1.0 + unified: 11.0.5 + + rehype-remark@10.0.1: + dependencies: + '@types/hast': 3.0.5 + '@types/mdast': 4.0.4 + hast-util-to-mdast: 10.1.2 + unified: 11.0.5 + vfile: 6.0.3 + remark-directive@4.0.0: dependencies: '@types/mdast': 4.0.4 @@ -8275,6 +8593,32 @@ snapshots: transitivePeerDependencies: - supports-color + remark-gfm@4.0.1: + dependencies: + '@types/mdast': 4.0.4 + mdast-util-gfm: 3.1.0 + micromark-extension-gfm: 3.0.0 + remark-parse: 11.0.0 + remark-stringify: 11.0.0 + unified: 11.0.5 + transitivePeerDependencies: + - supports-color + + remark-parse@11.0.0: + dependencies: + '@types/mdast': 4.0.4 + mdast-util-from-markdown: 2.0.1 + micromark-util-types: 2.0.0 + unified: 11.0.5 + transitivePeerDependencies: + - supports-color + + remark-stringify@11.0.0: + dependencies: + '@types/mdast': 4.0.4 + mdast-util-to-markdown: 2.1.2 + unified: 11.0.5 + remove-accents@0.5.0: {} request-light@0.5.8: {} @@ -8626,6 +8970,27 @@ snapshots: sprintf-js@1.0.3: {} + starlight-llms-txt@0.12.0(@astrojs/markdown-satteri@0.4.7)(@astrojs/starlight@0.42.10(astro@7.4.7(@types/node@24.19.2)(esbuild@0.28.2)(jiti@2.7.0)(terser@5.34.1)(tsx@4.23.12)(yaml@2.9.1))(typescript@5.6.3))(astro@7.4.7(@types/node@24.19.2)(esbuild@0.28.2)(jiti@2.7.0)(terser@5.34.1)(tsx@4.23.12)(yaml@2.9.1)): + dependencies: + '@astrojs/mdx': 8.1.2(@astrojs/markdown-satteri@0.4.7)(astro@7.4.7(@types/node@24.19.2)(esbuild@0.28.2)(jiti@2.7.0)(terser@5.34.1)(tsx@4.23.12)(yaml@2.9.1)) + '@astrojs/starlight': 0.42.10(astro@7.4.7(@types/node@24.19.2)(esbuild@0.28.2)(jiti@2.7.0)(terser@5.34.1)(tsx@4.23.12)(yaml@2.9.1))(typescript@5.6.3) + '@types/hast': 3.0.5 + '@types/micromatch': 4.0.10 + astro: 7.4.7(@types/node@24.19.2)(esbuild@0.28.2)(jiti@2.7.0)(terser@5.34.1)(tsx@4.23.12)(yaml@2.9.1) + github-slugger: 2.0.0 + hast-util-select: 6.0.4 + micromatch: 4.0.8 + rehype-parse: 9.0.1 + rehype-remark: 10.0.1 + remark-gfm: 4.0.1 + remark-stringify: 11.0.0 + unified: 11.0.5 + unist-util-remove: 4.0.0 + transitivePeerDependencies: + - '@astrojs/markdown-remark' + - '@astrojs/markdown-satteri' + - supports-color + statuses@2.0.2: {} std-env@4.3.0: {} @@ -8736,6 +9101,8 @@ snapshots: trim-lines@3.0.1: {} + trim-trailing-lines@2.1.0: {} + trough@2.2.0: {} tslib@2.6.3: {} @@ -8814,6 +9181,12 @@ snapshots: dependencies: '@types/unist': 3.0.3 + unist-util-remove@4.0.0: + dependencies: + '@types/unist': 3.0.3 + unist-util-is: 6.0.0 + unist-util-visit-parents: 6.0.2 + unist-util-stringify-position@4.0.0: dependencies: '@types/unist': 3.0.3 @@ -8823,6 +9196,11 @@ snapshots: '@types/unist': 3.0.3 unist-util-is: 6.0.0 + unist-util-visit-parents@6.1.0: + dependencies: + '@types/unist': 3.0.3 + unist-util-is: 6.0.0 + unist-util-visit@5.1.0: dependencies: '@types/unist': 3.0.3 @@ -8899,6 +9277,11 @@ snapshots: verkit@0.5.0: {} + vfile-location@5.0.4: + dependencies: + '@types/unist': 3.0.3 + vfile: 6.0.3 + vfile-message@4.0.2: dependencies: '@types/unist': 3.0.3 @@ -9066,6 +9449,8 @@ snapshots: vscode-uri@3.2.0: {} + web-namespaces@2.0.1: {} + webidl-conversions@3.0.1: {} webpack-virtual-modules@0.6.2: {}