@mintfolio/theme-verdant 0.2.0

package/styles/themes/happyhues/theme.css

@@ -0,0 +1,225 @@
+:root {
+  --font-display: 'Playfair Display', 'Noto Sans SC', 'PingFang SC', 'Microsoft YaHei', serif;
+  --font-family: 'Inter', 'Noto Sans SC', 'PingFang SC', 'Microsoft YaHei', system-ui, sans-serif;
+  --font-mono: 'JetBrains Mono', 'Fira Code', 'Cascadia Code', monospace;
+  --section-padding: 5rem 1.5rem;
+  --max-width: 1200px;
+  --radius-sm: 10px;
+  --radius-md: 18px;
+  --radius-lg: 24px;
+  --radius-full: 9999px;
+  --transition-fast: 150ms ease;
+  --transition-base: 250ms ease;
+  --transition-slow: 400ms ease;
+}
+
+/* Primary is for readable actions; accent and play add decorative contrast. */
+
+/* 1. 青柠薄荷 */
+:root, [data-theme="light-1"] {
+  --color-bg: #f6f8ef;
+  --color-surface: #fffef9;
+  --color-text: #243d36;
+  --color-text-muted: #556660;
+  --color-primary: #08765f;
+  --color-accent: #ff795f;
+  --color-play: #e1ee79;
+}
+
+[data-theme="dark-1"] {
+  --color-bg: #132622;
+  --color-surface: #1c342e;
+  --color-text: #edf4e5;
+  --color-text-muted: #adc5b9;
+  --color-primary: #73e0b7;
+  --color-accent: #ff9983;
+  --color-play: #d5e67b;
+}
+
+/* 2. 橘子汽水 */
+[data-theme="light-2"] {
+  --color-bg: #fff7ee;
+  --color-surface: #fffdfa;
+  --color-text: #45302b;
+  --color-text-muted: #6e564e;
+  --color-primary: #b7441c;
+  --color-accent: #526ce0;
+  --color-play: #ffc65c;
+}
+
+[data-theme="dark-2"] {
+  --color-bg: #2b211e;
+  --color-surface: #3a2d27;
+  --color-text: #fff1e3;
+  --color-text-muted: #d4b9a8;
+  --color-primary: #ffad83;
+  --color-accent: #9daeff;
+  --color-play: #ffd277;
+}
+
+/* 3. 晴空海盐 */
+[data-theme="light-3"] {
+  --color-bg: #f5f6ff;
+  --color-surface: #fdfdff;
+  --color-text: #283451;
+  --color-text-muted: #5e6981;
+  --color-primary: #3454cd;
+  --color-accent: #ff9163;
+  --color-play: #cddd76;
+}
+
+[data-theme="dark-3"] {
+  --color-bg: #182035;
+  --color-surface: #232e48;
+  --color-text: #eef2ff;
+  --color-text-muted: #b5c0dc;
+  --color-primary: #a5baff;
+  --color-accent: #ffa779;
+  --color-play: #d6e596;
+}
+
+/* 4. 葡萄跳跳糖 */
+[data-theme="light-4"] {
+  --color-bg: #faf5ff;
+  --color-surface: #fffaff;
+  --color-text: #3f3052;
+  --color-text-muted: #746180;
+  --color-primary: #7441bc;
+  --color-accent: #bbd94f;
+  --color-play: #ffadca;
+}
+
+[data-theme="dark-4"] {
+  --color-bg: #251e33;
+  --color-surface: #342a46;
+  --color-text: #f5edff;
+  --color-text-muted: #c6b3d9;
+  --color-primary: #d0acff;
+  --color-accent: #c9e477;
+  --color-play: #f7aaca;
+}
+
+/* 5. 莓果奶昔 */
+[data-theme="light-5"] {
+  --color-bg: #fff5f6;
+  --color-surface: #fffafb;
+  --color-text: #4d2f3b;
+  --color-text-muted: #805e6b;
+  --color-primary: #ba375e;
+  --color-accent: #73cec2;
+  --color-play: #f5c75c;
+}
+
+[data-theme="dark-5"] {
+  --color-bg: #2d202a;
+  --color-surface: #402d38;
+  --color-text: #ffeef3;
+  --color-text-muted: #dec0ce;
+  --color-primary: #ffabc7;
+  --color-accent: #8ad9c9;
+  --color-play: #f6d47e;
+}
+
+/* 6. 向日葵 */
+[data-theme="light-6"] {
+  --color-bg: #fff9e9;
+  --color-surface: #fffdf6;
+  --color-text: #473d26;
+  --color-text-muted: #6b5d43;
+  --color-primary: #91600c;
+  --color-accent: #4364cc;
+  --color-play: #f2c94c;
+}
+
+[data-theme="dark-6"] {
+  --color-bg: #29251b;
+  --color-surface: #393326;
+  --color-text: #fff4d9;
+  --color-text-muted: #cdc0a0;
+  --color-primary: #edcc75;
+  --color-accent: #9bb3ff;
+  --color-play: #ffb880;
+}
+
+/* 7. 海岛假日 */
+[data-theme="light-7"] {
+  --color-bg: #eff9fb;
+  --color-surface: #faffff;
+  --color-text: #253f47;
+  --color-text-muted: #4c6871;
+  --color-primary: #087387;
+  --color-accent: #f48652;
+  --color-play: #aadad0;
+}
+
+[data-theme="dark-7"] {
+  --color-bg: #15272e;
+  --color-surface: #203840;
+  --color-text: #e7f5f5;
+  --color-text-muted: #afc7cc;
+  --color-primary: #80dbe4;
+  --color-accent: #ffa875;
+  --color-play: #addbd1;
+}
+
+/* 8. 午夜游乐场 */
+[data-theme="light-8"] {
+  --color-bg: #f5f5f2;
+  --color-surface: #fdfdfa;
+  --color-text: #30394b;
+  --color-text-muted: #5c6370;
+  --color-primary: #394860;
+  --color-accent: #ffbb3b;
+  --color-play: #a4b8ec;
+}
+
+[data-theme="dark-8"] {
+  --color-bg: #1a202c;
+  --color-surface: #282f3e;
+  --color-text: #f0f1ee;
+  --color-text-muted: #b7bfce;
+  --color-primary: #c3d0ee;
+  --color-accent: #ffcb67;
+  --color-play: #9db5ef;
+}
+
+:root {
+  color-scheme: light;
+  --color-on-primary: #ffffff;
+  --color-secondary: var(--color-text);
+  --color-text-headline: var(--color-text);
+  --color-bg-alt: color-mix(in srgb, var(--color-primary) 7%, var(--color-bg));
+  --color-border: color-mix(in srgb, var(--color-text) 19%, var(--color-surface));
+  --color-tag-bg: color-mix(in srgb, var(--color-primary) 10%, var(--color-surface));
+  --color-tag-text: var(--color-primary);
+  --color-accent-soft: color-mix(in srgb, var(--color-accent) 22%, var(--color-surface));
+  --color-play-soft: color-mix(in srgb, var(--color-play) 32%, var(--color-surface));
+  --shadow-sm: 0 2px 0 color-mix(in srgb, var(--color-text) 7%, transparent);
+  --shadow-md: 0 8px 24px color-mix(in srgb, var(--color-text) 8%, transparent);
+  --shadow-lg: 0 18px 48px color-mix(in srgb, var(--color-text) 12%, transparent);
+  --shadow-offset: 6px 6px 0 var(--color-accent-soft);
+}
+
+[data-theme^="dark-"] {
+  color-scheme: dark;
+  --color-on-primary: #18252d;
+  --color-accent-soft: color-mix(in srgb, var(--color-accent) 17%, var(--color-surface));
+  --color-play-soft: color-mix(in srgb, var(--color-play) 17%, var(--color-surface));
+  --shadow-sm: 0 2px 0 #00000024;
+  --shadow-md: 0 8px 24px #00000024;
+  --shadow-lg: 0 18px 48px #00000038;
+}
+
+@media (prefers-color-scheme: dark) {
+  :root:not([data-theme]) {
+    color-scheme: dark;
+    --color-bg: #132622;
+    --color-surface: #1c342e;
+    --color-text: #edf4e5;
+    --color-text-muted: #adc5b9;
+    --color-primary: #73e0b7;
+    --color-accent: #ff9983;
+    --color-play: #d5e67b;
+    --color-on-primary: #18252d;
+  }
+}

