npm - @publier/shell - Versions diffs - 3.1.5 - Mend

@publier/shell 3.1.5

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 (140) hide show

package/README.md +1 -0
package/dist/build-integration.d.mts +7 -0
package/dist/build-integration.mjs +1 -0
package/dist/image-zoom-runtime-Cr8vBrXH.mjs +1 -0
package/dist/index-Bc-beOEe.d.mts +1033 -0
package/dist/index.d.mts +33 -0
package/dist/index.mjs +1 -0
package/dist/integration-6L__3wwu.mjs +102 -0
package/dist/integration-DKTmdCWN.d.mts +203 -0
package/dist/integration.d.mts +2 -0
package/dist/integration.mjs +1 -0
package/dist/loaders/index.d.mts +54 -0
package/dist/loaders/index.mjs +1 -0
package/dist/plugins/remark-asides.d.mts +8 -0
package/dist/plugins/remark-asides.mjs +2 -0
package/dist/plugins/remark-snippets.d.mts +11 -0
package/dist/plugins/remark-snippets.mjs +1 -0
package/dist/plugins/remark-structure.d.mts +13 -0
package/dist/plugins/remark-structure.mjs +1 -0
package/dist/plugins/remark-vars.d.mts +7 -0
package/dist/plugins/remark-vars.mjs +1 -0
package/dist/presets-DL0qjtya.mjs +1 -0
package/dist/presets-RGpZ_X1B.d.mts +16 -0
package/dist/runtime/code-group-sync.d.mts +30 -0
package/dist/runtime/code-group-sync.mjs +103 -0
package/dist/runtime/lazy-upgrade-registry.d.mts +41 -0
package/dist/runtime/lazy-upgrade-registry.mjs +1 -0
package/dist/runtime/tabs-sync.d.mts +25 -0
package/dist/runtime/tabs-sync.mjs +106 -0
package/dist/search/index.d.mts +92 -0
package/dist/search/index.mjs +1 -0
package/dist/tailwind/css-plugin.d.mts +16 -0
package/dist/tailwind/css-plugin.mjs +1 -0
package/dist/tailwind/index.d.mts +6 -0
package/dist/tailwind/index.mjs +1 -0
package/dist/tailwind/loader.d.mts +94 -0
package/dist/tailwind/loader.mjs +2 -0
package/dist/theme-toggle-element-DzFjxwpS.mjs +1 -0
package/dist/themes/almond.css +115 -0
package/dist/themes/aspen.css +95 -0
package/dist/themes/catppuccin.css +98 -0
package/dist/themes/dark.css +98 -0
package/dist/themes/dusk.css +98 -0
package/dist/themes/emerald.css +95 -0
package/dist/themes/light.css +95 -0
package/dist/themes/maple.css +119 -0
package/dist/themes/neutral.css +73 -0
package/dist/themes/ocean.css +98 -0
package/dist/themes/purple.css +95 -0
package/dist/themes/ruby.css +95 -0
package/dist/themes/solar.css +98 -0
package/dist/themes/vitepress.css +95 -0
package/package.json +178 -0
package/src/astro-modules.d.ts +20 -0
package/src/components/LastModified.astro +25 -0
package/src/components/announcement-banner.astro +25 -0
package/src/components/aside.astro +17 -0
package/src/components/ask-ai.tsx +146 -0
package/src/components/badge.astro +18 -0
package/src/components/breadcrumbs.astro +23 -0
package/src/components/callouts/caution.astro +13 -0
package/src/components/callouts/check.astro +13 -0
package/src/components/callouts/danger.astro +13 -0
package/src/components/callouts/info.astro +13 -0
package/src/components/callouts/note.astro +13 -0
package/src/components/callouts/tip.astro +13 -0
package/src/components/callouts/warning.astro +13 -0
package/src/components/card-grid.astro +14 -0
package/src/components/card.astro +18 -0
package/src/components/code-group.astro +55 -0
package/src/components/columns.astro +18 -0
package/src/components/docs-layout.astro +25 -0
package/src/components/file-tree-node.astro +13 -0
package/src/components/file-tree.astro +9 -0
package/src/components/icon.astro +18 -0
package/src/components/index.ts +154 -0
package/src/components/link-button.astro +21 -0
package/src/components/link-card.astro +21 -0
package/src/components/open-in-ai.astro +13 -0
package/src/components/package-install.astro +17 -0
package/src/components/panels.astro +16 -0
package/src/components/search-button.astro +21 -0
package/src/components/sidebar.astro +12 -0
package/src/components/skip-link.astro +12 -0
package/src/components/steps.astro +13 -0
package/src/components/table-of-contents.astro +22 -0
package/src/components/tabs.astro +17 -0
package/src/components/theme-storage.ts +5 -0
package/src/components/theme-toggle-element.ts +85 -0
package/src/components/theme-toggle.astro +25 -0
package/src/components/tile-grid.astro +13 -0
package/src/components/tile.astro +17 -0
package/src/components/top-nav-mobile.astro +11 -0
package/src/components/top-nav.astro +20 -0
package/src/components/types.ts +522 -0
package/src/components/ui/blur-image.astro +60 -0
package/src/components/ui/changelog-entry.astro +56 -0
package/src/components/ui/cta-band.astro +30 -0
package/src/components/ui/feature-grid.astro +38 -0
package/src/components/ui/feature-section.astro +85 -0
package/src/components/ui/frame.astro +52 -0
package/src/components/ui/hero.astro +47 -0
package/src/components/ui/jobs-list.astro +53 -0
package/src/components/ui/logo-cloud.astro +68 -0
package/src/components/ui/press-gallery.astro +52 -0
package/src/components/ui/pricing-comparison-table.astro +73 -0
package/src/components/ui/pricing-section.astro +113 -0
package/src/components/ui/pricing-table.astro +54 -0
package/src/components/ui/status-indicator.astro +38 -0
package/src/components/ui/team-grid.astro +63 -0
package/src/components/ui/testimonial-card.astro +42 -0
package/src/components/ui/types.ts +323 -0
package/src/components/update-badge.astro +15 -0
package/src/components/version-switcher.astro +20 -0
package/src/icons/index.tsx +195 -0
package/src/layouts/base-layout.astro +65 -0
package/src/qwik.ts +3 -0
package/src/routes/blog-index.astro +20 -0
package/src/routes/blog-rss.xml.ts +40 -0
package/src/routes/blog-slug.astro +32 -0
package/src/routes/changelog-index.astro +25 -0
package/src/routes/changelog-rss.xml.ts +47 -0
package/src/routes/docs-slug.astro +31 -0
package/src/routes/not-found.astro +14 -0
package/src/runtime/banner-init.ts +9 -0
package/src/runtime/lazy-upgrade-init.ts +5 -0
package/src/runtime/sidebar-scroll-init.ts +3 -0
package/src/runtime/theme-init.ts +16 -0
package/src/schemas/blog.ts +38 -0
package/src/schemas/changelog.ts +29 -0
package/src/schemas/common.ts +88 -0
package/src/schemas/docs.ts +104 -0
package/src/schemas/index.ts +14 -0
package/src/schemas/pages.ts +23 -0
package/src/styles/base.css +627 -0
package/src/styles/expressive-code.css +41 -0
package/src/styles/rules.css +66 -0
package/src/styles/tailwind-sources.css +17 -0
package/src/tailwind/preset.css +193 -0
package/src/virtual-modules.d.ts +164 -0

