fumadocs-openapi 11.4.3 → 12.0.0

package/dist/packages/shared-api/dist/.translations/keys.js

@@ -0,0 +1,28 @@
+//#region ../shared-api/dist/.translations/keys.js
+var keys_default = [
+	"Default(schema UI)",
+	"Deprecated(schema UI)",
+	"Enter Property Name(playground)",
+	"Enter value(playground)",
+	"Example(schema UI)",
+	"Filter Properties(schema UI)",
+	"Format(schema UI)",
+	"Items(schema UI)",
+	"Length(schema UI)",
+	"Match(schema UI)",
+	"Multiple Of(schema UI)",
+	"New Item(playground)",
+	"New(playground)",
+	"No property matching(schema UI)",
+	"Properties(schema UI)",
+	"Range(schema UI)",
+	"Remove Item(playground)(aria-label)",
+	"Select(playground)",
+	"Selected(playground)",
+	"Show Property(playground)",
+	"Unset(playground)",
+	"Upload(playground)",
+	"Value in(schema UI)"
+];
+//#endregion
+export { keys_default as default };

package/dist/packages/shared-api/dist/auto-anchor/client.js

@@ -0,0 +1,20 @@
+"use client";
+import { anchorSegments } from "./index.js";
+import { createContext, use, useMemo } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region ../shared-api/dist/auto-anchor/client.js
+const AnchorContext = createContext([]);
+/** Append segment to anchor IDs */
+function AnchorSection({ segments, children }) {
+	const v = use(AnchorContext);
+	return /* @__PURE__ */ jsx(AnchorContext, {
+		value: useMemo(() => [...v, ...segments], [v, segments]),
+		children
+	});
+}
+function useAnchorId(segments) {
+	if (!segments) return null;
+	return anchorSegments(...use(AnchorContext), ...segments);
+}
+//#endregion
+export { AnchorSection, useAnchorId };

package/dist/packages/shared-api/dist/auto-anchor/index.js

@@ -0,0 +1,17 @@
+import { slug } from "github-slugger";
+//#region ../shared-api/dist/auto-anchor/index.js
+/** slugify segments, append `\0` to keep segment as-is */
+function anchorSegments(...segs) {
+	const mapped = [];
+	for (const seg of segs) if (seg.startsWith("\0")) mapped.push(seg.slice(1));
+	else if (seg.length > 0) mapped.push(slug(seg));
+	return mapped.join(".");
+}
+/**
+* Check if `id1` starts with `id2`
+*/
+function anchorIdStartsWith(id1, id2) {
+	return id1 === id2 || id1.startsWith(`${id2}.`);
+}
+//#endregion
+export { anchorIdStartsWith, anchorSegments };

package/dist/packages/shared-api/dist/codegen.d.ts

@@ -0,0 +1,42 @@
+declare namespace codegen_d_exports {
+  export { CodeUsageGenerator, CodeUsageGeneratorRegistry, InlineCodeUsageGenerator, createCodeUsageGeneratorRegistry };
+}
+//#region src/codegen.d.ts
+export interface CodeUsageGeneratorRegistry<Data = unknown, Context = unknown> {
+  add: (id: string, generator: CodeUsageGenerator<Data, Context>) => void;
+  get: (id: string) => CodeUsageGenerator<Data, Context> | undefined;
+  addInline: (generator: InlineCodeUsageGenerator<Data, Context>) => void;
+  /**
+   * @returns if the generator is removed
+   */
+  remove: (id: string) => boolean;
+  map: () => Map<string, CodeUsageGenerator<Data, Context>>;
+}
+/**
+ * Generate code example for given programming language
+ */
+export interface CodeUsageGenerator<Data = unknown, Context = unknown> {
+  generate: (data: Data, context: Context) => string;
+  lang: string;
+  label?: string;
+}
+/**
+ * Generate code example for given programming language
+ */
+export interface InlineCodeUsageGenerator<Data = unknown, Context = unknown> {
+  id?: string;
+  lang: string;
+  label?: string;
+  /**
+   * either:
+   * - code
+   * - a function imported from a file with "use client" directive
+   * - false (disabled)
+   */
+  source?: string | CodeUsageGeneratorFn<Data, Context> | false;
+}
+export declare function createCodeUsageGeneratorRegistry<Data, Context>(inherit?: CodeUsageGeneratorRegistry<Data, Context>): CodeUsageGeneratorRegistry<Data, Context>;
+type CodeUsageGeneratorFn<Data, Context> = (data: Data, context: Context) => string;
+//#endregion
+//#endregion
+export { codegen_d_exports };

package/dist/packages/shared-api/dist/codegen.js

