@axerity/cli 0.1.4 → 0.2.1

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

@@ -1,35 +0,0 @@
-<script lang="ts">
-	import type { Snippet } from 'svelte';
-
-	let { title = 'Possible enum values', children }: { title?: string; children: Snippet } =
-		$props();
-</script>
-
-<div class="enum">
-	<div class="enum-head">{title}</div>
-	<div class="enum-body">
-		{@render children()}
-	</div>
-</div>
-
-<style>
-	.enum {
-		margin: 0.75rem 0;
-		border: 1px solid var(--border);
-		border-radius: 0.5rem;
-		background-color: var(--bg-subtle);
-	}
-	.enum-head {
-		padding: 0.55rem 0.85rem;
-		border-bottom: 1px solid var(--border);
-		font-size: 0.78rem;
-		font-weight: 600;
-		color: var(--fg-muted);
-	}
-	.enum-body {
-		padding: 0.25rem 0.85rem;
-	}
-	.enum-body > :global(.enum-item:not(:first-child)) {
-		border-top: 1px solid var(--border);
-	}
-</style>

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

@@ -1,70 +0,0 @@
-<script lang="ts">
-	import { untrack } from 'svelte';
-	import type { Snippet } from 'svelte';
-	import { slide } from 'svelte/transition';
-	import Plus from '@lucide/svelte/icons/plus';
-	import Minus from '@lucide/svelte/icons/minus';
-
-	let {
-		title = 'child attributes',
-		open = false,
-		children
-	}: { title?: string; open?: boolean; children: Snippet } = $props();
-
-	let isOpen = $state(untrack(() => open));
-</script>
-
-<div class="expandable">
-	<button
-		type="button"
-		class="expandable-toggle"
-		onclick={() => (isOpen = !isOpen)}
-		aria-expanded={isOpen}
-	>
-		{#if isOpen}
-			<Minus size={14} />
-		{:else}
-			<Plus size={14} />
-		{/if}
-		<span>{isOpen ? 'Hide' : 'Show'} {title}</span>
-	</button>
-
-	{#if isOpen}
-		<div class="expandable-body" transition:slide={{ duration: 150 }}>
-			{@render children()}
-		</div>
-	{/if}
-</div>
-
-<style>
-	.expandable {
-		margin-top: 0.6rem;
-	}
-
-	.expandable-toggle {
-		display: inline-flex;
-		align-items: center;
-		gap: 0.4rem;
-		padding: 0.3rem 0.7rem;
-		border: 1px solid var(--border);
-		border-radius: 0.375rem;
-		background-color: var(--surface);
-		font-size: 0.8rem;
-		font-weight: 500;
-		color: var(--fg-muted);
-		cursor: pointer;
-		transition:
-			color 0.12s,
-			border-color 0.12s;
-	}
-	.expandable-toggle:hover {
-		color: var(--fg);
-		border-color: var(--border-strong);
-	}
-
-	.expandable-body {
-		margin-top: 0.5rem;
-		padding-left: 1rem;
-		border-left: 1px solid var(--border);
-	}
-</style>

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

@@ -1,67 +0,0 @@
-<script lang="ts">
-	import type { Snippet } from 'svelte';
-	import ArrowUp from '@lucide/svelte/icons/arrow-up';
-	import ArrowDown from '@lucide/svelte/icons/arrow-down';
-
-	let {
-		direction = 'receive',
-		name,
-		children
-	}: {
-		direction?: 'send' | 'receive' | 'publish' | 'subscribe';
-		name?: string;
-		children?: Snippet;
-	} = $props();
-
-	const isSend = $derived(direction === 'send' || direction === 'publish');
-</script>
-
-<div class="message">
-	<div class="message-head" data-direction={isSend ? 'send' : 'receive'}>
-		{#if isSend}
-			<ArrowUp size={14} />
-		{:else}
-			<ArrowDown size={14} />
-		{/if}
-		<span class="message-label">{isSend ? 'Send' : 'Receive'}</span>
-		{#if name}
-			<code class="message-name">{name}</code>
-		{/if}
-	</div>
-	{#if children}
-		<div class="message-body">
-			{@render children()}
-		</div>
-	{/if}
-</div>
-
-<style>
-	.message {
-		margin: 1.75rem 0 0;
-	}
-	.message-head {
-		display: inline-flex;
-		align-items: center;
-		gap: 0.5rem;
-		border-radius: var(--radius-md);
-		padding: 0.25rem 0.6rem;
-		font-size: 0.8rem;
-		font-weight: 600;
-		color: var(--d);
-		background-color: color-mix(in oklab, var(--d) 12%, transparent);
-	}
-	.message-head[data-direction='send'] {
-		--d: oklch(0.6 0.16 250);
-	}
-	.message-head[data-direction='receive'] {
-		--d: oklch(0.6 0.15 155);
-	}
-	.message-name {
-		font-family: var(--font-mono);
-		font-weight: 600;
-		color: inherit;
-	}
-	.message-body :global(> :first-child) {
-		margin-top: 0.75rem;
-	}
-</style>

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

@@ -1,11 +0,0 @@
-<script lang="ts">
-	import { getContext, onDestroy, untrack } from 'svelte';
-	import type { Snippet } from 'svelte';
-	import { API, type ApiContext } from './api-context';
-
-	let { title = 'Object', children }: { title?: string; children: Snippet } = $props();
-
-	const api = getContext<ApiContext>(API);
-	const id = untrack(() => api.registerExample({ title, kind: 'object', snippet: children }));
-	onDestroy(() => api.unregisterExample(id));
-</script>

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

@@ -1,11 +0,0 @@
-<script lang="ts">
-	import { getContext, onDestroy, untrack } from 'svelte';
-	import type { Snippet } from 'svelte';
-	import { API, type ApiContext } from './api-context';
-
-	let { title = 'Request', children }: { title?: string; children: Snippet } = $props();
-
-	const api = getContext<ApiContext>(API);
-	const id = untrack(() => api.registerExample({ title, kind: 'request', snippet: children }));
-	onDestroy(() => api.unregisterExample(id));
-</script>

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

@@ -1,11 +0,0 @@
-<script lang="ts">
-	import { getContext, onDestroy, untrack } from 'svelte';
-	import type { Snippet } from 'svelte';
-	import { API, type ApiContext } from './api-context';
-
-	let { title = 'Response', children }: { title?: string; children: Snippet } = $props();
-
-	const api = getContext<ApiContext>(API);
-	const id = untrack(() => api.registerExample({ title, kind: 'response', snippet: children }));
-	onDestroy(() => api.unregisterExample(id));
-</script>

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;
-}