package/src/layouts/base-layout.astro ADDED Viewed

@@ -0,0 +1,65 @@
+---
+import { Font } from 'astro:assets';
+import { ClientRouter } from 'astro:transitions';
+import { shellRenderBaseLayout, navigationMatchNavPath } from '@publier/native';
+import SearchButton from '../components/search-button.astro';
+import ThemeToggle from '../components/theme-toggle.astro';
+import TopNavMobile from '../components/top-nav-mobile.astro';
+import { TopNav } from '../components/index.ts';
+import { announcement } from 'virtual:publier-announcement';
+import { feeds } from 'virtual:publier-feeds';
+import { fonts } from 'virtual:publier-fonts';
+import { navConfig } from 'virtual:publier-nav-config';
+import { site } from 'virtual:publier-site';
+interface Props { title: string; description?: string; nav?: string | false; class?: string }
+const { title, description, nav: navProp, class: className } = Astro.props;
+const currentPath = Astro.url.pathname;
+let navVariant: string | false;
+if (navProp !== undefined) {
+	navVariant = navProp;
+} else {
+	const matched = navigationMatchNavPath(JSON.stringify(navConfig.pathRules), currentPath);
+	navVariant = matched === 'false'
+		? false
+		: matched === 'null'
+			? navConfig.defaultVariant
+			: (JSON.parse(matched) as string);
+}
+const storageKey = announcement?.storageKey ?? 'publier-announcement';
+const [head, bodyOpen, bodyClose] = JSON.parse(shellRenderBaseLayout(JSON.stringify({
+	title, description, className, favicon: site.favicon, footer: site.footer, serviceWorker: !!site.serviceWorker,
+	announcement: announcement && { ...announcement, variant: announcement.variant ?? 'info', storageKey, dismissible: true },
+}))) as [string, string, string];
+---
+<!doctype html>
+<html lang="en">
+<head>
+<Fragment set:html={head} />
+<Font cssVariable="--publier-font-builtin-sans" preload />
+<Font cssVariable="--publier-font-builtin-mono" />
+{fonts.slots.includes('heading') && <Font cssVariable="--publier-font-heading" preload />}
+{fonts.slots.includes('body') && <Font cssVariable="--publier-font-body" preload />}
+{fonts.slots.includes('mono') && <Font cssVariable="--publier-font-mono" />}
+{site.url && feeds.map((f) => (
+	<link rel="alternate" type="application/rss+xml" title={f.title} href={`${site.url}${f.href}`} />
+))}
+<ClientRouter />
+<slot name="head" />
+</head>
+<body class={className}>
+<slot name="skip" />
+<Fragment set:html={bodyOpen} />
+{navVariant !== false && (
+	<TopNav variant={navVariant} currentPath={currentPath}>
+		{navConfig.searchEnabled && <SearchButton slot="search" />}
+		<ThemeToggle slot="theme" />
+		<TopNavMobile slot="mobile" variant={navVariant} currentPath={currentPath} />
+	</TopNav>
+)}
+<slot />
+<Fragment set:html={bodyClose} />
+</body>
+</html>

