fumapress 0.5.0 → 0.5.1

package/css/generated.css

@@ -1,21 +1,47 @@
+@source inline("!ctx");
+@source inline("!sizes");
 @source inline("---spacing");
 @source inline("-translate-x-1/2");
+@source inline("@default");
 @source inline("@orama/orama");
 @source inline("a");
+@source inline("above");
 @source inline("absolutePath");
+@source inline("accepts");
 @source inline("active:scale-95");
+@source inline("actually");
+@source inline("all");
+@source inline("allSizes");
 @source inline("allTags");
+@source inline("allowed");
+@source inline("allows");
+@source inline("and");
+@source inline("and/or");
+@source inline("any");
+@source inline("app");
+@source inline("are");
 @source inline("as");
+@source inline("associated");
+@source inline("assumes");
 @source inline("async");
+@source inline("attribute");
+@source inline("attributes");
 @source inline("await");
 @source inline("backToHome");
 @source inline("backdrop-blur-sm");
+@source inline("base");
+@source inline("basePathname");
+@source inline("be");
+@source inline("because");
+@source inline("before");
+@source inline("between");
 @source inline("bg-fd-card");
 @source inline("bg-fd-primary");
 @source inline("bg-fd-primary/10");
 @source inline("bg-fd-secondary/80");
 @source inline("blog");
 @source inline("blogPosts");
+@source inline("blue");
 @source inline("body");
 @source inline("border");
 @source inline("border-2");
@@ -24,18 +50,34 @@
 @source inline("border-fd-primary");
 @source inline("border-y");
 @source inline("bottom-2");
+@source inline("browsers");
+@source inline("bug");
+@source inline("buildImageUrl");
+@source inline("but");
 @source inline("buttonVariants");
+@source inline("by");
 @source inline("can");
+@source inline("canOptimize");
+@source inline("cannot");
+@source inline("cases");
+@source inline("cause");
+@source inline("causes");
+@source inline("check");
 @source inline("children");
 @source inline("class-variance-authority");
 @source inline("className");
 @source inline("client");
 @source inline("cn");
+@source inline("component");
 @source inline("components");
+@source inline("conditions");
 @source inline("config");
 @source inline("const");
 @source inline("content");
 @source inline("copied");
+@source inline("copies");
+@source inline("copy");
+@source inline("copyright");
 @source inline("core:docs-layout");
 @source inline("core:home-layout");
 @source inline("core:notebook-layout");
@@ -57,7 +99,7 @@
 @source inline("createNotebookLayoutPage");
 @source inline("createRootLayout");
 @source inline("creationDate");
-@source inline("cssUrl");
+@source inline("crossOrigin");
 @source inline("ctx");
 @source inline("current");
 @source inline("currentDate");
@@ -66,23 +108,38 @@
 @source inline("data-fd-home-layout-container");
 @source inline("data-version");
 @source inline("date");
+@source inline("deal");
 @source inline("decoded");
 @source inline("decoration-fd-primary");
 @source inline("default");
+@source inline("defaultQuality");
+@source inline("defaultWidth");
 @source inline("defined");
+@source inline("detail");
 @source inline("detect");
 @source inline("detector");
+@source inline("deviceSizes");
 @source inline("do");
+@source inline("documentation");
 @source inline("duration-150");
+@source inline("eager");
+@source inline("edge");
 @source inline("else");
 @source inline("empty");
 @source inline("empty:hidden");
 @source inline("en");
 @source inline("english");
+@source inline("even");
+@source inline("except");
 @source inline("export");
 @source inline("extends");
+@source inline("eye");
 @source inline("false");
+@source inline("fetch");
+@source inline("fetchPriority");
+@source inline("files");
 @source inline("find");
+@source inline("first");
 @source inline("fixed");
 @source inline("flex");
 @source inline("flex-1");
@@ -90,47 +147,76 @@
 @source inline("flex-row");
 @source inline("flex-wrap");
 @source inline("flexsearchStaticClient");
+@source inline("following");
 @source inline("font-medium");
 @source inline("font-mono");
 @source inline("font-semibold");
 @source inline("for");
+@source inline("framework");
+@source inline("free");
 @source inline("from");
+@source inline("full");
+@source inline("fumadocs-core/framework");
 @source inline("fumadocs-core/i18n");
 @source inline("fumadocs-core/source");
 @source inline("fumadocs-core/toc");
 @source inline("fumadocs-ui/i18n");
 @source inline("fumapress");
 @source inline("function");