package/theme.mjs

@@ -0,0 +1,60 @@
+// @ts-check
+import { defineTheme } from '@mintfolio/theme-api';
+
+/** @param {string} label @param {string} [value] @returns {import('@mintfolio/theme-api').StringSetting} */
+const text = (label, value = '') => ({ type: 'string', label, default: value });
+/** @param {string} label @param {boolean} value @returns {import('@mintfolio/theme-api').BooleanSetting} */
+const flag = (label, value) => ({ type: 'boolean', label, default: value });
+
+/** All layout, typography, cards, reading tools, and palette controls belong to this theme. */
+export default defineTheme({
+  manifest: {
+    id: 'verdant',
+    name: 'Verdant',
+    version: '0.2.0',
+    author: 'Mintfolio contributors',
+    description: 'Portfolio hero, article cards, reading tools, and eight visitor-selectable palettes.',
+    engine: '^1.0.0',
+  },
+  capabilities: { encryptedPosts: true, search: true, tags: true, categories: true, toc: true, darkMode: true },
+  build: { react: true, tailwind: true },
+  pages: {
+    home: './pages/home.astro',
+    post: './pages/post.astro',
+    archive: './pages/archive.astro',
+    page: './pages/page.astro',
+  },
+  settings: {
+    initialMode: { type: 'select', label: '初始明暗模式', default: 'auto', options: ['auto', 'light', 'dark'] },
+    initialPalette: { type: 'select', label: '初始配色', default: '1', options: ['1', '2', '3', '4', '5', '6', '7', '8'] },
+    homePageSize: { type: 'number', label: '首页初始文章数', default: 6, min: 1, max: 100 },
+    archivePageSize: { type: 'number', label: '归档初始文章数', default: 8, min: 1, max: 100 },
+    analyticsId: text('Google Analytics ID'),
+    sidebar: {
+      type: 'object', label: '侧边栏', default: {}, properties: {
+        sections: { type: 'object', label: '显示区域', default: {}, properties: {
+          contact: flag('联系方式', true), activity: flag('最近动态', true), tools: flag('推荐工具', true),
+        } },
+        tools: { type: 'array', label: '推荐工具', default: [], items: {
+          type: 'object', label: '工具', default: {}, properties: { name: text('名称'), description: text('简介'), url: text('地址') },
+        } },
+        quote: { type: 'object', label: '引言', default: {}, properties: {
+          enabled: flag('显示引言', false), text: text('内容'), author: text('作者'),
+        } },
+      },
+    },
+    home: { type: 'object', label: '首页', default: {}, properties: {
+      hotContent: { type: 'object', label: '推荐文章', default: {}, properties: {
+        enabled: flag('显示推荐文章', false),
+        items: { type: 'array', label: '文章列表', default: [], items: {
+          type: 'object', label: '文章', default: {}, properties: { postId: text('文章 ID'), image: text('图片地址') },
+        } },
+      } },
+    } },
+    article: { type: 'object', label: '文章', default: {}, properties: {
+      footerImage: { type: 'object', label: '文末插图', default: {}, properties: {
+        enabled: flag('显示文末插图', false), src: text('图片地址（为空时使用站点头像）'),
+      } },
+    } },
+  },
+});