package/src/qwik.ts ADDED Viewed

	@@ -0,0 +1,3 @@
1	+
2	+
3	+ export { AskAi } from './components/ask-ai';

package/src/routes/blog-index.astro ADDED Viewed

@@ -0,0 +1,20 @@
+---
+import { getCollection } from 'astro:content';
+import BaseLayout from '../layouts/base-layout.astro';
+import { shellRenderBlogIndex } from '@publier/native';
+interface BlogEntry {
+	id: string;
+	data: { title: string; description?: string; author?: string; date?: Date; pubDate?: Date; draft?: boolean };
+}
+const posts = ((await getCollection('blog')) as unknown as BlogEntry[])
+	.filter((p) => !p.data.draft)
+	.map((p) => ({ ...p, resolvedDate: p.data.date ?? p.data.pubDate ?? new Date(0) }))
+	.sort((a, b) => b.resolvedDate.getTime() - a.resolvedDate.getTime());
+const bodyHtml = shellRenderBlogIndex(JSON.stringify({ posts: posts.map((p) => ({ href: `/blog/${p.id.replace(/\.(mdx?|md)$/, '')}`, title: p.data.title, description: p.data.description ?? null, author: p.data.author ?? null, date_ms: p.resolvedDate.getTime() })) }));
+---
+<BaseLayout title="Blog" description="News, updates, and articles." nav="blog">
+	<Fragment set:html={bodyHtml} />
+</BaseLayout>

package/src/routes/blog-rss.xml.ts ADDED Viewed

@@ -0,0 +1,40 @@
+import { getCollection } from 'astro:content';
+import { site as siteConfig } from 'virtual:publier-site';
+import rss from '@astrojs/rss';
+interface BlogEntry {
+	id: string;
+	data: {
+		title: string;
+		description?: string;
+		author?: string;
+		date: Date;
+		updated?: Date;
+		draft: boolean;
+	};
+}
+export async function GET(context: { site?: URL }) {
+	const all = (await getCollection('blog')) as unknown as BlogEntry[];
+	const items = all
+		.filter((entry) => !entry.data.draft)
+		.sort((a, b) => b.data.date.getTime() - a.data.date.getTime())
+		.map((entry) => ({
+			title: entry.data.title,
+			description: entry.data.description ?? '',
+			pubDate: entry.data.date,
+			link: `/blog/${entry.id.replace(/\.(mdx?|md)$/, '')}/`,
+			...(entry.data.author ? { author: entry.data.author } : {}),
+		}));
+	return rss({
+		title: `${siteConfig.name || 'Publier'} — Blog`,
+		description: siteConfig.description ?? 'Latest blog posts.',
+		site: context.site ?? new URL(siteConfig.url ?? 'https://example.com'),
+		items,
+	});
+}

