@san-siva/blogkit-md 0.1.2 → 0.2.1

package/README.md

@@ -123,7 +123,7 @@ description: A short description shown below the title
 | Image                | `![alt](url)`                                  |
 | Ordered list         | `1. item`                                      |
 | Unordered list       | `- item`                                       |
-| Table                | GFM table syntax                               |
+| Table                | `\| col \| col \|` — headers and rows only     |
 | Code block           | ` ```lang `                                    |
 | Mermaid diagram      | ` ```mermaid `                                 |
 | Thematic break       | `---`                                          |
@@ -259,13 +259,13 @@ Result content.
 
 ### Callouts
 
-Blockquotes are rendered as styled callout banners. The callout type is controlled by a prefix on the first word of the quote:
+Blockquotes are rendered as styled callout banners. The callout type is controlled by a prefix on the first word of the quote.
 
-| Syntax    | Callout Type | Example                      |
-| :-------- | :----------- | :--------------------------- |
-| `> text`  | Info         | `> This is an info callout.` |
-| `> ~text` | Warning      | `> ~This is a warning.`      |
-| `> !text` | Error        | `> !This is an error.`       |
+> This is an info callout. Use `> text` for general information.
+
+> ~This is a warning callout. Use `> ~text` to flag caution.
+
+> !This is an error callout. Use `> !text` for errors or destructive actions.
 
 The prefix character is stripped from the rendered output — only the callout style changes.
 

package/hooks/readMarkdownFile.ts

@@ -1,11 +1,10 @@
 import { readFile } from 'node:fs/promises';
 import path from 'node:path';
 
-import '@/utils/devReloadTrigger';
-import type { Frontmatter } from '@/utils/parseMarkdown';
-import { parseMarkdown } from '@/utils/parseMarkdown';
-import type { RenderedMarkdown } from '@/utils/renderMarkdown';
-import { renderMarkdownAst } from '@/utils/renderMarkdown';
+import type { Frontmatter } from '../utils/parseMarkdown';
+import { parseMarkdown } from '../utils/parseMarkdown';
+import type { RenderedMarkdown } from '../utils/renderMarkdown';
+import { renderMarkdownAst } from '../utils/renderMarkdown';
 
 type MarkdownFileResult =
 	| { success: true; rendered: RenderedMarkdown; frontmatter: Frontmatter }
