@publier/openapi 0.3.38

package/dist/parser.d.mts

@@ -0,0 +1,136 @@
+//#region src/types.d.ts
+interface OpenApiSpec {
+  openapi: string;
+  info: OpenApiInfo;
+  servers?: OpenApiServer[];
+  paths: Record<string, OpenApiPathItem>;
+  /**
+   * OpenAPI 3.1 webhooks — server-to-client push endpoints, keyed by name.
+   * Shape-identical to path items but not part of the HTTP routing table.
+   */
+  webhooks?: Record<string, OpenApiPathItem>;
+  components?: OpenApiComponents;
+  tags?: OpenApiTag[];
+}
+interface OpenApiInfo {
+  title: string;
+  description?: string;
+  version: string;
+}
+interface OpenApiServer {
+  url: string;
+  description?: string;
+}
+interface OpenApiPathItem {
+  get?: OpenApiOperation;
+  post?: OpenApiOperation;
+  put?: OpenApiOperation;
+  delete?: OpenApiOperation;
+  patch?: OpenApiOperation;
+  head?: OpenApiOperation;
+  options?: OpenApiOperation;
+  summary?: string;
+  description?: string;
+  parameters?: OpenApiParameter[];
+}
+interface OpenApiOperation {
+  operationId?: string;
+  summary?: string;
+  description?: string;
+  tags?: string[];
+  parameters?: OpenApiParameter[];
+  requestBody?: OpenApiRequestBody;
+  responses: Record<string, OpenApiResponse>;
+  /**
+   * OpenAPI 3.0+ callbacks — out-of-band requests the service will make in
+   * response to this operation.
+   */
+  callbacks?: Record<string, Record<string, OpenApiPathItem>>;
+  security?: Record<string, string[]>[];
+  deprecated?: boolean;
+  'x-codeSamples'?: OpenApiCodeSample[];
+}
+interface OpenApiParameter {
+  name: string;
+  in: 'path' | 'query' | 'header' | 'cookie';
+  description?: string;
+  required?: boolean;
+  schema?: OpenApiSchema;
+  deprecated?: boolean;
+}
+interface OpenApiRequestBody {
+  description?: string;
+  required?: boolean;
+  content: Record<string, OpenApiMediaType>;
+}
+interface OpenApiResponse {
+  description: string;
+  content?: Record<string, OpenApiMediaType>;
+  headers?: Record<string, {
+    description?: string;
+    schema?: OpenApiSchema;
+  }>;
+}
+interface OpenApiMediaType {
+  schema?: OpenApiSchema;
+  example?: unknown;
+  examples?: Record<string, {
+    value: unknown;
+    summary?: string;
+  }>;
+}
+interface OpenApiSchema {
+  type?: string;
+  format?: string;
+  description?: string;
+  properties?: Record<string, OpenApiSchema>;
+  items?: OpenApiSchema;
+  required?: string[];
+  enum?: unknown[];
+  default?: unknown;
+  oneOf?: OpenApiSchema[];
+  anyOf?: OpenApiSchema[];
+  allOf?: OpenApiSchema[];
+  $ref?: string;
+  nullable?: boolean;
+  readOnly?: boolean;
+  writeOnly?: boolean;
+  deprecated?: boolean;
+  example?: unknown;
+  title?: string;
+  minimum?: number;
+  maximum?: number;
+  pattern?: string;
+  minLength?: number;
+  maxLength?: number;
+  additionalProperties?: boolean | OpenApiSchema;
+}
+interface OpenApiComponents {
+  schemas?: Record<string, OpenApiSchema>;
+  parameters?: Record<string, OpenApiParameter>;
+  responses?: Record<string, OpenApiResponse>;
+  requestBodies?: Record<string, OpenApiRequestBody>;
+  securitySchemes?: Record<string, OpenApiSecurityScheme>;
+}
+interface OpenApiSecurityScheme {
+  type: 'apiKey' | 'http' | 'oauth2' | 'openIdConnect';
+  description?: string;
+  name?: string;
+  in?: 'query' | 'header' | 'cookie';
+  scheme?: string;
+  bearerFormat?: string;
+}
+interface OpenApiTag {
+  name: string;
+  description?: string;
+}
+interface OpenApiCodeSample {
+  lang: string;
+  label?: string;
+  source: string;
+}
+//#endregion
+//#region src/parser.d.ts
+declare function parseOpenApiSpec(input: string): OpenApiSpec;
+//#endregion
+export { parseOpenApiSpec };

