@btst/stack 1.0.1 → 1.1.1

package/src/plugins/blog/client/components/pages/post-page.tsx

@@ -0,0 +1,38 @@
+"use client";
+
+import { lazy } from "react";
+import { usePluginOverrides } from "@btst/stack/context";
+import type { BlogPluginOverrides } from "../../overrides";
+import { ComposedRoute } from "@btst/stack/client/components";
+import { DefaultError } from "../shared/default-error";
+import { PostLoading } from "../loading";
+import { NotFoundPage } from "./404-page";
+
+// Lazy load the internal component with actual page content
+const PostPage = lazy(() =>
+	import("./post-page.internal").then((m) => ({ default: m.PostPage })),
+);
+
+// Exported wrapped component with error and loading boundaries
+export function PostPageComponent({ slug }: { slug: string }) {
+	const { onRouteError } = usePluginOverrides<BlogPluginOverrides>("blog");
+	return (
+		<ComposedRoute
+			path={`/blog/${slug}`}
+			PageComponent={PostPage}
+			ErrorComponent={DefaultError}
+			LoadingComponent={PostLoading}
+			NotFoundComponent={NotFoundPage}
+			props={{ slug }}
+			onError={(error) => {
+				if (onRouteError) {
+					onRouteError("post", error, {
+						path: `/blog/${slug}`,
+						isSSR: typeof window === "undefined",
+						slug,
+					});
+				}
+			}}
+		/>
+	);
+}

package/src/plugins/blog/client/components/pages/tag-page.internal.tsx

@@ -0,0 +1,74 @@
+"use client";
+
+import { PageHeader } from "../shared/page-header";
+import { PageWrapper } from "../shared/page-wrapper";
+import { PostsList } from "../shared/posts-list";
+import { EmptyList } from "../shared/empty-list";
+
+import { useSuspensePosts } from "../../hooks/blog-hooks";
+import { BLOG_LOCALIZATION } from "../../localization";
+import { usePluginOverrides } from "@btst/stack/context";
+import type { BlogPluginOverrides } from "../../overrides";
+import { useTags } from "../../hooks/blog-hooks";
+import { useRouteLifecycle } from "../shared/use-route-lifecycle";
+
+// Internal component with actual page content
+export function TagPage({ tagSlug }: { tagSlug: string }) {
+	const { localization } = usePluginOverrides<
+		BlogPluginOverrides,
+		Partial<BlogPluginOverrides>
+	>("blog", {
+		localization: BLOG_LOCALIZATION,
+	});
+
+	// Call lifecycle hooks
+	useRouteLifecycle({
+		routeName: "tag",
+		context: {
+			path: `/blog/tag/${tagSlug}`,
+			params: { tagSlug },
+			isSSR: typeof window === "undefined",
+		},
+	});
+
+	const { tags } = useTags();
+	const tag = tags?.find((t) => t.slug === tagSlug);
+
+	if (!tag) {
+		return (
+			<PageWrapper testId="tag-page">
+				<div className="flex flex-col items-center gap-3">
+					<PageHeader title={localization.BLOG_TAG_NOT_FOUND} />
+				</div>
+				<EmptyList message={localization.BLOG_TAG_NOT_FOUND_DESCRIPTION} />
+			</PageWrapper>
+		);
+	}
+
+	return (
+		<PageWrapper testId="tag-page">
+			<div className="flex flex-col items-center gap-3">
+				<PageHeader
+					title={`${localization.BLOG_TAG_PAGE_TITLE.replace("{tag}", tag.name)}`}
+					description={localization.BLOG_TAG_PAGE_DESCRIPTION}
+				/>
+			</div>
+			<Content tagSlug={tagSlug} />
+		</PageWrapper>
+	);
+}
+
+function Content({ tagSlug }: { tagSlug: string }) {
+	const { posts, loadMore, hasMore, isLoadingMore } = useSuspensePosts({
+		published: true,
+		tagSlug: tagSlug,
+	});
+	return (
+		<PostsList
+			posts={posts}
+			onLoadMore={loadMore}
+			hasMore={hasMore}
+			isLoadingMore={isLoadingMore}
+		/>
+	);
+}

package/src/plugins/blog/client/components/pages/tag-page.tsx

