@ox-content/vite-plugin 3.0.0-alpha.4 → 3.0.0-alpha.6

package/dist/index.d.mts

@@ -225,6 +225,14 @@ interface ThemeConfig {
    * `breadcrumbs: false` still hides it on that page.
    */
   breadcrumbs?: boolean | Record<string, unknown>;
+  /**
+   * Heading permalink visibility. CSS only — the renderer HTML stays
+   * `<a class="header-anchor" href="#id">`.
+   *
+   * `"hover"` (default) reveals the `#` on hover / focus-visible, and
+   * stays visible on touch. `"always"` keeps it visible.
+   */
+  headingPermalink?: "hover" | "always";
   /** Light mode colors (maps to CSS variables) */
   colors?: ThemeColors;
   /** Dark mode colors (maps to CSS variables) */
@@ -279,6 +287,7 @@ interface ResolvedThemeConfig {
   viewTransitions: boolean;
   aside: boolean;
   breadcrumbs: boolean;
+  headingPermalink: "hover" | "always";
   colors: ThemeColors;
   darkColors: ThemeColors;
   fonts: ThemeFonts;
@@ -465,19 +474,20 @@ interface TwitterEmbedOptions {
   cache?: boolean;
   /** Directory used for the persistent metadata cache. @default ".cache/ox-content/twitter" */
   cacheDir?: string;
-  /** Directory where avatars and photos are written. @default "public/ox-content/twitter" */
+  /** Directory where avatars, photos, and videos are written. @default "public/ox-content/twitter" */
   mediaOutputDir?: string;
   /** Public URL prefix for downloaded media. @default "/ox-content/twitter" */
   mediaPublicPath?: string;
-}
+  /** Download MP4 video and animated GIF assets at build time. @default false */
+  downloadVideo?: boolean;
+  /** Maximum video size in bytes. Oversized assets are skipped. @default 8388608 */
+  maxVideoBytes?: number;
+  /** Fetched-card chrome. `"full"` matches sveltweet / react-tweet. @default "compact" */
+  appearance?: TweetAppearance;
+}
+type TweetAppearance = "compact" | "full";
 //#endregion
-//#region src/plugins/ogp.d.ts
-/**
- * OGP Card Plugin - Link card embedding
- *
- * Transforms <OgCard> components into static link preview cards
- * by fetching OGP metadata at build time.
- */
+//#region src/plugins/ogp/types.d.ts
 interface OgpData {
   url: string;
   title: string;
@@ -494,35 +504,44 @@ interface OgpOptions {
   timeout?: number;
   /**
    * Cache fetched Open Graph metadata in memory for the current process.
+   * Persistent disk cache also requires this to be enabled.
    * @default true
    */
   cache?: boolean;
   /**
-   * Cache TTL in milliseconds.
+   * Cache TTL in milliseconds. Fresh memory and disk entries skip the network.
    * @default 3600000
    */
   cacheTTL?: number;
+  /**
+   * Persist successful and negative cache entries to disk across builds.
+   * Off by default so existing sites do not write a cache directory.
+   * @default false
+   */
+  persistCache?: boolean;
+  /**
+   * Directory used for the persistent metadata cache when `persistCache` is on.
+   * @default ".cache/ox-content/ogp"
+   */
+  cacheDir?: string;
+  /**
+   * Re-fetch metadata even when a fresh cache entry exists.
+   * @default false
+   */
+  refresh?: boolean;
   /**
    * User agent sent with metadata fetch requests.
    * @default 'ox-content-ogp-bot/1.0 (compatible; +https://github.com/ubugeeei-prod/ox-content)'
    */
   userAgent?: string;
 }
-/**
- * Fetch OGP data for a URL.
- */
-declare function fetchOgpData(url: string, options: Required<OgpOptions>): Promise<OgpData | null>;
-/**
- * Collect all OGP URLs from HTML for pre-fetching.
- */
+//#endregion
+//#region src/plugins/ogp/fetch.d.ts
+declare function fetchOgpData(url: string, options?: OgpOptions): Promise<OgpData | null>;
+//#endregion
+//#region src/plugins/ogp/transform.d.ts
 declare function collectOgpUrls(html: string): Promise<string[]>;
-/**
- * Pre-fetch all OGP data.
- */
 declare function prefetchOgpData(urls: string[], options?: OgpOptions): Promise<Map<string, OgpData | null>>;
-/**
- * Transform OgCard components in HTML.
- */
 declare function transformOgp(html: string, ogpDataMap?: Map<string, OgpData | null>, options?: OgpOptions): Promise<string>;
 //#endregion
 //#region src/plugins/pm.d.ts
@@ -570,7 +589,8 @@ declare function generateTabsCSS(groupCount: number): string;
  * YouTube Plugin - Privacy-enhanced iframe embedding
  *
  * Transforms <YouTube> components into responsive iframe embeds using
- * youtube-nocookie.com for enhanced privacy.
+ * youtube-nocookie.com for enhanced privacy. A digits-only `start` attribute
+ * becomes `?start=` on the iframe URL.
  *
  * The HTML rewrite is performed in Rust (`transformYoutubeEmbeds` in
  * @ox-content/napi), replacing the previous rehype parse/stringify
@@ -687,6 +707,8 @@ interface BasePageProps {
   path: string;
   /** Output URL path */
   url: string;
+  /** Published Markdown companion URL when `ssg.markdownSource` is on */
+  markdownSource?: string;
   /** Raw frontmatter object */
   frontmatter: Record<string, unknown>;
   /** Layout name from frontmatter */
@@ -892,6 +914,8 @@ interface PageData {
   path: string;
   /** Output URL path */
   url: string;
+  /** Published Markdown companion URL when `ssg.markdownSource` is on */
+  markdownSource?: string;
   /** Frontmatter */
   frontmatter: Record<string, unknown>;
   /** Layout name */
@@ -1244,6 +1268,15 @@ interface SsgOptions {
    * @default false
    */
   jsonLd?: boolean | JsonLdOptions;
+  /**
+   * Validate custom page-head descriptors during SSG.
+   *
+   * `false` / omitted drops invalid values silently. `warn` logs them.
+   * `strict` fails the build on unsafe URLs or invalid hreflang.
+   *
+   * @default false
+   */
+  headValidation?: false | "warn" | "strict";
   /**
    * Opt-in copy buttons, outbound-link icons, and a back-to-top control.
    *
@@ -1284,6 +1317,20 @@ interface SsgOptions {
    * @default false
    */
   pageChrome?: boolean | Record<string, unknown>;
+  /**
+   * Publish the original Markdown beside each generated HTML page.
+   *
+   * Off by default. `true` writes a `.md` companion using the published URL
+   * (permalink, locale, base, and output directory) and adds
+   * `<link rel="alternate" type="text/markdown">`. An object enables the
+   * feature and can turn the alternate link off.
+   *
+   * The companion is a byte-for-byte copy of the source file, including
+   * frontmatter. Draft and unlisted pages are never written.
+   *
+   * @default false
+   */
+  markdownSource?: boolean | MarkdownSourceOptions;
   /**
    * Write a themed 404 page during SSG.
    *
@@ -1438,7 +1485,18 @@ interface JsonLdOptions {
    * Logo and other Organization fields are never invented.
    */
   publisher?: JsonLdPublisherOptions;
+  /**
+   * Page `@type`. Defaults to `TechArticle`.
+   */
+  type?: JsonLdPageType;
+  /**
+   * Extra `@graph` nodes. Only objects are kept. The build does not invent
+   * fields inside them.
+   */
+  graph?: Record<string, unknown>[];
 }
+/** JSON-LD page node `@type`. Unknown values fall back to `TechArticle`. */
+type JsonLdPageType = "TechArticle" | "BlogPosting" | "WebPage";
 /**
  * Optional JSON-LD publisher. Empty or omitted fields are left out.
  */
@@ -1457,6 +1515,8 @@ type ResolvedJsonLd = false | {
     name?: string;
     url?: string;
   };
+  type?: JsonLdPageType;
+  graph?: Record<string, unknown>[];
 };
 /**
  * Resolved SSG options.
@@ -1482,10 +1542,18 @@ interface ResolvedSsgOptions {
   pagination: boolean;
   breadcrumbs: boolean;
   jsonLd: ResolvedJsonLd;
+  /**
+   * Present after `resolveSsgOptions`. Omitted / `false` means off.
+   */
+  headValidation?: false | "warn" | "strict";
   readerChrome: ResolvedReaderChrome;
   localeSwitcher: boolean;
   a11y: ResolvedA11y;
   pageChrome: boolean;
+  /**
+   * Present after `resolveSsgOptions`. Omitted in hand-built fixtures means off.
+   */
+  markdownSource?: ResolvedMarkdownSourceOptions;
   /**
    * Present after `resolveSsgOptions`. Omitted in hand-built fixtures means off.
    */
@@ -1658,6 +1726,23 @@ interface ResolvedPwaOptions {
   backgroundColor?: string;
   startUrl?: string;
 }
+/**
+ * Opt-in Markdown source companions written beside generated HTML.
+ */
+interface MarkdownSourceOptions {
+  /**
+   * Add `<link rel="alternate" type="text/markdown">` to generated HTML.
+   * @default true
+   */
+  alternate?: boolean;
+}
+/**
+ * Resolved Markdown source-companion options.
+ */
+interface ResolvedMarkdownSourceOptions {
+  enabled: boolean;
+  alternate: boolean;
+}
 /**
  * Opt-in crawl manifests written during SSG.
  */
@@ -1863,7 +1948,32 @@ interface BlogOptions {
    * @default 10
    */
   pageSize?: number;
+  /**
+   * External RSS / Atom sources merged into the blog index at build time.
+   * Empty / omitted fetches nothing. Only these URLs are requested.
+   * @default []
+   */
+  feeds?: Array<string | BlogFeedSource>;
+}
+/**
+ * One configured external blog feed.
+ */
+interface BlogFeedSource {
+  /** Absolute `https:` feed URL. */
+  url: string;
+  /** Default language applied when an item omits one. */
+  language?: string;
+  /** Default author applied when an item omits one. */
+  author?: string;
+  /**
+   * Failed fetch / parse handling for this source.
+   * `warn` skips the source. `error` fails the build after other sources run.
+   * @default "warn"
+   */
+  onError?: BlogFeedFailurePolicy;
 }
+/** How a failed external feed source is reported. */
+type BlogFeedFailurePolicy = "warn" | "error";
 /**
  * Resolved blog options.
  */
@@ -1872,6 +1982,16 @@ interface ResolvedBlogOptions {
   collection?: string;
   authors: Record<string, BlogAuthor>;
   pageSize: number;
+  feeds: ResolvedBlogFeedSource[];
+}
+/**
+ * Resolved external blog feed source.
+ */
+interface ResolvedBlogFeedSource {
+  url: string;
+  language?: string;
+  author?: string;
+  onError: BlogFeedFailurePolicy;
 }
 /**
  * Opt-in term list pages, per-term pages, and related-page lists.
@@ -2149,6 +2269,17 @@ interface OxContentOptions {
    * @default true
    */
   footnotes?: boolean;
+  /**
+   * Render footnotes as a semantic ordered section with numeric markers.
+   *
+   * Source identifiers are used only for lookup and slugs. Visible markers
+   * are 1, 2, … in document order, and definitions emit as
+   * `<section class="footnotes"><ol><li>…`.
+   *
+   * Off by default so current alpha HTML stays stable.
+   * @default false
+   */
+  semanticFootnotes?: boolean;
   /**
    * Enable tables.
    * @default true
@@ -2234,6 +2365,18 @@ interface OxContentOptions {
    * @default false
    */
   badges?: boolean | BadgeOptions;
+  /**
+   * Opt-in `{link:...}` rich magic links.
+   *
+   * Passing `true` or an options object enables GitHub-user, alias, and
+   * explicit `label|url` forms. Attributes and text are HTML-escaped.
+   * Fenced, indented, inline, and raw code, plus already-linked text, are
+   * skipped. The transform does not make network requests unless an explicit
+   * favicon template is enabled (still URL-only; no fetch at transform time).
+   *
+   * @default false
+   */
+  magicLinks?: boolean | MagicLinkOptions;
   /**
    * Opt-in `::: tip` custom containers.
    *
@@ -2263,6 +2406,7 @@ interface OxContentOptions {
    * source mtime plus transform params. Paths that leave the page
    * directory or `srcDir` are rejected. Missing sources fail the build
    * when `missing` is `"error"` (the default when enabled).
+   * `dedupe` is off unless set; it does not turn on with `true` / `{}`.
    *
    * This is separate from `images`, which only adds figures, captions,
    * and lazy-loading.
@@ -2413,6 +2557,15 @@ interface OxContentOptions {
    * @default 3
    */
   tocMaxDepth?: number;
+  /**
+   * Append a visible heading permalink (`<a class="header-anchor" href="#id">`).
+   *
+   * Reuses the generated heading id. Default off. Theme
+   * `headingPermalink: "hover" | "always"` changes only CSS visibility.
+   *
+   * @default false
+   */
+  headingPermalinks?: boolean | HeadingPermalinksOptions;
   /**
    * Enable OG image generation.
    * @default false
@@ -2495,6 +2648,10 @@ interface ResolvedOptions {
   gfm: boolean;
   mdx?: boolean;
   footnotes: boolean;
+  /**
+   * Present after `resolveOptions`. Omitted in hand-built fixtures means off.
+   */
+  semanticFootnotes?: boolean;
   tables: boolean;
   taskLists: boolean;
   strikethrough: boolean;
@@ -2505,6 +2662,10 @@ interface ResolvedOptions {
   emojiShortcodes: ResolvedEmojiShortcodeOptions;
   attrs: ResolvedAttrsOptions;
   badges: ResolvedBadgeOptions;
+  /**
+   * Present after `resolveOptions`. Omitted in hand-built fixtures means off.
+   */
+  magicLinks?: ResolvedMagicLinkOptions;
   containers: ResolvedContainerOptions;
   images: ResolvedImageOptions;
   codeImports: ResolvedCodeImportOptions;
@@ -2527,6 +2688,10 @@ interface ResolvedOptions {
   frontmatter: boolean;
   toc: boolean;
   tocMaxDepth: number;
+  /**
+   * Present after `resolveOptions`. Omitted in hand-built fixtures means off.
+   */
+  headingPermalinks?: ResolvedHeadingPermalinksOptions;
   ogImage: boolean;
   ogImageOptions: ResolvedOgImageOptions$1;
   transformers: MarkdownTransformer[];
@@ -2631,6 +2796,62 @@ interface BadgeOptions {
 interface ResolvedBadgeOptions {
   enabled: boolean;
 }
+/**
+ * Options for opt-in `{link:...}` rich magic links.
+ */
+interface MagicLinkOptions {
+  /**
+   * Enable the magic-link transform when an options object is supplied.
+   *
+   * @default true
+   */
+  enabled?: boolean;
+  /**
+   * Named aliases. A string value is treated as `{ href }`.
+   */
+  aliases?: Record<string, string | MagicLinkAlias>;
+  /**
+   * Emit a favicon URL when a link has no image.
+   *
+   * `true` uses `https://{host}/favicon.ico`. Pass `{ template }` to override.
+   * The transform never fetches; the browser may load the URL later.
+   *
+   * @default false
+   */
+  favicon?: boolean | {
+    template?: string;
+  };
+  /**
+   * Replace the resolved image for matching hrefs.
+   */
+  imageOverrides?: MagicLinkImageOverride[];
+}
+/**
+ * One configured magic-link target.
+ */
+interface MagicLinkAlias {
+  href: string;
+  label?: string;
+  image?: string;
+}
+/**
+ * Replace the image for an exact href or prefix.
+ */
+interface MagicLinkImageOverride {
+  href?: string;
+  prefix?: string;
+  image: string;
+}
+/**
+ * Resolved magic-link transform options.
+ */
+interface ResolvedMagicLinkOptions {
+  enabled: boolean;
+  aliases: Record<string, MagicLinkAlias>;
+  favicon: boolean;
+  faviconTemplate?: string;
+  imageOverrides: MagicLinkImageOverride[];
+}
 /**
  * Options for opt-in `::: type` custom containers.
  */
@@ -2710,6 +2931,15 @@ interface ResourcesOptions {
    * @default "error"
    */
   missing?: "error" | "warn";
+  /**
+   * Emit identical bytes once as `/assets/content/<sha256>.<ext>` and
+   * rewrite `src`, `poster`, and relevant `href` to that URL.
+   *
+   * Off unless this is `true`. `resources: true` and `{}` leave it off.
+   *
+   * @default false
+   */
+  dedupe?: boolean;
 }
 /**
  * Resolved page-resource options.
@@ -2719,6 +2949,7 @@ interface ResolvedResourcesOptions {
   formats: string[];
   widths: number[];
   missing: "error" | "warn";
+  dedupe: boolean;
 }
 /**
  * Options for expanding Obsidian-style wiki links.
@@ -2819,6 +3050,27 @@ interface AttrsOptions {
 interface ResolvedAttrsOptions {
   enabled: boolean;
 }
+/**
+ * Opt-in visible heading permalinks.
+ *
+ * Headings already have stable `id`s. Enabling this appends a real
+ * `<a class="header-anchor" href="#id">` using that exact id. Off by
+ * default so existing HTML stays byte-stable.
+ */
+interface HeadingPermalinksOptions {
+  /**
+   * Emit the permalink control.
+   *
+   * @default true
+   */
+  enabled?: boolean;
+}
+/**
+ * Resolved heading permalink options.
+ */
+interface ResolvedHeadingPermalinksOptions {
+  enabled: boolean;
+}
 /**
  * Options for importing source snippets into code fences.
  *
@@ -4296,6 +4548,9 @@ declare function resolveStepsOptions(options: OxContentOptions["steps"]): Resolv
 //#region src/file-tree-options.d.ts
 declare function resolveFileTreeOptions(options: OxContentOptions["fileTree"]): ResolvedOptions["fileTree"];
 //#endregion
+//#region src/heading-permalinks-options.d.ts
+declare function resolveHeadingPermalinksOptions(options: OxContentOptions["headingPermalinks"]): ResolvedOptions["headingPermalinks"];
+//#endregion
 //#region src/typed-hover.d.ts
 declare function resolveTypedHoverOptions(options: OxContentOptions["typedHover"]): ResolvedOptions["typedHover"];
 //#endregion
@@ -5308,6 +5563,76 @@ interface SsgBuildResult {
  */
 declare function buildSsg(options: ResolvedOptions, root: string): Promise<SsgBuildResult>;
 //#endregion
+//#region src/page-head.d.ts
+/** How invalid head descriptors are reported. */
+type HeadValidationMode = false | "off" | "warn" | "strict";
+interface SiteHead {
+  name?: string;
+  url?: string;
+  locale?: string;
+  titleTemplate?: string;
+}
+interface HeadMeta {
+  key?: string;
+  name?: string;
+  property?: string;
+  httpEquiv?: string;
+  content: string;
+}
+interface HeadLink {
+  key?: string;
+  rel: string;
+  href: string;
+  hreflang?: string;
+  type?: string;
+  sizes?: string;
+}
+interface HeadAlternate {
+  lang: string;
+  href: string;
+}
+interface HeadJsonLd {
+  key?: string;
+  json: string;
+}
+/**
+ * Build-time page-head input. Unhead-shaped, no client runtime.
+ *
+ * Unknown keys such as `twitter.imggg` are a TypeScript error here. Use
+ * `metas` / `links` for extra tags.
+ */
+interface HeadInput {
+  site?: SiteHead;
+  title?: string;
+  titleTemplate?: string;
+  titleSuffix?: boolean;
+  description?: string;
+  canonical?: string;
+  robots?: string;
+  ogImage?: string;
+  ogType?: string;
+  twitterCard?: "summary" | "summary_large_image" | (string & {});
+  social?: boolean;
+  emitSiteName?: boolean;
+  trusted?: boolean;
+  metas?: HeadMeta[];
+  links?: HeadLink[];
+  alternates?: HeadAlternate[];
+  jsonLd?: HeadJsonLd[];
+  validation?: "off" | "warn" | "strict";
+}
+interface HeadDiagnostic {
+  strict: boolean;
+  message: string;
+}
+interface RenderedHead {
+  html: string;
+  diagnostics: HeadDiagnostic[];
+}
+/** Resolve descriptors to escaped `<head>` markup. Build-time only. */
+declare function renderHead(input: HeadInput): RenderedHead;
+declare function resolveHeadValidation(value: HeadValidationMode | undefined): false | "warn" | "strict";
+//#endregion
 //#region src/not-found.d.ts
 /**
  * Resolves `ssg.notFound` with defaults.
@@ -5326,6 +5651,15 @@ declare function resolveNotFoundOptions(value: boolean | NotFoundOptions | undef
  */
 declare function resolveSiteMapsOptions(value: boolean | SiteMapsOptions | undefined): ResolvedSiteMapsOptions;
 //#endregion
+//#region src/markdown-source.d.ts
+/**
+ * Resolves `ssg.markdownSource` with defaults.
+ *
+ * `false` / omitted stays off. `true` enables companions and the alternate
+ * link. An object enables the feature and overrides only the fields set.
+ */
+declare function resolveMarkdownSourceOptions(value: boolean | MarkdownSourceOptions | undefined): ResolvedMarkdownSourceOptions;
+//#endregion
 //#region src/publish-state.d.ts
 /** Split pages into production output vs listing surfaces. */
 interface PartitionedPages<T> {
@@ -5385,6 +5719,12 @@ declare function resolveBlogOptions(value: boolean | BlogOptions | undefined): R
  */
 declare function resolveBlogCollectionName(requested: string | undefined, collectionNames: readonly string[]): string | undefined;
 //#endregion
+//#region src/blog-feeds.d.ts
+declare class BlogFeedError extends Error {
+  readonly issues: string[];
+  constructor(issues: string[]);
+}
+//#endregion
 //#region src/blog-reading.d.ts
 /**
  * Deterministic blog reading-time estimates.
@@ -5768,5 +6108,5 @@ declare function resolveBadgeOptions(options: OxContentOptions["badges"]): Resol
  */
 declare function generateVirtualModule(path: string, options: ResolvedOptions): string;
 //#endregion
-export { A11yOptions, AttrsOptions, BadgeOptions, type BasePageProps, BlogAuthor, BlogOptions, BuiltinEmbedOptions, BuiltinPmOptions, CardOptions, CascadeOptions, CodeAnnotationKind, CodeAnnotationSyntax, CodeAnnotationsOptions, type CodeBlockDiagnostic, CodeBlockLintOptions, CodeBlockTypecheckOptions, CodeImportOptions, type CollectedDocsTest, CollectionEntry, CollectionIncludeField, CollectionManifest, CollectionOptions, CollectionQueryBuilder, CollectionQueryOperator, CollectionsOptions, type ComponentRegistry, ContainerOptions, ContainerTypeOptions, ContributorsOptions, DEFAULT_HTML_TEMPLATE, DEFAULT_MARKDOWN_EXTENSIONS, DefaultTheme, type DiscoverDocumentMdxIslandsInput, type DiscoverDocumentMdxIslandsResult, type DiscoverRegisteredMdxComponentsInput, DocEntry, DocMember, DocsEntryPoint, DocsOptions, DocsSortStrategy, DocsSummary, type DocsTestFileOptions, type DocsTestHarnessOptions, DocsTestOptions, DocsTestRunError, type DocsTestRunResult, type DocsTestSource, type DocsTestWriteResult, type DocumentImportDiagnostic, type DocumentImportDiagnosticCode, EditThisPageOptions, EmojiShortcodeOptions, EntryPageConfig, type ExtractedCodeBlock, ExtractedDocs, FeatureConfig, FeedFormat, FeedsOptions, FileTreeIconOptions, FileTreeOptions, Fragment, type FrameworkCodegenMode, type FrameworkCodegenTarget, type FrameworkComponentIsland, type FrameworkMarkdownOptions, type FrameworkRenderTarget, type FrameworkTransformData, type FrontmatterSchema, type GenerateVitePressMigrationConfigOptions, GeneratedDocsData, type GitHubLineRange, type GitHubOptions, type GitHubRepoData, type GitHubSourceCommit, type GitHubSourceData, type GitHubSourceRef, type GlobalComponentMap, type HeaderNavItem, HeroAction, HeroConfig, HeroImage, HeroNotice, I18nOptions, ImageOptions, IncludeOptions, type IncrementalMarkdownParseAppendOptions, type IncrementalMarkdownParseResult, IncrementalMarkdownParser, type IncrementalMarkdownParserOptions, type IncrementalMarkdownRenderAppendOptions, type IncrementalMarkdownRenderResult, IncrementalMarkdownRenderer, type IncrementalMarkdownRendererOptions, type IslandInfo, type JSXChild, type JSXElementType, type JSXNode, type JSXProps, JsonLdOptions, JsonLdPublisherOptions, type LoadStrategy, LocaleConfig, type LocaleLabel, type MarkdownChunkSource, MarkdownDisplayFormat, type MarkdownLintFileDiagnostic as MarkdownLintBatchDiagnostic, type MarkdownLintFileDiagnostic, type MarkdownLintDiagnostic, type MarkdownLintDictionaryOptions, type MarkdownLintFileOptions, type MarkdownLintFileOptions as MarkdownLintProjectOptions, type MarkdownLintFileResult, type MarkdownLintFilesResult, type MarkdownLintLanguage, type MarkdownLintOptions, type MarkdownLintResult, type MarkdownLintRuleOptions, type MarkdownLintSeverity, type MarkdownLintStandardDictionaryOptions, MarkdownNode, MarkdownTransformer, MathOptions, MdxImport, MdxImportSpecifier, MdxImportSpecifierKind, type MermaidOptions, type NavGroup, NavItem, NotFoundOptions, type OgBrowserSession, OgImageOptions, type OgImagePageEntry, type OgImageOptions$1 as OgImagePluginOptions, type OgImageResult, type OgImageTemplateFn, type OgImageTemplateProps, type OgpData, type OgpOptions, OxContentOptions, type PageChromeFlags, type PageData, type PageProps, PageResourceError, ParamDoc, type ParseIslandsResult, PermalinksOptions, PublishStateOptions, PwaOptions, ReaderChromeOptions, RedirectsOptions, type RenderContext, type RenderIslandComponentImportsInput, type RenderIslandFn, type ResolveDocumentComponentImportsInput, type ResolveDocumentComponentImportsResult, ResolvedA11y, ResolvedAttrsOptions, ResolvedBadgeOptions, ResolvedBlogOptions, ResolvedBuiltinEmbedOptions, ResolvedCardOptions, ResolvedCascadeOptions, ResolvedCodeAnnotationsOptions, ResolvedCodeBlockLintOptions, ResolvedCodeBlockTypecheckOptions, ResolvedCodeImportOptions, ResolvedCollectionOptions, ResolvedCollectionsOptions, ResolvedContainerOptions, ResolvedContributors, ResolvedDocsEntryPoint, ResolvedDocsOptions, ResolvedDocsTestOptions, type ResolvedDocumentComponentImport, ResolvedEditThisPageOptions, ResolvedEmojiShortcodeOptions, ResolvedFeedsOptions, ResolvedFileTreeOptions, ResolvedI18nOptions, ResolvedImageOptions, ResolvedIncludeOptions, ResolvedJsonLd, ResolvedMathOptions, ResolvedNotFoundOptions, ResolvedOgImageOptions, ResolvedOptions, ResolvedPermalinksOptions, ResolvedPublishStateOptions, ResolvedPwaOptions, ResolvedReaderChrome, ResolvedRedirectsOptions, ResolvedResourcesOptions, ResolvedSanitizeOptions, ResolvedSearchOptions, ResolvedSectionIndexOptions, ResolvedSiteMapsOptions, ResolvedSsgOptions, ResolvedStepsOptions, ResolvedTaxonomiesOptions, ResolvedTeamOptions, type ResolvedThemeConfig, ResolvedTypedHoverOptions, ResolvedVersionEntry, ResolvedVersionsOptions, ResolvedWikiLinkOptions, ResourcesOptions, ReturnDoc, type RunDocsTestsOptions, SanitizeOptions, ScopedSearchQuery, SearchDocument, SearchOptions, SearchResult, SectionIndexOptions, SectionIndexStyle, type SidebarItem, type SiteConfig, SiteMapsOptions, type SocialLinks, SsgNavigationGroup, SsgNavigationItem, SsgOptions, StepsOptions, TaxonomiesOptions, TeamLink, TeamMember, TeamOptions, type ThemeAnnouncement, type ThemeColors, type ThemeComponent, type ThemeConfig, type ThemeEmbed, type ThemeEntryPage, type ThemeFonts, type ThemeFooter, type ThemeHeader, type ThemeLayout, type ThemeProps, type ThemeRenderOptions, type ThemeTokens, ThrowsDoc, TocEntry, type TransformAllOptions, TransformContext, TransformResult, type TwitterEmbedOptions, type TypecheckCodeBlockOptions, TypedHoverOptions, VersionBannerKind, VersionEntry, VersionsOptions, type VitePressConfig, type VitePressFooter, type VitePressLogo, type VitePressNavItem, type VitePressSidebar, type VitePressSidebarItem, type VitePressSocialLink, type VitePressThemeConfig, WikiLinkOptions, type WrittenDocsTestFile, type YouTubeOptions, applyIslandSsrHtml, buildCollectionManifest, buildSearchIndex, buildSsg, classifyPublishState, clearRenderContext, collectDocsTests, collectGitHubRepos, collectGitHubSources, collectMdxIslandNamesFromHtml, collectMdxJsxNamesFromAst, collectOgpUrls, convertVitePressNav, convertVitePressSidebar, createFrameworkMarkdownOptions, createI18nPlugin, createIncrementalMarkdownParser, createIncrementalMarkdownRenderer, createMarkdownEnvironment, createTheme, defaultTheme, defineCollection, defineCollections, defineTheme, discoverDocumentMdxIslands, discoverRegisteredMdxComponents, each, escapeSvelteMarkup, extractCodeBlocks, extractDocs, extractDocsTests, extractIslandInfo, extractVideoId, fetchGitHubSource, fetchOgpData, fetchRepoData, fromVitePressConfig, generateCollectionsVirtualModule, generateFrontmatterTypes, generateHydrationScript, generateMarkdown, generateOgImages, generateTabsCSS, generateTypes, generateVirtualModule, generateVitePressMigrationConfig, hasIslands, inferType, intersectHydratableComponentNames, intersectRegisteredComponentNames, isMarkdownFilePath, isMdxFilePath, isRegisteredComponent, jsx, jsxs, lintCodeBlocks, lintMarkdown, lintMarkdownAsync, lintMarkdownFile, lintMarkdownFiles, mergeThemes, mermaidClientScript, normalizeMarkdownExtensions, normalizeVitePressFrontmatter, oxContent, parseGitHubLineRange, parseGitHubPermalink, parsePageChromeFlags, partitionPublishedPages, prefetchGitHubRepos, prefetchGitHubSources, prefetchOgpData, raw, readingTimeMinutes, renderAllPages, renderHtmlToFrameworkCode, renderHtmlToReactComponent, renderHtmlToReactCreateElement, renderHtmlToSvelteComponent, renderHtmlToVueComponent, renderHtmlToVueH, renderIslandComponentImports, renderMarkdownStream, renderPage, renderToString, resolveBadgeOptions, resolveBlogCollectionName, resolveBlogOptions, resolveBuiltinEmbedOptions, resolveCardOptions, resolveCascadeOptions, resolveCollectionsOptions, resolveContentRootPath, resolveDocsOptions, resolveDocumentComponentImports, resolveFeedsOptions, resolveFileTreeOptions, resolveHeaderNavItems, resolveI18nOptions, resolveImageOptions, resolveIncludeOptions, resolveLocaleLabel, resolveMathOptions, resolveMdxForFilePath, resolveNotFoundOptions, resolveOgImageOptions, resolvePageChromeOption, resolvePermalinksOptions, resolvePublishStateOptions, resolvePwaOptions, resolveRedirectsOptions, resolveResourcesOptions, resolveSearchOptions, resolveSectionIndexOptions, resolveSiteMapsOptions, resolveSsgOptions, resolveStepsOptions, resolveTaxonomiesOptions, resolveTeamOptions, resolveTheme, resolveTypedHoverOptions, resolveVersionsOptions, runDocsTests, setRenderContext, shouldLintMarkdownFile, stripMarkdownExtension, stripViteQuery, transformAllPlugins, transformGitHub, transformIslands, transformMarkdown, transformMermaidStatic, transformOgp, transformTabs, transformYouTube, typecheckCodeBlocks, useIsActive, useNav, usePageProps, useRenderContext, useSiteConfig, when, writeDocs, writeDocsTestFiles, writeSearchIndex };
+export { A11yOptions, AttrsOptions, BadgeOptions, type BasePageProps, BlogAuthor, BlogFeedError, BlogFeedFailurePolicy, BlogFeedSource, BlogOptions, BuiltinEmbedOptions, BuiltinPmOptions, CardOptions, CascadeOptions, CodeAnnotationKind, CodeAnnotationSyntax, CodeAnnotationsOptions, type CodeBlockDiagnostic, CodeBlockLintOptions, CodeBlockTypecheckOptions, CodeImportOptions, type CollectedDocsTest, CollectionEntry, CollectionIncludeField, CollectionManifest, CollectionOptions, CollectionQueryBuilder, CollectionQueryOperator, CollectionsOptions, type ComponentRegistry, ContainerOptions, ContainerTypeOptions, ContributorsOptions, DEFAULT_HTML_TEMPLATE, DEFAULT_MARKDOWN_EXTENSIONS, DefaultTheme, type DiscoverDocumentMdxIslandsInput, type DiscoverDocumentMdxIslandsResult, type DiscoverRegisteredMdxComponentsInput, DocEntry, DocMember, DocsEntryPoint, DocsOptions, DocsSortStrategy, DocsSummary, type DocsTestFileOptions, type DocsTestHarnessOptions, DocsTestOptions, DocsTestRunError, type DocsTestRunResult, type DocsTestSource, type DocsTestWriteResult, type DocumentImportDiagnostic, type DocumentImportDiagnosticCode, EditThisPageOptions, EmojiShortcodeOptions, EntryPageConfig, type ExtractedCodeBlock, ExtractedDocs, FeatureConfig, FeedFormat, FeedsOptions, FileTreeIconOptions, FileTreeOptions, Fragment, type FrameworkCodegenMode, type FrameworkCodegenTarget, type FrameworkComponentIsland, type FrameworkMarkdownOptions, type FrameworkRenderTarget, type FrameworkTransformData, type FrontmatterSchema, type GenerateVitePressMigrationConfigOptions, GeneratedDocsData, type GitHubLineRange, type GitHubOptions, type GitHubRepoData, type GitHubSourceCommit, type GitHubSourceData, type GitHubSourceRef, type GlobalComponentMap, type HeadAlternate, type HeadDiagnostic, type HeadInput, type HeadJsonLd, type HeadLink, type HeadMeta, type HeadValidationMode, type HeaderNavItem, HeadingPermalinksOptions, HeroAction, HeroConfig, HeroImage, HeroNotice, I18nOptions, ImageOptions, IncludeOptions, type IncrementalMarkdownParseAppendOptions, type IncrementalMarkdownParseResult, IncrementalMarkdownParser, type IncrementalMarkdownParserOptions, type IncrementalMarkdownRenderAppendOptions, type IncrementalMarkdownRenderResult, IncrementalMarkdownRenderer, type IncrementalMarkdownRendererOptions, type IslandInfo, type JSXChild, type JSXElementType, type JSXNode, type JSXProps, JsonLdOptions, JsonLdPageType, JsonLdPublisherOptions, type LoadStrategy, LocaleConfig, type LocaleLabel, MagicLinkAlias, MagicLinkImageOverride, MagicLinkOptions, type MarkdownChunkSource, MarkdownDisplayFormat, type MarkdownLintFileDiagnostic as MarkdownLintBatchDiagnostic, type MarkdownLintFileDiagnostic, type MarkdownLintDiagnostic, type MarkdownLintDictionaryOptions, type MarkdownLintFileOptions, type MarkdownLintFileOptions as MarkdownLintProjectOptions, type MarkdownLintFileResult, type MarkdownLintFilesResult, type MarkdownLintLanguage, type MarkdownLintOptions, type MarkdownLintResult, type MarkdownLintRuleOptions, type MarkdownLintSeverity, type MarkdownLintStandardDictionaryOptions, MarkdownNode, MarkdownSourceOptions, MarkdownTransformer, MathOptions, MdxImport, MdxImportSpecifier, MdxImportSpecifierKind, type MermaidOptions, type NavGroup, NavItem, NotFoundOptions, type OgBrowserSession, OgImageOptions, type OgImagePageEntry, type OgImageOptions$1 as OgImagePluginOptions, type OgImageResult, type OgImageTemplateFn, type OgImageTemplateProps, type OgpData, type OgpOptions, OxContentOptions, type PageChromeFlags, type PageData, type PageProps, PageResourceError, ParamDoc, type ParseIslandsResult, PermalinksOptions, PublishStateOptions, PwaOptions, ReaderChromeOptions, RedirectsOptions, type RenderContext, type RenderIslandComponentImportsInput, type RenderIslandFn, type RenderedHead, type ResolveDocumentComponentImportsInput, type ResolveDocumentComponentImportsResult, ResolvedA11y, ResolvedAttrsOptions, ResolvedBadgeOptions, ResolvedBlogFeedSource, ResolvedBlogOptions, ResolvedBuiltinEmbedOptions, ResolvedCardOptions, ResolvedCascadeOptions, ResolvedCodeAnnotationsOptions, ResolvedCodeBlockLintOptions, ResolvedCodeBlockTypecheckOptions, ResolvedCodeImportOptions, ResolvedCollectionOptions, ResolvedCollectionsOptions, ResolvedContainerOptions, ResolvedContributors, ResolvedDocsEntryPoint, ResolvedDocsOptions, ResolvedDocsTestOptions, type ResolvedDocumentComponentImport, ResolvedEditThisPageOptions, ResolvedEmojiShortcodeOptions, ResolvedFeedsOptions, ResolvedFileTreeOptions, ResolvedHeadingPermalinksOptions, ResolvedI18nOptions, ResolvedImageOptions, ResolvedIncludeOptions, ResolvedJsonLd, ResolvedMagicLinkOptions, ResolvedMarkdownSourceOptions, ResolvedMathOptions, ResolvedNotFoundOptions, ResolvedOgImageOptions, ResolvedOptions, ResolvedPermalinksOptions, ResolvedPublishStateOptions, ResolvedPwaOptions, ResolvedReaderChrome, ResolvedRedirectsOptions, ResolvedResourcesOptions, ResolvedSanitizeOptions, ResolvedSearchOptions, ResolvedSectionIndexOptions, ResolvedSiteMapsOptions, ResolvedSsgOptions, ResolvedStepsOptions, ResolvedTaxonomiesOptions, ResolvedTeamOptions, type ResolvedThemeConfig, ResolvedTypedHoverOptions, ResolvedVersionEntry, ResolvedVersionsOptions, ResolvedWikiLinkOptions, ResourcesOptions, ReturnDoc, type RunDocsTestsOptions, SanitizeOptions, ScopedSearchQuery, SearchDocument, SearchOptions, SearchResult, SectionIndexOptions, SectionIndexStyle, type SidebarItem, type SiteConfig, type SiteHead, SiteMapsOptions, type SocialLinks, SsgNavigationGroup, SsgNavigationItem, SsgOptions, StepsOptions, TaxonomiesOptions, TeamLink, TeamMember, TeamOptions, type ThemeAnnouncement, type ThemeColors, type ThemeComponent, type ThemeConfig, type ThemeEmbed, type ThemeEntryPage, type ThemeFonts, type ThemeFooter, type ThemeHeader, type ThemeLayout, type ThemeProps, type ThemeRenderOptions, type ThemeTokens, ThrowsDoc, TocEntry, type TransformAllOptions, TransformContext, TransformResult, type TwitterEmbedOptions, type TypecheckCodeBlockOptions, TypedHoverOptions, VersionBannerKind, VersionEntry, VersionsOptions, type VitePressConfig, type VitePressFooter, type VitePressLogo, type VitePressNavItem, type VitePressSidebar, type VitePressSidebarItem, type VitePressSocialLink, type VitePressThemeConfig, WikiLinkOptions, type WrittenDocsTestFile, type YouTubeOptions, applyIslandSsrHtml, buildCollectionManifest, buildSearchIndex, buildSsg, classifyPublishState, clearRenderContext, collectDocsTests, collectGitHubRepos, collectGitHubSources, collectMdxIslandNamesFromHtml, collectMdxJsxNamesFromAst, collectOgpUrls, convertVitePressNav, convertVitePressSidebar, createFrameworkMarkdownOptions, createI18nPlugin, createIncrementalMarkdownParser, createIncrementalMarkdownRenderer, createMarkdownEnvironment, createTheme, defaultTheme, defineCollection, defineCollections, defineTheme, discoverDocumentMdxIslands, discoverRegisteredMdxComponents, each, escapeSvelteMarkup, extractCodeBlocks, extractDocs, extractDocsTests, extractIslandInfo, extractVideoId, fetchGitHubSource, fetchOgpData, fetchRepoData, fromVitePressConfig, generateCollectionsVirtualModule, generateFrontmatterTypes, generateHydrationScript, generateMarkdown, generateOgImages, generateTabsCSS, generateTypes, generateVirtualModule, generateVitePressMigrationConfig, hasIslands, inferType, intersectHydratableComponentNames, intersectRegisteredComponentNames, isMarkdownFilePath, isMdxFilePath, isRegisteredComponent, jsx, jsxs, lintCodeBlocks, lintMarkdown, lintMarkdownAsync, lintMarkdownFile, lintMarkdownFiles, mergeThemes, mermaidClientScript, normalizeMarkdownExtensions, normalizeVitePressFrontmatter, oxContent, parseGitHubLineRange, parseGitHubPermalink, parsePageChromeFlags, partitionPublishedPages, prefetchGitHubRepos, prefetchGitHubSources, prefetchOgpData, raw, readingTimeMinutes, renderAllPages, renderHead, renderHtmlToFrameworkCode, renderHtmlToReactComponent, renderHtmlToReactCreateElement, renderHtmlToSvelteComponent, renderHtmlToVueComponent, renderHtmlToVueH, renderIslandComponentImports, renderMarkdownStream, renderPage, renderToString, resolveBadgeOptions, resolveBlogCollectionName, resolveBlogOptions, resolveBuiltinEmbedOptions, resolveCardOptions, resolveCascadeOptions, resolveCollectionsOptions, resolveContentRootPath, resolveDocsOptions, resolveDocumentComponentImports, resolveFeedsOptions, resolveFileTreeOptions, resolveHeadValidation, resolveHeaderNavItems, resolveHeadingPermalinksOptions, resolveI18nOptions, resolveImageOptions, resolveIncludeOptions, resolveLocaleLabel, resolveMarkdownSourceOptions, resolveMathOptions, resolveMdxForFilePath, resolveNotFoundOptions, resolveOgImageOptions, resolvePageChromeOption, resolvePermalinksOptions, resolvePublishStateOptions, resolvePwaOptions, resolveRedirectsOptions, resolveResourcesOptions, resolveSearchOptions, resolveSectionIndexOptions, resolveSiteMapsOptions, resolveSsgOptions, resolveStepsOptions, resolveTaxonomiesOptions, resolveTeamOptions, resolveTheme, resolveTypedHoverOptions, resolveVersionsOptions, runDocsTests, setRenderContext, shouldLintMarkdownFile, stripMarkdownExtension, stripViteQuery, transformAllPlugins, transformGitHub, transformIslands, transformMarkdown, transformMermaidStatic, transformOgp, transformTabs, transformYouTube, typecheckCodeBlocks, useIsActive, useNav, usePageProps, useRenderContext, useSiteConfig, when, writeDocs, writeDocsTestFiles, writeSearchIndex };
 //# sourceMappingURL=index.d.mts.map