package/utils/blogNavigation.ts

@@ -0,0 +1,3 @@
+/** Verdant's existing storage key is presentation navigation state. */
+export const ARTICLE_BACK_NAV_STORAGE_KEY = 'article-back-target';
+export { resolveStoredArticleBackHref, shouldPersistArticleBackHref } from '@mintfolio/core/client';

package/utils/homeReturnHint.ts

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview Home return hint utilities for managing the "return to hero" hint display state.
+ * Controls when to show the hint button that appears when the hero section is collapsed on the home page.
+ */
+
+/**
+ * Local storage key for tracking whether the home return hint has been dismissed.
+ * Once dismissed, the hint won't show again on subsequent visits.
+ */
+export const HOME_RETURN_HINT_STORAGE_KEY = 'home-return-hint-dismissed';
+
+/**
+ * Determines whether the home return hint should be displayed.
+ * 
+ * The hint is shown only once per user - after they see it and it auto-dismisses,
+ * the value is set to '1' in localStorage and the hint won't appear again.
+ * 
+ * @param storageValue - The current value from localStorage (null if not set)
+ * @returns True if the hint should be shown (not yet dismissed)
+ * 
+ * @example
+ * ```ts
+ * const showHint = shouldShowHomeReturnHint(
+ *   localStorage.getItem('home-return-hint-dismissed')
+ * );
+ * if (showHint) {
+ *   // Display the hint and mark as dismissed
+ *   localStorage.setItem('home-return-hint-dismissed', '1');
+ * }
+ * ```
+ */
+export function shouldShowHomeReturnHint(storageValue: string | null): boolean {
+  return storageValue !== '1';
+}

package/utils/storage.ts

@@ -0,0 +1,16 @@
+/** Privacy settings may deny storage; navigation and theme controls must still work. */
+export function readStorage(kind: 'local' | 'session', key: string): string | null {
+  try {
+    return window[`${kind}Storage`].getItem(key);
+  } catch {
+    return null;
+  }
+}
+
+export function writeStorage(kind: 'local' | 'session', key: string, value: string): void {
+  try {
+    window[`${kind}Storage`].setItem(key, value);
+  } catch {
+    /* Optional persistence. */
+  }
+}

package/utils/types.ts

@@ -0,0 +1,8 @@
+import type { SearchEntry } from '@mintfolio/theme-api';
+
+export type { PostFilters } from '@mintfolio/theme-api';
+
+/** The Verdant Theme attaches a card element to the SDK's public search entry. */
+export interface PostItem extends SearchEntry {
+  element: HTMLElement;
+}