+@source inline("furnished");
 @source inline("gap-1");
 @source inline("gap-2");
 @source inline("gap-4");
+@source inline("generate");
+@source inline("generatedProps");
 @source inline("getBlogContext");
 @source inline("getLayoutProps");
 @source inline("getPressContext");
 @source inline("getTags");
 @source inline("ghost");
 @source inline("githubUrl");
+@source inline("given");
+@source inline("green");
 @source inline("grid");
 @source inline("grid-cols-1");
 @source inline("grid-cols-2");
 @source inline("groupTags");
 @source inline("grouped");
 @source inline("h-12");
+@source inline("height");
+@source inline("hereby");
+@source inline("high");
 @source inline("hook");
 @source inline("hooks");
+@source inline("hostname");
 @source inline("hover:bg-fd-accent");
 @source inline("hover:text-fd-accent-foreground");
+@source inline("how");
 @source inline("href");
+@source inline("html");
+@source inline("human");
+@source inline("i");
 @source inline("i18n");
 @source inline("i18nProvider");
 @source inline("if");
+@source inline("image");
+@source inline("imageSizes");
+@source inline("imageSrcSet");
+@source inline("images");
+@source inline("imagesrcset");
+@source inline("immediately");
 @source inline("import");
 @source inline("in");
+@source inline("included");
+@source inline("including");
+@source inline("incorrect");
 @source inline("indexPath");
 @source inline("inherit");
 @source inline("inheritLayoutProps");
 @source inline("inherited");
 @source inline("inline-flex");
+@source inline("integer");
+@source inline("intended");
 @source inline("interface");
 @source inline("is");
 @source inline("isBlog");
@@ -141,11 +227,15 @@
 @source inline("items-center");
 @source inline("items-start");
 @source inline("joinPathname");
+@source inline("js");
+@source inline("keep");
 @source inline("key");
 @source inline("keyof");
+@source inline("kind");
 @source inline("label");
 @source inline("lang");
 @source inline("language");
+@source inline("last");
 @source inline("lastModified");
 @source inline("layout");
 @source inline("layoutData");
@@ -154,9 +244,13 @@
 @source inline("left-1/2");
 @source inline("length");
 @source inline("let");
-@source inline("loaderConfig");
+@source inline("level");
+@source inline("like");
+@source inline("limitation");
+@source inline("loading");
 @source inline("locale");
 @source inline("lucide-react");
+@source inline("magnifying");
 @source inline("markdownUrl");
 @source inline("matchingBlogPosts");
 @source inline("max-h-[min(600px,calc(100vh---spacing(30)))]");
@@ -168,15 +262,30 @@
 @source inline("md:grid-cols-3");
 @source inline("md:grid-cols-4");
 @source inline("md:p-8");
+@source inline("means");
 @source inline("min-h-screen");
 @source inline("min-w-0");
+@source inline("minIndex");
+@source inline("minRatio");
+@source inline("minSize");
+@source inline("more");
+@source inline("most");
 @source inline("ms-auto");
 @source inline("mt-4");
 @source inline("mt-6");
 @source inline("mt-auto");
+@source inline("multiple");
 @source inline("mx-auto");
+@source inline("name");
 @source inline("new");
+@source inline("normal");
+@source inline("not");
+@source inline("notice");
+@source inline("number");
+@source inline("object");
+@source inline("obtaining");
 @source inline("of");
+@source inline("omit");
 @source inline("on");
 @source inline("onClick");
 @source inline("onCopy");
@@ -184,26 +293,48 @@
 @source inline("onSearchChange");
 @source inline("only");
 @source inline("open");
+@source inline("optimized");
 @source inline("option");
 @source inline("options");
+@source inline("or");
 @source inline("orderedPosts");
 @source inline("outer");
 @source inline("overline");
+@source inline("p");
 @source inline("p-1");
 @source inline("p-4");
 @source inline("page");
 @source inline("pageProps");
 @source inline("panelButtonVariants");
+@source inline("params");
+@source inline("parsed");
+@source inline("path");
+@source inline("pathname");
 @source inline("payload");
 @source inline("pb-6");
+@source inline("percent");
+@source inline("percentSizes");
+@source inline("permission");
+@source inline("permit");
+@source inline("person");
+@source inline("persons");
+@source inline("portions");
 @source inline("posts");
+@source inline("potentially");
+@source inline("preload");
+@source inline("preloadElement");
+@source inline("preloadOptions");
 @source inline("primary");
+@source inline("production");
+@source inline("prop");
 @source inline("props");
 @source inline("prose");
