@axerity/cli 0.1.4 → 0.2.1

package/mdsvex.config.js

@@ -1,261 +0,0 @@
-import { readFileSync } from 'node:fs';
-import { defineMDSveXConfig } from 'mdsvex';
-import { escapeSvelte } from 'mdsvex';
-import rehypeSlug from 'rehype-slug';
-import { createHighlighter } from 'shiki';
-import { transformerTwoslash } from '@shikijs/twoslash';
-
-let basePath = '';
-try {
-	basePath = JSON.parse(readFileSync('./axerity.json', 'utf8')).basePath ?? '';
-} catch {
-	// no config
-}
-
-function rehypeBasePath() {
-	return (tree) => {
-		const walk = (node) => {
-			if (node.type === 'element' && node.tagName === 'a') {
-				const href = node.properties?.href;
-				if (
-					typeof href === 'string' &&
-					href.startsWith('/') &&
-					!href.startsWith('//') &&
-					!href.startsWith(`${basePath}/`)
-				) {
-					node.properties.href = basePath + href;
-				}
-			}
-			node.children?.forEach(walk);
-		};
-		if (basePath) walk(tree);
-	};
-}
-
-/**
- * Wrap every `<table>` in a `<div class="table-wrapper">` so it can be a rounded,
- * horizontally-scrollable card (a bare table can't clip rounded corners while
- * also scrolling on overflow).
- */
-function rehypeTableWrapper() {
-	return (tree) => {
-		const walk = (node) => {
-			if (!node.children) return;
-			node.children = node.children.map((child) => {
-				if (child.type === 'element' && child.tagName === 'table') {
-					return {
-						type: 'element',
-						tagName: 'div',
-						properties: { className: ['table-wrapper'] },
-						children: [child]
-					};
-				}
-				walk(child);
-				return child;
-			});
-		};
-		walk(tree);
-	};
-}
-
-function rehypeExternalLinks() {
-	return (tree) => {
-		const walk = (node) => {
-			if (node.type === 'element' && node.tagName === 'a') {
-				const href = node.properties?.href;
-				if (typeof href === 'string' && /^https?:\/\//.test(href)) {
-					node.properties.target = '_blank';
-					node.properties.rel = 'noreferrer noopener';
-				}
-			}
-			node.children?.forEach(walk);
-		};
-		walk(tree);
-	};
-}
-
-// Dual theme: light tokens are inlined, dark tokens exposed as CSS vars that
-// `layout.css` switches on under `.dark`.
-const themes = { light: 'github-light', dark: 'vesper' };
-
-// Languages preloaded into the highlighter. Anything else falls back to plain
-// text (see the try/catch below).
-const langs = [
-	'svelte',
-	'typescript',
-	'javascript',
-	'json',
-	'yaml',
-	'bash',
-	'shell',
-	'html',
-	'css',
-	'markdown'
-];
-
-// Lazily create a single shared highlighter (loading grammars + themes is
-// expensive, so do it once).
-let highlighterPromise;
-function getHighlighter() {
-	if (!highlighterPromise) {
-		highlighterPromise = createHighlighter({ themes: Object.values(themes), langs });
-	}
-	return highlighterPromise;
-}
-
-/** Escape HTML special chars for safe interpolation into the title bar. */
-function escapeHtml(str) {
-	return str
-		.replace(/&/g, '&amp;')
-		.replace(/</g, '&lt;')
-		.replace(/>/g, '&gt;')
-		.replace(/"/g, '&quot;');
-}
-
-/** Pull `title="…"` (or single-quoted) out of a fence's meta string. */
-function parseTitle(meta) {
-	const match = meta.match(/title=(?:"([^"]*)"|'([^']*)')/);
-	return match ? (match[1] ?? match[2]) : null;
-}
-
-/**
- * Parse a `{1,3-5}` line-range expression from a fence's meta into a Set of
- * 1-based line numbers to highlight.
- */
-function parseHighlightLines(meta) {
-	const match = meta.match(/\{([\d,\s-]+)\}/);
-	const lines = new Set();
-	if (!match) return lines;
-	for (const part of match[1].split(',')) {
-		const range = part.trim();
-		if (!range) continue;
-		const [start, end] = range.split('-').map((n) => parseInt(n, 10));
-		for (let i = start; i <= (end ?? start); i++) lines.add(i);
-	}
-	return lines;
-}
-
-/** Whether the fence asked for line numbers (```ts showLineNumbers). */
-function hasLineNumbers(meta) {
-	return /\bshowLineNumbers\b/.test(meta);
-}
-
-/** Whether the fence asked for Twoslash type annotations (```ts twoslash). */
-function hasTwoslash(meta) {
-	return /\btwoslash\b/.test(meta);
-}
-
-const twoslash = transformerTwoslash({ explicitTrigger: true });
-
-/**
- * The YAML grammar gives the `---` document markers no scope, so they inherit
- * the bright default foreground and read as unhighlighted. Dim them to a subtle
- * token that adapts to both themes.
- */
-function transformerDimYamlMarkers() {
-	return {
-		name: 'axerity:dim-yaml-markers',
-		span(node) {
-			const text = node.children?.[0];
-			if (text && text.type === 'text' && text.value.trim() === '---') {
-				node.properties = { ...node.properties, style: 'color:var(--fg-subtle)' };
-			}
-		}
-	};
-}
-
-/** Shiki transformer: tag the requested lines with a `highlighted` class. */
-function transformerHighlightLines(lines) {
-	return {
-		name: 'axerity:highlight-lines',
-		line(node, lineNumber) {
-			if (lines.has(lineNumber)) this.addClassToHast(node, 'highlighted');
-		}
-	};
-}
-
-/**
- * Shiki separates lines with literal "\n" text nodes. With block-level lines
- * (needed for full-width highlights) those render as blank lines, so strip
- * them — the copy handler rejoins lines with newlines itself.
- */
-function transformerRemoveLineBreaks() {
-	return {
-		name: 'axerity:remove-line-breaks',
-		code(node) {
-			node.children = node.children.filter(
-				(child) => !(child.type === 'text' && child.value === '\n')
-			);
-		}
-	};
-}
-
-/** Shiki transformer: flag the block so CSS counters can number the lines. */
-function transformerLineNumbers() {
-	return {
-		name: 'axerity:line-numbers',
-		pre(node) {
-			this.addClassToHast(node, 'has-line-numbers');
-		}
-	};
-}
-
-// Static copy button injected into every code block; clicks are handled by a
-// delegated listener in DocsLayout (the markup carries no state itself).
-const COPY_BUTTON =
-	'<button class="copy-button" type="button" aria-label="Copy code">' +
-	'<svg class="icon-copy" xmlns="http://www.w3.org/2000/svg" width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect width="14" height="14" x="8" y="8" rx="2"/><path d="M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2"/></svg>' +
-	'<svg class="icon-check" xmlns="http://www.w3.org/2000/svg" width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><path d="M20 6 9 17l-5-5"/></svg>' +
-	'</button>';
-
-export default defineMDSveXConfig({
-	extensions: ['.svx', '.md'],
-	// Give every heading a stable id so the TOC can anchor + scroll-spy to it.
-	rehypePlugins: [rehypeSlug, rehypeTableWrapper, rehypeExternalLinks, rehypeBasePath],
-	highlight: {
-		highlighter: async (code, lang, meta) => {
-			if (lang === 'mermaid') {
-				const graph = escapeSvelte(
-					code.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;')
-				);
-				return `{@html \`<pre class="mermaid">${graph}</pre>\`}`;
-			}
-
-			const highlighter = await getHighlighter();
-			const language = (lang && highlighter.getLoadedLanguages().includes(lang) && lang) || 'text';
-			meta = meta || '';
-
-			const title = parseTitle(meta);
-			const highlightLines = parseHighlightLines(meta);
-			const twoslashEnabled = hasTwoslash(meta);
-
-			const transformers = [];
-			if (twoslashEnabled) transformers.push(twoslash);
-			if (language === 'yaml') transformers.push(transformerDimYamlMarkers());
-			transformers.push(transformerRemoveLineBreaks());
-			if (highlightLines.size) transformers.push(transformerHighlightLines(highlightLines));
-			if (hasLineNumbers(meta)) transformers.push(transformerLineNumbers());
-
-			const html = highlighter.codeToHtml(code, {
-				lang: language,
-				meta: { __raw: meta },
-				themes,
-				defaultColor: 'light',
-				transformers
-			});
-
-			// With a title, the copy button lives in the header bar; otherwise it
-			// floats in the top-right corner of the block.
-			const header = title
-				? `<div class="code-header"><span class="code-title">${escapeHtml(title)}</span>${COPY_BUTTON}</div>`
-				: '';
-			const blockClass =
-				(title ? 'code-block has-header' : 'code-block') + (twoslashEnabled ? ' has-twoslash' : '');
-			const floatingButton = title ? '' : COPY_BUTTON;
-			const wrapped = `<div class="${blockClass}">${header}${floatingButton}${html}</div>`;
-
-			// Escape so Svelte doesn't try to parse `{`, `}`, or backticks in the code.
-			return `{@html \`${escapeSvelte(wrapped)}\`}`;
-		}
-	}
-});

package/scripts/prepare-engine.mjs

@@ -1,20 +0,0 @@
-#!/usr/bin/env node
-import { cpSync, existsSync, mkdirSync, readdirSync, rmSync, symlinkSync } from 'node:fs';
-import { dirname, join, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const root = resolve(dirname(fileURLToPath(import.meta.url)), '..');
-const symlinkType = process.platform === 'win32' ? 'junction' : 'dir';
-
-const demo = join(root, 'src', 'content', 'demo');
-const docs = join(root, 'src', 'content', 'docs');
-const defaultConfig = join(root, 'axerity.default.json');
-const config = join(root, 'axerity.json');
-
-rmSync(docs, { recursive: true, force: true });
-mkdirSync(docs, { recursive: true });
-for (const entry of readdirSync(demo)) {
-	symlinkSync(join(demo, entry), join(docs, entry), symlinkType);
-}
-
-if (existsSync(defaultConfig)) cpSync(defaultConfig, config);

package/src/app.d.ts

@@ -1,17 +0,0 @@
-// See https://svelte.dev/docs/kit/types#app.d.ts
-// for information about these interfaces
-declare global {
-	namespace App {
-		// interface Error {}
-		// interface Locals {}
-		// interface PageData {}
-		// interface PageState {}
-		// interface Platform {}
-	}
-}
-
-// Fontsource ships CSS without type declarations; declare the side-effect imports.
-declare module '@fontsource-variable/geist/*';
-declare module '@fontsource-variable/geist-mono/*';
-
-export {};

package/src/app.html

@@ -1,39 +0,0 @@
-<!doctype html>
-<html lang="en">
-	<head>
-		<meta charset="utf-8" />
-		<meta name="viewport" content="width=device-width, initial-scale=1" />
-		<meta name="text-scale" content="scale" />
-		<script>
-			(() => {
-				try {
-					const pref = localStorage.getItem('axerity-theme') ?? 'dark';
-					const dark =
-						pref === 'dark' ||
-						(pref === 'system' && window.matchMedia('(prefers-color-scheme: dark)').matches);
-					document.documentElement.classList.toggle('dark', dark);
-				} catch {}
-			})();
-			(() => {
-				try {
-					const hide = [];
-					for (let i = 0; i < localStorage.length; i++) {
-						const key = localStorage.key(i);
-						if (key && key.indexOf('axerity-banner:') === 0 && localStorage.getItem(key) === '1') {
-							hide.push('[data-banner-key="' + key.replace(/"/g, '\\"') + '"]');
-						}
-					}
-					if (hide.length) {
-						const style = document.createElement('style');
-						style.textContent = hide.join(',') + '{display:none!important}';
-						document.head.appendChild(style);
-					}
-				} catch {}
-			})();
-		</script>
-		%sveltekit.head%
-	</head>
-	<body data-sveltekit-preload-data="hover">
-		<div style="display: contents">%sveltekit.body%</div>
-	</body>
-</html>

package/src/content/demo/api/meta.json

@@ -1,5 +0,0 @@
-{
-	"title": "API Reference",
-	"icon": "code",
-	"pages": ["pet", "store", "user"]
-}

package/src/content/demo/api/pet/add-pet.md

@@ -1,105 +0,0 @@
----
-title: Add a new pet
-description: Add a new pet to the store.
-icon: paw-print
-layout: api
-method: POST
----
-
-<script>
-	import { Api, Endpoint, ParamField, ResponseField, RequestExample, ResponseExample, ObjectExample } from '$lib';
-</script>
-
-# Add a new pet
-
-Add a new pet to the store.
-
-<Api>
-
-<Endpoint method="POST" path="/pet" baseUrl="https://petstore3.swagger.io/api/v3" />
-
-## Body parameters
-
-Create a new pet in the store.
-
-<ParamField name="name" type="string" required>
-
-The pet's name.
-
-</ParamField>
-
-<ParamField name="photoUrls" type="array of strings" required>
-
-URLs of the pet's photos.
-
-</ParamField>
-
-<ParamField name="category" type="Category" typeLink="/api/pet/pet-object">
-
-The category this pet belongs to.
-
-</ParamField>
-
-<ParamField name="status" type="enum">
-
-Pet status in the store. One of `available`, `pending`, or `sold`.
-
-</ParamField>
-
-## Returns
-
-Returns the created [Pet](/api/pet/pet-object).
-
-<ResponseField name="id" type="integer">
-
-Unique id for the new pet.
-
-</ResponseField>
-
-<RequestExample title="cURL">
-
-```bash
-curl https://petstore3.swagger.io/api/v3/pet \
-  -H "Content-Type: application/json" \
-  -d '{ "name": "doggie", "photoUrls": ["https://example.com/doggie.png"], "status": "available" }'
-```
-
-</RequestExample>
-
-<ResponseExample title="200 OK">
-
-```json
-{
-	"id": 10,
-	"name": "doggie",
-	"photoUrls": ["https://example.com/doggie.png"],
-	"status": "available"
-}
-```
-
-</ResponseExample>
-
-<ResponseExample title="400 Invalid input">
-
-```json
-{ "code": 400, "message": "Invalid input" }
-```
-
-</ResponseExample>
-
-<ObjectExample title="The Pet object">
-
-```json
-{
-	"id": 10,
-	"name": "doggie",
-	"category": { "id": 1, "name": "Dogs" },
-	"photoUrls": ["https://example.com/doggie.png"],
-	"tags": [{ "id": 1, "name": "friendly" }],
-	"status": "available"
-}
-```
-
-</ObjectExample>
-
-</Api>

package/src/content/demo/api/pet/delete-pet.md

@@ -1,70 +0,0 @@
----
-title: Delete a pet
-description: Delete a pet from the store.
-icon: paw-print
-layout: api
-method: DELETE
----
-
-<script>
-	import { Api, Endpoint, ParamField, ResponseField, RequestExample, ResponseExample } from '$lib';
-</script>
-
-# Delete a pet
-
-Delete a pet.
-
-<Api>
-
-<Endpoint method="DELETE" path={'/pet/{petId}'} baseUrl="https://petstore3.swagger.io/api/v3" />
-
-## Headers
-
-<ParamField name="api_key" type="string">
-
-Your store API key.
-
-</ParamField>
-
-## Path parameters
-
-<ParamField name="petId" type="integer" required>
-
-The id of the pet to delete.
-
-</ParamField>
-
-## Returns
-
-<ResponseField name="code" type="integer">
-
-The HTTP status code of the result.
-
-</ResponseField>
-
-<RequestExample title="cURL">
-
-```bash
-curl -X DELETE https://petstore3.swagger.io/api/v3/pet/10 \
-  -H "api_key: special-key"
-```
-
-</RequestExample>
-
-<ResponseExample title="200 OK">
-
-```json
-{ "code": 200, "message": "Pet deleted" }
-```
-
-</ResponseExample>
-
-<ResponseExample title="400 Invalid value">
-
-```json
-{ "code": 400, "message": "Invalid pet value" }
-```
-
-</ResponseExample>
-
-</Api>

package/src/content/demo/api/pet/find-by-status.md

@@ -1,72 +0,0 @@
----
-title: Find pets by status
-description: Find pets filtered by status.
-icon: paw-print
-layout: api
-method: GET
----
-
-<script>
-	import { Api, Endpoint, ParamField, ResponseField, RequestExample, ResponseExample, EnumValues, Enum } from '$lib';
-</script>
-
-# Find pets by status
-
-Multiple status values can be provided as comma separated strings.
-
-<Api>
-
-<Endpoint method="GET" path="/pet/findByStatus" baseUrl="https://petstore3.swagger.io/api/v3" />
-
-## Query parameters
-
-<ParamField name="status" type="enum" default="available">
-
-The status to filter by.
-
-<EnumValues>
-	<Enum value="available">Available for purchase.</Enum>
-	<Enum value="pending">Reserved, sale in progress.</Enum>
-	<Enum value="sold">Already sold.</Enum>
-</EnumValues>
-
-</ParamField>
-
-## Returns
-
-Returns an array of [Pet](/api/pet/pet-object) objects.
-
-<ResponseField name="data" type="Pet[]">
-
-The pets that match the status.
-
-</ResponseField>
-
-<RequestExample title="cURL">
-
-```bash
-curl "https://petstore3.swagger.io/api/v3/pet/findByStatus?status=available"
-```
-
-</RequestExample>
-
-<ResponseExample title="200 OK">
-
-```json
-[
-	{ "id": 10, "name": "doggie", "status": "available" },
-	{ "id": 11, "name": "kitty", "status": "available" }
-]
-```
-
-</ResponseExample>
-
-<ResponseExample title="400 Invalid status">
-
-```json
-{ "code": 400, "message": "Invalid status value" }
-```
-
-</ResponseExample>
-
-</Api>

package/src/content/demo/api/pet/find-by-tags.md

@@ -1,64 +0,0 @@
----
-title: Find pets by tags
-description: Find pets filtered by tags.
-icon: paw-print
-layout: api
-method: GET
----
-
-<script>
-	import { Api, Endpoint, ParamField, ResponseField, RequestExample, ResponseExample } from '$lib';
-</script>
-
-# Find pets by tags
-
-Multiple tags can be provided as comma separated strings. Use `tag1`, `tag2`,
-`tag3` for testing.
-
-<Api>
-
-<Endpoint method="GET" path="/pet/findByTags" baseUrl="https://petstore3.swagger.io/api/v3" />
-
-## Query parameters
-
-<ParamField name="tags" type="array of strings">
-
-Tags to filter by.
-
-</ParamField>
-
-## Returns
-
-Returns an array of [Pet](/api/pet/pet-object) objects.
-
-<ResponseField name="data" type="Pet[]">
-
-The pets that match the tags.
-
-</ResponseField>
-
-<RequestExample title="cURL">
-
-```bash
-curl "https://petstore3.swagger.io/api/v3/pet/findByTags?tags=friendly"
-```
-
-</RequestExample>
-
-<ResponseExample title="200 OK">
-
-```json
-[{ "id": 10, "name": "doggie", "tags": [{ "id": 1, "name": "friendly" }] }]
-```
-
-</ResponseExample>
-
-<ResponseExample title="400 Invalid tag">
-
-```json
-{ "code": 400, "message": "Invalid tag value" }
-```
-
-</ResponseExample>
-
-</Api>