npm - @fumadocs/api-docs - Versions diffs - 0.0.2 → 0.0.3 - Mend

@fumadocs/api-docs 0.0.2 → 0.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (40) hide show

package/css/generated/shared.css CHANGED Viewed

	@@ -1 +1 @@
1	- @source inline("!isDefined :data-[collapsible=true]:order-last :min-w-0 --min-height --radix-popover-content-available-width -mx-3 -translate-x-1/2 -translate-y-1/2 @container @default @fuma-translate/react @fumari/stf @md:grid-cols-2 @param @radix-ui/react-accordion @radix-ui/react-dialog @radix-ui/react-select [&_svg]:size-3.5 a absolute accordion actual additionalProperties again ajv aliasName allOf always an anchor anchorIdStartsWith anchorSegments and animate-spin any anyFields anyOf applicable aria-label array as asSchema autoIds avoid backdrop-blur-sm be behavior bg-black/30 bg-fd-background/50 bg-fd-muted bg-fd-popover bg-fd-primary bg-fd-secondary binary block body boolean border border-b border-fd-primary/20 border-t both button buttonVariants catch children class-variance-authority className client clientHeight closed cn code col-span-full collapsible collisionPadding color const content createContext ctx current currentValue cva dark:text-yellow-400 data-[disabled]:opacity-50 data-[disabled]:pointer-events-none data-[state=closed]:animate-fd-accordion-up data-[state=closed]:animate-fd-dialog-out data-[state=closed]:animate-fd-fade-out data-[state=open]:animate-fd-accordion-down data-[state=open]:animate-fd-dialog-in data-[state=open]:animate-fd-fade-in data-[state=open]:text-fd-accent-foreground data-collapsible data-object-search-input data-placeholder:text-fd-muted-foreground dataEngine decoded default defaultValue deferredValue define delete deprecated depth dereference dereferenceShallow dereferenced description disabled:cursor-not-allowed disabled:opacity-50 display displayName div doc docRoot duplicated duration-200 dynamic element else empty empty:hidden end end-2 engine ensure enum example examples exclusiveMax exclusiveMin export extends fallback false fd-scroll-container field fieldData fieldLabelVariants fieldName fields file files filtered first first:border-t-0 firstItemRef fixed flex flex-1 flex-col flex-col-reverse flex-row flex-wrap focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-fd-ring focus-within:[&_svg]:text-fd-primary focus-within:ring-2 focus-within:ring-fd-ring focus:bg-fd-accent focus:outline-none focus:ring focus:ring-fd-ring focus:text-fd-accent-foreground font-medium font-mono font-semibold for format forwardRef from function gap-0.5 gap-1 gap-1.5 gap-2 gap-4 generate generateDefault generated ghost grid grid-cols-1 group-data-[state=open]/accordion:rotate-90 group/accordion h-10 h-9 h-[240px] h-px hash hidden hiddenProperties highlighted hook hover:bg-fd-accent hover:text-fd-accent-foreground hover:underline htmlFor i icon-sm icon-xs id idx if ignore import in in-popover include index indexItemMatch info infoTags initial inline-flex input inset-0 instanceof integer interface invalid is isDefined isDuplicated isDynamic isLazy isNumber isRequired it item itemId items items-center ~~items-start~~ j justify-center key kind label labelVariants ~~labels~~ last:border-b-0 lazy leading-none left-1/2 length let line-through lucide-react ~~match~~ matching max max-h-[460px] max-w-(--radix-popover-content-available-width) max-w-full max-w-lg mb-auto md me-auto merge mergeAllOf mergeRefs min min-h-(--min-height,200px) min-w-0 ms-auto mt-2 multiple ~~multipleOf~~ must mx-1 my-1 my-2 my-2! name namespace nested never new next not-prose note null number object objectSearchOverrides objects of omit onChange onClick onKeyDown onOpenAutoFocus onOpenChange onScrollEnd onValueChange oneOf only opacity-80 open or order-last out outline outline-none overflow-hidden overflow-x-auto overflow-y-hidden overview p-1 p-1.5 p-2 p-4 param parentItem parentPathIndex part path pathIndex pathName pattern patternProperties pb-0 pe-2 peer-disabled:cursor-not-allowed peer-disabled:opacity-70 placeholder placeholder:text-fd-muted-foreground playground popover popoverRef position prev preventScroll primitive prop properties property props prose-no-margin ps-2 ps-3 ps-6 pt-0 px px-2 px-3 px-4 py-0 py-1 py-1.5 py-2 py-4 quiet range raw rawRef rawSearch re-triggering react read readOnly ref refs remove removeItem render renderMarkdown renderTypeInfoTrigger represents required resize-none resolver return role root rootId rotate-90 rounded-lg rounded-md rounded-sm rounded-xl s-highlight same sample satisfies schema schemaPropKeys schemaToString scroll scroll-m-20 scrollTop search secondary section segments select-none selected selectedType sep setError setInfo setNextName ~~setOpen~~ setPath setSearch setShow setValue shadow-lg shadow-md shadow-sm show showExample showSelect shrink-0 simplified single size size-3.5 size-4 skipNonRequired skipReadOnly slotType sm sm:flex-row sm:gap-2 sm:justify-end sm:text-start smooth stable states status step stf sticky store strict string stringifyFieldKey such svg t tab tabDepth tabValues ~~tag~~ tags target text text-[0.8125rem] text-center text-end text-fd-foreground text-fd-muted-foreground text-fd-muted-foreground/70 text-fd-popover-foreground text-fd-primary text-fd-primary-foreground text-fd-secondary-foreground text-lg text-orange-400 text-red-400 text-red-400/80 text-sm text-start text-xs text-yellow-600 that the tiem to toolbar top top-0 top-1/2 top-10 top-2 tracking-tight transition-colors transition-transform trigger true truncate try type typeName typeVariants typeof types undefined underline union unionField unknown updateInfo updated url use useAnchorId useCopyButton useFieldValue useMemo useNamespace useObject useRef useState useTranslations validateFormats validateSchema value ~~valueIn~~ valueSchema values variant variants w-0 w-[600px] w-fit w-full will with wrap-break-word write writeOnly x-playground-lazy z-20 z-50");
1	+ @source inline("!isDefined :data-[collapsible=true]:order-last :min-w-0 --min-height --radix-popover-content-available-width -mx-3 -translate-x-1/2 -translate-y-1/2 @container @default @fuma-translate/react @fumari/stf @md:grid-cols-2 @param @radix-ui/react-accordion @radix-ui/react-dialog @radix-ui/react-select [&_svg]:size-3.5 a absolute accordion actual additionalProperties again ajv aliasName allOf always an anchor anchorIdStartsWith anchorSegments and animate-spin any anyFields anyOf applicable aria-label array as asSchema autoIds avoid backdrop-blur-sm be behavior bg-black/30 bg-fd-background/50 bg-fd-muted bg-fd-popover bg-fd-primary bg-fd-secondary binary block blocks body boolean border border-b border-fd-primary/20 border-t both button buttonVariants catch children class-variance-authority className client clientHeight closed cn code col-span-full collapsible collisionPadding color const content createContext ctx current currentValue cva dark:text-yellow-400 data-[disabled]:opacity-50 data-[disabled]:pointer-events-none data-[state=closed]:animate-fd-accordion-up data-[state=closed]:animate-fd-dialog-out data-[state=closed]:animate-fd-fade-out data-[state=open]:animate-fd-accordion-down data-[state=open]:animate-fd-dialog-in data-[state=open]:animate-fd-fade-in data-[state=open]:text-fd-accent-foreground data-collapsible data-object-search-input data-placeholder:text-fd-muted-foreground dataEngine decoded default defaultCode defaultValue deferredValue define delete deprecated depth dereference dereferenceShallow dereferenced description disabled:cursor-not-allowed disabled:opacity-50 display displayName div doc docRoot duplicated duration-200 dynamic element else empty empty:hidden end end-2 engine ensure enum example examples exclusiveMax exclusiveMin export extends fallback false fd-scroll-container field fieldData fieldLabelVariants fieldName fields file files filtered first first:border-t-0 firstItemRef fixed flex flex-1 flex-col flex-col-reverse flex-row flex-wrap focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-fd-ring focus-within:[&_svg]:text-fd-primary focus-within:ring-2 focus-within:ring-fd-ring focus:bg-fd-accent focus:outline-none focus:ring focus:ring-fd-ring focus:text-fd-accent-foreground font-medium font-mono font-semibold for format forwardRef from function gap-0.5 gap-1 gap-1.5 gap-2 gap-4 generate generateDefault generated ghost grid grid-cols-1 group-data-[state=open]/accordion:rotate-90 group/accordion h-10 h-9 h-[240px] h-px hash hidden hiddenProperties highlighted hook hover:bg-fd-accent hover:text-fd-accent-foreground hover:underline htmlFor i icon-sm icon-xs id idx if ignore import in in-popover include index indexItemMatch info infoTags initial inline-flex inlines input inset-0 instanceof integer interface invalid is isDefined isDuplicated isDynamic isLazy isNumber isRequired it item itemId items items-center j json justify-center key kind label labelVariants lang last:border-b-0 lazy leading-none left-1/2 length let line-through list-disc list-inside lucide-react marker:text-fd-muted-foreground matching max max-h-[460px] max-w-(--radix-popover-content-available-width) max-w-full max-w-lg mb-auto md me-auto members merge mergeAllOf mergeRefs min min-h-(--min-height,200px) min-w-0 ms-auto mt-2 multiple must mx-1 my-1 my-2 my-2! name namespace nested never new next node not-prose note null number object objectSearchOverrides objects of omit onChange onClick onKeyDown onOpenAutoFocus onOpenChange onScrollEnd onValueChange oneOf only opacity-80 open opts or order-last out outline outline-none overflow-hidden overflow-x-auto overflow-y-hidden overview p-1 p-1.5 p-2 p-4 param parentItem parentPathIndex part path pathIndex pathName pattern patternProperties pb-0 pe-2 peer-disabled:cursor-not-allowed peer-disabled:opacity-70 placeholder placeholder:text-fd-muted-foreground playground popover popoverRef position prev preventScroll primitive prop properties property props prose-no-margin ps-1 ps-2 ps-3 ps-6 pt-0 px px-2 px-3 px-4 py-0 py-1 py-1.5 py-2 py-4 quiet range raw rawRef rawSearch re-triggering react read readOnly ref refs remove removeItem render renderCodeblock renderMarkdown renderTypeInfoTrigger represents required resize-none resolver return role root rootId rotate-90 rounded-lg rounded-md rounded-sm rounded-xl s-highlight same sample satisfies schema schemaPropKeys schemaToString scroll scroll-m-20 scrollTop search secondary section segments select-none selected selectedType sep setError setInfo setNextName setPath setSearch setShow setValue shadow-lg shadow-md shadow-sm show showExample showSelect shrink-0 simplified single size size-3.5 size-4 skipNonRequired skipReadOnly slotType sm sm:flex-row sm:gap-2 sm:justify-end sm:text-start smooth stable states status step stf sticky store strict string stringifyFieldKey such svg t tab tabDepth tabValues tags target text text-[0.8125rem] text-center text-end text-fd-foreground text-fd-muted-foreground text-fd-muted-foreground/70 text-fd-popover-foreground text-fd-primary text-fd-primary-foreground text-fd-secondary-foreground text-lg text-orange-400 text-red-400 text-red-400/80 text-sm text-start text-xs text-yellow-600 that the tiem to toolbar top top-0 top-1/2 top-10 top-2 tracking-tight transition-colors transition-transform translations trigger true truncate try type typeName typeVariants typeof types undefined underline union unionField unknown updateInfo updated url use useAnchorId useCopyButton useFieldValue useMemo useNamespace useObject useRef useState useTranslations validateFormats validateSchema value valueSchema values variant variants w-0 w-[600px] w-fit w-full will with wrap-break-word write writeOnly x-playground-lazy z-20 z-50");