package/src/routes/blog-slug.astro ADDED Viewed

@@ -0,0 +1,32 @@
+---
+import { getCollection, render } from 'astro:content';
+import BaseLayout from '../layouts/base-layout.astro';
+import { LastModified } from '../components/index.ts';
+import { shellRenderBlogSlug } from '@publier/native';
+interface BlogEntry {
+	id: string;
+	data: { title: string; description?: string; author?: string; date?: Date; pubDate?: Date; updated?: Date };
+}
+export async function getStaticPaths() {
+	const posts = await getCollection('blog');
+	return posts.map((post) => ({
+		params: { slug: post.id.replace(/\.(mdx?|md)$/, '') },
+		props: { post },
+	}));
+}
+const { post } = Astro.props as { post: BlogEntry };
+const { Content } = await render(post as unknown as Parameters<typeof render>[0]);
+const d = post.data.date ?? post.data.pubDate;
+const updated = post.data.updated instanceof Date ? post.data.updated : null;
+const [head, tail] = shellRenderBlogSlug(JSON.stringify({ title: post.data.title, description: post.data.description ?? null, author: post.data.author ?? null, date_ms: d ? d.getTime() : null })).split('<!--publier-content-slot-->');
+---
+<BaseLayout title={post.data.title} description={post.data.description} nav="blog">
+	<Fragment set:html={head} />
+	<Content />
+	{updated && <LastModified date={updated} />}
+	<Fragment set:html={tail} />
+</BaseLayout>

package/src/routes/changelog-index.astro ADDED Viewed

@@ -0,0 +1,25 @@
+---
+import { getCollection, render } from 'astro:content';
+import BaseLayout from '../layouts/base-layout.astro';
+import { shellRenderChangelogEntry, shellRenderChangelogFooter, shellRenderChangelogHeader } from '@publier/native';
+interface ChangelogEntry {
+	id: string;
+	data: { title: string; description?: string; version?: string; date: Date; draft?: boolean; tags?: string[] };
+}
+const entries = ((await getCollection('changelog')) as unknown as ChangelogEntry[])
+	.filter((e) => !e.data.draft)
+	.sort((a, b) => b.data.date.getTime() - a.data.date.getTime());
+const rendered = await Promise.all(entries.map(async (entry) => {
+	const { Content } = await render(entry as unknown as Parameters<typeof render>[0]);
+	const [head, tail] = shellRenderChangelogEntry(JSON.stringify({ title: entry.data.title, date_ms: entry.data.date.getTime(), version: entry.data.version ?? null, tags: entry.data.tags ?? [] })).split('<!--publier-content-slot-->');
+	return { head, tail, Content };
+}));
+---
+<BaseLayout title="Changelog" description="Version history and release notes.">
+	<Fragment set:html={shellRenderChangelogHeader()} />
+	{rendered.map(({ head, tail, Content }) => (<><Fragment set:html={head} /><Content /><Fragment set:html={tail} /></>))}
+	<Fragment set:html={shellRenderChangelogFooter()} />
+</BaseLayout>

package/src/routes/changelog-rss.xml.ts ADDED Viewed

@@ -0,0 +1,47 @@
+import { getCollection } from 'astro:content';
+import { site as siteConfig } from 'virtual:publier-site';
+import rss from '@astrojs/rss';
+interface ChangelogEntry {
+	id: string;
+	data: {
+		title: string;
+		description?: string;
+		version?: string;
+		date: Date;
+		draft: boolean;
+		tags?: string[];
+	};
+}
+export async function GET(context: { site?: URL }) {
+	const all = (await getCollection('changelog')) as unknown as ChangelogEntry[];
+	const items = all
+		.filter((entry) => !entry.data.draft)
+		.sort((a, b) => b.data.date.getTime() - a.data.date.getTime())
+		.map((entry) => {
+			const version = entry.data.version;
+			const baseTitle = entry.data.title;
+			const displayTitle =
+				version && !baseTitle.includes(version) ? `${baseTitle} (${version})` : baseTitle;
+			return {
+				title: displayTitle,
+				description: entry.data.description ?? '',
+				pubDate: entry.data.date,
+				link: `/changelog/#${entry.id.replace(/\.(mdx?|md)$/, '')}`,
+				...(entry.data.tags ? { categories: entry.data.tags } : {}),
+			};
+		});
+	return rss({
+		title: `${siteConfig.name || 'Publier'} — Changelog`,
+		description: siteConfig.description ?? 'Version history and release notes.',
+		site: context.site ?? new URL(siteConfig.url ?? 'https://example.com'),
+		items,
+	});
+}

