@publier/openapi 0.3.38

package/src/components/code-samples.astro

@@ -0,0 +1,28 @@
+---
+import { openapiRenderCodeSamples } from '@publier/native';
+import { buildCodeSamples } from '../code-sample-generators.ts';
+import type { CodeSamplesProps } from './props.ts';
+type Props = CodeSamplesProps;
+
+const { method, path, operation, baseUrl = 'https://api.example.com' } = Astro.props;
+const samples = buildCodeSamples(method, path, operation, baseUrl);
+const html = openapiRenderCodeSamples(method, path, JSON.stringify(samples));
+---
+
+<Fragment set:html={html} />
+
+<style is:global>
+	.cs-code {
+		background-color: var(--color-zinc-950);
+	}
+	.cs-code .tab::before {
+		font-size: 0.75rem;
+		font-weight: 500;
+		color: var(--color-zinc-500);
+		transition: color 0.15s;
+	}
+	.cs-code .tab:hover::before { color: var(--color-zinc-300); }
+	.cs-code .tab:checked::before { color: var(--color-zinc-100); }
+	.cs-code .tab:checked { border-bottom-color: var(--color-primary); }
+	.cs-code .tab-content { border: none; border-radius: 0; padding: 0; background: transparent; }
+</style>

package/src/components/method-badge.astro

@@ -0,0 +1,26 @@
+---
+import { openapiRenderMethodBadge } from '@publier/native';
+import type { MethodBadgeProps } from './props.ts';
+type Props = MethodBadgeProps;
+
+const { method } = Astro.props;
+const html = openapiRenderMethodBadge(method);
+---
+
+<Fragment set:html={html} />
+
+<style is:global>
+	.method-badge {
+		--badge-h: var(--color-zinc-500);
+		--badge-l: var(--color-zinc-600);
+		--badge-d: var(--color-zinc-400);
+		color: light-dark(var(--badge-l), var(--badge-d));
+		background: color-mix(in oklch, var(--badge-h) 10%, transparent);
+		border-color: color-mix(in oklch, var(--badge-h) 20%, transparent);
+	}
+	.method-badge[data-method="get"]     { --badge-h: var(--color-green-500);  --badge-l: var(--color-green-600);  --badge-d: var(--color-green-400); }
+	.method-badge[data-method="post"]    { --badge-h: var(--color-blue-500);   --badge-l: var(--color-blue-600);   --badge-d: var(--color-blue-400); }
+	.method-badge[data-method="put"]     { --badge-h: var(--color-yellow-500); --badge-l: var(--color-yellow-600); --badge-d: var(--color-yellow-400); }
+	.method-badge[data-method="delete"]  { --badge-h: var(--color-red-500);    --badge-l: var(--color-red-600);    --badge-d: var(--color-red-400); }
+	.method-badge[data-method="patch"]   { --badge-h: var(--color-orange-500); --badge-l: var(--color-orange-600); --badge-d: var(--color-orange-400); }
+</style>

package/src/components/param-field.astro

@@ -0,0 +1,11 @@
+---
+import { openapiRenderParamField } from '@publier/native';
+import type { ParamFieldProps } from './props.ts';
+type Props = ParamFieldProps;
+
+const { name, type, required, default: d, deprecated, placeholder } = Astro.props;
+const slotHtml = await Astro.slots.render('default');
+const html = openapiRenderParamField(name, type, required ?? false, deprecated ?? false, d ?? null, placeholder ?? null, slotHtml);
+---
+
+<Fragment set:html={html} />

package/src/components/props.ts

