ezal-theme-example 0.0.1

package/assets/styles/links.styl

@@ -0,0 +1,121 @@
+@import '_index'
+
+// MARK: Header
+header
+	img
+		filter blur(4px)
+		scale 1.05
+
+.cates
+	display flex
+	flex-wrap wrap
+	font-weight bold
+	gap 4px 16px
+
+.tag
+	&:before
+		content '#'
+		opacity .5
+
+.article-info
+	display flex
+	flex-wrap wrap
+	gap 8px
+	:before
+		margin-right 4px
+
+// MARK: Main
+main
+	display flex
+	flex-direction row-reverse
+
+article
+	flex 1
+	padding 8px
+	width 0
+	text-wrap pretty
+
+.sticky
+	position sticky
+	top var(--sticky)
+	z-index 4
+	background var(--panel)
+	backdrop-filter blur(4px)
+	--sticky 0px
+
+.sticky-content
+	.sticky
+		z-index 3
+		--sticky 40px
+	.sticky-content
+		.sticky
+			z-index 2
+			--sticky 80px
+		.sticky-content
+			.sticky
+				z-index 1
+				--sticky 80px
+			.sticky-content
+				.sticky
+					z-index 0
+					--sticky 80px
+
+if linksStyle('heading')
+	@import '_article/heading'
+
+@import '_article/other'
+
+if linksStyle('image')
+	@import '_article/image'
+
+if linksStyle('table')
+	@import '_article/table'
+
+if linksStyle('list')
+	@import '_article/list'
+
+if linksStyle('footnote')
+	@import '_article/footnote'
+
+if linksStyle('tabs')
+	@import '_article/tabs'
+
+if linksStyle('note')
+	@import '_article/note'
+
+if linksStyle('fold')
+	@import '_article/fold'
+
+if linksStyle('kbd')
+	@import '_article/kbd'
+
+// MARK: Links
+.links
+	margin 16px 0
+	text-align center
+	text-wrap balance
+	a
+		position relative
+		display inline-block
+		margin 8px
+		padding 16px
+		max-width 300px
+		width 100%
+		border 1px solid var(--border)
+		background var(--panel)
+		color var(--text)
+		text-align left
+		text-decoration none
+		transition .1s
+		&:hover
+			border-color var(--theme)
+			color var(--text)
+			&:after
+				opacity .5
+	img
+		width 48px
+		height 48px
+		object-fit cover
+
+.link-title
+	font-weight bold

package/assets/styles/page.styl

@@ -0,0 +1,12 @@
+@import '_index'
+@import '_article/other'
+@import '_article/heading'
+@import '_article/image'
+@import '_article/table'
+@import '_article/list'
+@import '_article/footnote'
+@import '_article/tabs'
+@import '_article/note'
+@import '_article/fold'
+@import '_article/kbd'
+@import '_article/links'

package/assets/styles/tag.styl

@@ -0,0 +1,4 @@
+@import '_index'
+
+.archive a
+	margin-left 1ch

package/dist/config.d.ts

@@ -0,0 +1,128 @@
+import type { Temporal } from '@js-temporal/polyfill';
+import type { ArrayOr } from 'ezal';
+import type { TokenizeOptions } from 'ezal-markdown';
+import type { RawTheme } from 'shiki';
+export interface NavItem {
+    name: string;
+    link: string;
+}
+export interface Contact {
+    url: string;
+    name: string;
+    icon: string;
+    color: string;
+}
+export interface Link {
+    name: string;
+    description: string;
+    link: string;
+    avatar: string;
+    color: string;
+}
+export interface LinkGroup {
+    title: string;
+    description: string;
+    items: Link[];
+}
+export type LinkPageStyles = 'image' | 'table' | 'heading' | 'list' | 'footnote' | 'tabs' | 'note' | 'fold' | 'kbd';
+export interface ThemeConfig {
+    /** 导航栏 */
+    nav?: NavItem[];
+    /** 站点图标 */
+    favicon?: ArrayOr<string>;
+    /** 主题色 */
+    color?: {
+        /** @default '#006000' */
+        light?: string;
+        /** @default '#00BB00' */
+        dark?: string;
+    };
+    /** 建站时间 */
+    since?: Temporal.ZonedDateTime;
+    /** 联系方式 */
+    contact?: Contact[];
+    /** 友情链接 */
+    links?: LinkGroup[];
+    /**
+     * 友情链接页面启用的样式
+     * @default 全部启用
+     */
+    linkPageStyles?: LinkPageStyles[];
+    /** Markdown 配置 */
+    markdown?: {
+        /**
+         * 换行规则
+         * @description
+         * - `common-mark`：CommonMark 规范，行尾 2+ 空格渲染为换行
+         * - `soft`：软换行，换行符 `\n` 渲染为换行
+         * @default `common-mark`
+         */
+        lineBreak?: TokenizeOptions['lineBreak'];
+        /**
+         * 代码块主题
+         * @default {light:'light-plus',dark:'dark-plus'}
+         */
+        codeBlockTheme?: {
+            light: RawTheme;
+            dark: RawTheme;
+        };
+    };
+    /** 主页设置 */
+    home?: {
+        /**
+         * 每页文章数量
+         * @default 10
+         */
+        articlesPrePage?: number;
+        logo?: {
+            viewBox: string;
+            g: string;
+        };
+        slogan?: string;
+    };
+    imageCache?: {
+        /**
+         * 图像元数据缓存路径
+         * @description
+         * 支持绝对路径和相对路径，相对路径将以工作目录为起点。
+         * 默认为工作目录下 `image-metadata.sqlite`。
+         */
+        metadata?: string;
+        /**
+         * 优化版图像缓存路径
+         * @description
+         * 支持绝对路径和相对路径，相对路径将以工作目录为起点。
+         * 默认为工作目录下 `cache`。
+         */
+        optimized?: string;
+    };
+    cdn?: {
+        /** @default 'https://unpkg.com/katex@0.16.21/dist/katex.min.css' */
+        katex?: string;
+        /** @default 'https://unpkg.com/@waline/client@v3/dist/waline.css' */
+        walineCSS?: string;
+        /** @default 'https://unpkg.com/@waline/client@v3/dist/waline.js' */
+        walineJS?: string;
+    };
+    /** HTML 头部插入内容 */
+    inject?: string;
+    /** IndexNow 配置 */
+    indexNow?: {
+        /** Bing IndexNow 密钥 */
+        bing?: string;
+        /** Yandex IndexNow 密钥 */
+        yandex?: string;
+    };
+    /** Waline 评论配置 */
+    waline?: {
+        /** 后端地址 */
+        serverURL: string;
+        visitor?: boolean;
+        commentCount?: boolean;
+        pageview?: boolean;
+        emoji?: string[];
+        reaction?: string[];
+    };
+}
+export declare function setThemeConfig(cfg?: ThemeConfig): void;
+export declare function getThemeConfig(): ThemeConfig;