package/src/routes/docs-slug.astro ADDED Viewed

@@ -0,0 +1,31 @@
+---
+import { getCollection, render } from 'astro:content';
+import BaseLayout from '../layouts/base-layout.astro';
+import { type BreadcrumbItem, DocsLayout, LastModified, Sidebar, SkipLink, TableOfContents } from '../components/index.ts';
+import { buildSidebar, entryToPage } from '@publier/shell/search';
+import { shellPlanDocsSlug, shellRenderDocsSlug } from '@publier/native';
+import { docsConfig } from 'virtual:publier-docs-config';
+import '../styles/expressive-code.css';
+export async function getStaticPaths() {
+	return (await getCollection('docs')).map((entry) => ({ params: { slug: entry.id.replace(/\.(mdx?|md)$/, '').replace(/\/index$/, '').replace(/^index$/, '') || undefined }, props: { entry } }));
+}
+const { entry } = Astro.props;
+const { Content, headings } = await render(entry);
+const all = await getCollection('docs');
+const plan = JSON.parse(shellPlanDocsSlug(JSON.stringify({ entry_id: entry.id, title: entry.data.title, description: entry.data.description ?? null, tab_sections: docsConfig.tabSections, all_entry_ids: all.map((e) => e.id) }))) as { breadcrumbs: BreadcrumbItem[]; section_entry_ids: string[]; scope: string; current_path: string; sidebar_persist_key: string };
+const ids = new Set(plan.section_entry_ids);
+const sidebarItems = buildSidebar(all.filter((e) => ids.has(e.id)).map((e) => entryToPage({ slug: e.id.replace(/\.(mdx?|md)$/, ''), data: e.data, headings: [] }, { urlPrefix: '/docs' })), { urlPrefix: '/docs', meta: docsConfig.sidebarMeta });
+const [bodyHead, bodyTail] = shellRenderDocsSlug(JSON.stringify({ title: entry.data.title, description: entry.data.description ?? null })).split('<!--publier-content-slot-->');
+const lastUpdated = entry.data.lastUpdated instanceof Date ? entry.data.lastUpdated : null;
+---
+<BaseLayout title={`${entry.data.title} — Docs`} description={entry.data.description} nav="docs">
+	<SkipLink slot="skip" targetId="main-content" />
+	<DocsLayout breadcrumbs={plan.breadcrumbs.length > 2 ? plan.breadcrumbs : undefined} sidebarPersistKey={plan.sidebar_persist_key}>
+		<Sidebar slot="sidebar" items={sidebarItems} currentPath={plan.current_path} versions={docsConfig.versions.length > 0 ? docsConfig.versions : undefined} anchors={docsConfig.anchors.length > 0 ? docsConfig.anchors : undefined} scope={plan.scope} />
+		<TableOfContents slot="toc" headings={headings} />
+		<Fragment set:html={bodyHead} />
+		<Content />
+		{lastUpdated && <LastModified date={lastUpdated} />}
+		<Fragment set:html={bodyTail} />
+	</DocsLayout>
+</BaseLayout>

package/src/routes/not-found.astro ADDED Viewed

@@ -0,0 +1,14 @@
+---
+import BaseLayout from '../layouts/base-layout.astro';
+import { shellRenderNotFound } from '@publier/native';
+const bodyHtml = shellRenderNotFound();
+---
+<BaseLayout
+	title="Page not found"
+	description="The page you were looking for could not be found."
+	nav="default"
+>
+	<Fragment set:html={bodyHtml} />
+</BaseLayout>

package/src/runtime/banner-init.ts ADDED Viewed