@@ -0,0 +1,38 @@
+"use client";
+
+import { lazy } from "react";
+import { usePluginOverrides } from "@btst/stack/context";
+import type { BlogPluginOverrides } from "../../overrides";
+import { ComposedRoute } from "@btst/stack/client/components";
+import { DefaultError } from "../shared/default-error";
+import { PostsLoading } from "../loading";
+import { NotFoundPage } from "./404-page";
+
+// Lazy load the internal component with actual page content
+const TagPage = lazy(() =>
+	import("./tag-page.internal").then((m) => ({ default: m.TagPage })),
+);
+
+// Exported wrapped component with error and loading boundaries
+export function TagPageComponent({ tagSlug }: { tagSlug: string }) {
+	const { onRouteError } = usePluginOverrides<BlogPluginOverrides>("blog");
+	return (
+		<ComposedRoute
+			path={`/blog/tag/${tagSlug}`}
+			PageComponent={TagPage}
+			ErrorComponent={DefaultError}
+			LoadingComponent={PostsLoading}
+			NotFoundComponent={NotFoundPage}
+			props={{ tagSlug }}
+			onError={(error) => {
+				if (onRouteError) {
+					onRouteError("tag", error, {
+						path: `/blog/tag/${tagSlug}`,
+						isSSR: typeof window === "undefined",
+						tagSlug,
+					});
+				}
+			}}
+		/>
+	);
+}

package/src/plugins/blog/client/components/shared/better-blog-attribution.tsx

@@ -0,0 +1,19 @@
+export function BetterBlogAttribution() {
+	return (
+		<div className="w-full text-center">
+			<p className="flex items-center justify-center gap-1 py-2 text-gray-500 text-sm">
+				Powered by{" "}
+				<a
+					className="flex items-center gap-1 font-semibold underline"
+					href="https://www.better-stack.ai"
+					target="_blank"
+					rel="noreferrer noopener"
+					aria-label="Better Stack — Composable full-stack plugin system for React frameworks"
+					title="Better Stack — Composable full-stack plugin system for React frameworks"
+				>
+					<span className="cursor-pointer">Better-Stack</span>
+				</a>
+			</p>
+		</div>
+	);
+}

package/src/plugins/blog/client/components/shared/default-error.tsx

@@ -0,0 +1,20 @@
+"use client";
+
+import type { FallbackProps } from "react-error-boundary";
+import { ErrorPlaceholder } from "./error-placeholder";
+import { usePluginOverrides } from "@btst/stack/context";
+import { BLOG_LOCALIZATION } from "../../localization";
+import type { BlogPluginOverrides } from "../../overrides";
+
+// Default error component for blog plugin routes
+export function DefaultError({ error }: FallbackProps) {
+	const { localization } = usePluginOverrides<
+		BlogPluginOverrides,
+		Partial<BlogPluginOverrides>
+	>("blog", {
+		localization: BLOG_LOCALIZATION,
+	});
+	const title = localization.BLOG_GENERIC_ERROR_TITLE;
+	const message = error?.message ?? localization.BLOG_GENERIC_ERROR_MESSAGE;
+	return <ErrorPlaceholder title={title} message={message} />;
+}

package/src/plugins/blog/client/components/shared/defaults.tsx

@@ -0,0 +1,9 @@
+export const DefaultLink = (props: React.ComponentProps<"a">) => {
+	return <a {...props} />;
+};
+
+export const DefaultImage = (
+	props: React.ImgHTMLAttributes<HTMLImageElement>,
+) => {
+	return <img {...props} />;
+};

package/src/plugins/blog/client/components/shared/empty-list.tsx

@@ -0,0 +1,25 @@
+import { NotebookTextIcon } from "lucide-react";
+import {
+	Empty,
+	EmptyHeader,
+	EmptyMedia,
+	EmptyTitle,
+} from "@workspace/ui/components/empty";
+
+export function EmptyList({ message }: { message: string }) {
+	return (
+		<>
+			<Empty
+				className="border border-dashed min-h-[600px] w-full"
+				data-testid="empty-state"
+			>
+				<EmptyHeader>
+					<EmptyMedia variant="icon" className="size-20">
+						<NotebookTextIcon className="text-muted-foreground size-16" />
+					</EmptyMedia>
+					<EmptyTitle data-testid="empty-message">{message}</EmptyTitle>
+				</EmptyHeader>
+			</Empty>
+		</>
+	);
+}

package/src/plugins/blog/client/components/shared/error-placeholder.tsx