package/dist/parser.mjs

@@ -0,0 +1 @@
+import{openapiParseOpenapiSpec as e}from"@publier/native";import{parse as t}from"yaml";function n(n){let r;try{JSON.parse(n),r=n}catch{r=JSON.stringify(t(n))}return JSON.parse(e(r))}export{n as parseOpenApiSpec};

package/dist/server.d.mts

@@ -0,0 +1,238 @@
+//#region src/types.d.ts
+interface OpenApiSpec {
+  openapi: string;
+  info: OpenApiInfo;
+  servers?: OpenApiServer[];
+  paths: Record<string, OpenApiPathItem>;
+  /**
+   * OpenAPI 3.1 webhooks — server-to-client push endpoints, keyed by name.
+   * Shape-identical to path items but not part of the HTTP routing table.
+   */
+  webhooks?: Record<string, OpenApiPathItem>;
+  components?: OpenApiComponents;
+  tags?: OpenApiTag[];
+}
+interface OpenApiInfo {
+  title: string;
+  description?: string;
+  version: string;
+}
+interface OpenApiServer {
+  url: string;
+  description?: string;
+}
+interface OpenApiPathItem {
+  get?: OpenApiOperation;
+  post?: OpenApiOperation;
+  put?: OpenApiOperation;
+  delete?: OpenApiOperation;
+  patch?: OpenApiOperation;
+  head?: OpenApiOperation;
+  options?: OpenApiOperation;
+  summary?: string;
+  description?: string;
+  parameters?: OpenApiParameter[];
+}
+interface OpenApiOperation {
+  operationId?: string;
+  summary?: string;
+  description?: string;
+  tags?: string[];
+  parameters?: OpenApiParameter[];
+  requestBody?: OpenApiRequestBody;
+  responses: Record<string, OpenApiResponse>;
+  /**
+   * OpenAPI 3.0+ callbacks — out-of-band requests the service will make in
+   * response to this operation.
+   */
+  callbacks?: Record<string, Record<string, OpenApiPathItem>>;
+  security?: Record<string, string[]>[];
+  deprecated?: boolean;
+  'x-codeSamples'?: OpenApiCodeSample[];
+}
+interface OpenApiParameter {
+  name: string;
+  in: 'path' | 'query' | 'header' | 'cookie';
+  description?: string;
+  required?: boolean;
+  schema?: OpenApiSchema;
+  deprecated?: boolean;
+}
+interface OpenApiRequestBody {
+  description?: string;
+  required?: boolean;
+  content: Record<string, OpenApiMediaType>;
+}
+interface OpenApiResponse {
+  description: string;
+  content?: Record<string, OpenApiMediaType>;
+  headers?: Record<string, {
+    description?: string;
+    schema?: OpenApiSchema;
+  }>;
+}
+interface OpenApiMediaType {
+  schema?: OpenApiSchema;
+  example?: unknown;
+  examples?: Record<string, {
+    value: unknown;
+    summary?: string;
+  }>;
+}
+interface OpenApiSchema {
+  type?: string;
+  format?: string;
+  description?: string;
+  properties?: Record<string, OpenApiSchema>;
+  items?: OpenApiSchema;
+  required?: string[];
+  enum?: unknown[];
+  default?: unknown;
+  oneOf?: OpenApiSchema[];
+  anyOf?: OpenApiSchema[];
+  allOf?: OpenApiSchema[];
+  $ref?: string;
+  nullable?: boolean;
+  readOnly?: boolean;
+  writeOnly?: boolean;
+  deprecated?: boolean;
+  example?: unknown;
+  title?: string;
+  minimum?: number;
+  maximum?: number;
+  pattern?: string;
+  minLength?: number;
+  maxLength?: number;
+  additionalProperties?: boolean | OpenApiSchema;
+}
+interface OpenApiComponents {
+  schemas?: Record<string, OpenApiSchema>;
+  parameters?: Record<string, OpenApiParameter>;
+  responses?: Record<string, OpenApiResponse>;
+  requestBodies?: Record<string, OpenApiRequestBody>;
+  securitySchemes?: Record<string, OpenApiSecurityScheme>;
+}
+interface OpenApiSecurityScheme {
+  type: 'apiKey' | 'http' | 'oauth2' | 'openIdConnect';
+  description?: string;
+  name?: string;
+  in?: 'query' | 'header' | 'cookie';
+  scheme?: string;
+  bearerFormat?: string;
+}
+interface OpenApiTag {
+  name: string;
+  description?: string;
+}
+interface OpenApiCodeSample {
+  lang: string;
+  label?: string;
+  source: string;
+}
+type HttpMethod = 'get' | 'post' | 'put' | 'delete' | 'patch' | 'head' | 'options';
+//#endregion
+//#region src/endpoints.d.ts
+/** The kind of endpoint — a regular HTTP path, or an OpenAPI 3.1 webhook. */
+type EndpointKind = 'path' | 'webhook';
+/** A single endpoint extracted from an OpenAPI spec. */
+interface EndpointEntry {
+  method: HttpMethod;
+  path: string;
+  operation: OpenApiOperation;
+  /** `'path'` for `spec.paths`, `'webhook'` for `spec.webhooks`. Default `'path'`. */
+  kind?: EndpointKind;
+}
+//#endregion
+//#region src/navigation.d.ts
+/** A single navigation entry — typically one endpoint. */
+interface NavigationItem {
+  /** Human-readable label (operation summary or fall-back). */
+  label: string;
+  /** URL-safe slug usable as a sidebar link or a page id. */
+  slug: string;
+  /** HTTP method, uppercase. */
+  method: string;
+  /** Path template (e.g. `/users/{id}`). */
+  path: string;
+  /** Present when the upstream operation is flagged deprecated. */
+  deprecated?: boolean;
+  /** `'webhook'` when this came from `spec.webhooks`, else `'path'`. */
+  kind?: 'path' | 'webhook';
+}
+/**
+ * A group of related endpoints — one per tag (default) or per first path
+ * segment. Maps naturally to a sidebar group entry.
+ */
+interface NavigationGroup {
+  label: string;
+  description?: string;
+  items: NavigationItem[];
+}
+interface BuildNavigationOptions {
+  /**
+   * How to group endpoints. `'tag'` is the OpenAPI norm; `'path'` groups by
+   * first non-parameter path segment (useful for specs without tags).
+   */
+  groupBy?: 'tag' | 'path';
+  /**
+   * URL path prefixed onto every item slug. When the generated docs live
+   * under `/api`, pass `'api'` to get `api/<tag>/<operation>` slugs.
+   */
+  slugPrefix?: string;
+  /**
+   * Override the default label (operation.summary or `METHOD path`).
+   * Note: this callback cannot cross the Rust boundary and is not applied.
+   * Apply a post-pass on the returned groups if custom labels are needed.
+   */
+  formatLabel?: (ep: EndpointEntry) => string;
+  /**
+   * Drop deprecated operations from the output entirely. Default: keep them
+   * and expose the `deprecated` flag for renderers to style as needed.
+   */
+  excludeDeprecated?: boolean;
+  /** Forwarded to `extractEndpoints` — see that function's docs. */
+  includeWebhooks?: boolean;
+}
+//#endregion
+//#region src/server.d.ts
+interface CreateOpenAPIOptions {
+  /**
+   * OpenAPI spec input — file paths (JSON/YAML), URLs, or raw spec objects.
+   * Multiple specs are merged by combining their paths.
+   */
+  input: string[] | OpenApiSpec[];
+  /** Disable spec caching (re-parse on every access). */
+  disableCache?: boolean;
+}
+/** Resolved operation lookup result. */
+interface ResolvedOperation {
+  method: HttpMethod;
+  path: string;
+  operation: OpenApiOperation;
+}
+interface OpenAPIServer {
+  /** Get the parsed and merged OpenAPI spec. */
+  getSpec(): Promise<OpenApiSpec>;
+  /**
+   * Look up an operation by its `operationId`. Returns `undefined` when no
+   * operation matches.
+   */
+  getOperation(operationId: string): Promise<ResolvedOperation | undefined>;
+  /**
+   * Look up an operation by path + method (e.g. `'/users'`, `'get'`).
+   * Returns `undefined` when no operation matches.
+   */
+  getOperationByPath(path: string, method: HttpMethod): Promise<ResolvedOperation | undefined>;
+  /**
+   * Return every operation tagged with the given tag (case-sensitive, matches
+   * OpenAPI's `tags: [...]` array).
+   */
+  getOperationsByTag(tag: string): Promise<ResolvedOperation[]>;
+  /** Flat list of every extracted endpoint — paths and (by default) webhooks. */
+  getEndpoints(): Promise<EndpointEntry[]>;
+  /** Build a navigation tree from the merged spec. */
+  getNavigation(options?: BuildNavigationOptions): Promise<NavigationGroup[]>;
+}
+declare function createOpenAPI(options: CreateOpenAPIOptions): OpenAPIServer;
+//#endregion
+export { CreateOpenAPIOptions, OpenAPIServer, ResolvedOperation, createOpenAPI };