@@ -15,14 +14,12 @@ export const readMarkdownFile = async (
 	filePath: string | undefined
 ): Promise<MarkdownFileResult> => {
 	if (!filePath) {
-		return {
-			success: false,
-			error:
-				'MARKDOWN_FILE env variable is required. Usage: MARKDOWN_FILE=data/test.md npm run dev',
-		};
+		return { success: false, error: 'No file path provided.' };
 	}
 
-	const absolutePath = path.join(process.cwd(), filePath);
+	const absolutePath = path.isAbsolute(filePath)
+		? filePath
+		: path.join(process.cwd(), filePath);
 
 	let content: string;
 	try {

package/index.ts

@@ -1 +1,3 @@
 export { default as BlogPost } from './components/BlogPost';
+export { readMarkdownFile } from './hooks/readMarkdownFile';
+export { MarkdownSections } from './utils/renderMarkdown';

package/package.json

@@ -1,15 +1,12 @@
 {
 	"name": "@san-siva/blogkit-md",
-	"version": "0.1.2",
+	"version": "0.2.1",
 	"description": "Converts markdown files into JSX blog posts for Blogkit",
 	"main": "index.ts",
 	"exports": {
 		".": "./index.ts"
 	},
 	"scripts": {
-		"dev": "tsx scripts/dev.ts",
-		"build": "MARKDOWN_FILE=data/test.md next build",
-		"start": "next start",
 		"test": "vitest run",
 		"lint": "eslint . --config eslint.config.ts",
 		"fix": "eslint . --config eslint.config.ts --fix"
@@ -50,7 +47,6 @@
 		"eslint-plugin-unicorn": "^62.0.0",
 		"jiti": "^2.0.0",
 		"prettier": "^3.0.0",
-		"tsx": "^4.0.0",
 		"typescript": "^5.0.0",
 		"typescript-eslint": "^8.0.0",
 		"vitest": "^4.1.0"

package/website/package-lock.json

@@ -25,7 +25,7 @@
 		},
 		"..": {
 			"name": "@san-siva/blogkit-md",
-			"version": "0.1.1",
+			"version": "0.1.2",
 			"dependencies": {
 				"@san-siva/blogkit": "^1.1.20",
 				"@san-siva/stylekit": "^1.0.8",

package/app/layout.tsx

@@ -1,44 +0,0 @@
-import type { Metadata } from 'next';
-import { JetBrains_Mono, Montserrat, Rubik } from 'next/font/google';
-
-import '@san-siva/stylekit/styles/globals.scss';
-import '@san-siva/blogkit/styles.css';
-import styles from '@san-siva/stylekit/styles/index.module.scss';
-
-const montserrat = Montserrat({
-	subsets: ['latin'] as const,
-	weight: ['400', '500', '600', '700', '800'] as const,
-	style: ['normal', 'italic'] as const,
-	variable: '--font-montserrat',
-});
-
-const rubik = Rubik({
-	subsets: ['latin'] as const,
-	weight: ['300', '400', '500', '600', '700', '800', '900'] as const,
-	style: ['normal', 'italic'] as const,
-	variable: '--font-rubik',
-});
-
-const jetbrainsMono = JetBrains_Mono({
-	subsets: ['latin'] as const,
-	weight: ['400', '500', '600', '700'] as const,
-	style: ['normal', 'italic'] as const,
-	variable: '--font-jetbrains-mono',
-});
-
-export const metadata: Metadata = {
-	title: 'Blogkit MD',
-	description: 'Markdown to JSX blog post renderer',
-};
-
-const RootLayout = ({ children }: { children: React.ReactNode }) => (
-	<html lang="en">
-		<body
-			className={`${montserrat.variable} ${rubik.variable} ${jetbrainsMono.variable}`}
-		>
-			<div className={`${styles.page}`}>{children}</div>
-		</body>
-	</html>
-);
-
-export default RootLayout;

package/app/page.tsx

@@ -1,32 +0,0 @@
-import { Blog, BlogHeader, Callout } from '@san-siva/blogkit';
-
-import { readMarkdownFile } from '@/hooks/readMarkdownFile';
-import { MarkdownSections } from '@/utils/renderMarkdown';
-
-const Page = async () => {
-	const result = await readMarkdownFile(process.env.MARKDOWN_FILE);
-
-	if (!result.success) {
-		return (
-			<Blog>
-				<Callout type="warning">{result.error}</Callout>
-			</Blog>
-		);
-	}
-
-	const { rendered, frontmatter } = result;
-
-	return (
-		<Blog>
-			{frontmatter.title && (
-				<BlogHeader
-					title={[frontmatter.title]}
-					desc={frontmatter.description ? [frontmatter.description] : []}
-				/>
-			)}
-			<MarkdownSections rendered={rendered} />
-		</Blog>
-	);
-};
-
-export default Page;

package/next.config.ts

@@ -1,5 +0,0 @@
-import type { NextConfig } from 'next';
-
-const nextConfig: NextConfig = {};
-
-export default nextConfig;

package/scripts/dev.ts

@@ -1,50 +0,0 @@
-import { exec, spawn } from 'node:child_process';
-import { stat, writeFileSync } from 'node:fs';
-import path from 'node:path';
-
-const fileArgument = process.argv.find(argument => argument.startsWith('--file='));
-const markdownFile = fileArgument ? fileArgument.replace('--file=', '') : 'data/test.md';
-
-const markdownPath = path.join(process.cwd(), markdownFile);
-const triggerPath = path.join(process.cwd(), 'utils/devReloadTrigger.ts');
-
-// Write on startup so fresh clones have the file before Next.js compiles.
-writeFileSync(triggerPath, `export const reloadTrigger = '${Date.now()}';\n`);
-
-let lastMtime: number | null = null;
-
-const checkMarkdownFile = () => {
-	stat(markdownPath, (error, stats) => {
-		if (error) return;
-		const { mtimeMs } = stats;
-		if (lastMtime !== null && mtimeMs !== lastMtime) {
-			writeFileSync(triggerPath, `export const reloadTrigger = '${mtimeMs}';\n`);
-		}
-		lastMtime = mtimeMs;
-	});
-};
-
-setInterval(checkMarkdownFile, 500);
-checkMarkdownFile();
-
-const child = spawn('next', ['dev'], {
-	env: { ...process.env, MARKDOWN_FILE: markdownFile },
-	stdio: ['inherit', 'pipe', 'inherit'],
-});
-
-let browserOpened = false;
-
-child.stdout?.on('data', (chunk: Buffer) => {
-	process.stdout.write(chunk);
-	if (!browserOpened) {
-		const match = chunk.toString().match(/http:\/\/localhost:\d+/);
-		if (match) {
-			browserOpened = true;
-			exec(`open ${match[0]}`);
-		}
-	}
-});
-
-child.on('exit', code => {
-	process.exit(code ?? 0);
-});