@@ -0,0 +1,20 @@
+import { CloudAlert } from "lucide-react";
+import { PageHeader } from "./page-header";
+
+export function ErrorPlaceholder({
+	title,
+	message,
+}: {
+	title: string;
+	message: string;
+}) {
+	return (
+		<div
+			className="flex min-h-[600px] flex-col items-center justify-center gap-10"
+			data-testid="error-placeholder"
+		>
+			<PageHeader title={title} description={message} />
+			<CloudAlert className="size-[100px]" />
+		</div>
+	);
+}

package/src/plugins/blog/client/components/shared/highlight-text.tsx

@@ -0,0 +1,80 @@
+interface HighlightTextProps {
+	text: string;
+	searchQuery: string;
+	className?: string;
+	maxLength?: number;
+}
+
+export function HighlightText({
+	text,
+	searchQuery,
+	className,
+	maxLength = 150,
+}: HighlightTextProps) {
+	if (!searchQuery.trim()) {
+		const truncated =
+			maxLength && text.length > maxLength
+				? `${text.substring(0, maxLength)}...`
+				: text;
+		return <span className={className}>{truncated}</span>;
+	}
+
+	const query = searchQuery.toLowerCase();
+	const lowerText = text.toLowerCase();
+	const matchIndex = lowerText.indexOf(query);
+
+	if (matchIndex === -1) {
+		const truncated =
+			maxLength && text.length > maxLength
+				? `${text.substring(0, maxLength)}...`
+				: text;
+		return <span className={className}>{truncated}</span>;
+	}
+
+	// Create snippet around the match
+	let startIndex = 0;
+	let endIndex = text.length;
+
+	if (maxLength && text.length > maxLength) {
+		// Center the snippet around the match
+		const snippetStart = Math.max(0, matchIndex - Math.floor(maxLength / 2));
+		const snippetEnd = Math.min(text.length, snippetStart + maxLength);
+
+		startIndex = snippetStart;
+		endIndex = snippetEnd;
+	}
+
+	const snippet = text.substring(startIndex, endIndex);
+	const adjustedMatchIndex = matchIndex - startIndex;
+
+	if (adjustedMatchIndex < 0 || adjustedMatchIndex >= snippet.length) {
+		const truncated = snippet + (endIndex < text.length ? "..." : "");
+		return (
+			<span className={className}>
+				{startIndex > 0 ? `...${truncated}` : truncated}
+			</span>
+		);
+	}
+
+	const beforeMatch = snippet.substring(0, adjustedMatchIndex);
+	const match = snippet.substring(
+		adjustedMatchIndex,
+		adjustedMatchIndex + query.length,
+	);
+	const afterMatch = snippet.substring(adjustedMatchIndex + query.length);
+
+	const prefix = startIndex > 0 ? "..." : "";
+	const suffix = endIndex < text.length ? "..." : "";
+
+	return (
+		<span className={className}>
+			{prefix}
+			{beforeMatch}
+			<mark className="rounded-sm bg-yellow-200 font-medium text-foreground dark:bg-yellow-800">
+				{match}
+			</mark>
+			{afterMatch}
+			{suffix}
+		</span>
+	);
+}

package/src/plugins/blog/client/components/shared/markdown-content-styles.css

