@anglefeint/astro-theme 0.1.15 → 0.1.17

package/README.md

@@ -1,6 +1,7 @@
 ---
 doc_id: package_readme
 doc_role: package-guide
+doc_purpose: Package-level install, upgrade, and manual integration reference for advanced users.
 doc_scope: [package-install, package-upgrade, package-usage]
 update_triggers: [package-change, command-change, export-change]
 source_of_truth: true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anglefeint/astro-theme",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "type": "module",
   "description": "Anglefeint core theme package for Astro",
   "keywords": [
@@ -13,6 +13,9 @@
     "matrix"
   ],
   "license": "MIT",
+  "engines": {
+    "node": ">=22.12.0"
+  },
   "files": [
     "src/index.ts",
     "src/consts.ts",
@@ -43,6 +46,6 @@
     "./consts": "./src/consts.ts"
   },
   "peerDependencies": {
-    "astro": "^5.0.0"
+    "astro": "^5.0.0 || ^6.0.0-beta.0"
   }
 }

package/src/cli-new-page.mjs

@@ -1,54 +1,15 @@
 import { access, mkdir, writeFile } from 'node:fs/promises';
 import { constants } from 'node:fs';
 import path from 'node:path';
+import {
+	buildNewPageTemplate,
+	isValidNewPageTheme,
+	parseNewPageArgs,
+	usageNewPage,
+	validatePageSlug,
+} from './scaffold/new-page.mjs';
 
-const THEMES = ['base', 'cyber', 'ai', 'hacker', 'matrix'];
 const PAGES_ROOT = path.resolve(process.cwd(), 'src/pages/[lang]');
