@publier/shell 2.1.1

package/src/schemas/changelog.ts

@@ -0,0 +1,28 @@
+
+
+import { z } from 'astro/zod';
+
+export const changelogSchema = z.object({
+	
+	title: z.string(),
+
+	
+	description: z.string().optional(),
+
+	
+	date: z.coerce.date(),
+
+	
+	author: z.string().optional(),
+
+	
+	tags: z.array(z.string()).optional(),
+
+	
+	version: z.string().optional(),
+
+	
+	draft: z.boolean().default(false),
+});
+
+export type ChangelogEntry = z.infer<typeof changelogSchema>;

package/src/schemas/common.ts

@@ -0,0 +1,82 @@
+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({});

package/src/schemas/docs.ts

@@ -0,0 +1,101 @@
+import { z } from 'astro/zod';
+import {
+	BadgeConfigSchema,
+	FrontmatterTableOfContentsSchema,
+	HeadConfigSchema,
+	HeroSchema,
+	PrevNextLinkConfigSchema,
+	SidebarLinkAttrsSchema,
+} from './common.ts';
+
+type BaseSchema = z.ZodTypeAny;
+
+const PublierDocsFrontmatterSchema = () =>
+	z.object({
+		
+		title: z.string(),
+
+		
+		description: z.string().optional(),
+
+		
+		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: z.boolean().default(false),
+
+		
+
+		
+		tags: z.array(z.string()).optional(),
+
+		
+		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

@@ -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

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