@anglefeint/astro-theme 0.1.17 → 0.1.18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anglefeint/astro-theme",
-  "version": "0.1.17",
+  "version": "0.1.18",
   "type": "module",
   "description": "Anglefeint core theme package for Astro",
   "keywords": [
@@ -26,6 +26,7 @@
     "src/scripts",
     "src/i18n",
     "src/styles",
+    "src/utils",
     "src/assets/theme",
     "src/cli-new-post.mjs",
     "src/cli-new-page.mjs"
@@ -42,6 +43,8 @@
     "./i18n/*": "./src/i18n/*",
     "./styles/*": "./src/styles/*",
     "./assets/*": "./src/assets/*",
+    "./utils/merge": "./src/utils/merge.ts",
+    "./utils/*": "./src/utils/*",
     "./content-schema": "./src/content-schema.ts",
     "./consts": "./src/consts.ts"
   },

package/src/cli-new-post.mjs

@@ -5,7 +5,9 @@ import { SUPPORTED_LOCALES } from './i18n/locales.mjs';
 import {
 	buildNewPostTemplate,
 	loadDefaultCovers,
+	parseNewPostArgs,
 	pickDefaultCoverBySlug,
+	resolveLocales,
 	usageNewPost,
 	validatePostSlug,
 } from './scaffold/new-post.mjs';
@@ -23,7 +25,7 @@ async function exists(filePath) {
 }
 
 async function main() {
-	const slug = process.argv[2];
+	const { slug, locales: cliLocales } = parseNewPostArgs(process.argv);
 	if (!slug) {
 		console.error(usageNewPost());
 		process.exit(1);
@@ -36,10 +38,15 @@ async function main() {
 
 	const pubDate = new Date().toISOString().slice(0, 10);
 	const defaultCovers = await loadDefaultCovers(DEFAULT_COVERS_ROOT);
+	const locales = resolveLocales({
+		cliLocales,
+		envLocales: process.env.ANGLEFEINT_LOCALES ?? '',
+		defaultLocales: SUPPORTED_LOCALES,
+	});
 	const created = [];
 	const skipped = [];
 
-	for (const locale of SUPPORTED_LOCALES) {
+	for (const locale of locales) {
 		const localeDir = path.join(CONTENT_ROOT, locale);
 		const filePath = path.join(localeDir, `${slug}.md`);
 		await mkdir(localeDir, { recursive: true });

package/src/config/theme.ts

@@ -8,4 +8,8 @@ export const THEME = {
 	HOME_LATEST_COUNT: 3,
 	/** Whether to enable the About page (disable to hide from nav/routes if needed) */
 	ENABLE_ABOUT_PAGE: true,
+	/** Optional visual effects switches */
+	EFFECTS: {
+		ENABLE_RED_QUEEN: true,
+	},
 } as const;

package/src/layouts/BlogPost.astro

@@ -7,6 +7,7 @@ import FormattedDate from '../components/FormattedDate.astro';
 import AiShell from './shells/AiShell.astro';
 import blogPostCssUrl from '../styles/blog-post.css?url';
 import { SITE_AUTHOR } from '@anglefeint/site-config/site';
+import { THEME } from '@anglefeint/site-config/theme';
 import { DEFAULT_LOCALE, type Locale, isLocale, localePath, blogIdToSlugAnyLocale } from '@anglefeint/site-i18n/config';
 import { getMessages } from '@anglefeint/site-i18n/messages';
 
@@ -49,6 +50,7 @@ const hasSystemMeta = Boolean(aiModel || aiMode || aiState);
 const hasResponseMeta = aiLatencyMs !== undefined || aiConfidence !== undefined;
 const hasStats = aiModel || wordCount !== undefined || tokenCount !== undefined;
 const confidenceText = aiConfidence !== undefined ? aiConfidence.toFixed(2) : undefined;
+const enableRedQueen = THEME.EFFECTS.ENABLE_RED_QUEEN;
 ---
 
 <AiShell
@@ -79,11 +81,13 @@ const confidenceText = aiConfidence !== undefined ? aiConfidence.toFixed(2) : un
 			</div>
 			<canvas class="ai-network-canvas" aria-hidden="true"></canvas>
 		</div>
-		<aside class="rq-tv rq-tv-collapsed">
-			<div class="rq-tv-stage" data-rq-src={themeRedqueen1.src} data-rq-src2={themeRedqueen2.src}></div>
-			<div class="rq-tv-badge">monitor feed<span class="rq-tv-dot"></span></div>
-			<button type="button" class="rq-tv-toggle" aria-label="Replay monitor feed" aria-expanded="false">▶</button>
-		</aside>
+		{enableRedQueen && (
+			<aside class="rq-tv rq-tv-collapsed">
+				<div class="rq-tv-stage" data-rq-src={themeRedqueen1.src} data-rq-src2={themeRedqueen2.src}></div>
+				<div class="rq-tv-badge">monitor feed<span class="rq-tv-dot"></span></div>
+				<button type="button" class="rq-tv-toggle" aria-label="Replay monitor feed" aria-expanded="false">▶</button>
+			</aside>
+		)}
 		<div class="ai-read-progress" aria-hidden="true"></div>
 		<button type="button" class="ai-back-to-top" aria-label="Back to top" title="Back to top">↑</button>
 		<div class="ai-stage-toast" aria-live="polite" aria-atomic="true"></div>

package/src/scripts/blogpost-effects.js

@@ -17,6 +17,8 @@ export function initBlogpostEffects() {
   initReadProgressAndBackToTop(prefersReducedMotion);
   initNetworkCanvas(prefersReducedMotion);
   initHeroCanvas(prefersReducedMotion);
-  initRedQueenTv(prefersReducedMotion);
+  if (document.querySelector('.rq-tv-stage')) {
+    initRedQueenTv(prefersReducedMotion);
+  }
   initPostInteractions(prefersReducedMotion);
 }

package/src/utils/merge.ts

@@ -0,0 +1,31 @@
+export type DeepPartial<T> = {
+	[K in keyof T]?: T[K] extends Array<infer U>
+		? Array<DeepPartial<U>>
+		: T[K] extends object
+			? DeepPartial<T[K]>
+			: T[K];
+};
+
+export function isPlainObject(value: unknown): value is Record<string, unknown> {
+	return Object.prototype.toString.call(value) === '[object Object]';
+}
+
+export function deepMerge<T>(base: T, override: DeepPartial<T>): T {
+	if (!isPlainObject(base) || !isPlainObject(override)) return (override as T) ?? base;
+
+	const result: Record<string, unknown> = { ...(base as Record<string, unknown>) };
+	for (const [key, value] of Object.entries(override)) {
+		if (value === undefined) continue;
+		const existing = result[key];
+		if (Array.isArray(value)) {
+			result[key] = value;
+			continue;
+		}
+		if (isPlainObject(existing) && isPlainObject(value)) {
+			result[key] = deepMerge(existing, value);
+			continue;
+		}
+		result[key] = value;
+	}
+	return result as T;
+}