package/dist/server.mjs

@@ -0,0 +1 @@
+import{readFileSync as e}from"node:fs";import{openapiExtractEndpoints as t,openapiMergeSpecs as n,openapiNavigationBuild as r,openapiParseOpenapiSpec as i}from"@publier/native";import{parse as a}from"yaml";const o=[`get`,`post`,`put`,`delete`,`patch`,`head`,`options`];function s(e,n={}){let{mergePathParameters:r=!1,includeWebhooks:i=!0}=n;return JSON.parse(t(JSON.stringify(e),r,i))}function c(e,t={}){let{groupBy:n=`tag`,slugPrefix:i,excludeDeprecated:a=!1,includeWebhooks:o=!0}=t;return JSON.parse(r(JSON.stringify(e),n,i??null,a,o))}function l(e){let t;try{JSON.parse(e),t=e}catch{t=JSON.stringify(a(e))}return JSON.parse(i(t))}function u(t){let r=null;async function i(){if(r&&!t.disableCache)return r;let i=[];for(let n of t.input)if(typeof n==`string`){let t;if(n.startsWith(`http:`)||n.startsWith(`https:`)){let e=await fetch(n);if(!e.ok)throw Error(`Failed to fetch OpenAPI spec from "${n}": ${e.status} ${e.statusText}`);t=await e.text()}else t=e(n,`utf-8`);i.push(l(t))}else i.push(n);if(i.length===0)throw Error(`No OpenAPI specs provided`);return i.length===1?(r=i[0],r):(r=JSON.parse(n(JSON.stringify(i))),r)}return{getSpec:i,async getOperation(e){let t=await i();for(let[n,r]of Object.entries(t.paths))for(let t of o){let i=r[t];if(i?.operationId===e)return{method:t,path:n,operation:i}}},async getOperationByPath(e,t){let n=(await i()).paths[e]?.[t];return n?{method:t,path:e,operation:n}:void 0},async getOperationsByTag(e){return s(await i(),{mergePathParameters:!0}).filter(t=>t.operation.tags?.includes(e)).map(({method:e,path:t,operation:n})=>({method:e,path:t,operation:n}))},async getEndpoints(){return s(await i(),{mergePathParameters:!0})},async getNavigation(e){return c(await i(),e)}}}export{u as createOpenAPI};

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@publier/openapi",
+  "version": "0.3.38",
+  "license": "UNLICENSED",
+  "_filesRationale": "dist-only: TS → tsdown → dist; publishConfig.exports remaps to dist/*.mjs",
+  "type": "module",
+  "files": [
+    "dist",
+    "src/components/**/*.astro",
+    "src/components/**/*.ts",
+    "src/components/props.ts",
+    "!src/**/__tests__/**",
+    "!src/**/*.test.ts"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    },
+    "./server": {
+      "types": "./dist/server.d.mts",
+      "import": "./dist/server.mjs"
+    },
+    "./generate": {
+      "types": "./dist/generate.d.mts",
+      "import": "./dist/generate.mjs"
+    },
+    "./parser": {
+      "types": "./dist/parser.d.mts",
+      "import": "./dist/parser.mjs"
+    },
+    "./components/api-reference": "./src/components/api-reference.astro",
+    "./components/api-page": "./src/components/api-page.astro",
+    "./components/api-playground": "./src/components/api-playground.astro",
+    "./components/async-channel": "./src/components/async-channel.astro",
+    "./components/async-message": "./src/components/async-message.astro",
+    "./components/code-samples": "./src/components/code-samples.astro",
+    "./components/request-example": "./src/components/request-example.astro",
+    "./components/response-example": "./src/components/response-example.astro",
+    "./components/schema-view": "./src/components/schema-view.astro",
+    "./components/param-field": "./src/components/ParamField.astro",
+    "./components/response-field": "./src/components/ResponseField.astro",
+    "./components/method-badge": "./src/components/method-badge.astro"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@readme/httpsnippet": "^11.1.0",
+    "openapi-sampler": "^1.7.3",
+    "yaml": "^2.9.0",
+    "@publier/native": "0.10.1"
+  },
+  "peerDependencies": {
+    "astro": "^6.0.0 || >=7.0.0-alpha.0",
+    "tailwindcss": "^4"
+  },
+  "peerDependenciesMeta": {
+    "tailwindcss": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "astro": "7.0.0-beta.3",
+    "tsdown": "^0.22.0",
+    "typescript": "^6.0.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Publier/releases.git",
+    "directory": "packages/openapi"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "check-types": "tsc --noEmit",
+    "test": "echo \"@publier/openapi: covered by root vitest workspace\" && exit 0"
+  }
+}