package/dist/components/schema/client.d.ts CHANGED Viewed

@@ -1,4 +1,5 @@
 import { SchemaUIGeneratedData } from "./index.js";
+import { ReactNode } from "react";
 //#region src/components/schema/client.d.ts
 interface SchemaUIProps {
@@ -13,5 +14,19 @@ declare function SchemaUI({
   as,
   generated
 }: SchemaUIProps): import("react").JSX.Element;
+declare function InlineTag({
+  label,
+  children
+}: {
+  label: ReactNode;
+  children: ReactNode;
+}): import("react").JSX.Element;
+declare function BlockTag({
+  label,
+  children
+}: {
+  label: ReactNode;
+  children: ReactNode;
+}): import("react").JSX.Element;
 //#endregion
-export { SchemaUI, SchemaUIProps };
+export { BlockTag, InlineTag, SchemaUI, SchemaUIProps };

package/dist/components/schema/client.js CHANGED Viewed

@@ -108,7 +108,7 @@ function SchemaDescription({ schema, ...props }) {
 		className: cn("prose-no-margin py-2 empty:hidden", props.className),
 		children: [schema.description, schema.infoTags && schema.infoTags.length > 0 && /* @__PURE__ */ jsx("div", {
 			className: "flex flex-row gap-2 flex-wrap mt-2 not-prose empty:hidden",
-			children: schema.infoTags.map((tag, i) => /* @__PURE__ */ jsx(InfoTag, { tag }, i))
+			children: schema.infoTags.map((tag, i) => /* @__PURE__ */ jsx(Fragment, { children: tag.node }, i))
 		})]
 	});
 }