@@ -0,0 +1,328 @@
+.milkdown-custom .milkdown .milkdown-content {
+	font-family: var(--crepe-font-default);
+	color: var(--crepe-color-on-background);
+	background: var(--crepe-color-background);
+	padding: 0px;
+}
+
+.milkdown-custom .milkdown .milkdown-content img {
+	vertical-align: bottom;
+	max-width: 100%;
+}
+
+.milkdown-custom .milkdown .milkdown-content .markdown-image-wrapper {
+	display: block;
+	position: relative;
+	width: 100%;
+	aspect-ratio: 16 / 9;
+	min-height: 200px;
+}
+
+.milkdown-custom .milkdown .milkdown-content .markdown-image-wrapper > div {
+	width: 100%;
+	height: 100%;
+}
+
+.milkdown-custom .milkdown .milkdown-content .markdown-image-wrapper img {
+	object-fit: contain;
+}
+
+.milkdown-custom .milkdown .milkdown-content h1,
+.milkdown-custom .milkdown .milkdown-content h2,
+.milkdown-custom .milkdown .milkdown-content h3,
+.milkdown-custom .milkdown .milkdown-content h4,
+.milkdown-custom .milkdown .milkdown-content h5,
+.milkdown-custom .milkdown .milkdown-content h6 {
+	font-family: var(--crepe-font-title);
+	font-weight: 400;
+	padding: 2px 0;
+	scroll-margin-top: 56px;
+}
+
+.milkdown-custom .milkdown .milkdown-content h1 .heading-anchor,
+.milkdown-custom .milkdown .milkdown-content h2 .heading-anchor,
+.milkdown-custom .milkdown .milkdown-content h3 .heading-anchor,
+.milkdown-custom .milkdown .milkdown-content h4 .heading-anchor,
+.milkdown-custom .milkdown .milkdown-content h5 .heading-anchor,
+.milkdown-custom .milkdown .milkdown-content h6 .heading-anchor {
+	opacity: 0;
+	margin-left: 8px;
+	color: var(--crepe-color-on-surface-variant);
+	text-decoration: none;
+	transition: opacity 0.15s ease-in-out;
+}
+
+.milkdown-custom .milkdown .milkdown-content h1:hover .heading-anchor,
+.milkdown-custom .milkdown .milkdown-content h2:hover .heading-anchor,
+.milkdown-custom .milkdown .milkdown-content h3:hover .heading-anchor,
+.milkdown-custom .milkdown .milkdown-content h4:hover .heading-anchor,
+.milkdown-custom .milkdown .milkdown-content h5:hover .heading-anchor,
+.milkdown-custom .milkdown .milkdown-content h6:hover .heading-anchor {
+	opacity: 1;
+}
+
+.milkdown-custom .milkdown .milkdown-content h1 {
+	font-size: 42px;
+	line-height: 50px;
+	margin-top: 32px;
+}
+
+.milkdown-custom .milkdown .milkdown-content h2 {
+	font-size: 36px;
+	line-height: 44px;
+	margin-top: 28px;
+}
+
+.milkdown-custom .milkdown .milkdown-content h3 {
+	font-size: 32px;
+	line-height: 40px;
+	margin-top: 24px;
+}
+
+.milkdown-custom .milkdown .milkdown-content h4 {
+	font-size: 28px;
+	line-height: 36px;
+	margin-top: 20px;
+}
+
+.milkdown-custom .milkdown .milkdown-content h5 {
+	font-size: 24px;
+	line-height: 32px;
+	margin-top: 16px;
+}
+
+.milkdown-custom .milkdown .milkdown-content h6 {
+	font-size: 18px;
+	font-weight: 700;
+	line-height: 28px;
+	margin-top: 16px;
+}
+
+.milkdown-custom .milkdown .milkdown-content p {
+	font-size: 16px;
+	line-height: 24px;
+	padding: 4px 0;
+}
+
+.milkdown-custom .milkdown .milkdown-content a {
+	color: var(--crepe-color-primary);
+	text-decoration: underline;
+}
+
+.milkdown-custom .milkdown .milkdown-content code {
+	color: var(--crepe-color-inline-code);
+	background: color-mix(
+		in srgb,
+		var(--crepe-color-inline-area),
+		transparent 40%
+	);
+	font-family: var(--crepe-font-code);
+	padding: 0 2px;
+	border-radius: 4px;
+	font-size: 87.5%;
+	display: inline-block;
+	line-height: 1.4286;
+}
+
+.milkdown-custom .milkdown .milkdown-content pre {
+	background: color-mix(
+		in srgb,
+		var(--crepe-color-inline-area),
+		transparent 40%
+	);
+	padding: 10px;
+	border-radius: 4px;
+	overflow-x: auto;
+}
+
+.milkdown-custom .milkdown .milkdown-content pre code {
+	padding: 0;
+	background: transparent;
+}
+
+/* Ensure highlight.js themes color tokens inside our containers */
+.milkdown-custom .milkdown .milkdown-content pre code.hljs,
+.milkdown-custom .milkdown .milkdown-content code.hljs {
+	display: block;
+	overflow-x: auto;
+}
+
+.milkdown-custom .milkdown .milkdown-code-block {
+	display: block;
+	position: relative;
+	padding: 40px 8px 20px 20px;
+	margin: 4px 0;
+}
+
+.milkdown-custom .milkdown .milkdown-code-block pre {
+	background: transparent;
+	padding: 0;
+	border-radius: 0;
+}
+
+/* Layout wrapper to host gutter and code content side-by-side */
+.milkdown-custom .milkdown .milkdown-code-block .code-content {
+	display: grid;
+	grid-template-columns: var(--code-gutter-width, 3ch) 1fr;
+	gap: 0.35rem;
+	align-items: stretch;
+}
+
+/* Gutter line numbers */
+.milkdown-custom .milkdown .milkdown-code-block .line-numbers {
+	list-style: none;
+	margin: 0;
+	user-select: none;
+	color: var(--crepe-color-on-surface-variant);
+	text-align: end;
+	display: flex;
+	flex-direction: column;
+	justify-content: space-between;
+	align-items: center;
+	height: 100%;
+}
+
+.milkdown-custom .milkdown .milkdown-code-block .line-numbers li {
+	font-family: var(--crepe-font-code);
+	font-size: 12px;
+}
+
+.milkdown-custom .milkdown .milkdown-code-block .code-toolbar {
+	position: absolute;
+	top: 8px;
+	left: 18px;
+	right: 18px;
+	display: flex;
+	align-items: center;
+	justify-content: space-between;
+	pointer-events: none;
+	opacity: 0;
+	transition: opacity 0.15s ease-in-out;
+}
+
+.milkdown-custom .milkdown .milkdown-code-block:hover .code-toolbar {
+	opacity: 1;
+}
+
+/* Also reveal toolbar when focused via keyboard for accessibility */
+.milkdown-custom .milkdown .milkdown-code-block:focus-within .code-toolbar {
+	opacity: 1;
+}
+
+.milkdown-custom .milkdown .milkdown-code-block .language-label {
+	pointer-events: auto;
+	font-family: var(--crepe-font-default);
+	font-size: 12px;
+	font-weight: 600;
+	line-height: 16px;
+	color: var(--crepe-color-on-surface-variant);
+	background: var(--crepe-color-surface-low);
+	padding: 2px 8px;
+	border-radius: 4px;
+}
+
+.milkdown-custom .milkdown .milkdown-code-block .copy-button {
+	pointer-events: auto;
+	display: inline-flex;
+	align-items: center;
+	justify-content: center;
+	background: var(--crepe-color-surface-low);
+	color: var(--crepe-color-on-surface-variant);
+	border-radius: 4px;
+	padding: 4px 8px;
+	height: 26px;
+	width: 32px;
+	cursor: pointer;
+	transition: background-color 0.2s ease-in-out;
+}
+
+.milkdown-custom .milkdown .milkdown-code-block .copy-button:hover {
+	background: var(--crepe-color-hover);
+}
+
+.milkdown-custom .milkdown .milkdown-content blockquote {
+	position: relative;
+	padding-left: 40px;
+	padding-top: 0;
+	padding-bottom: 0;
+	box-sizing: content-box;
+	margin: 4px 0;
+}
+
+.milkdown-custom .milkdown .milkdown-content blockquote::before {
+	content: "";
+	width: 4px;
+	left: 0;
+	top: 4px;
+	bottom: 4px;
+	position: absolute;
+	background: var(--crepe-color-selected);
+	border-radius: 100px;
+}
+
+.milkdown-custom .milkdown .milkdown-content hr {
+	border: none;
+	background-color: color-mix(
+		in srgb,
+		var(--crepe-color-outline),
+		transparent 80%
+	);
+	background-clip: content-box;
+	padding: 6px 0;
+	height: 13px;
+	position: relative;
+}
+
+.milkdown-custom .milkdown .milkdown-content ul:not(.contains-task-list) {
+	padding: 0;
+	list-style-type: disc;
+	margin-left: 26px;
+}
+
+.milkdown-custom
+	.milkdown
+	.milkdown-content
+	ul:not(.contains-task-list)
+	li::marker {
+	color: var(--crepe-color-outline);
+	font-size: 1.2em;
+}
+
+.milkdown-custom .milkdown .milkdown-content ol {
+	padding: 0;
+	list-style-type: decimal;
+	margin-left: 20px;
+}
+
+.milkdown-custom .milkdown .milkdown-content li.task-list-item {
+	position: relative;
+	list-style: none;
+	padding-left: 28px;
+}
+
+.milkdown-custom
+	.milkdown
+	.milkdown-content
+	li.task-list-item
+	input[type="checkbox"] {
+	width: 20px;
+	height: 20px;
+	position: absolute;
+	left: 0;
+	margin: 0;
+}
+
+.milkdown-custom .milkdown .milkdown-content table {
+	border-collapse: collapse;
+	table-layout: fixed;
+	width: 100%;
+	margin: 4px 0;
+}
+
+.milkdown-custom .milkdown .milkdown-content th,
+.milkdown-custom .milkdown .milkdown-content td {
+	border: 1px solid
+		color-mix(in srgb, var(--crepe-color-outline), transparent 80%);
+	padding: 4px 16px;
+	overflow-wrap: anywhere;
+}