+@source inline("provider");
 @source inline("providerProps");
 @source inline("pt-2");
 @source inline("pt-3.5");
 @source inline("pt-4");
+@source inline("push");
 @source inline("px-1.5");
 @source inline("px-2");
 @source inline("px-3");
@@ -212,47 +343,86 @@
 @source inline("py-1");
 @source inline("py-2");
 @source inline("py-6");
+@source inline("quality");
 @source inline("query");
 @source inline("r");
 @source inline("react");
+@source inline("react-dom");
+@source inline("received");
+@source inline("red");
+@source inline("reference");
+@source inline("referrerPolicy");
+@source inline("refresh");
 @source inline("rel");
+@source inline("relative");
+@source inline("relevant");
 @source inline("render");
 @source inline("renderCtx");
 @source inline("renderRootMeta");
 @source inline("replacements");
+@source inline("reproduced");
+@source inline("requests");
+@source inline("resolution");
+@source inline("resolve");
 @source inline("resolved");
+@source inline("rest");
 @source inline("result");
 @source inline("return");
+@source inline("rights");
 @source inline("root");
 @source inline("rotate-180");
 @source inline("rounded-2xl");
 @source inline("rounded-lg");
 @source inline("rounded-xl");
+@source inline("router");
+@source inline("run");
+@source inline("s");
+@source inline("satisfies");
+@source inline("say");
 @source inline("schema");
 @source inline("schemaId");
+@source inline("screens");
 @source inline("search");
+@source inline("see");
+@source inline("sell");
 @source inline("server");
 @source inline("setOpen");
 @source inline("shadow-inner");
 @source inline("shadow-md");
 @source inline("shadow-sm");
+@source inline("shall");
 @source inline("shrink-0");
+@source inline("significantly");
 @source inline("size-3.5");
 @source inline("size-4");
 @source inline("size-6");
+@source inline("sizes");
 @source inline("sm:border");
 @source inline("sm:bottom-4");
 @source inline("sm:grid-cols-3");
 @source inline("sm:max-w-[400px]");
 @source inline("sm:rounded-xl");
 @source inline("so");
+@source inline("software");
+@source inline("something");
 @source inline("source");
+@source inline("specified");
 @source inline("specify");
+@source inline("src");
+@source inline("srcSet");
+@source inline("srcset");
+@source inline("start");
 @source inline("static");
 @source inline("string");
 @source inline("styleTag");
-@source inline("styles");
+@source inline("stylesHref");
+@source inline("stylesInline");
 @source inline("stylesheet");
+@source inline("subject");
+@source inline("subset");
+@source inline("substantial");
+@source inline("support");
+@source inline("supported");
 @source inline("sure");
 @source inline("swap");
 @source inline("t");
@@ -261,6 +431,7 @@
 @source inline("tags");
 @source inline("tagsInTotal");
 @source inline("tagsPath");
+@source inline("takes");
 @source inline("text");
 @source inline("text-2xl");
 @source inline("text-3xl");
@@ -270,12 +441,17 @@
 @source inline("text-fd-primary-foreground");
 @source inline("text-sm");
 @source inline("text-xs");
+@source inline("that");
 @source inline("the");
+@source inline("they");
 @source inline("this");
+@source inline("those");
+@source inline("though");
 @source inline("throw");
 @source inline("title");
 @source inline("to");
 @source inline("toc");
+@source inline("took");
 @source inline("transition-all");
 @source inline("transition-colors");
 @source inline("transition-transform");
@@ -286,22 +462,47 @@
 @source inline("truncate");
 @source inline("type");
 @source inline("typeof");
+@source inline("undefined");
+@source inline("unnecessary");
+@source inline("unoptimized");
 @source inline("unstable_notFound");
+@source inline("updated");
+@source inline("updates");
 @source inline("url");
 @source inline("use");
 @source inline("useCopyButton");
 @source inline("useDocsSearch");
 @source inline("useI18n");
 @source inline("useMemo");
+@source inline("useRouter");
 @source inline("useState");
 @source inline("useTOCItems");
 @source inline("useTranslations");
 @source inline("useTranslationsBase");
+@source inline("used");
+@source inline("v");
+@source inline("valid");
 @source inline("value");
+@source inline("values");
 @source inline("variant");
+@source inline("viewport");
+@source inline("viewportWidthRe");
+@source inline("visually");
+@source inline("vs");
+@source inline("vw");
+@source inline("w");
 @source inline("w-full");
 @source inline("waku");