@@ -298,22 +298,27 @@ function ObjectSearchContent({ search: rawSearch, firstItemRef, properties, empt
 	if (filtered.length === 0) return empty();
 	return filtered.map(render);
 }
-function InfoTag({ tag }) {
-	const ref = useRef(null);
-	const [open, setOpen] = useState(false);
-	return /* @__PURE__ */ jsxs("button", {
-		className: "inline-flex text-start items-start gap-2 bg-fd-secondary border rounded-lg text-xs p-1.5 shadow-md max-w-full",
-		onClick: () => setOpen((prev) => !prev),
+function InlineTag({ label, children }) {
+	return /* @__PURE__ */ jsxs("div", {
+		className: "inline-flex gap-2 bg-fd-secondary border rounded-lg text-xs p-1.5 shadow-md max-w-full",
 		children: [/* @__PURE__ */ jsx("span", {
 			className: "font-medium",
-			children: tag.label
+			children: label
 		}), /* @__PURE__ */ jsx("code", {
-			ref,
-			className: cn("min-w-0 flex-1 text-fd-muted-foreground", open ? "wrap-break-word" : "truncate"),
-			children: tag.value
+			className: "min-w-0 flex-1 text-fd-muted-foreground wrap-break-word",
+			children
 		})]
 	});
 }
+function BlockTag({ label, children }) {
+	return /* @__PURE__ */ jsxs("div", {
+		className: "flex flex-col w-full gap-2 bg-fd-secondary border rounded-lg p-1.5 shadow-md",
+		children: [/* @__PURE__ */ jsx("p", {
+			className: "font-medium text-xs",
+			children: label
+		}), children]
+	});
+}
 function SchemaUIPopover() {
 	const states = useStates();
 	const { path, setPath } = states;
@@ -412,4 +417,4 @@ function decodePath(path, highlighted) {
 	return out;
 }
 //#endregion
-export { SchemaUI };
+export { BlockTag, InlineTag, SchemaUI };

package/dist/components/schema/index.d.ts CHANGED Viewed

@@ -3,6 +3,9 @@ import { SchemaUIProps } from "./client.js";
 import { ReactNode } from "react";
 //#region src/components/schema/index.d.ts
+interface InfoTag {
+  node: ReactNode;
+}
 interface FieldBase {
   description?: ReactNode;
   infoTags?: InfoTag[];
@@ -10,10 +13,6 @@ interface FieldBase {
   aliasName: string;
   deprecated?: boolean;
 }
-interface InfoTag {
-  label: ReactNode;
-  value: string;
-}
 interface SchemaDataObjectProperty {
   name: string;
   $type: string;
@@ -47,6 +46,10 @@ interface SchemaUIOptions {
   client: Omit<SchemaUIProps, 'generated'>;
   resolver: SchemaResolver;
   renderMarkdown: (md: string) => ReactNode;
+  renderCodeblock: (opts: {
+    lang: string;
+    code: string;
+  }) => ReactNode;
   /**
    * include read only props
    */
@@ -66,18 +69,6 @@ interface SchemaUIGeneratedData {
   $root: string;
   refs: Record<string, SchemaData>;
 }
-interface SchemaUILabels {
-  default: string;
-  match: string;
-  format: string;
-  multipleOf: string;
-  range: string;
-  length: string;
-  properties: string;
-  items: string;
-  valueIn: string;
-  example: string;
-}
 declare function Schema({
   client,
   root,
@@ -85,18 +76,20 @@ declare function Schema({
   writeOnly,
   resolver,
   showExample,
-  renderMarkdown
+  renderMarkdown,
+  renderCodeblock
 }: SchemaUIOptions): import("react").JSX.Element;
 declare function generateSchemaUI({
   root,
   resolver,
   renderMarkdown,
+  renderCodeblock,
   readOnly,
   writeOnly,
   showExample,
-  labels
+  translations
 }: Omit<SchemaUIOptions, 'client'> & {
-  labels: SchemaUILabels;
+  translations?: Partial<Record<string, string>>;
 }): SchemaUIGeneratedData;
 //#endregion
-export { FieldBase, InfoTag, Schema, SchemaData, SchemaDataObjectProperty, SchemaUIGeneratedData, SchemaUIOptions, generateSchemaUI };
+export { FieldBase, Schema, SchemaData, SchemaDataObjectProperty, SchemaUIGeneratedData, SchemaUIOptions, generateSchemaUI };

package/dist/components/schema/index.js CHANGED Viewed

@@ -1,13 +1,13 @@
 "use client";
 import { mergeAllOf } from "../../schema/merge.js";
 import { schemaToString } from "../../schema/to-string.js";
-import { SchemaUI } from "./client.js";
+import { BlockTag, InlineTag, SchemaUI } from "./client.js";
 import { useMemo } from "react";
 import { jsx } from "react/jsx-runtime";
-import { useTranslations } from "@fuma-translate/react";
+import { fromTranslations, useTranslations } from "@fuma-translate/react";
 //#region src/components/schema/index.tsx
-function Schema({ client, root, readOnly, writeOnly, resolver, showExample, renderMarkdown }) {
-	const t = useTranslations({ note: "schema UI" });
+function Schema({ client, root, readOnly, writeOnly, resolver, showExample, renderMarkdown, renderCodeblock }) {
+	const translations = useTranslations().translations;
 	const generated = useMemo(() => {
 		return generateSchemaUI({
 			root,
@@ -16,18 +16,8 @@ function Schema({ client, root, readOnly, writeOnly, resolver, showExample, rend
 			writeOnly,
 			showExample,
 			renderMarkdown,
-			labels: {
-				default: t("Default"),
-				match: t("Match"),
-				format: t("Format"),
-				multipleOf: t("Multiple Of"),
-				range: t("Range"),
-				length: t("Length"),
-				properties: t("Properties"),
-				items: t("Items"),
-				valueIn: t("Value in"),
-				example: t("Example")
-			}
+			renderCodeblock,
+			translations
 		});
 	}, [
 		root,
@@ -36,62 +26,94 @@ function Schema({ client, root, readOnly, writeOnly, resolver, showExample, rend
 		resolver,
 		showExample,
 		renderMarkdown,
-		t
+		renderCodeblock,
+		translations
 	]);
 	return /* @__PURE__ */ jsx(SchemaUI, {
 		...client,
 		generated
 	});
 }
-function generateSchemaUI({ root, resolver, renderMarkdown, readOnly = false, writeOnly = false, showExample = false, labels }) {
+function generateSchemaUI({ root, resolver, renderMarkdown, renderCodeblock, readOnly = false, writeOnly = false, showExample = false, translations = {} }) {
+	const t = fromTranslations(translations, { note: "schema UI" });
 	const refs = {};
 	function generateInfoTags(schema) {
-		const fields = [];
-		if (schema.default !== void 0) fields.push({
-			label: labels.default,
-			value: JSON.stringify(schema.default)
-		});
-		if (schema.pattern) fields.push({
-			label: labels.match,
-			value: schema.pattern
-		});
-		if (schema.format) fields.push({
-			label: labels.format,
-			value: schema.format
-		});
-		if (schema.multipleOf) fields.push({
-			label: labels.multipleOf,
-			value: schema.multipleOf.toString()
-		});
+		const inlines = [];
+		const blocks = [];
+		if (schema.pattern) inlines.push({ node: /* @__PURE__ */ jsx(InlineTag, {
+			label: t("Match"),
+			children: schema.pattern
+		}) });
+		if (schema.format) inlines.push({ node: /* @__PURE__ */ jsx(InlineTag, {
+			label: t("Format"),
+			children: schema.format
+		}) });
+		if (schema.multipleOf) inlines.push({ node: /* @__PURE__ */ jsx(InlineTag, {
+			label: t("Multiple Of"),
+			children: schema.multipleOf
+		}) });
 		let range = formatRange("value", schema.minimum, schema.exclusiveMinimum, schema.maximum, schema.exclusiveMaximum);
-		if (range) fields.push({
-			label: labels.range,
-			value: range
-		});
+		if (range) inlines.push({ node: /* @__PURE__ */ jsx(InlineTag, {
+			label: t("Range"),
+			children: range
+		}) });
 		range = formatRange("length", schema.minLength, void 0, schema.maxLength, void 0);
-		if (range) fields.push({
-			label: labels.length,
-			value: range
-		});
+		if (range) inlines.push({ node: /* @__PURE__ */ jsx(InlineTag, {
+			label: t("Length"),
+			children: range
+		}) });
 		range = formatRange("properties", schema.minProperties, void 0, schema.maxProperties, void 0);
-		if (range) fields.push({
-			label: labels.properties,
-			value: range
-		});
+		if (range) inlines.push({ node: /* @__PURE__ */ jsx(InlineTag, {
+			label: t("Properties"),
+			children: range
+		}) });
 		range = formatRange("items", schema.minItems, void 0, schema.maxItems, void 0);
-		if (range) fields.push({
-			label: labels.items,
-			value: range
-		});
-		if (schema.enum) fields.push({
-			label: labels.valueIn,
-			value: schema.enum.map((value) => JSON.stringify(value)).join(" | ")
-		});
-		if (showExample && schema.examples) for (const example of schema.examples) fields.push({
-			label: labels.example,
-			value: JSON.stringify(example, null, 2)
-		});
-		return fields;
+		if (range) inlines.push({ node: /* @__PURE__ */ jsx(InlineTag, {
+			label: t("Items"),
+			children: range
+		}) });
+		if (schema.enum && schema.enum.length > 0) {
+			const members = schema.enum.map((value) => JSON.stringify(value, null, 2));
+			blocks.push({ node: /* @__PURE__ */ jsx(BlockTag, {
+				label: t("Value in"),
+				children: /* @__PURE__ */ jsx("ul", { children: members.map((m, i) => /* @__PURE__ */ jsx("li", {
+					className: "font-mono list-disc list-inside ps-1 marker:text-fd-muted-foreground",
+					children: m
+				}, i)) })
+			}) });
+		}
+		if (schema.default !== void 0) {
+			const defaultCode = JSON.stringify(schema.default, null, 2);
+			if (defaultCode.includes("\n")) blocks.push({ node: /* @__PURE__ */ jsx(BlockTag, {
+				label: t("Default"),
+				children: renderCodeblock({
+					lang: "json",
+					code: defaultCode
+				})
+			}) });
+			else inlines.push({ node: /* @__PURE__ */ jsx(InlineTag, {
+				label: t("Default"),
+				children: defaultCode
+			}) });
+		}
+		if (showExample && schema.examples) for (const example of schema.examples) {
+			const code = JSON.stringify(example, null, 2);
+			if (code.includes("\n")) {
+				blocks.push({ node: /* @__PURE__ */ jsx(BlockTag, {
+					label: t("Example"),
+					children: renderCodeblock({
+						lang: "json",
+						code
+					})
+				}) });
+				continue;
+			}
+			inlines.push({ node: /* @__PURE__ */ jsx(InlineTag, {
+				label: t("Example"),
+				children: code
+			}) });
+		}
+		return [...inlines, ...blocks];
 	}
 	let _counter = 0;
 	const autoIds = /* @__PURE__ */ new WeakMap();

package/dist/node_modules/.pnpm/{@apidevtools_json-schema-ref-parser@15.3.5_@types_json-schema@7.0.15 → @apidevtools_json-schema-ref-parser@15.3.6_@types_json-schema@7.0.15}/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/bundle.js RENAMED Viewed

@@ -2,7 +2,7 @@ import { getHash, resolve, stripHash } from "./util/url.js";
 import { getSchemaBasePath } from "./util/schema-resources.js";
 import Pointer from "./pointer.js";
 import $Ref from "./ref.js";
-//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.5_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/bundle.js
+//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.6_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/bundle.js
 /**
 * Bundles all external JSON references into the main JSON schema, thus resulting in a schema that
 * only has *internal* references, not any *external* references.

@@ -3,7 +3,7 @@ import { TimeoutError } from "./util/errors.js";
 import { getSchemaBasePath } from "./util/schema-resources.js";
 import Pointer from "./pointer.js";
 import $Ref from "./ref.js";
-//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.5_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/dereference.js
+//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.6_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/dereference.js
 var dereference_default = dereference;
 /**
 * Crawls the JSON schema, finds all JSON references, and dereferences them.

@@ -3,7 +3,7 @@ import { ParserOptions } from "./options.js";
 import { JSONParserError, MissingPointerError, ParserError, ResolverError } from "./util/errors.js";
 import { $Refs } from "./refs.js";
-//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.5_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/index.d.ts
+//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.6_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/index.d.ts
 /**
  * This class parses a JSON schema, builds a map of its JSON references and their resolved values,
  * and provides methods for traversing, manipulating, and dereferencing those references.

@@ -11,7 +11,7 @@ import resolveExternal from "./resolve-external.js";
 import bundle$1 from "./bundle.js";
 import dereference_default from "./dereference.js";
 import maybe from "./util/maybe.js";
-//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.5_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/index.js
+//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.6_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/index.js
 /**
 * This class parses a JSON schema, builds a map of its JSON references and their resolved values,
 * and provides methods for traversing, manipulating, and dereferencing those references.

@@ -1,5 +1,5 @@
 import { getNewOptions } from "./options.js";
-//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.5_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/normalize-args.js
+//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.6_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/normalize-args.js
 /**
 * Normalizes the given arguments, accounting for optional args.
 */

@@ -1,6 +1,6 @@
 import { HTTPResolverOptions, JSONSchema, JSONSchemaObject, Plugin, ResolverOptions } from "./types/index.js";
-//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.5_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/options.d.ts
+//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.6_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/options.d.ts
 type DeepPartial<T> = T extends object ? { [P in keyof T]?: DeepPartial<T[P]> } : T;
 interface BundleOptions {
   /**

@@ -4,7 +4,7 @@ import text_default from "./parsers/text.js";
 import binary_default from "./parsers/binary.js";
 import file_default from "./resolvers/file.js";
 import http_default from "./resolvers/http.js";
-//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.5_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/options.js
+//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.6_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/options.js
 const getJsonSchemaRefParserDefaultOptions = () => {
 	return {
 		/**

@@ -2,7 +2,7 @@ import { getExtension } from "./util/url.js";
 import { ParserError, ResolverError, UnmatchedParserError, UnmatchedResolverError, isHandledError } from "./util/errors.js";
 import { registerSchemaResources, usesDynamicIdScope } from "./util/schema-resources.js";
 import { all, filter, run, sort } from "./util/plugins.js";
-//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.5_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/parse.js
+//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.6_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/parse.js
 /**
 * Reads and parses the specified file path or URL.
 */

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.5_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/parsers/binary.js
+//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.6_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/parsers/binary.js
 const BINARY_REGEXP = /\.(jpeg|jpg|gif|png|bmp|ico)$/i;
 var binary_default = {
 	/**

@@ -1,5 +1,5 @@
 import { ParserError } from "../util/errors.js";
-//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.5_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/parsers/json.js
+//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.6_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/parsers/json.js
 var json_default = {
 	/**
 	* The order that this parser will run, in relation to other parsers.

@@ -1,5 +1,5 @@
 import { ParserError } from "../util/errors.js";
-//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.5_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/parsers/text.js
+//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.6_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/parsers/text.js
 const TEXT_REGEXP = /\.(txt|htm|html|md|xml|js|min|map|css|scss|less|svg)$/i;
 var text_default = {
 	/**

@@ -1,6 +1,6 @@
 import { ParserError } from "../util/errors.js";
 import yaml, { JSON_SCHEMA } from "js-yaml";
-//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.5_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/parsers/yaml.js
+//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.6_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/parsers/yaml.js
 var yaml_default = {
 	/**
 	* The order that this parser will run, in relation to other parsers.

@@ -3,7 +3,7 @@ import { ParserOptions } from "./options.js";
 import { $Ref } from "./ref.js";
 import { JSONSchema4Type, JSONSchema6Type, JSONSchema7Type } from "json-schema";
-//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.5_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/pointer.d.ts
+//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.6_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/pointer.d.ts
 /**
  * This class represents a single JSON pointer and its resolved value.
  *

@@ -2,12 +2,17 @@ import { getHash, resolve, stripHash } from "./util/url.js";
 import { InvalidPointerError, JSONParserError, MissingPointerError, isHandledError } from "./util/errors.js";
 import { getSchemaBasePath } from "./util/schema-resources.js";
 import $Ref from "./ref.js";
-//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.5_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/pointer.js
+//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.6_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/pointer.js
 const nullSymbol = Symbol("null");
 const slashes = /\//g;
 const tildes = /~/g;
 const escapedSlash = /~1/g;
 const escapedTilde = /~0/g;
+const unsafeSetTokens = new Set([
+	"__proto__",
+	"constructor",
+	"prototype"
+]);
 /**
 * This class represents a single JSON pointer and its resolved value.
 *
@@ -128,6 +133,7 @@ var Pointer = class Pointer {
 			this.value = value;
 			return value;
 		}
+		assertSafeSetTokens(this.path, tokens);
 		this.value = unwrapOrThrow(obj);
 		if (this.$ref.dynamicIdScope && !isAliasedResource(this.$ref)) this.scopeBase = getSchemaBasePath(this.scopeBase, this.value);
 		for (let i = 0; i < tokens.length - 1; i++) {
@@ -228,6 +234,9 @@ function setValue(pointer, token, value) {
 	else throw new JSONParserError(`Error assigning $ref pointer "${pointer.path}". \nCannot set "${token}" of a non-object.`);
 	return value;
 }
+function assertSafeSetTokens(pointerPath, tokens) {
+	for (const token of tokens) if (unsafeSetTokens.has(token)) throw new JSONParserError(`Error assigning $ref pointer "${pointerPath}". \nUnsafe JSON Pointer token "${token}" cannot be used for assignment.`);
+}
 function unwrapOrThrow(value) {
 	if (isHandledError(value)) throw value;
 	return value;

@@ -5,7 +5,7 @@ import { Pointer } from "./pointer.js";
 import { $Refs } from "./refs.js";
 import { JSONSchema4Type, JSONSchema6Type, JSONSchema7Type } from "json-schema";
-//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.5_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/ref.d.ts
+//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.6_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/ref.d.ts
 type $RefError = JSONParserError | ResolverError | ParserError | MissingPointerError;
 /**
  * This class represents a single JSON reference and its resolved value.

@@ -1,7 +1,7 @@
 import { getHash, safePointerToPath, stripHash } from "./util/url.js";
 import { InvalidPointerError, isHandledError, normalizeError } from "./util/errors.js";
 import Pointer, { nullSymbol } from "./pointer.js";
-//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.5_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/ref.js
+//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.6_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/ref.js
 /**
 * This class represents a single JSON reference and its resolved value.
 *

@@ -4,7 +4,7 @@ import { $Ref } from "./ref.js";
 import { Pointer } from "./pointer.js";
 import { JSONSchema4Type, JSONSchema6Type, JSONSchema7Type } from "json-schema";
-//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.5_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/refs.d.ts
+//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.6_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/refs.d.ts
 interface $RefsMap<S extends object = JSONSchema, O extends ParserOptions<S> = ParserOptions<S>> {
   [url: string]: $Ref<S, O>;
 }

@@ -1,7 +1,7 @@
 import convertPathToPosix from "./util/convert-path-to-posix.js";
 import { resolve, stripHash, toFileSystemPath } from "./util/url.js";
 import $Ref from "./ref.js";
-//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.5_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/refs.js
+//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.6_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/refs.js
 /**
 * When you call the resolve method, the value that gets passed to the callback function (or Promise) is a $Refs object. This same object is accessible via the parser.$refs property of $RefParser objects.
 *

@@ -4,7 +4,7 @@ import { getSchemaBasePath } from "./util/schema-resources.js";
 import Pointer from "./pointer.js";
 import $Ref from "./ref.js";
 import parse from "./parse.js";
-//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.5_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/resolve-external.js
+//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.6_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/resolve-external.js
 /**
 * Crawls the JSON schema, finds all external JSON references, and resolves their values.
 * This method does not mutate the JSON schema. The resolved values are added to {@link $RefParser#$refs}.

@@ -1,6 +1,6 @@
 import { isFileSystemPath, toFileSystemPath } from "../util/url.js";
 import { ResolverError } from "../util/errors.js";
-//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.5_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/resolvers/file.js
+//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.6_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/resolvers/file.js
 var file_default = {
 	/**
 	* The order that this resolver will run, in relation to other resolvers.

@@ -1,6 +1,6 @@
 import { isHttp, isUnsafeUrl, parse, resolve } from "../util/url.js";
 import { ResolverError } from "../util/errors.js";
-//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.5_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/resolvers/http.js
+//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.6_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/resolvers/http.js
 var http_default = {
 	/**
 	* The order that this resolver will run, in relation to other resolvers.
@@ -61,6 +61,7 @@ async function download(u, httpOptions, _redirects) {
 	const redirects = _redirects || [];
 	redirects.push(u.href);
 	try {
+		if (httpOptions.safeUrlResolver && isUnsafeUrl(u.href)) throw new Error(`Unsafe URL blocked by safeUrlResolver: ${u.href}`);
 		const res = await get(u, httpOptions);
 		if (res.status >= 400) {
 			const error = /* @__PURE__ */ new Error(`HTTP ERROR ${res.status}`);
@@ -70,11 +71,15 @@ async function download(u, httpOptions, _redirects) {
 			const error = /* @__PURE__ */ new Error(`Error downloading ${redirects[0]}. \nToo many redirects: \n  ${redirects.join(" \n  ")}`);
 			error.status = res.status;
 			throw new ResolverError(error);
-		} else if (!("location" in res.headers) || !res.headers.location) {
-			const error = /* @__PURE__ */ new Error(`HTTP ${res.status} redirect with no location header`);
-			error.status = res.status;
-			throw error;
-		} else return download(resolve(u.href, res.headers.location), httpOptions, redirects);
+		} else {
+			const location = getHeader(res, "location");
+			if (!location) {
+				const error = /* @__PURE__ */ new Error(`HTTP ${res.status} redirect with no location header`);
+				error.status = res.status;
+				throw error;
+			}
+			return download(resolve(u.href, location), httpOptions, redirects);
+		}
 		else {
 			if (res.body) {
 				const buf = await res.arrayBuffer();
@@ -103,10 +108,14 @@ async function get(u, httpOptions) {
 		method: "GET",
 		headers: httpOptions.headers || {},
 		credentials: httpOptions.withCredentials ? "include" : "same-origin",
+		redirect: "manual",
 		signal: controller ? controller.signal : null
 	});
 	if (timeoutId) clearTimeout(timeoutId);
 	return response;
 }
+function getHeader(response, name) {
+	return response.headers.get(name);
+}
 //#endregion
 export { http_default as default };

@@ -2,7 +2,7 @@ import { ParserOptions } from "../options.js";
 import { $Refs } from "../refs.js";
 import { JSONSchema4, JSONSchema4Object, JSONSchema6, JSONSchema6Object, JSONSchema7, JSONSchema7Object } from "json-schema";
-//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.5_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/types/index.d.ts
+//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.6_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/types/index.d.ts
 type JSONSchema = JSONSchema4 | JSONSchema6 | JSONSchema7;
 type JSONSchemaObject = JSONSchema4Object | JSONSchema6Object | JSONSchema7Object;
 type SchemaCallback<S extends object = JSONSchema> = (err: Error | null, schema?: S | object | null) => any;

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.5_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/util/convert-path-to-posix.js
+//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.6_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/util/convert-path-to-posix.js
 const win32Sep = "\\";
 function convertPathToPosix(filePath) {
 	if (filePath.startsWith("\\\\?\\")) return filePath;

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.5_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/util/errors.d.ts
+//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.6_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/util/errors.d.ts
 type JSONParserErrorType = "EUNKNOWN" | "EPARSER" | "EUNMATCHEDPARSER" | "ETIMEOUT" | "ERESOLVER" | "EUNMATCHEDRESOLVER" | "EMISSINGPOINTER" | "EINVALIDPOINTER";
 declare class JSONParserError extends Error {
   readonly name: string;

@@ -1,5 +1,5 @@
 import { getHash, stripHash, toFileSystemPath } from "./url.js";
-//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.5_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/util/errors.js
+//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.6_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/util/errors.js
 const nonJsonTypes = [
 	"function",
 	"symbol",

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.5_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/util/is-windows.js
+//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.6_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/util/is-windows.js
 const isWindowsConst = /^win/.test(globalThis.process ? globalThis.process.platform : "");
 const isWindows = () => isWindowsConst;
 //#endregion

@@ -1,5 +1,5 @@
 import next_default from "./next.js";
-//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.5_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/util/maybe.js
+//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.6_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/util/maybe.js
 function maybe(cb, promise) {
 	if (cb) {
 		promise.then(function(result) {

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.5_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/util/next.js
+//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.6_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/util/next.js
 function makeNext() {
 	if (typeof process === "object" && typeof process.nextTick === "function") return process.nextTick;
 	else if (typeof setImmediate === "function") return setImmediate;

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.5_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/util/plugins.js
+//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.6_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/util/plugins.js
 /**
 * Returns the given plugins as an array, rather than an object map.
 * All other methods in this module expect an array of plugins rather than an object map.

@@ -1,5 +1,5 @@
 import { resolve } from "./url.js";
-//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.5_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/util/schema-resources.js
+//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.6_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/util/schema-resources.js
 function getSchemaBasePath(basePath, value) {
 	const schemaId = getSchemaId(value);
 	return schemaId ? resolve(basePath, schemaId) : basePath;

@@ -1,6 +1,6 @@
 import convertPathToPosix from "./convert-path-to-posix.js";
 import { isWindows } from "./is-windows.js";
-//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.5_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/util/url.js
+//#region ../../node_modules/.pnpm/@apidevtools+json-schema-ref-parser@15.3.6_@types+json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/util/url.js
 const forwardSlashPattern = /\//g;
 const protocolPattern = /^(\w{2,}):\/\//i;
 const jsonPointerSlash = /~1/g;
@@ -19,6 +19,15 @@ const urlDecodePatterns = [
 	/%40/g,
 	"@"
 ];
+const unsafeDomainSuffixes = [
+	".localhost",
+	".local",
+	".internal",
+	".intranet",
+	".corp",
+	".home",
+	".lan"
+];
 const parse = (u) => new URL(u);
 /**
 * Returns resolved target URL relative to a base URL in a manner similar to that of a Web browser resolving an anchor tag HREF.
@@ -147,58 +156,115 @@ function isUnsafeUrl(path) {
 	if (normalizedPath.startsWith("javascript:") || normalizedPath.startsWith("vbscript:") || normalizedPath.startsWith("data:")) return true;
 	if (normalizedPath.startsWith("file:")) return true;
 	if (typeof window !== "undefined" && window.location && window.location.href) return false;
-	const localPatterns = [
-		"localhost",
-		"127.0.0.1",
-		"::1",
-		"10.",
-		"172.16.",
-		"172.17.",
-		"172.18.",
-		"172.19.",
-		"172.20.",
-		"172.21.",
-		"172.22.",
-		"172.23.",
-		"172.24.",
-		"172.25.",
-		"172.26.",
-		"172.27.",
-		"172.28.",
-		"172.29.",
-		"172.30.",
-		"172.31.",
-		"192.168.",
-		"169.254.",
-		".local",
-		".internal",
-		".intranet",
-		".corp",
-		".home",
-		".lan"
-	];
 	try {
 		const url = new URL(normalizedPath.startsWith("//") ? "http:" + normalizedPath : normalizedPath);
-		const hostname = url.hostname.toLowerCase();
-		for (const pattern of localPatterns) if (hostname === pattern || hostname.startsWith(pattern) || hostname.endsWith(pattern)) return true;
-		if (isPrivateIP(hostname)) return true;
+		if (isUnsafeHostname(url.hostname)) return true;
 		const port = url.port;
 		if (port && isInternalPort(parseInt(port))) return true;
 	} catch {
 		if (normalizedPath.startsWith("/") && !normalizedPath.startsWith("//")) return false;
-		for (const pattern of localPatterns) if (normalizedPath.includes(pattern)) return true;
+		if (containsUnsafeHostname(normalizedPath)) return true;
 	}
 	return false;
 }
 /**
-* Helper function to check if an IP address is in a private range
+* Helper function to check if a hostname is local or resolves to a non-public literal address.
+*/
+function isUnsafeHostname(hostname) {
+	const normalizedHostname = normalizeHostname(hostname);
+	if (!normalizedHostname) return true;
+	if (normalizedHostname === "localhost" || unsafeDomainSuffixes.some((suffix) => normalizedHostname.endsWith(suffix))) return true;
+	const ipv4 = parseIPv4Address(normalizedHostname);
+	if (ipv4) return isUnsafeIPv4Address(ipv4);
+	const ipv6 = parseIPv6Address(normalizedHostname);
+	if (ipv6) return isUnsafeIPv6Address(ipv6);
+	return false;
+}
+function normalizeHostname(hostname) {
+	let normalizedHostname = hostname.trim().toLowerCase();
+	if (normalizedHostname.startsWith("[") && normalizedHostname.endsWith("]")) normalizedHostname = normalizedHostname.slice(1, -1);
+	while (normalizedHostname.endsWith(".")) normalizedHostname = normalizedHostname.slice(0, -1);
+	return normalizedHostname;
+}
+function parseIPv4Address(ip) {
+	const parts = ip.split(".");
+	if (parts.length !== 4) return;
+	const octets = parts.map((part) => {
+		if (!/^\d+$/.test(part)) return NaN;
+		return Number(part);
+	});
+	if (octets.some((octet) => !Number.isInteger(octet) || octet < 0 || octet > 255)) return;
+	return octets;
+}
+/**
+* Helper function to check if an IPv4 address is in a non-public range.
+*/
+function isUnsafeIPv4Address([a, b, c, d]) {
+	return a === 0 || a === 10 || a === 127 || a === 100 && b >= 64 && b <= 127 || a === 169 && b === 254 || a === 172 && b >= 16 && b <= 31 || a === 192 && b === 0 && c === 0 || a === 192 && b === 168 || a === 198 && (b === 18 || b === 19) || a >= 224 || a === 255 && b === 255 && c === 255 && d === 255;
+}
+function parseIPv6Address(ip) {
+	if (!ip.includes(":")) return;
+	let normalizedIP = ip;
+	const lastSeparator = normalizedIP.lastIndexOf(":");
+	const possibleIPv4 = normalizedIP.slice(lastSeparator + 1);
+	if (possibleIPv4.includes(".")) {
+		const ipv4 = parseIPv4Address(possibleIPv4);
+		if (!ipv4) return;
+		const firstGroup = ipv4[0] * 256 + ipv4[1];
+		const secondGroup = ipv4[2] * 256 + ipv4[3];
+		normalizedIP = `${normalizedIP.slice(0, lastSeparator + 1)}${firstGroup.toString(16)}:${secondGroup.toString(16)}`;
+	}
+	const halves = normalizedIP.split("::");
+	if (halves.length > 2) return;
+	const head = parseIPv6Groups(halves[0]);
+	const tail = halves.length === 2 ? parseIPv6Groups(halves[1]) : [];
+	if (!head || !tail) return;
+	if (halves.length === 1) return head.length === 8 ? head : void 0;
+	const missingGroups = 8 - head.length - tail.length;
+	if (missingGroups < 1) return;
+	return [
+		...head,
+		...Array(missingGroups).fill(0),
+		...tail
+	];
+}
+function parseIPv6Groups(groups) {
+	if (!groups) return [];
+	const parsedGroups = groups.split(":").map((group) => {
+		if (!/^[\da-f]{1,4}$/i.test(group)) return NaN;
+		return Number.parseInt(group, 16);
+	});
+	if (parsedGroups.some((group) => !Number.isInteger(group) || group < 0 || group > 65535)) return;
+	return parsedGroups;
+}
+/**
+* Helper function to check if an IPv6 address is in a non-public range.
 */
-function isPrivateIP(ip) {
-	const match = ip.match(/^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/);
-	if (!match) return false;
-	const [, a, b, c, d] = match.map(Number);
-	if (a > 255 || b > 255 || c > 255 || d > 255) return false;
-	return a === 10 || a === 127 || a === 172 && b >= 16 && b <= 31 || a === 192 && b === 168 || a === 169 && b === 254;
+function isUnsafeIPv6Address(groups) {
+	if (groups.length !== 8) return false;
+	const isUnspecified = groups.every((group) => group === 0);
+	const isLoopback = groups.slice(0, 7).every((group) => group === 0) && groups[7] === 1;
+	const isUniqueLocal = (groups[0] & 65024) === 64512;
+	const isLinkLocal = (groups[0] & 65472) === 65152;
+	const isMulticast = (groups[0] & 65280) === 65280;
+	if (isUnspecified || isLoopback || isUniqueLocal || isLinkLocal || isMulticast) return true;
+	const mappedIPv4 = getMappedIPv4Address(groups);
+	return mappedIPv4 ? isUnsafeIPv4Address(mappedIPv4) : false;
+}
+function getMappedIPv4Address(groups) {
+	const firstFiveGroupsAreZero = groups.slice(0, 5).every((group) => group === 0);
+	const firstSixGroupsAreZero = firstFiveGroupsAreZero && groups[5] === 0;
+	const isIPv4Mapped = firstFiveGroupsAreZero && groups[5] === 65535;
+	if (!firstSixGroupsAreZero && !isIPv4Mapped) return;
+	return [
+		Math.floor(groups[6] / 256),
+		groups[6] % 256,
+		Math.floor(groups[7] / 256),
+		groups[7] % 256
+	];
+}
+function containsUnsafeHostname(value) {
+	return value.split(/[\s/?#]+/).map((candidate) => candidate.replace(/^[a-z][\d+.a-z-]*:\/\//i, "").replace(/:\d+$/, "")).filter(Boolean).some((candidate) => isUnsafeHostname(candidate));
 }
 /**
 * Helper function to check if a port is typically used for internal services

package/dist/schema/bundle.d.ts CHANGED Viewed

@@ -1,2 +1,2 @@
-import { bundle } from "../node_modules/.pnpm/@apidevtools_json-schema-ref-parser@15.3.5_@types_json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/index.js";
+import { bundle } from "../node_modules/.pnpm/@apidevtools_json-schema-ref-parser@15.3.6_@types_json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/index.js";
 export { bundle };

package/dist/schema/bundle.js CHANGED Viewed

@@ -1,2 +1,2 @@
-import { bundle } from "../node_modules/.pnpm/@apidevtools_json-schema-ref-parser@15.3.5_@types_json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/index.js";
+import { bundle } from "../node_modules/.pnpm/@apidevtools_json-schema-ref-parser@15.3.6_@types_json-schema@7.0.15/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/index.js";
 export { bundle };

package/dist/schema/to-string.js CHANGED Viewed

@@ -24,6 +24,12 @@ function schemaToString(value, resolver, flags = 0) {
 		const { dereferenced: schema, $ref: rawRef } = resolver?.(input) ?? { dereferenced: input };
 		if (schema === true) return "any";
 		else if (schema === false) return "never";
+		if (schema.enum?.length === 1) switch (typeof schema.enum[0]) {
+			case "bigint":
+			case "boolean":
+			case "number":
+			case "string": return JSON.stringify(schema.enum[0]);
+		}
 		if ((flags & 1) === 1) {
 			if (schema.title) return schema.title;
 			if (typeof rawRef === "string") {

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@fumadocs/api-docs",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Shared utils for API docs generation",
   "keywords": [
     "Docs",
@@ -9,7 +9,10 @@
   "homepage": "https://fumadocs.dev",
   "license": "MIT",
   "author": "Fuma Nama",
-  "repository": "github:fuma-nama/fumadocs",
+  "repository": {
+    "type": "git",
+    "url": "github:fuma-nama/fumadocs"
+  },
   "files": [
     "css",
     "dist"
@@ -47,28 +50,28 @@
     "access": "public"
   },
   "dependencies": {
-    "@fuma-translate/react": "^1.0.1",
-    "@radix-ui/react-accordion": "^1.2.13",
-    "@radix-ui/react-dialog": "^1.1.16",
-    "@radix-ui/react-select": "^2.3.0",
+    "@fuma-translate/react": "^1.0.2",
+    "@radix-ui/react-accordion": "^1.2.14",
+    "@radix-ui/react-dialog": "^1.1.17",
+    "@radix-ui/react-select": "^2.3.1",
     "class-variance-authority": "^0.7.1",
     "github-slugger": "^2.0.0",
     "js-yaml": "^4.2.0",
-    "lucide-react": "^1.17.0",
+    "lucide-react": "^1.20.0",
     "tailwind-merge": "^3.6.0",
     "@fumari/stf": "1.0.5"
   },
   "devDependencies": {
-    "@apidevtools/json-schema-ref-parser": "^15.3.5",
+    "@apidevtools/json-schema-ref-parser": "^15.3.6",
     "@fastify/deepmerge": "^3.2.1",
-    "@tailwindcss/oxide": "^4.3.0",
-    "@types/node": "25.9.2",
+    "@tailwindcss/oxide": "^4.3.1",
+    "@types/node": "25.9.3",
     "@types/react": "^19.2.17",
     "ajv": "^8.20.0",
     "json-schema-typed": "^8.0.2",
-    "tsdown": "0.22.2",
-    "fumadocs-core": "16.10.1",
-    "fumadocs-ui": "16.10.1",
+    "tsdown": "0.22.3",
+    "fumadocs-ui": "16.10.5",
+    "fumadocs-core": "16.10.5",
     "tsconfig": "0.0.0"
   },
   "peerDependencies": {
@@ -88,7 +91,7 @@
     }
   },
   "inlinedDependencies": {
-    "@apidevtools/json-schema-ref-parser": "15.3.5",
+    "@apidevtools/json-schema-ref-parser": "15.3.6",
     "@fastify/deepmerge": "3.2.1",
     "ajv": "8.20.0",
     "fast-deep-equal": "3.1.3",