@axerity/cli 0.1.4 → 0.2.0

package/src/lib/components/kit/api/Webhook.svelte

@@ -1,115 +0,0 @@
-<script lang="ts">
-	import { setContext } from 'svelte';
-	import type { Snippet } from 'svelte';
-	import { API, type ApiContext, type ApiExampleEntry } from './api-context';
-	import ApiExamplePanel from './ApiExamplePanel.svelte';
-
-	let {
-		event,
-		method = 'POST',
-		description,
-		children
-	}: { event: string; method?: string; description?: string; children: Snippet } = $props();
-
-	const examples = $state<ApiExampleEntry[]>([]);
-	let counter = 0;
-
-	const objects = $derived(examples.filter((example) => example.kind === 'object'));
-	const payloads = $derived(examples.filter((example) => example.kind !== 'object'));
-
-	setContext<ApiContext>(API, {
-		registerExample(entry) {
-			const id = counter++;
-			examples.push({ ...entry, id });
-			return id;
-		},
-		unregisterExample(id) {
-			const index = examples.findIndex((example) => example.id === id);
-			if (index !== -1) examples.splice(index, 1);
-		}
-	});
-</script>
-
-<div class="api">
-	<div class="api-main">
-		<div class="webhook-head" data-method={method.toUpperCase()}>
-			<span class="webhook-method">{method.toUpperCase()}</span>
-			<code class="webhook-event">{event}</code>
-		</div>
-		<p class="webhook-sub">
-			Delivered to your webhook endpoint as a {method.toUpperCase()} request when this event occurs.
-		</p>
-		{#if description}
-			<p>{description}</p>
-		{/if}
-		{@render children()}
-	</div>
-
-	<div class="api-rail">
-		<div class="api-rail-sticky">
-			{#each objects as object (object.id)}
-				<ApiExamplePanel label={object.title} entries={[object]} />
-			{/each}
-			<ApiExamplePanel label="Payload" entries={payloads} />
-		</div>
-	</div>
-</div>
-
-<style>
-	.api {
-		display: grid;
-		grid-template-columns: minmax(0, 1fr);
-		gap: 2rem;
-	}
-	@media (min-width: 1024px) {
-		.api {
-			grid-template-columns: minmax(0, 1fr) 28rem;
-			gap: 2.5rem;
-			align-items: start;
-		}
-	}
-	.api-main :global(h2) {
-		margin-top: 1.75rem;
-		font-size: 1.2rem;
-	}
-
-	.webhook-head {
-		display: flex;
-		align-items: center;
-		gap: 0.625rem;
-		margin-bottom: 0.5rem;
-	}
-	.webhook-method {
-		flex-shrink: 0;
-		border-radius: var(--radius-md);
-		background-color: color-mix(in oklab, var(--accent) 14%, transparent);
-		padding: 0.15rem 0.5rem;
-		font-family: var(--font-mono);
-		font-size: 0.7rem;
-		font-weight: 700;
-		letter-spacing: 0.02em;
-		color: var(--accent);
-	}
-	.webhook-event {
-		font-family: var(--font-mono);
-		font-size: 1.05rem;
-		font-weight: 600;
-		color: var(--fg);
-	}
-	.webhook-sub {
-		margin-top: 0;
-		color: var(--fg-muted);
-	}
-
-	.api-rail-sticky {
-		display: flex;
-		flex-direction: column;
-		gap: 1rem;
-	}
-	@media (min-width: 1024px) {
-		.api-rail-sticky {
-			position: sticky;
-			top: calc(var(--spacing-header) + 1.5rem);
-		}
-	}
-</style>

package/src/lib/components/kit/api/api-context.ts

@@ -1,15 +0,0 @@
-import type { Snippet } from 'svelte';
-
-export interface ApiExampleEntry {
-	id: number;
-	title: string;
-	kind: 'request' | 'response' | 'object';
-	snippet: Snippet;
-}
-
-export interface ApiContext {
-	registerExample(entry: Omit<ApiExampleEntry, 'id'>): number;
-	unregisterExample(id: number): void;
-}
-
-export const API = Symbol('api');

package/src/lib/components/kit/tabs-context.ts

@@ -1,8 +0,0 @@
-/** Context shared between <Tabs> and its <Tab> children. */
-export interface TabsContext {
-	register(title: string, icon?: string): number;
-	unregister(id: number): void;
-	isActive(id: number): boolean;
-}
-
-export const TABS = Symbol('tabs');

package/src/lib/components/kit/tabs-store.svelte.ts

@@ -1,28 +0,0 @@
-/**
- * Shared selection state for grouped tabs.
- *
- */
-import { browser } from '$app/environment';
-
-const PREFIX = 'axerity-tabs:';
-
-class TabGroupStore {
-	#values = $state<Record<string, string>>({});
-
-	init(group: string) {
-		if (!browser || this.#values[group] !== undefined) return;
-		const stored = localStorage.getItem(PREFIX + group);
-		if (stored !== null) this.#values[group] = stored;
-	}
-
-	get(group: string): string | undefined {
-		return this.#values[group];
-	}
-
-	set(group: string, value: string) {
-		this.#values[group] = value;
-		if (browser) localStorage.setItem(PREFIX + group, value);
-	}
-}
-
-export const tabGroups = new TabGroupStore();

package/src/lib/config/site.ts

@@ -1,34 +0,0 @@
-import { base } from '$app/paths';
-import type { SiteConfig, TopNavLink } from '$lib/types';
-import config from '../../../axerity.json';
-
-const raw = config as SiteConfig;
-
-// Prefix internal (leading-slash) links with the base path so the whole site
-// works under a sub-path. External links and matchers are handled in step.
-const p = (href?: string): string | undefined =>
-	href && href.startsWith('/') ? base + href : href;
-
-const link = (l: TopNavLink): TopNavLink => ({ ...l, href: p(l.href)!, match: p(l.match) });
-
-export const site: SiteConfig = base
-	? {
-			...raw,
-			logo: raw.logo && {
-				...raw.logo,
-				light: p(raw.logo.light),
-				dark: p(raw.logo.dark),
-				href: p(raw.logo.href)
-			},
-			og: raw.og && { ...raw.og, logo: p(raw.og.logo) },
-			topNav: raw.topNav?.map(link) ?? [],
-			versions: raw.versions?.map((v) => ({ ...v, href: p(v.href)! })),
-			sidebarLinks: raw.sidebarLinks?.map((s) => ({ ...s, href: p(s.href)! })),
-			dropdowns: raw.dropdowns?.map((d) => ({
-				...d,
-				href: p(d.href)!,
-				match: p(d.match),
-				tabs: d.tabs?.map(link)
-			}))
-		}
-	: raw;

package/src/lib/content/index.ts

@@ -1,50 +0,0 @@
-import { base } from '$app/paths';
-import { site } from '$lib/config/site';
-import type { NavLink, NavSection } from '$lib/types';
-import { buildSidebar, flattenSections } from './tree';
-
-const ROOT = '/src/content/docs';
-
-const stripBase = (path: string): string =>
-	base && path.startsWith(base) ? path.slice(base.length) : path;
-
-// A versioned site keeps each version's content in a top-level folder matching
-// the version's path, e.g. `docs/v2/...` for a version with href `/v2`.
-const versionPaths = (site.versions ?? [])
-	.map((v) => stripBase(v.href))
-	.filter((href) => href && href !== '/');
-
-export const versioned = versionPaths.length > 0;
-export const defaultVersionPath = versionPaths[0] ?? '';
-
-const sidebars = new Map<string, NavSection[]>();
-if (versioned) {
-	for (const path of versionPaths) sidebars.set(path, buildSidebar(ROOT + path));
-}
-
-function activeVersionPath(pathname: string): string {
-	const path = stripBase(pathname);
-	return versionPaths.find((vp) => path === vp || path.startsWith(`${vp}/`)) ?? defaultVersionPath;
-}
-
-/** The sidebar and prev/next list for the version the pathname belongs to. */
-export function navFor(pathname: string): { sidebar: NavSection[]; flatPages: NavLink[] } {
-	if (!versioned) return { sidebar, flatPages };
-	const sb = sidebars.get(activeVersionPath(pathname)) ?? [];
-	return { sidebar: sb, flatPages: flattenSections(sb) };
-}
-
-/** Rewrite a path to the same page in another version (falls back to its root). */
-export function pathInVersion(pathname: string, versionPath: string): string {
-	const current = activeVersionPath(pathname);
-	const rest = stripBase(pathname).slice(current.length);
-	const candidate = `${versionPath}${rest}`;
-	const target = sidebars.get(versionPath);
-	const exists = target && flattenSections(target).some((p) => stripBase(p.href) === candidate);
-	return base + (exists ? candidate : versionPath);
-}
-
-export const sidebar = versioned ? (sidebars.get(defaultVersionPath) ?? []) : buildSidebar();
-export const flatPages = flattenSections(sidebar);
-
-export { buildSidebar, flattenSections };

package/src/lib/content/raw.ts

@@ -1,21 +0,0 @@
-const rawModules = import.meta.glob('/src/content/docs/**/*.md', {
-	query: '?raw',
-	import: 'default'
-}) as Record<string, () => Promise<string>>;
-
-const BASE = '/src/content/docs';
-
-function clean(markdown: string): string {
-	return markdown
-		.replace(/^---\r?\n[\s\S]*?\r?\n---\r?\n/, '')
-		.replace(/<script[\s\S]*?<\/script>\s*/g, '')
-		.trim();
-}
-
-export async function getRawMarkdown(slug: string): Promise<string | null> {
-	const rel = slug.replace(/\/+$/, '');
-	const candidates = rel ? [`${BASE}/${rel}.md`, `${BASE}/${rel}/index.md`] : [`${BASE}/index.md`];
-	const path = candidates.find((candidate) => candidate in rawModules);
-	if (!path) return null;
-	return clean(await rawModules[path]());
-}

package/src/lib/content/tree.ts

@@ -1,169 +0,0 @@
-/**
- * Content-tree generator.
- *
- */
-import { base } from '$app/paths';
-import type { FolderMeta, NavEntry, NavLink, NavSection, PageFrontmatter } from '$lib/types';
-
-const ROOT = '/src/content/docs';
-
-const metaModules = import.meta.glob<FolderMeta>('/src/content/docs/**/meta.json', {
-	eager: true,
-	import: 'default'
-});
-const pageModules = import.meta.glob<PageFrontmatter>('/src/content/docs/**/*.md', {
-	eager: true,
-	import: 'metadata'
-});
-
-interface PageEntry {
-	slug: string;
-	frontmatter: PageFrontmatter;
-}
-
-function dirOf(path: string): string {
-	return path.slice(0, path.lastIndexOf('/'));
-}
-
-function slugOf(path: string): string {
-	return path.slice(path.lastIndexOf('/') + 1).replace(/\.md$/, '');
-}
-
-function hrefFor(folder: string, slug: string): string {
-	const rel = folder.slice(ROOT.length);
-	if (slug === 'index') return base + (rel || '/');
-	return base + rel + '/' + slug;
-}
-
-const metaFor = (folder: string): FolderMeta =>
-	metaModules[`${folder}/meta.json`] ?? ({} as FolderMeta);
-
-/** Pages grouped by their containing folder. */
-function pagesByFolder(): Map<string, Map<string, PageEntry>> {
-	const byFolder = new Map<string, Map<string, PageEntry>>();
-	for (const [path, frontmatter] of Object.entries(pageModules)) {
-		const folder = dirOf(path);
-		if (!byFolder.has(folder)) byFolder.set(folder, new Map());
-		byFolder.get(folder)!.set(slugOf(path), { slug: slugOf(path), frontmatter: frontmatter ?? {} });
-	}
-	return byFolder;
-}
-
-const byFolder = pagesByFolder();
-const allFolders = new Set<string>([...byFolder.keys(), ...Object.keys(metaModules).map(dirOf)]);
-
-/** Folders nested directly inside `folder`. */
-function subfoldersOf(folder: string): string[] {
-	return [...allFolders].filter((f) => f !== folder && dirOf(f) === folder);
-}
-
-function linkFor(folder: string, slug: string): NavLink {
-	const { frontmatter } = byFolder.get(folder)!.get(slug)!;
-	return {
-		title: frontmatter.title ?? slug,
-		href: hrefFor(folder, slug),
-		icon: frontmatter.icon,
-		badge: frontmatter.badge,
-		description: frontmatter.description,
-		method: frontmatter.method
-	};
-}
-
-/**
- * Build a folder's entries: its pages (as links) and its subfolders (as nested
- * groups), ordered by `meta.pages` with anything unlisted appended.
- */
-function entriesFor(folder: string, includeIndex = true): NavEntry[] {
-	const meta = metaFor(folder);
-	const pages = byFolder.get(folder) ?? new Map<string, PageEntry>();
-	const subfolders = subfoldersOf(folder);
-	const subByName = new Map(subfolders.map((f) => [f.slice(f.lastIndexOf('/') + 1), f]));
-
-	const order = meta.pages ?? [];
-	const handledPages = new Set<string>();
-	const handledSubs = new Set<string>();
-	const entries: NavEntry[] = [];
-
-	const pushPage = (slug: string) => {
-		if (!includeIndex && slug === 'index') return;
-		entries.push(linkFor(folder, slug));
-		handledPages.add(slug);
-	};
-
-	for (const name of order) {
-		if (pages.has(name)) pushPage(name);
-		else if (subByName.has(name)) {
-			entries.push(groupFor(subByName.get(name)!));
-			handledSubs.add(name);
-		}
-	}
-
-	for (const slug of [...pages.keys()].filter((s) => !handledPages.has(s)).sort()) pushPage(slug);
-	for (const [name, path] of subByName) if (!handledSubs.has(name)) entries.push(groupFor(path));
-
-	return entries;
-}
-
-function groupFor(folder: string): NavGroupResult {
-	const meta = metaFor(folder);
-	return {
-		title: meta.title ?? folder.slice(folder.lastIndexOf('/') + 1),
-		icon: meta.icon,
-		items: entriesFor(folder),
-		defaultOpen: meta.defaultOpen
-	};
-}
-// Local alias so groupFor reads cleanly above its NavGroup return.
-type NavGroupResult = Extract<NavEntry, { items: NavEntry[] }>;
-
-/**
- * Generate the sidebar rooted at a folder: its own pages as a lead section, then
- * each subfolder as a section. Pass a version folder (e.g. `/src/content/docs/v2`)
- * to build that version's sidebar.
- */
-export function buildSidebar(rootFolder: string = ROOT): NavSection[] {
-	const rootMeta = metaFor(rootFolder);
-	const topSubfolders = subfoldersOf(rootFolder);
-	const subByName = new Map(topSubfolders.map((f) => [f.slice(f.lastIndexOf('/') + 1), f]));
-
-	// Order top-level folders by the root meta.pages entries that name them.
-	const named = (rootMeta.pages ?? [])
-		.filter((name) => subByName.has(name))
-		.map((name) => subByName.get(name)!);
-	const rest = topSubfolders.filter((f) => !named.includes(f)).sort();
-
-	const sections: NavSection[] = [];
-
-	// Lead section: only the root folder's own pages (subfolders are promoted).
-	if (byFolder.has(rootFolder)) {
-		sections.push({
-			title: rootMeta.title ?? 'Docs',
-			icon: rootMeta.icon,
-			items: entriesFor(rootFolder).filter((entry) => 'href' in entry)
-		});
-	}
-
-	for (const folder of [...named, ...rest]) {
-		const meta = metaFor(folder);
-		sections.push({
-			title: meta.title ?? folder.slice(folder.lastIndexOf('/') + 1),
-			icon: meta.icon,
-			items: entriesFor(folder)
-		});
-	}
-
-	return sections;
-}
-
-/** Flatten the sidebar into an ordered list of page links (for prev/next nav). */
-export function flattenSections(sections: NavSection[]): NavLink[] {
-	const out: NavLink[] = [];
-	const walk = (entries: NavEntry[]) => {
-		for (const entry of entries) {
-			if ('href' in entry) out.push(entry);
-			else walk(entry.items);
-		}
-	};
-	for (const section of sections) walk(section.items);
-	return out;
-}

package/src/lib/index.ts

@@ -1,79 +0,0 @@
-// Public API surface for the docs engine — what the generator core will expose.
-export { default as DocsLayout } from './components/docs/DocsLayout.svelte';
-export { default as Navbar } from './components/docs/Navbar.svelte';
-export { default as Sidebar } from './components/docs/Sidebar.svelte';
-export { default as TableOfContents } from './components/docs/TableOfContents.svelte';
-export { default as ThemeToggle } from './components/docs/ThemeToggle.svelte';
-
-// Component kit (usable inside markdown).
-export { default as Badge } from './components/kit/Badge.svelte';
-export { default as Callout } from './components/kit/Callout.svelte';
-export { default as Columns } from './components/kit/Columns.svelte';
-export { default as Kbd } from './components/kit/Kbd.svelte';
-export { default as Update } from './components/kit/Update.svelte';
-export { default as Roadmap } from './components/kit/Roadmap.svelte';
-export { default as RoadmapItem } from './components/kit/RoadmapItem.svelte';
-export { default as Card } from './components/kit/Card.svelte';
-export { default as CardGroup } from './components/kit/CardGroup.svelte';
-export { default as CodeGroup } from './components/kit/CodeGroup.svelte';
-export { default as Accordion } from './components/kit/Accordion.svelte';
-export { default as AccordionGroup } from './components/kit/AccordionGroup.svelte';
-export { default as Tabs } from './components/kit/Tabs.svelte';
-export { default as Tab } from './components/kit/Tab.svelte';
-export { default as Steps } from './components/kit/Steps.svelte';
-export { default as Step } from './components/kit/Step.svelte';
-export { default as Frame } from './components/kit/Frame.svelte';
-export { default as Icon } from './components/kit/Icon.svelte';
-export { default as Tooltip } from './components/kit/Tooltip.svelte';
-export { default as Tree } from './components/kit/Tree.svelte';
-export { default as Video } from './components/kit/Video.svelte';
-export { default as Folder } from './components/kit/Folder.svelte';
-export { default as File } from './components/kit/File.svelte';
-export { default as TypeTable } from './components/kit/TypeTable.svelte';
-export type { TypeTableProp } from './components/kit/TypeTable.svelte';
-
-// Webhook kit.
-export { default as Webhook } from './components/kit/api/Webhook.svelte';
-export { default as EventList } from './components/kit/EventList.svelte';
-export { default as Event } from './components/kit/Event.svelte';
-
-// WebSocket / AsyncAPI kit.
-export { default as Channel } from './components/kit/api/Channel.svelte';
-export { default as Message } from './components/kit/api/Message.svelte';
-
-// API reference kit.
-export { default as Api } from './components/kit/api/Api.svelte';
-export { default as Endpoint } from './components/kit/api/Endpoint.svelte';
-export { default as ParamField } from './components/kit/api/ApiField.svelte';
-export { default as ResponseField } from './components/kit/api/ApiField.svelte';
-export { default as RequestExample } from './components/kit/api/RequestExample.svelte';
-export { default as ResponseExample } from './components/kit/api/ResponseExample.svelte';
-export { default as ObjectExample } from './components/kit/api/ObjectExample.svelte';
-export { default as Expandable } from './components/kit/api/Expandable.svelte';
-export { default as EnumValues } from './components/kit/api/EnumValues.svelte';
-export { default as Enum } from './components/kit/api/Enum.svelte';
-
-export { theme } from './state/theme.svelte';
-export type { ThemePreference, ResolvedTheme } from './state/theme.svelte';
-
-// Any Lucide icon by kebab-case name (lazily loaded — no manual registry).
-export { default as DynamicIcon } from './components/DynamicIcon.svelte';
-
-// NOTE: the content tree (`sidebar` / `buildSidebar`) is intentionally NOT
-// re-exported here. It eagerly globs every markdown file, and markdown files
-// import this barrel to use the component kit — re-exporting it would create an
-// import cycle (markdown → $lib → content → glob → markdown). Import it from
-// `$lib/content` directly instead.
-
-export type {
-	SiteConfig,
-	LayoutVariant,
-	NavSection,
-	NavGroup,
-	NavEntry,
-	NavLink,
-	TopNavLink,
-	TocEntry,
-	FolderMeta,
-	PageFrontmatter
-} from './types';

package/src/lib/nav-match.ts

@@ -1,23 +0,0 @@
-interface Prefixed {
-	href: string;
-	match?: string;
-}
-
-function base(item: Prefixed): string {
-	return item.match ?? item.href;
-}
-
-export function activeFor<T extends Prefixed>(path: string, items: T[]): T | undefined {
-	let best: T | undefined;
-	let bestLength = -1;
-	for (const item of items) {
-		const prefix = base(item);
-		if (path === prefix || path.startsWith(prefix.endsWith('/') ? prefix : prefix + '/')) {
-			if (prefix.length > bestLength) {
-				best = item;
-				bestLength = prefix.length;
-			}
-		}
-	}
-	return best;
-}