package/src/components/_collapsible-section.astro

@@ -0,0 +1,14 @@
+---
+import { openapiRenderCollapsibleSection } from '@publier/native';
+
+interface Props {
+	title: string;
+	defaultOpen?: boolean;
+}
+
+const { title, defaultOpen = false } = Astro.props;
+const slotHtml = await Astro.slots.render('default');
+const html = openapiRenderCollapsibleSection(title, defaultOpen, slotHtml);
+---
+
+<Fragment set:html={html} />

package/src/components/_schema-row.astro

@@ -0,0 +1,11 @@
+---
+import { openapiRenderSchemaRow } from '@publier/native';
+import type { OpenApiSchema } from '../types.ts';
+
+interface Props { schema: OpenApiSchema; name?: string; required?: boolean; depth?: number }
+
+const { schema, name, required = false, depth = 0 } = Astro.props;
+const html = openapiRenderSchemaRow(JSON.stringify({ schema, name, required, depth }));
+---
+
+<Fragment set:html={html} />

package/src/components/api-page.astro

@@ -0,0 +1,21 @@
+---
+import { openapiRenderApiPage } from '@publier/native';
+import type { APIPageProps } from './props.ts';
+type Props = APIPageProps;
+
+const { method, path, operation } = Astro.props;
+const html = openapiRenderApiPage(method, path, JSON.stringify(operation));
+---
+
+<Fragment set:html={html} />
+
+<style is:global>
+	.res-row {
+		border-left-color: var(--color-zinc-400);
+		background: color-mix(in oklch, var(--color-zinc-500) 5%, transparent);
+	}
+	.res-row[data-family="2"] { border-left-color: var(--color-green-500);  background: color-mix(in oklch, var(--color-green-500)  5%, transparent); }
+	.res-row[data-family="3"] { border-left-color: var(--color-blue-500);   background: color-mix(in oklch, var(--color-blue-500)   5%, transparent); }
+	.res-row[data-family="4"] { border-left-color: var(--color-yellow-500); background: color-mix(in oklch, var(--color-yellow-500) 5%, transparent); }
+	.res-row[data-family="5"] { border-left-color: var(--color-red-500);    background: color-mix(in oklch, var(--color-red-500)    5%, transparent); }
+</style>