@@ -0,0 +1,9 @@
+import { shellBuildBannerInitScript } from '@publier/native';
+export const BANNER_DEFAULT_STORAGE_KEY = 'publier-banner-dismissed';
+export function buildBannerInitScript(storageKey: string = BANNER_DEFAULT_STORAGE_KEY): string {
+	return shellBuildBannerInitScript(storageKey);
+}

package/src/runtime/lazy-upgrade-init.ts ADDED Viewed

@@ -0,0 +1,5 @@
+import { shellLazyUpgradeScript } from '@publier/native';
+export const LAZY_UPGRADE_SCRIPT = shellLazyUpgradeScript();

package/src/runtime/sidebar-scroll-init.ts ADDED Viewed

	@@ -0,0 +1,3 @@
1	+
2	+
3	+ export const SIDEBAR_SCROLL_STORAGE_KEY = 'publier:docs-sidebar-scroll';

package/src/runtime/theme-init.ts ADDED Viewed

@@ -0,0 +1,16 @@
+import { shellBuildThemeInitScript } from '@publier/native';
+export interface AppearanceOptions {
+	default?: 'system' | 'light' | 'dark';
+	strict?: boolean;
+}
+export function buildThemeInitScript(appearance: AppearanceOptions = {}): string {
+	return shellBuildThemeInitScript(appearance.default ?? 'system', appearance.strict ?? false);
+}
+export const THEME_INIT_SCRIPT = buildThemeInitScript({ default: 'system', strict: false });

package/src/schemas/blog.ts ADDED Viewed

@@ -0,0 +1,38 @@
+import { z } from 'astro/zod';
+import { DescriptionFieldSchema, DraftFieldSchema, TagsFieldSchema } from './common.ts';
+export const blogSchema = z.object({
+	title: z.string(),
+	description: DescriptionFieldSchema,
+	date: z.coerce.date(),
+	updated: z.coerce.date().optional(),
+	author: z.string().optional(),
+	tags: TagsFieldSchema,
+	image: z.string().optional(),
+	imageAlt: z.string().optional(),
+	draft: DraftFieldSchema,
+	excerpt: z.string().optional(),
+});
+export type BlogEntry = z.infer<typeof blogSchema>;

package/src/schemas/changelog.ts ADDED Viewed

@@ -0,0 +1,29 @@
+import { z } from 'astro/zod';
+import { DescriptionFieldSchema, DraftFieldSchema, TagsFieldSchema } from './common.ts';
+export const changelogSchema = z.object({
+	title: z.string(),
+	description: DescriptionFieldSchema,
+	date: z.coerce.date(),
+	author: z.string().optional(),
+	tags: TagsFieldSchema,
+	version: z.string().optional(),
+	draft: DraftFieldSchema,
+});
+export type ChangelogEntry = z.infer<typeof changelogSchema>;

package/src/schemas/common.ts ADDED Viewed

@@ -0,0 +1,88 @@
+import { z } from 'astro/zod';
+export const BadgeConfigSchema = z
+	.union([
+		z.string(),
+		z.object({
+			variant: z
+				.enum(['note', 'tip', 'caution', 'danger', 'success', 'default'])
+				.default('default'),
+			text: z.string(),
+			class: z.string().optional(),
+		}),
+	])
+	.optional();
+export const HeadConfigSchema = z
+	.array(
+		z.object({
+			tag: z.enum(['title', 'base', 'link', 'style', 'meta', 'script', 'noscript', 'template']),
+			attrs: z.record(z.string(), z.union([z.string(), z.boolean(), z.undefined()])).default({}),
+			content: z.string().default(''),
+		}),
+	)
+	.default([]);
+export const FrontmatterTableOfContentsSchema = z
+	.union([
+		z.object({
+			minHeadingLevel: z.number().int().min(1).max(6).optional(),
+			maxHeadingLevel: z.number().int().min(1).max(6).optional(),
+		}),
+		z.literal(false),
+	])
+	.optional();
+export const PrevNextLinkConfigSchema = z
+	.union([
+		z.boolean(),
+		z.string(),
+		z.object({
+			link: z.string().optional(),
+			label: z.string().optional(),
+		}),
+	])
+	.optional();
+export const HeroSchema = z
+	.object({
+		title: z.string().optional(),
+		tagline: z.string().optional(),
+		image: z
+			.union([
+				z.object({
+					alt: z.string(),
+					file: z.string(),
+				}),
+				z.object({
+					alt: z.string(),
+					dark: z.string(),
+					light: z.string(),
+				}),
+				z.object({
+					html: z.string(),
+				}),
+			])
+			.optional(),
+		actions: z
+			.array(
+				z.object({
+					text: z.string(),
+					link: z.string(),
+					variant: z.enum(['primary', 'secondary', 'minimal']).default('primary'),
+					icon: z.string().optional(),
+				}),
+			)
+			.default([]),
+	})
+	.optional();
+export const SidebarLinkAttrsSchema = z
+	.record(z.string(), z.union([z.string(), z.number(), z.boolean(), z.undefined()]))
+	.default({});
+export const DescriptionFieldSchema = z.string().optional();
+export const TagsFieldSchema = z.array(z.string()).optional();
+export const DraftFieldSchema = z.boolean().default(false);