@@ -0,0 +1,35 @@
+//#region ../shared-api/dist/codegen.js
+function createCodeUsageGeneratorRegistry(inherit) {
+	const registry = new Map(inherit?.map());
+	return {
+		add(id, generator) {
+			registry.set(id, generator);
+		},
+		get(id) {
+			return registry.get(id);
+		},
+		addInline(generator) {
+			const source = generator.source;
+			const id = generator.id ?? generator.lang;
+			if (!source) {
+				this.remove(id);
+				return;
+			}
+			registry.set(id, {
+				lang: generator.lang,
+				label: generator.label,
+				generate() {
+					return typeof source === "string" ? source : "";
+				}
+			});
+		},
+		remove(id) {
+			return registry.delete(id);
+		},
+		map() {
+			return registry;
+		}
+	};
+}
+//#endregion
+export { createCodeUsageGeneratorRegistry };

package/dist/packages/shared-api/dist/components/accordion.js

@@ -0,0 +1,71 @@
+"use client";
+import { cn } from "../utils/cn.js";
+import { anchorIdStartsWith } from "../auto-anchor/index.js";
+import { AnchorSection, useAnchorId } from "../auto-anchor/client.js";
+import { createContext, use, useEffect, useMemo, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { ChevronRight } from "lucide-react";
+import { Accordion } from "@base-ui/react/accordion";
+//#region ../shared-api/dist/components/accordion.js
+const Context = createContext(null);
+function Accordions({ type = "single", defaultValue, ...props }) {
+	const [value, setValue] = useState(() => {
+		if (Array.isArray(defaultValue)) return defaultValue;
+		if (defaultValue) return [defaultValue];
+		return [];
+	});
+	return /* @__PURE__ */ jsx(Context, {
+		value: useMemo(() => ({
+			type,
+			setValue
+		}), [type]),
+		children: /* @__PURE__ */ jsx(Accordion.Root, {
+			multiple: type === "multiple",
+			value,
+			onValueChange: setValue,
+			...props
+		})
+	});
+}
+function AccordionItem({ value, className, anchorSegments, ...props }) {
+	const ctx = use(Context);
+	const id = useAnchorId(anchorSegments ?? false);
+	useEffect(() => {
+		if (id && anchorIdStartsWith(window.location.hash.slice(1), id)) ctx.setValue([value]);
+	}, [
+		value,
+		id,
+		ctx
+	]);
+	const content = /* @__PURE__ */ jsx(Accordion.Item, {
+		value,
+		className: cn("scroll-m-20 border-b last:border-b-0", className),
+		...props
+	});
+	return anchorSegments ? /* @__PURE__ */ jsx(AnchorSection, {
+		segments: anchorSegments,
+		children: content
+	}) : content;
+}
+function AccordionContent(props) {
+	return /* @__PURE__ */ jsx(Accordion.Panel, {
+		...props,
+		className: cn("h-(--accordion-panel-height) overflow-hidden transition-[height] ease-out data-ending-style:h-0 data-starting-style:h-0", props.className)
+	});
+}
+function AccordionHeader(props) {
+	return /* @__PURE__ */ jsx(Accordion.Header, {
+		...props,
+		className: cn("not-prose flex text-fd-foreground font-medium", props.className),
+		children: props.children
+	});
+}
+function AccordionTrigger(props) {
+	return /* @__PURE__ */ jsxs(Accordion.Trigger, {
+		...props,
+		className: cn("flex flex-1 items-center gap-1 text-start group/accordion py-2 focus-visible:outline-none", props.className),
+		children: [/* @__PURE__ */ jsx(ChevronRight, { className: "size-3.5 text-fd-muted-foreground shrink-0 transition-transform group-data-[panel-open]/accordion:rotate-90" }), props.children]
+	});
+}
+//#endregion
+export { AccordionContent, AccordionHeader, AccordionItem, AccordionTrigger, Accordions };

package/dist/packages/shared-api/dist/components/badge.js

@@ -0,0 +1,21 @@
+import { cn } from "../utils/cn.js";
+import { jsx } from "react/jsx-runtime";
+import { cva } from "class-variance-authority";
+//#region ../shared-api/dist/components/badge.js
+const badgeVariants = cva("font-mono font-medium", { variants: { color: {
+	green: "text-green-600 dark:text-green-400",
+	yellow: "text-yellow-600 dark:text-yellow-400",
+	red: "text-red-600 dark:text-red-400",
+	blue: "text-blue-600 dark:text-blue-400",
+	orange: "text-orange-600 dark:text-orange-400",
+	gray: "text-fd-muted-foreground"
+} } });
+function Badge({ className, color, ...props }) {
+	return /* @__PURE__ */ jsx("span", {
+		className: cn(badgeVariants({ color }), className),
+		...props,
+		children: props.children
+	});
+}
+//#endregion
+export { Badge, badgeVariants };

package/dist/packages/shared-api/dist/components/collapsible.d.ts

@@ -0,0 +1,7 @@
+import { ComponentProps } from "react";
+import { Collapsible } from "@base-ui/react/collapsible";
+//#region ../shared-api/dist/components/collapsible.d.ts
+//#region src/components/collapsible.d.ts
+declare const Collapsible$1: import("react").ForwardRefExoticComponent<Omit<import("@base-ui/react").CollapsibleRootProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+//#endregion
+export { Collapsible$1 as Collapsible };

package/dist/packages/shared-api/dist/components/collapsible.js

@@ -0,0 +1,16 @@
+"use client";
+import { cn } from "../utils/cn.js";
+import { jsx } from "react/jsx-runtime";
+import { Collapsible } from "@base-ui/react/collapsible";
+//#region ../shared-api/dist/components/collapsible.js
+const Collapsible$1 = Collapsible.Root;
+const CollapsibleTrigger = Collapsible.Trigger;
+function CollapsibleContent({ children, className, ...props }) {
+	return /* @__PURE__ */ jsx(Collapsible.Panel, {
+		...props,
+		className: (s) => cn("overflow-hidden [&[hidden]:not([hidden='until-found'])]:hidden h-(--collapsible-panel-height) transition-[height,opacity] data-starting-style:opacity-0 data-starting-style:h-0 data-ending-style:h-0 data-ending-style:opacity-0", typeof className === "function" ? className(s) : className),
+		children
+	});
+}
+//#endregion
+export { Collapsible$1 as Collapsible, CollapsibleContent, CollapsibleTrigger };

package/dist/packages/shared-api/dist/components/defaults.d.ts

@@ -0,0 +1,20 @@
+import { ComponentProps, FC } from "react";
+import { DynamicCodeblockProps } from "fumadocs-ui/components/dynamic-codeblock.core";
+import { ShikiFactory } from "fumadocs-core/highlight/shiki";
+import { BundledTheme, CodeOptionsThemes, CodeToHastOptionsCommon } from "shiki";
+//#region ../shared-api/dist/components/defaults.d.ts
+//#region src/components/defaults.d.ts
+export type CodeBlockProps = Omit<DynamicCodeblockProps, 'highlighter' | 'options'>;
+export type ShikiOptions = Omit<CodeToHastOptionsCommon, 'lang'> & CodeOptionsThemes<BundledTheme>;
+/** components an API page renders its content through */
+export interface PageComponents {
+  Markdown: FC<{
+    md: string;
+  }>;
+  CodeBlock: FC<CodeBlockProps>;
+  Heading: FC<ComponentProps<'h1'> & {
+    id: string;
+    depth: number;
+  }>;
+}
+//#endregion

package/dist/packages/shared-api/dist/components/defaults.js

@@ -0,0 +1,70 @@
+"use client";
+import { Children, useMemo } from "react";
+import * as JsxRuntime from "react/jsx-runtime";
+import { jsx } from "react/jsx-runtime";
+import { remark } from "remark";
+import remarkRehype from "remark-rehype";
+import { remarkGfm } from "fumadocs-core/mdx-plugins/remark-gfm";
+import { toJsxRuntime } from "hast-util-to-jsx-runtime";
+import defaultMdxComponents from "fumadocs-ui/mdx";
+import { Heading } from "fumadocs-ui/components/heading";
+import { DynamicCodeBlock } from "fumadocs-ui/components/dynamic-codeblock.core";
+//#region ../shared-api/dist/components/defaults.js
+const defaultShikiOptions = { themes: {
+	light: "github-light",
+	dark: "github-dark"
+} };
+/**
+* The default Markdown, code block and heading components of API pages.
+*
+* Markdown is rendered with Remark, its code blocks go through {@link PageComponents}.
+*/
+function createPageComponents({ shiki, shikiOptions = defaultShikiOptions, components }) {
+	const CodeBlock = components.CodeBlock ?? ((props) => /* @__PURE__ */ jsx(DynamicCodeBlock, {
+		highlighter: () => shiki.getOrInit(),
+		options: shikiOptions,
+		...props
+	}));
+	let processor;
+	return {
+		CodeBlock,
+		Markdown: components.Markdown ?? (({ md }) => useMemo(() => {
+			processor ??= createProcessor(CodeBlock);
+			return processor.processSync(md).result;
+		}, [md])),
+		Heading: components.Heading ?? (({ depth, ...props }) => /* @__PURE__ */ jsx(Heading, {
+			as: `h${depth}`,
+			...props
+		}))
+	};
+}
+function createProcessor(CodeBlock) {
+	function Pre(props) {
+		const codeProps = Children.only(props.children).props;
+		const content = codeProps.children;
+		if (typeof content !== "string") return null;
+		const lang = codeProps.className?.split(" ").find((v) => v.startsWith("language-"))?.slice(9) ?? "text";
+		return /* @__PURE__ */ jsx(CodeBlock, {
+			lang,
+			code: content.trimEnd()
+		});
+	}
+	const mdxComponents = {
+		...defaultMdxComponents,
+		img: void 0,
+		pre: Pre
+	};
+	function rehypeReact() {
+		this.compiler = (tree, file) => {
+			return toJsxRuntime(tree, {
+				development: false,
+				filePath: file.path,
+				...JsxRuntime,
+				components: mdxComponents
+			});
+		};
+	}
+	return remark().use(remarkGfm).use(remarkRehype).use(rehypeReact);
+}
+//#endregion
+export { createPageComponents, defaultShikiOptions };

package/dist/packages/shared-api/dist/components/dialog.js

@@ -0,0 +1,55 @@
+"use client";
+import { cn } from "../utils/cn.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { X } from "lucide-react";
+import { buttonVariants } from "fumadocs-ui/components/ui/button";
+import { Dialog } from "@base-ui/react/dialog";
+//#region ../shared-api/dist/components/dialog.js
+const Dialog$1 = Dialog.Root;
+const DialogTrigger = Dialog.Trigger;
+const DialogPortal = Dialog.Portal;
+Dialog.Close;
+function DialogOverlay({ className, ref, ...props }) {
+	return /* @__PURE__ */ jsx(Dialog.Backdrop, {
+		ref,
+		className: cn("fixed inset-0 z-50 bg-black/30 backdrop-blur-sm data-open:animate-fd-fade-in data-closed:animate-fd-fade-out", className),
+		...props
+	});
+}
+function DialogContent({ className, children, ref, ...props }) {
+	return /* @__PURE__ */ jsxs(DialogPortal, { children: [/* @__PURE__ */ jsx(DialogOverlay, {}), /* @__PURE__ */ jsxs(Dialog.Popup, {
+		ref,
+		className: cn("fixed left-1/2 top-1/2 z-50 flex flex-col gap-4 w-full max-w-lg -translate-x-1/2 -translate-y-1/2 border bg-fd-popover p-4 shadow-lg rounded-xl duration-200 data-open:animate-fd-dialog-in data-closed:animate-fd-dialog-out focus-visible:outline-none", className),
+		...props,
+		children: [children, /* @__PURE__ */ jsx(Dialog.Close, {
+			"aria-label": "Close",
+			className: cn(buttonVariants({
+				size: "icon-sm",
+				variant: "ghost"
+			}), "absolute end-2 top-2 text-fd-muted-foreground/70"),
+			children: /* @__PURE__ */ jsx(X, {})
+		})]
+	})] });
+}
+function DialogHeader({ className, ...props }) {
+	return /* @__PURE__ */ jsx("div", {
+		className: cn("flex flex-col gap-1.5 text-center sm:text-start", className),
+		...props
+	});
+}
+function DialogTitle({ className, ref, ...props }) {
+	return /* @__PURE__ */ jsx(Dialog.Title, {
+		ref,
+		className: cn("text-lg font-semibold leading-none tracking-tight", className),
+		...props
+	});
+}
+function DialogDescription({ className, ref, ...props }) {
+	return /* @__PURE__ */ jsx(Dialog.Description, {
+		ref,
+		className: cn("text-sm text-fd-muted-foreground", className),
+		...props
+	});
+}
+//#endregion
+export { Dialog$1 as Dialog, DialogContent, DialogDescription, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger };

package/dist/packages/shared-api/dist/components/input.js

@@ -0,0 +1,14 @@
+import { cn } from "../utils/cn.js";
+import "react";
+import { jsx } from "react/jsx-runtime";
+//#region ../shared-api/dist/components/input.js
+function Input({ className, type, ref, ...props }) {
+	return /* @__PURE__ */ jsx("input", {
+		type,
+		className: cn("flex h-9 w-full rounded-md border bg-fd-secondary px-2 py-1.5 text-[0.8125rem] text-fd-secondary-foreground transition-colors placeholder:text-fd-muted-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-fd-ring disabled:cursor-not-allowed disabled:opacity-50", className),
+		ref,
+		...props
+	});
+}
+//#endregion
+export { Input };

package/dist/packages/shared-api/dist/components/label.js

@@ -0,0 +1,11 @@
+import { cn } from "../utils/cn.js";
+import { jsx } from "react/jsx-runtime";
+//#region ../shared-api/dist/components/label.js
+function Label({ className, ...props }) {
+	return /* @__PURE__ */ jsx("label", {
+		className: cn("text-xs font-medium text-fd-foreground peer-disabled:cursor-not-allowed peer-disabled:opacity-70", className),
+		...props
+	});
+}
+//#endregion
+export { Label };