+@source inline("wasteful");
+@source inline("we");
+@source inline("whom");
+@source inline("width");
+@source inline("widths");
+@source inline("will");
+@source inline("without");
+@source inline("would");
 @source inline("wrapper");
+@source inline("x");
 @source inline("xl:grid-cols-4");
 @source inline("xl:grid-cols-6");
 @source inline("you");

package/dist/adapters/mdx.d.ts

@@ -5,7 +5,7 @@ import { MDXComponents } from "mdx/types";
 
 //#region src/adapters/mdx.d.ts
 interface MdxAdapterOptions<C extends ConfigContext = ConfigContext> {
-  getMdxComponents?: (this: AppContext<C>, page: C["loaderConfig"]["page"]) => Awaitable<MDXComponents>;
+  getMdxComponents?: (this: AppContext<C>, page: C["page"]) => Awaitable<MDXComponents>;
 }
 declare function fumadocsMdx<C extends ConfigContext = ConfigContext>(options?: MdxAdapterOptions<C>): Adapter<C>;
 //#endregion

package/dist/client.d.ts

@@ -16,7 +16,6 @@ interface LinkProps extends ComponentProps<"a"> {
   unstable_prefetchOnEnter?: boolean;
   unstable_prefetchOnView?: boolean;
   unstable_startTransition?: ((fn: TransitionFunction) => void) | undefined;
-  href: string;
 }
 interface Router {
   push: (to: string, options?: {

package/dist/client.js

@@ -2,7 +2,7 @@
 import { Link as Link$1, useRouter as useRouter$1 } from "waku/router/client";
 import { jsx } from "react/jsx-runtime";
 //#region src/client.tsx
-function Link({ href, children, ...props }) {
+function Link({ href = "#", children, ...props }) {
 	return /* @__PURE__ */ jsx(Link$1, {
 		to: href,
 		...props,

package/dist/components/blog.js

@@ -1,7 +1,7 @@
 import { getCreationDate, getPressContext } from "../lib/shared.js";
 import { cn } from "../lib/cn.js";
 import { I18nLabel } from "./i18n.js";
-import { joinPathname } from "../lib/join-pathname.js";
+import { joinPathname } from "../lib/pathname.js";
 import { getBlogContext } from "../plugins/blog.js";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { Link } from "waku";

package/dist/components/image.d.ts

@@ -0,0 +1,30 @@
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+import { ImgHTMLAttributes, ReactNode } from "react";
+
+//#region src/components/image.d.ts
+interface StaticImageData {
+  src: string;
+  width: number;
+  height: number;
+}
+interface ImageProps extends Omit<ImgHTMLAttributes<HTMLImageElement>, "src"> {
+  src?: string | StaticImageData;
+  /** a value between 1-100, the quality of optimized image */
+  quality?: number;
+  /** Act like a normal `<img>` tag, default to `false` except for SVG images */
+  unoptimized?: boolean;
+  /** Preload the image @default true */
+  preload?: boolean;
+}
+declare function Image({
+  src: _src,
+  width: _width,
+  height: _height,
+  sizes,
+  quality,
+  unoptimized,
+  preload,
+  ...rest
+}: ImageProps): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+export { Image, ImageProps, StaticImageData };

package/dist/components/image.js

@@ -0,0 +1,143 @@
+"use client";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { createContext, use, useMemo } from "react";
+import ReactDOM from "react-dom";
+import { useRouter } from "waku";
+//#region src/components/image.tsx
+function parseLength(v) {
+	if (typeof v !== "string") return v;
+	const parsed = parseInt(v, 10);
+	if (Number.isNaN(parsed)) throw new Error(`[Fumapress] <Image /> only accepts integer values of width/height, received: "${v}"`);
+	return parsed;
+}
+/**
+* resolve src to a full pathname if relative
+*/
+function normalizeSrc(src, basePathname) {
+	if (src.startsWith("http://") || src.startsWith("https://")) return src;
+	const base = new URL(basePathname, "http://localhost");
+	const resolved = new URL(src, base);
+	if (resolved.hostname !== base.hostname) throw new Error(`The src attribute "${src}" is not a valid relative path`);
+	return resolved.pathname;
+}
+const ImageContext = createContext(null);
+function ImageProvider({ provider, children }) {
+	return /* @__PURE__ */ jsx(ImageContext, {
+		value: useMemo(() => ({ provider }), [provider]),
+		children
+	});
+}
+/** generate widths (ascending order) */
+function getWidths(provider, width, sizes) {
+	if (sizes) {
+		const allSizes = provider.sizes ?? provider.deviceSizes;
+		const viewportWidthRe = /(^|\s)(1?\d?\d)vw/g;
+		const percentSizes = [];
+		for (let match; match = viewportWidthRe.exec(sizes);) percentSizes.push(parseInt(match[2]));
+		if (percentSizes.length !== 0) {
+			const minRatio = Math.min(...percentSizes) * .01;
+			const minSize = provider.deviceSizes[0] * minRatio;
+			const minIndex = allSizes.findLastIndex((s) => s < minSize);
+			return {
+				widths: minIndex === -1 ? allSizes : allSizes.slice(minIndex + 1),
+				kind: "w"
+			};
+		}
+		return {
+			widths: allSizes,
+			kind: "w"
+		};
+	}
+	if (typeof width !== "number") return {
+		widths: provider.deviceSizes,
+		kind: "w"
+	};
+	if (provider.sizes) {
+		const widths = /* @__PURE__ */ new Set();
+		const sizes = provider.sizes;
+		const defaultWidth = sizes.at(-1);
+		widths.add(sizes.find((p) => p >= width) ?? defaultWidth);
+		widths.add(sizes.find((p) => p >= width * 2) ?? defaultWidth);
+		return {
+			widths: Array.from(widths),
+			kind: "x"
+		};
+	}
+	return {
+		widths: [width, width * 2],
+		kind: "x"
+	};
+}
+function generateImageAttributes(provider, src, quality = provider.defaultQuality, width, sizes) {
+	const { widths, kind } = getWidths(provider, width, sizes);
+	return {
+		sizes: !sizes && kind === "w" ? "100vw" : sizes,
+		srcSet: widths.map((w, i) => `${provider.buildImageUrl({
+			src,
+			width: w,
+			quality
+		})} ${kind === "w" ? w : i + 1}${kind}`).join(", "),
+		src: provider.buildImageUrl({
+			src,
+			width: widths.at(-1),
+			quality
+		})
+	};
+}
+function Image({ src: _src, width: _width, height: _height, sizes, quality, unoptimized = false, preload = true, ...rest }) {
+	const ctx = use(ImageContext);
+	const pathname = useRouter().path;
+	const { src, width, height } = useMemo(() => {
+		if (typeof _src === "object") return {
+			src: normalizeSrc(_src.src, pathname),
+			width: parseLength(_width ?? _src.width),
+			height: parseLength(_height ?? _src.height)
+		};
+		return {
+			src: _src ? normalizeSrc(_src, pathname) : void 0,
+			width: parseLength(_width),
+			height: parseLength(_height)
+		};
+	}, [
+		_src,
+		_width,
+		_height,
+		pathname
+	]);
+	if (src && ctx?.provider.canOptimize && !ctx.provider.canOptimize(src)) unoptimized = true;
+	if (!src || !ctx || unoptimized) return /* @__PURE__ */ jsx("img", {
+		...rest,
+		width,
+		height,
+		sizes,
+		src
+	});
+	const { provider } = ctx;
+	provider.validate?.(src);
+	const generatedProps = generateImageAttributes(provider, src, quality, width, sizes);
+	let preloadElement;
+	if (preload) {
+		const preloadOptions = {
+			as: "image",
+			imageSrcSet: generatedProps.srcSet,
+			imageSizes: generatedProps.sizes,
+			crossOrigin: rest.crossOrigin,
+			referrerPolicy: rest.referrerPolicy,
+			fetchPriority: rest.fetchPriority
+		};
+		if (ReactDOM.preload) ReactDOM.preload(generatedProps.src, preloadOptions);
+		else preloadElement = /* @__PURE__ */ jsx("link", {
+			rel: "preload",
+			href: generatedProps.srcSet ? void 0 : generatedProps.src,
+			...preloadOptions
+		}, "press-img-" + generatedProps.src + generatedProps.srcSet + generatedProps.sizes);
+	}
+	return /* @__PURE__ */ jsxs(Fragment, { children: [preloadElement, /* @__PURE__ */ jsx("img", {
+		...rest,
+		width,
+		height,
+		...generatedProps
+	})] });
+}
+//#endregion
+export { Image, ImageProvider };

package/dist/components/provider.d.ts

@@ -0,0 +1,6 @@
+import { RootProviderProps } from "fumadocs-ui/provider/base";
+
+//#region src/components/provider.d.ts
+type PressProviderProps = RootProviderProps;
+//#endregion
+export { PressProviderProps };