package/src/components/api-playground-ce-element.ts

@@ -0,0 +1,90 @@
+export class PublierApiPlayground extends HTMLElement {
+	connectedCallback() {
+		this.querySelector('form')?.addEventListener('submit', this.#send.bind(this));
+	}
+
+	async #send(e: SubmitEvent) {
+		e.preventDefault();
+		const form = e.target as HTMLFormElement;
+		const data = new FormData(form);
+
+		const method = (form.dataset.method ?? 'get').toUpperCase();
+		let path = form.dataset.path ?? '/';
+
+		for (const [key, val] of data.entries()) {
+			if (key.startsWith('path:')) {
+				const paramName = key.slice(5);
+				path = path.replace(`{${paramName}}`, encodeURIComponent((val as string) || paramName));
+			}
+		}
+
+		const qs = new URLSearchParams();
+		for (const [key, val] of data.entries()) {
+			if (key.startsWith('query:') && val) qs.set(key.slice(6), val as string);
+		}
+		const server = (data.get('server') as string) ?? '';
+		const fullUrl = `${server}${path}${qs.size > 0 ? `?${qs}` : ''}`;
+
+		const headers: Record<string, string> = { 'Content-Type': 'application/json' };
+		const bearer = data.get('auth:bearer') as string;
+		const apiKey = data.get('auth:apikey') as string;
+		if (bearer) headers.Authorization = `Bearer ${bearer}`;
+		if (apiKey) headers['X-API-Key'] = apiKey;
+		for (const [key, val] of data.entries()) {
+			if (key.startsWith('header:') && val) headers[key.slice(7)] = val as string;
+		}
+
+		const hasBody = !['GET', 'HEAD', 'OPTIONS'].includes(method);
+		const body = hasBody ? (data.get('body') as string) || undefined : undefined;
+
+		const sendBtn = this.querySelector<HTMLButtonElement>('[data-pg-send]');
+		const responseEl = this.querySelector('[data-pg-response]');
+		const errorEl = this.querySelector('[data-pg-error]');
+
+		if (sendBtn) {
+			sendBtn.disabled = true;
+			sendBtn.textContent = 'Sending…';
+		}
+		if (errorEl) errorEl.textContent = '';
+		if (responseEl) responseEl.innerHTML = '';
+
+		try {
+			const res = await fetch(fullUrl, { method, headers, body });
+			const bodyText = await res.text();
+
+			let formatted = bodyText;
+			try {
+				formatted = JSON.stringify(JSON.parse(bodyText), null, 2);
+			} catch {}
+
+			const isSuccess = res.status >= 200 && res.status < 300;
+			const statusColor = isSuccess ? 'var(--color-green-400)' : 'var(--color-red-400)';
+
+			if (responseEl) {
+				responseEl.innerHTML = `
+					<div style="display:flex;align-items:center;padding:0.375rem 0.75rem;border-bottom:1px solid var(--color-border,rgba(0,0,0,.12))">
+						<span style="font-family:ui-monospace,monospace;font-size:0.75rem;font-weight:600;color:${statusColor}">
+							${this.#escHtml(String(res.status))} ${this.#escHtml(res.statusText)}
+						</span>
+					</div>
+					<pre style="margin:0;overflow:auto;padding:0.625rem 0.75rem;font-family:ui-monospace,monospace;font-size:0.75rem;line-height:1.6"><code>${this.#escHtml(formatted)}</code></pre>
+				`;
+			}
+		} catch (err) {
+			if (errorEl) errorEl.textContent = err instanceof Error ? err.message : 'Request failed';
+		} finally {
+			if (sendBtn) {
+				sendBtn.disabled = false;
+				sendBtn.textContent = 'Send Request';
+			}
+		}
+	}
+
+	#escHtml(str: string): string {
+		return str.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+	}
+}
+
+if (typeof customElements !== 'undefined' && !customElements.get('publier-api-playground')) {
+	customElements.define('publier-api-playground', PublierApiPlayground);
+}