package/src/schemas/docs.ts ADDED Viewed

@@ -0,0 +1,104 @@
+import { z } from 'astro/zod';
+import {
+	BadgeConfigSchema,
+	DescriptionFieldSchema,
+	DraftFieldSchema,
+	FrontmatterTableOfContentsSchema,
+	HeadConfigSchema,
+	HeroSchema,
+	PrevNextLinkConfigSchema,
+	SidebarLinkAttrsSchema,
+	TagsFieldSchema,
+} from './common.ts';
+type BaseSchema = z.ZodTypeAny;
+const PublierDocsFrontmatterSchema = () =>
+	z.object({
+		title: z.string(),
+		description: DescriptionFieldSchema,
+		head: HeadConfigSchema,
+		tableOfContents: FrontmatterTableOfContentsSchema,
+		layout: z.enum(['doc', 'splash']).default('doc'),
+		hero: HeroSchema,
+		lastUpdated: z.union([z.date(), z.boolean()]).optional(),
+		prev: PrevNextLinkConfigSchema,
+		next: PrevNextLinkConfigSchema,
+		sidebar: z
+			.object({
+				order: z.number().optional(),
+				label: z.string().optional(),
+				hidden: z.boolean().default(false),
+				badge: BadgeConfigSchema,
+				attrs: SidebarLinkAttrsSchema,
+			})
+			.optional(),
+		banner: z
+			.object({
+				content: z.string(),
+			})
+			.optional(),
+		draft: DraftFieldSchema,
+		tags: TagsFieldSchema,
+		order: z.number().optional(),
+	});
+type DefaultSchema = ReturnType<typeof PublierDocsFrontmatterSchema>;
+type ExtendedSchema<T extends BaseSchema = never> = [T] extends [never]
+	? DefaultSchema
+	: T extends BaseSchema
+		? z.ZodIntersection<DefaultSchema, T>
+		: DefaultSchema;
+interface DocsSchemaOpts<T extends BaseSchema> {
+	extend?: T;
+}
+export function docsSchema<T extends BaseSchema = never>(
+	opts?: DocsSchemaOpts<T>,
+): ExtendedSchema<T> {
+	const base = PublierDocsFrontmatterSchema();
+	return (opts?.extend ? base.and(opts.extend) : base) as ExtendedSchema<T>;
+}
+export type DocsFrontmatter = z.infer<DefaultSchema>;

package/src/schemas/index.ts ADDED Viewed

@@ -0,0 +1,14 @@
+export { type BlogEntry, blogSchema } from './blog.ts';
+export { type ChangelogEntry, changelogSchema } from './changelog.ts';
+export {
+	BadgeConfigSchema,
+	FrontmatterTableOfContentsSchema,
+	HeadConfigSchema,
+	HeroSchema,
+	PrevNextLinkConfigSchema,
+	SidebarLinkAttrsSchema,
+} from './common.ts';
+export { type DocsFrontmatter, docsSchema } from './docs.ts';
+export { type PageEntry, pagesSchema } from './pages.ts';

package/src/schemas/pages.ts ADDED Viewed

@@ -0,0 +1,23 @@
+import { z } from 'astro/zod';
+import { DescriptionFieldSchema, DraftFieldSchema } from './common.ts';
+export const pagesSchema = z.object({
+	title: z.string(),
+	description: DescriptionFieldSchema,
+	image: z.string().optional(),
+	imageAlt: z.string().optional(),
+	draft: DraftFieldSchema,
+});
+export type PageEntry = z.infer<typeof pagesSchema>;