@@ -0,0 +1,91 @@
+import type {
+	AsyncApiChannel,
+	AsyncApiMessage,
+	AsyncApiOperation,
+	AsyncApiServer,
+} from '../async-types.ts';
+import type {
+	HttpMethod,
+	OpenApiOperation,
+	OpenApiResponse,
+	OpenApiServer,
+	OpenApiSpec,
+} from '../types.ts';
+
+export interface APIReferenceProps {
+	method: HttpMethod;
+	path: string;
+	operation: OpenApiOperation;
+	spec?: OpenApiSpec;
+	baseUrl?: string;
+}
+
+export interface APIPageProps {
+	method: HttpMethod;
+	path: string;
+	operation: OpenApiOperation;
+}
+
+export interface MethodBadgeProps {
+	method: HttpMethod;
+}
+
+export interface APIPlaygroundProps {
+	method: HttpMethod;
+	path: string;
+	operation: OpenApiOperation;
+	servers?: OpenApiServer[];
+}
+
+export interface CodeSamplesProps {
+	method: HttpMethod;
+	path: string;
+	operation: OpenApiOperation;
+	baseUrl?: string;
+}
+
+export interface RequestExampleProps {
+	method: HttpMethod;
+	path: string;
+	operation: OpenApiOperation;
+	baseUrl?: string;
+}
+
+export interface ResponseExampleProps {
+	responses: Record<string, OpenApiResponse>;
+	instanceId?: string;
+}
+
+export interface SchemaViewProps {
+	schema: import('../types.ts').OpenApiSchema;
+	name?: string;
+	required?: boolean;
+	depth?: number;
+}
+
+export interface ParamFieldProps {
+	name: string;
+	type: string;
+	required?: boolean;
+	default?: string;
+	deprecated?: boolean;
+	placeholder?: string;
+}
+
+export interface ResponseFieldProps {
+	name: string;
+	type: string;
+	required?: boolean;
+	deprecated?: boolean;
+}
+
+export interface AsyncChannelProps {
+	channelName: string;
+	channel: AsyncApiChannel;
+	operations: { name: string; operation: AsyncApiOperation; messages: AsyncApiMessage[] }[];
+	servers?: Record<string, AsyncApiServer>;
+}
+
+export interface AsyncMessageProps {
+	message: AsyncApiMessage;
+}

package/src/components/request-example.astro

@@ -0,0 +1,12 @@
+---
+import { openapiRenderRequestExample } from '@publier/native';
+import { getMediaTypeExample } from '../example-utils.ts';
+import type { RequestExampleProps } from './props.ts';
+type Props = RequestExampleProps;
+
+const { method, path, operation, baseUrl = 'https://api.example.com' } = Astro.props;
+const body = operation.requestBody?.content ? getMediaTypeExample(operation.requestBody.content) : null;
+const html = openapiRenderRequestExample(method, path, JSON.stringify(operation), baseUrl, body ?? null);
+---
+
+<Fragment set:html={html} />

package/src/components/response-example.astro

@@ -0,0 +1,17 @@
+---
+import { openapiRenderResponseExample } from '@publier/native';
+import { getMediaTypeExample } from '../example-utils.ts';
+import type { ResponseExampleProps } from './props.ts';
+type Props = ResponseExampleProps;
+
+const { responses, instanceId } = Astro.props;
+const tabs = Object.entries(responses).map(([code, r]) => ({
+	code,
+	description: r.description,
+	body: r.content ? getMediaTypeExample(r.content) : undefined,
+	headers: r.headers ? Object.entries(r.headers).map(([n, h]) => ({ name: n, description: h.description })) : undefined,
+}));
+const html = openapiRenderResponseExample(JSON.stringify(tabs), instanceId ?? null);
+---
+
+<Fragment set:html={html} />

package/src/components/response-field.astro

@@ -0,0 +1,11 @@
+---
+import { openapiRenderResponseField } from '@publier/native';
+import type { ResponseFieldProps } from './props.ts';
+type Props = ResponseFieldProps;
+
+const { name, type, required, deprecated } = Astro.props;
+const slotHtml = await Astro.slots.render('default');
+const html = openapiRenderResponseField(name, type, required ?? false, deprecated ?? false, slotHtml);
+---
+
+<Fragment set:html={html} />

package/src/components/schema-view.astro

@@ -0,0 +1,15 @@
+---
+import { openapiRenderSchemaView } from '@publier/native';
+import type { SchemaViewProps } from './props.ts';
+type Props = SchemaViewProps;
+
+const { schema, name, required, depth = 0 } = Astro.props;
+const html = openapiRenderSchemaView(
+	JSON.stringify(schema),
+	name ?? null,
+	required ?? false,
+	depth,
+);
+---
+
+<Fragment set:html={html} />