package/src/components/api-playground.astro

@@ -0,0 +1,14 @@
+---
+import { openapiRenderApiPlayground } from '@publier/native';
+import type { APIPlaygroundProps } from './props.ts';
+type Props = APIPlaygroundProps;
+
+const { method, path, operation, servers = [] } = Astro.props;
+const html = openapiRenderApiPlayground(JSON.stringify({ method, path, operation, servers }));
+---
+
+<Fragment set:html={html} />
+
+<script>
+	import './api-playground-ce-element.ts';
+</script>

package/src/components/api-reference.astro

@@ -0,0 +1,21 @@
+---
+import { openapiRenderApiReferenceShell, openapiBuildInstanceId, openapiResolveBaseUrl } from '@publier/native';
+import APIPage from './api-page.astro';
+import CodeSamples from './code-samples.astro';
+import RequestExample from './request-example.astro';
+import ResponseExample from './response-example.astro';
+import type { APIReferenceProps } from './props.ts';
+type Props = APIReferenceProps;
+
+const { method, path, operation, spec, baseUrl: baseUrlProp } = Astro.props;
+const baseUrl = openapiResolveBaseUrl(baseUrlProp ?? null, spec?.servers?.[0]?.url ?? null);
+const instanceId = openapiBuildInstanceId(method, path);
+const L = JSON.parse(openapiRenderApiReferenceShell());
+---
+<Fragment set:html={L.rootOpen + L.mainOpen} />
+<APIPage method={method} path={path} operation={operation} />
+<Fragment set:html={L.mainCloseAsideOpen} />
+<RequestExample method={method} path={path} operation={operation} baseUrl={baseUrl} />
+<CodeSamples method={method} path={path} operation={operation} baseUrl={baseUrl} />
+<ResponseExample responses={operation.responses} instanceId={instanceId} />
+<Fragment set:html={L.close} />

package/src/components/async-channel.astro

@@ -0,0 +1,11 @@
+---
+import { openapiRenderAsyncChannel } from '@publier/native';
+import type { AsyncChannelProps } from './props.ts';
+type Props = AsyncChannelProps;
+
+const { channelName, channel, operations, servers } = Astro.props;
+const protocol = ((servers ? Object.values(servers)[0]?.protocol : undefined) ?? 'ws').toLowerCase();
+const html = openapiRenderAsyncChannel(channelName, JSON.stringify(channel), JSON.stringify(operations), protocol);
+---
+
+<Fragment set:html={html} />

package/src/components/async-message.astro

@@ -0,0 +1,10 @@
+---
+import { openapiRenderAsyncMessage } from '@publier/native';
+import type { AsyncMessageProps } from './props.ts';
+type Props = AsyncMessageProps;
+
+const { message } = Astro.props;
+const html = openapiRenderAsyncMessage(JSON.stringify(message));
+---
+
+<Fragment set:html={html} />