package/dist/feed.d.ts

@@ -0,0 +1,4 @@
+import { Article, Category } from 'ezal';
+export declare function initFeed(): void;
+export declare function updateFeedItem(article: Article): void;
+export declare function updateFeedCategory(category: Category): void;

package/dist/image/asset.d.ts

@@ -0,0 +1,22 @@
+import { type Asset, VirtualAssets } from 'ezal';
+import Sharp from 'sharp';
+declare const OPTIMIZE: {
+    readonly '.avif': (sharp: Sharp.Sharp) => Promise<Buffer<ArrayBufferLike>>;
+    readonly '.webp': (sharp: Sharp.Sharp) => Promise<Buffer<ArrayBufferLike>>;
+    readonly '.jxl': (sharp: Sharp.Sharp) => Promise<Buffer<ArrayBufferLike>>;
+    readonly '.jpg': (sharp: Sharp.Sharp) => Promise<Buffer<ArrayBufferLike>>;
+    readonly '.png': (sharp: Sharp.Sharp) => Promise<Buffer<ArrayBufferLike>>;
+    readonly '.gif': (sharp: Sharp.Sharp) => Promise<Buffer<ArrayBufferLike>>;
+};
+export type OptimizedImageExt = keyof typeof OPTIMIZE;
+export declare class OptimizedImage extends VirtualAssets {
+    #private;
+    /**
+     * @param asset 源资源
+     * @param target 目标优化格式
+     */
+    constructor(asset: Asset, ext: OptimizedImageExt);
+    build(): Promise<Buffer<ArrayBufferLike> | import("fs").ReadStream>;
+    protected onDependenciesChanged(): void;
+}
+export {};

package/dist/image/db.d.ts

@@ -0,0 +1,18 @@
+export interface ImageMetadata {
+    path: string;
+    hash: string;
+    width: number;
+    height: number;
+    color: string | null;
+}
+declare function getMetadata(url: string): ImageMetadata | null;
+declare function updateMetadata(data: ImageMetadata): boolean;
+declare function deleteMetadata(url: string): boolean;
+declare function initImageMetadataDB(): void;
+export declare const imageDB: {
+    init: typeof initImageMetadataDB;
+    get: typeof getMetadata;
+    update: typeof updateMetadata;
+    delete: typeof deleteMetadata;
+};
+export {};

package/dist/image/index.d.ts

@@ -0,0 +1,10 @@
+import { type Asset } from 'ezal';
+import { type ImageMetadata } from './db';
+export interface ImageInfo {
+    metadata: ImageMetadata | null;
+    rule?: string[];
+}
+export declare function getImageInfo(url: string): ImageInfo | null;
+export declare function imageAddHook(asset: Asset): Promise<void>;
+export declare function imageUpdateHook(asset: Asset): Promise<void>;
+export declare function imageRemoveHook(asset: Asset): void;

package/dist/image/metadata.d.ts

@@ -0,0 +1,2 @@
+import type { Asset } from 'ezal';
+export declare function updateImageMetadata(asset: Asset): Promise<boolean>;

package/dist/image/utils.d.ts

@@ -0,0 +1 @@
+export declare function getOptimizedPath(filepath: string, ext: string): string;

package/dist/index-now.d.ts

@@ -0,0 +1 @@
+export declare function exeIndexNow(): Promise<void>;

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import type { ThemeConfig as EzalThemeConfig } from 'ezal';
+import { type ThemeConfig } from './config';
+export declare function theme(config?: ThemeConfig): Promise<EzalThemeConfig>;