-const LAYOUT_BY_THEME = {
-	base: 'BasePageLayout',
-	ai: 'AiPageLayout',
-	cyber: 'CyberPageLayout',
-	hacker: 'HackerPageLayout',
-	matrix: 'MatrixPageLayout',
-};
-
-function usage() {
-	console.error('Usage: npm run new-page -- <slug> [--theme <base|cyber|ai|hacker|matrix>]');
-}
-
-function parseArgs(argv) {
-	const args = argv.slice(2);
-	const positional = [];
-	let theme = 'base';
-
-	for (let i = 0; i < args.length; i += 1) {
-		const token = args[i];
-		if (token === '--theme') {
-			theme = args[i + 1] ?? '';
-			i += 1;
-			continue;
-		}
-		positional.push(token);
-	}
-
-	return { slug: positional[0], theme };
-}
-
-function validateSlug(slug) {
-	if (!slug) return false;
-	if (slug.startsWith('/') || slug.endsWith('/')) return false;
-	const parts = slug.split('/');
-	return parts.every((part) => /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(part));
-}
-
-function toTitleFromSlug(slug) {
-	const leaf = slug.split('/').pop() ?? slug;
-	return leaf
-		.split('-')
-		.filter(Boolean)
-		.map((segment) => segment[0].toUpperCase() + segment.slice(1))
-		.join(' ');
-}
 
 async function exists(filePath) {
 	try {
@@ -59,42 +20,20 @@ async function exists(filePath) {
 	}
 }
 
-function templateFor({ slug, theme }) {
-	const title = toTitleFromSlug(slug) || 'New Page';
-	const layoutName = LAYOUT_BY_THEME[theme];
-	return `---
-import type { GetStaticPaths } from 'astro';
-import ${layoutName} from '@anglefeint/astro-theme/layouts/${layoutName}.astro';
-import { SUPPORTED_LOCALES } from '@anglefeint/astro-theme/i18n/config';
-
-export const getStaticPaths = (() => SUPPORTED_LOCALES.map((lang) => ({ params: { lang } }))) satisfies GetStaticPaths;
-
-const locale = Astro.params.lang;
-const pageTitle = '${title}';
-const pageDescription = 'A custom page built from the ${theme} theme shell.';
----
-
-<${layoutName} locale={locale} title={pageTitle} description={pageDescription}>
-\t<h1>${title}</h1>
-\t<p>Replace this content with your own page content.</p>
-</${layoutName}>
-`;
-}
-
 async function main() {
-	const { slug, theme: rawTheme } = parseArgs(process.argv);
+	const { slug, theme: rawTheme } = parseNewPageArgs(process.argv);
 	const theme = String(rawTheme || '').toLowerCase();
 
 	if (!slug) {
-		usage();
+		console.error(usageNewPage());
 		process.exit(1);
 	}
-	if (!validateSlug(slug)) {
+	if (!validatePageSlug(slug)) {
 		console.error('Invalid page slug. Use lowercase letters, numbers, hyphens, and optional nested paths.');
 		process.exit(1);
 	}
-	if (!THEMES.includes(theme)) {
-		console.error(`Invalid theme "${rawTheme}". Use one of: ${THEMES.join(', ')}.`);
+	if (!isValidNewPageTheme(theme)) {
+		console.error('Invalid theme. Use one of: base, cyber, ai, hacker, matrix.');
 		process.exit(1);
 	}
 
@@ -109,7 +48,7 @@ async function main() {
 	await mkdir(targetDir, { recursive: true });
 	await writeFile(
 		targetPath,
-		templateFor({ slug, theme }),
+		buildNewPageTemplate({ slug, theme }),
 		'utf8',
 	);
 

package/src/cli-new-post.mjs

@@ -1,47 +1,18 @@
-import { mkdir, writeFile, access, readdir } from 'node:fs/promises';
+import { mkdir, writeFile, access } from 'node:fs/promises';
 import { constants } from 'node:fs';
 import path from 'node:path';
 import { SUPPORTED_LOCALES } from './i18n/locales.mjs';
+import {
+	buildNewPostTemplate,
+	loadDefaultCovers,
+	pickDefaultCoverBySlug,
+	usageNewPost,
+	validatePostSlug,
+} from './scaffold/new-post.mjs';
 
 const CONTENT_ROOT = path.resolve(process.cwd(), 'src/content/blog');
 const DEFAULT_COVERS_ROOT = path.resolve(process.cwd(), 'src/assets/blog/default-covers');
 
-function toTitleFromSlug(slug) {
-	return slug
-		.split('-')
-		.filter(Boolean)
-		.map((segment) => segment[0].toUpperCase() + segment.slice(1))
-		.join(' ');
-}
-
-function validateSlug(slug) {
-	return /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(slug);
-}
-
-function hashString(input) {
-	let hash = 5381;
-	for (let i = 0; i < input.length; i += 1) {
-		hash = ((hash << 5) + hash + input.charCodeAt(i)) >>> 0;
-	}
-	return hash >>> 0;
-}
-
-function normalizePathForFrontmatter(filePath) {
-	return filePath.split(path.sep).join('/');
-}
-
-async function loadDefaultCovers() {
-	try {
-		const entries = await readdir(DEFAULT_COVERS_ROOT, { withFileTypes: true });
-		return entries
-			.filter((entry) => entry.isFile() && /\.(webp|png|jpe?g)$/i.test(entry.name))
-			.map((entry) => path.join(DEFAULT_COVERS_ROOT, entry.name))
-			.sort((a, b) => a.localeCompare(b));
-	} catch {
-		return [];
-	}
-}
-
 async function exists(filePath) {
 	try {
 		await access(filePath, constants.F_OK);
@@ -51,54 +22,20 @@ async function exists(filePath) {
 	}
 }
 
-function templateFor(locale, slug, pubDate, heroImage) {
-	const titleByLocale = {
-		en: toTitleFromSlug(slug),
-		ja: '新しい記事タイトル',
-		ko: '새 글 제목',
-		es: 'Título del nuevo artículo',
-		zh: '新文章标题',
-	};
-	const descriptionByLocale = {
-		en: `A short EN post scaffold for "${slug}".`,
-		ja: `「${slug}」用の短い日本語記事テンプレートです。`,
-		ko: `"${slug}"용 한국어 글 템플릿입니다.`,
-		es: `Plantilla breve en español para "${slug}".`,
-		zh: `“${slug}”的中文文章模板。`,
-	};
-	const bodyByLocale = {
-		en: `Write your EN content for "${slug}" here.`,
-		ja: `ここに「${slug}」の日本語本文を書いてください。`,
-		ko: `여기에 "${slug}" 한국어 본문을 작성하세요.`,
-		es: `Escribe aquí el contenido en español para "${slug}".`,
-		zh: `请在这里填写“${slug}”的中文正文。`,
-	};
-	return `---
-title: '${titleByLocale[locale]}'
-subtitle: ''
-description: '${descriptionByLocale[locale]}'
-pubDate: '${pubDate}'
-${heroImage ? `heroImage: '${heroImage}'` : ''}
----
-
-${bodyByLocale[locale]}
-`;
-}
-
 async function main() {
 	const slug = process.argv[2];
 	if (!slug) {
-		console.error('Usage: npm run new-post -- <slug>');
+		console.error(usageNewPost());
 		process.exit(1);
 	}
 
-	if (!validateSlug(slug)) {
+	if (!validatePostSlug(slug)) {
 		console.error('Invalid slug. Use lowercase letters, numbers, and hyphens only.');
 		process.exit(1);
 	}
 
 	const pubDate = new Date().toISOString().slice(0, 10);
-	const defaultCovers = await loadDefaultCovers();
+	const defaultCovers = await loadDefaultCovers(DEFAULT_COVERS_ROOT);
 	const created = [];
 	const skipped = [];
 
@@ -112,13 +49,9 @@ async function main() {
 			continue;
 		}
 
-		let heroImage = '';
-		if (defaultCovers.length > 0) {
-			const coverPath = defaultCovers[hashString(slug) % defaultCovers.length];
-			heroImage = normalizePathForFrontmatter(path.relative(localeDir, coverPath));
-		}
+		const heroImage = pickDefaultCoverBySlug(slug, localeDir, defaultCovers);
 
-		await writeFile(filePath, templateFor(locale, slug, pubDate, heroImage), 'utf8');
+		await writeFile(filePath, buildNewPostTemplate(locale, slug, pubDate, heroImage), 'utf8');
 		created.push(filePath);
 	}
 

package/src/content-schema.ts

@@ -1,5 +1,6 @@
-import { defineCollection, z } from 'astro:content';
+import { defineCollection } from 'astro:content';
 import { glob } from 'astro/loaders';
+import { z } from 'astro/zod';
 
 const blog = defineCollection({
 	// Load Markdown and MDX files in the `src/content/blog/` directory.
@@ -26,7 +27,7 @@ const blog = defineCollection({
 				author: z.string().optional(),
 				tags: z.array(z.string()).optional(),
 				canonicalTopic: z.string().optional(),
-				sourceLinks: z.array(z.string().url()).optional(),
+				sourceLinks: z.array(z.url()).optional(),
 			}),
 });
 

package/src/i18n/messages.ts

@@ -1,6 +1,6 @@
 import type { Locale } from './config';
 
-type Messages = {
+export type Messages = {
 	siteTitle: string;
 	siteDescription: string;
 	langLabel: string;
@@ -39,7 +39,7 @@ type Messages = {
 	};
 };
 
-const MESSAGES: Record<Locale, Messages> = {
+export const DEFAULT_MESSAGES: Record<Locale, Messages> = {
 	en: {
 		siteTitle: 'Angle Feint',
 		siteDescription: 'Cinematic web interfaces and AI-era engineering essays.',
@@ -208,5 +208,5 @@ const MESSAGES: Record<Locale, Messages> = {
 };
 
 export function getMessages(locale: Locale): Messages {
-	return MESSAGES[locale];
+	return DEFAULT_MESSAGES[locale];
 }