@aureuma/svelta 0.1.1 → 0.4.0

package/packages/core/dist/server/docs.js

@@ -0,0 +1,309 @@
+import { DEV } from 'esm-env';
+import matter from 'gray-matter';
+import { marked } from 'marked';
+import { z } from 'zod';
+const docsFrontmatterSchema = z.object({
+    title: z.string(),
+    navTitle: z.string().optional(),
+    description: z.string().optional(),
+    section: z.string().optional(),
+    sectionLabel: z.string().optional(),
+    order: z.number().optional(),
+    sectionOrder: z.number().optional(),
+    tags: z.array(z.string()).optional(),
+    updatedAt: z.string().optional(),
+    draft: z.boolean().optional()
+});
+function slugify(input) {
+    return input
+        .toLowerCase()
+        .trim()
+        .replace(/['"]/g, '')
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+const fmtLong = new Intl.DateTimeFormat('en-US', {
+    month: 'long',
+    day: 'numeric',
+    year: 'numeric',
+    timeZone: 'UTC'
+});
+function parseUpdatedAt(date) {
+    if (!date)
+        return { iso: undefined, long: undefined };
+    if (/^\d{4}-\d{2}-\d{2}$/.test(date)) {
+        const d = new Date(`${date}T00:00:00Z`);
+        if (!Number.isNaN(d.getTime())) {
+            return { iso: date, long: fmtLong.format(d) };
+        }
+    }
+    const d = new Date(date);
+    if (Number.isNaN(d.getTime()))
+        return { iso: undefined, long: undefined };
+    return { iso: d.toISOString(), long: fmtLong.format(d) };
+}
+function sectionFromMeta(meta, defaultSectionLabel, sectionOrder) {
+    const label = (meta.sectionLabel || meta.section || defaultSectionLabel).trim();
+    const id = slugify(meta.section || label || defaultSectionLabel);
+    const configuredOrder = sectionOrder.indexOf(id);
+    const order = meta.sectionOrder ?? (configuredOrder === -1 ? 1000 : configuredOrder);
+    return { id, label, order };
+}
+export function createDocs(config) {
+    const defaultSectionLabel = config.defaultSectionLabel ?? 'Guides';
+    const sectionOrder = config.sectionOrder ?? ['overview', 'getting-started', 'guides', 'api', 'reference'];
+    let cachedMetaIndex = null;
+    let cachedFullIndex = null;
+    let cachedSlugToPath = null;
+    function getSlugToPath() {
+        if (!DEV && cachedSlugToPath)
+            return cachedSlugToPath;
+        const map = new Map();
+        for (const path of Object.keys(config.rawModules).sort()) {
+            const file = path.split('/').pop();
+            const slug = file?.replace(/\.md(?:\?.*)?$/, '');
+            if (!slug)
+                continue;
+            map.set(slug, path);
+        }
+        if (!DEV)
+            cachedSlugToPath = map;
+        return map;
+    }
+    async function buildMetaIndex() {
+        if (!DEV && cachedMetaIndex)
+            return cachedMetaIndex;
+        const pages = [];
+        const paths = Object.keys(config.rawModules).sort();
+        for (const path of paths) {
+            const file = path.split('/').pop();
+            const slug = file?.replace(/\.md(?:\?.*)?$/, '');
+            if (!slug)
+                continue;
+            const rawFn = config.rawModules[path];
+            if (!rawFn)
+                continue;
+            const raw = await rawFn();
+            const { data, content } = matter(raw);
+            const meta = config.mapFrontmatter
+                ? config.mapFrontmatter({ data, content, slug, path })
+                : docsFrontmatterSchema.parse(data);
+            if (meta.draft)
+                continue;
+            const section = sectionFromMeta(meta, defaultSectionLabel, sectionOrder);
+            const updated = parseUpdatedAt(meta.updatedAt);
+            pages.push({
+                slug,
+                title: meta.title.trim(),
+                navTitle: (meta.navTitle || meta.title).trim(),
+                description: (meta.description || '').trim(),
+                section,
+                order: meta.order ?? 1000,
+                tags: meta.tags ?? [],
+                updatedAt: updated.iso,
+                updatedAtLong: updated.long
+            });
+        }
+        pages.sort((a, b) => {
+            if (a.section.order !== b.section.order)
+                return a.section.order - b.section.order;
+            if (a.section.id !== b.section.id)
+                return a.section.id.localeCompare(b.section.id);
+            if (a.order !== b.order)
+                return a.order - b.order;
+            return a.title.localeCompare(b.title);
+        });
+        if (!DEV)
+            cachedMetaIndex = pages;
+        return pages;
+    }
+    async function getAllPages() {
+        return buildMetaIndex();
+    }
+    async function getAllPagesFull() {
+        if (!DEV && cachedFullIndex)
+            return cachedFullIndex;
+        const meta = await buildMetaIndex();
+        const slugToPath = getSlugToPath();
+        const full = [];
+        for (const page of meta) {
+            const path = slugToPath.get(page.slug);
+            const compiledFn = path ? config.compiledModules[path] : undefined;
+            if (!compiledFn)
+                continue;
+            const compiled = await compiledFn();
+            full.push({ ...page, component: compiled.default });
+        }
+        if (!DEV)
+            cachedFullIndex = full;
+        return full;
+    }
+    async function getPageBySlug(slug) {
+        const page = (await getAllPages()).find((p) => p.slug === slug) ?? null;
+        if (!page)
+            return null;
+        const path = getSlugToPath().get(slug);
+        const compiledFn = path ? config.compiledModules[path] : undefined;
+        if (!compiledFn)
+            return null;
+        const compiled = await compiledFn();
+        return { ...page, component: compiled.default };
+    }
+    async function getSections() {
+        const pages = await getAllPages();
+        const map = new Map();
+        for (const page of pages) {
+            map.set(page.section.id, page.section);
+        }
+        return Array.from(map.values()).sort((a, b) => {
+            if (a.order !== b.order)
+                return a.order - b.order;
+            return a.label.localeCompare(b.label);
+        });
+    }
+    async function getSidebar() {
+        const [sections, pages] = await Promise.all([getSections(), getAllPages()]);
+        return sections.map((section) => ({
+            ...section,
+            pages: pages.filter((page) => page.section.id === section.id)
+        }));
+    }
+    async function getAdjacentPages(slug) {
+        const pages = await getAllPages();
+        const index = pages.findIndex((page) => page.slug === slug);
+        if (index === -1)
+            return { previous: null, next: null };
+        return {
+            previous: pages[index - 1] ?? null,
+            next: pages[index + 1] ?? null
+        };
+    }
+    async function pickLandingPage() {
+        const pages = await getAllPages();
+        return pages[0] ?? null;
+    }
+    return {
+        getAllPages,
+        getAllPagesFull,
+        getPageBySlug,
+        getSections,
+        getSidebar,
+        getAdjacentPages,
+        pickLandingPage
+    };
+}
+const defaultRenderMarkdown = (markdown) => String(marked.parse(markdown));
+export function createRawDocs(config) {
+    const defaultSectionLabel = config.defaultSectionLabel ?? 'Guides';
+    const sectionOrder = config.sectionOrder ?? ['overview', 'getting-started', 'guides', 'api', 'reference'];
+    const renderMarkdown = config.renderMarkdown ?? defaultRenderMarkdown;
+    let cachedContentIndex = null;
+    async function buildContentIndex() {
+        if (!DEV && cachedContentIndex)
+            return cachedContentIndex;
+        const pages = [];
+        const paths = Object.keys(config.rawModules).sort();
+        for (const path of paths) {
+            const file = path.split('/').pop();
+            const slug = file?.replace(/\.md(?:\?.*)?$/, '');
+            if (!slug)
+                continue;
+            const rawFn = config.rawModules[path];
+            if (!rawFn)
+                continue;
+            const raw = await rawFn();
+            const { data, content } = matter(raw);
+            const meta = config.mapFrontmatter
+                ? config.mapFrontmatter({ data, content, slug, path })
+                : docsFrontmatterSchema.parse(data);
+            if (meta.draft)
+                continue;
+            const section = sectionFromMeta(meta, defaultSectionLabel, sectionOrder);
+            const updated = parseUpdatedAt(meta.updatedAt);
+            const html = await renderMarkdown(content);
+            pages.push({
+                slug,
+                title: meta.title.trim(),
+                navTitle: (meta.navTitle || meta.title).trim(),
+                description: (meta.description || '').trim(),
+                section,
+                order: meta.order ?? 1000,
+                tags: meta.tags ?? [],
+                updatedAt: updated.iso,
+                updatedAtLong: updated.long,
+                html,
+                raw: content,
+                frontmatter: typeof data === 'object' && data ? data : {}
+            });
+        }
+        pages.sort((a, b) => {
+            if (a.section.order !== b.section.order)
+                return a.section.order - b.section.order;
+            if (a.section.id !== b.section.id)
+                return a.section.id.localeCompare(b.section.id);
+            if (a.order !== b.order)
+                return a.order - b.order;
+            return a.title.localeCompare(b.title);
+        });
+        if (!DEV)
+            cachedContentIndex = pages;
+        return pages;
+    }
+    function stripContent(page) {
+        const { html: _html, raw: _raw, frontmatter: _frontmatter, ...meta } = page;
+        return meta;
+    }
+    async function getAllPages() {
+        const pages = await buildContentIndex();
+        return pages.map(stripContent);
+    }
+    async function getAllPagesWithContent() {
+        return buildContentIndex();
+    }
+    async function getPageBySlug(slug) {
+        const pages = await buildContentIndex();
+        return pages.find((page) => page.slug === slug) ?? null;
+    }
+    async function getSections() {
+        const pages = await getAllPages();
+        const map = new Map();
+        for (const page of pages) {
+            map.set(page.section.id, page.section);
+        }
+        return Array.from(map.values()).sort((a, b) => {
+            if (a.order !== b.order)
+                return a.order - b.order;
+            return a.label.localeCompare(b.label);
+        });
+    }
+    async function getSidebar() {
+        const [sections, pages] = await Promise.all([getSections(), getAllPages()]);
+        return sections.map((section) => ({
+            ...section,
+            pages: pages.filter((page) => page.section.id === section.id)
+        }));
+    }
+    async function getAdjacentPages(slug) {
+        const pages = await getAllPages();
+        const index = pages.findIndex((page) => page.slug === slug);
+        if (index === -1)
+            return { previous: null, next: null };
+        return {
+            previous: pages[index - 1] ?? null,
+            next: pages[index + 1] ?? null
+        };
+    }
+    async function pickLandingPage() {
+        const pages = await getAllPages();
+        return pages[0] ?? null;
+    }
+    return {
+        getAllPages,
+        getAllPagesWithContent,
+        getPageBySlug,
+        getSections,
+        getSidebar,
+        getAdjacentPages,
+        pickLandingPage
+    };
+}

package/packages/core/dist/server/index.d.ts

@@ -1 +1,2 @@
 export { createBlog, createRawBlog, parseMarkdownAuthorMap, parseVivaAuthorFrontmatter, parseVivaAuthorProfiles, parseVivaBlogFrontmatter, type BlogCreateConfig, type RawBlogCreateConfig, type MarkdownRenderer, type VivaAuthorFrontmatter, type VivaAuthorProfile, type VivaBlogFrontmatter, type VivaImageAsset, type VivaSeoFields } from './blog';
+export { createDocs, createRawDocs, type DocsCreateConfig, type RawDocsCreateConfig, type DocsFrontmatter, type DocsFrontmatterAdapter, type DocsMarkdownRenderer } from './docs';

package/packages/core/dist/server/index.js

@@ -1 +1,2 @@
 export { createBlog, createRawBlog, parseMarkdownAuthorMap, parseVivaAuthorFrontmatter, parseVivaAuthorProfiles, parseVivaBlogFrontmatter } from './blog';
+export { createDocs, createRawDocs } from './docs';

package/packages/core/dist/types/blog.d.ts

@@ -33,6 +33,20 @@ export type BlogTag = {
     name: string;
     slug: string;
 };
+export type SharePlatform = 'x' | 'linkedin' | 'facebook' | 'reddit' | 'hackernews' | 'copy';
+export type BlogArchiveGroup = {
+    id: string;
+    year: number;
+    month: number;
+    label: string;
+    count: number;
+    posts: BlogPost[];
+};
+export type BlogAuthorSummary = {
+    author: BlogAuthor;
+    postCount: number;
+    latestPostDate: string;
+};
 export type BlogPostWithContent = BlogPost & {
     html: string;
     raw: string;

package/packages/core/dist/types/docs.d.ts

@@ -0,0 +1,28 @@
+import type { ComponentType } from 'svelte';
+export type DocsSection = {
+    id: string;
+    label: string;
+    order: number;
+};
+export type DocsPage = {
+    slug: string;
+    title: string;
+    navTitle: string;
+    description: string;
+    section: DocsSection;
+    order: number;
+    tags: string[];
+    updatedAt?: string;
+    updatedAtLong?: string;
+};
+export type DocsPageFull = DocsPage & {
+    component: ComponentType;
+};
+export type DocsPageWithContent = DocsPage & {
+    html: string;
+    raw: string;
+    frontmatter: Record<string, unknown>;
+};
+export type DocsSidebarSection = DocsSection & {
+    pages: DocsPage[];
+};

package/packages/core/dist/types/docs.js

@@ -0,0 +1 @@
+export {};

package/packages/core/dist/types/experience.d.ts

@@ -0,0 +1,63 @@
+export type ExperienceKind = 'docs' | 'blog';
+export type ExperienceDefinition = {
+    kind: ExperienceKind;
+    label: string;
+    description: string;
+    href: string;
+};
+export type ExperienceCatalog = {
+    defaultKind: ExperienceKind;
+    items: ExperienceDefinition[];
+    byKind: Record<ExperienceKind, ExperienceDefinition>;
+    resolve: (kind?: string | null) => ExperienceDefinition;
+};
+export type SveltaNavItem = {
+    label: string;
+    href: string;
+    external?: boolean;
+};
+export type SveltaDocsPatternConfig = {
+    kind: 'docs';
+    brandName: string;
+    productName: string;
+    title: string;
+    description: string;
+    defaultSectionLabel: string;
+    sectionOrder: string[];
+    navigation: {
+        header: SveltaNavItem[];
+        footer: SveltaNavItem[];
+    };
+    search: {
+        enabled: boolean;
+        placeholder: string;
+        shortcut: string;
+    };
+    toc: {
+        enabled: boolean;
+        title: string;
+    };
+    feedback: {
+        enabled: boolean;
+        prompt: string;
+    };
+    editLinkTemplate: string;
+};
+export type SveltaBlogPatternConfig = {
+    kind: 'blog';
+    brandName: string;
+    title: string;
+    description: string;
+    pageSize: number;
+    maxPageSize: number;
+    infiniteScroll: boolean;
+    showRss: boolean;
+    navigation: {
+        header: SveltaNavItem[];
+        footer: SveltaNavItem[];
+    };
+};
+export type SveltaPatternConfig = {
+    docs: SveltaDocsPatternConfig;
+    blog: SveltaBlogPatternConfig;
+};

package/packages/core/dist/types/experience.js

@@ -0,0 +1 @@
+export {};

package/packages/core/dist/theme/ThemeSwitcher.svelte

@@ -1,34 +0,0 @@
-<script lang="ts">
-	import type { ThemeController, ThemeMode } from './store';
-
-	export let controller: ThemeController;
-
-	const options: { id: ThemeMode; label: string }[] = [
-		{ id: 'system', label: 'System' },
-		{ id: 'light', label: 'Light' },
-		{ id: 'dark', label: 'Dark' }
-	];
-
-	// Store auto-subscriptions only work on identifiers, so alias it.
-	const themeMode = controller.themeMode;
-	$: currentMode = $themeMode;
-</script>
-
-<div class="flex items-center gap-2">
-	<span class="text-xs font-mono uppercase tracking-[0.6px] text-text-muted">Theme</span>
-	<div class="inline-flex rounded-full border border-border-soft/10 bg-background-soft p-1">
-		{#each options as opt (opt.id)}
-			<button
-				type="button"
-				class="rounded-full px-3 py-1 text-xs font-mono uppercase tracking-[0.6px] transition
-					hover:bg-background-main/60
-					{(currentMode === opt.id && 'bg-background-main shadow-sm') || 'text-text-sub'}"
-				onclick={() => controller.setThemeMode(opt.id)}
-				aria-pressed={currentMode === opt.id}
-			>
-				{opt.label}
-			</button>
-		{/each}
-	</div>
-</div>
-

package/packages/core/dist/theme/index.d.ts

@@ -1,2 +0,0 @@
-export { createThemeController, type ThemeController, type ThemeMode } from './store';
-export { default as ThemeSwitcher } from './ThemeSwitcher.svelte';

package/packages/core/dist/theme/index.js

@@ -1,2 +0,0 @@
-export { createThemeController } from './store';
-export { default as ThemeSwitcher } from './ThemeSwitcher.svelte';

package/packages/core/dist/theme/store.d.ts

@@ -1,12 +0,0 @@
-import { type Writable } from 'svelte/store';
-export type ThemeMode = 'system' | 'light' | 'dark';
-export type ThemeController = {
-    storageKey: string;
-    themeMode: Writable<ThemeMode>;
-    initTheme: () => void | (() => void);
-    setThemeMode: (mode: ThemeMode) => void;
-};
-export declare function createThemeController(opts?: {
-    storageKey?: string;
-    defaultMode?: ThemeMode;
-}): ThemeController;

package/packages/core/dist/theme/store.js

@@ -1,50 +0,0 @@
-import { BROWSER } from 'esm-env';
-import { writable } from 'svelte/store';
-function resolve(mode) {
-    if (mode === 'light' || mode === 'dark')
-        return mode;
-    const prefersDark = window.matchMedia?.('(prefers-color-scheme: dark)')?.matches ?? false;
-    return prefersDark ? 'dark' : 'light';
-}
-function apply(mode) {
-    const resolved = resolve(mode);
-    document.documentElement.classList.remove('light', 'dark');
-    document.documentElement.classList.add(resolved);
-    document.documentElement.dataset.theme = mode;
-}
-export function createThemeController(opts) {
-    const storageKey = opts?.storageKey ?? 'svelta-theme';
-    const defaultMode = opts?.defaultMode ?? 'system';
-    const themeMode = writable(defaultMode);
-    function readStored() {
-        const v = localStorage.getItem(storageKey);
-        if (v === 'light' || v === 'dark' || v === 'system')
-            return v;
-        return defaultMode;
-    }
-    function initTheme() {
-        if (!BROWSER)
-            return;
-        const mode = readStored();
-        themeMode.set(mode);
-        apply(mode);
-        const mq = window.matchMedia?.('(prefers-color-scheme: dark)');
-        const onChange = () => {
-            let current = mode;
-            const unsub = themeMode.subscribe((v) => (current = v));
-            unsub();
-            if (current === 'system')
-                apply('system');
-        };
-        mq?.addEventListener?.('change', onChange);
-        return () => mq?.removeEventListener?.('change', onChange);
-    }
-    function setThemeMode(mode) {
-        themeMode.set(mode);
-        if (!BROWSER)
-            return;
-        localStorage.setItem(storageKey, mode);
-        apply(mode);
-    }
-    return { storageKey, themeMode, initTheme, setThemeMode };
-}