schema-components 1.28.2 → 2.0.0

package/dist/openapi/components.d.mts

@@ -1,7 +1,7 @@
-import { u as FieldOverride, w as SchemaMeta } from "../types-BTB73MB8.mjs";
-import { r as DiagnosticSink } from "../diagnostics-Cbwak-ZX.mjs";
-import { InferParameterOverrides, InferRequestBodyFields, InferResponseFields } from "../core/typeInference.mjs";
-import { WidgetMap } from "../react/SchemaComponent.mjs";
+import { u as FieldOverride, w as SchemaMeta } from "../types-BrYbjC7_.mjs";
+import { r as DiagnosticSink } from "../diagnostics-BTrm3O6J.mjs";
+import { WidgetMap } from "../core/renderer.mjs";
+import { InferParameterOverrides, InferRequestBodyFields, InferResponseFields, OpenAPIRequestBodyType, OpenAPIResponseType } from "../core/typeInference.mjs";
 import { ReactNode } from "react";
 
 //#region src/openapi/components.d.ts
@@ -168,13 +168,35 @@ interface ApiDiagnosticsProps {
   onDiagnostic?: DiagnosticSink;
   strict?: boolean;
 }
-interface ApiOperationProps<Doc = unknown, Path extends PathKeysOf<Doc> = PathKeysOf<Doc>, Method extends MethodKeysOf<Doc, Path> = MethodKeysOf<Doc, Path>, ContentType extends RequestContentTypesOf<Doc, Path, Method> = RequestContentTypesOf<Doc, Path, Method>> extends ApiDiagnosticsProps {
+/**
+ * Props accepted by {@link ApiOperation}.
+ *
+ * @group OpenAPI
+ */
+interface ApiOperationProps<Doc = unknown, Path extends PathKeysOf<Doc> = PathKeysOf<Doc>, Method extends MethodKeysOf<Doc, Path> = MethodKeysOf<Doc, Path>, ContentType extends RequestContentTypesOf<Doc, Path, Method> = RequestContentTypesOf<Doc, Path, Method>, ResponseStatus extends StatusKeysOf<Doc, Path, Method> = StatusKeysOf<Doc, Path, Method>, ResponseContentType extends ResponseContentTypesOf<Doc, Path, Method, ResponseStatus> = ResponseContentTypesOf<Doc, Path, Method, ResponseStatus>> extends ApiDiagnosticsProps {
   schema: Doc;
   path: Path;
   method: Method;
-  requestBodyValue?: unknown;
-  onRequestBodyChange?: (value: unknown) => void;
-  responseValue?: unknown;
+  /**
+   * Current request body value. Inferred from the operation's
+   * request body schema via {@link OpenAPIRequestBodyType} so a
+   * typed `schema` argument drives the rendered value's shape.
+   */
+  requestBodyValue?: OpenAPIRequestBodyType<Doc, Path & string, Method & string, ContentType & string>;
+  /**
+   * Called when the request body value changes. Parameter type
+   * mirrors {@link ApiOperationProps.requestBodyValue}.
+   */
+  onRequestBodyChange?: (value: OpenAPIRequestBodyType<Doc, Path & string, Method & string, ContentType & string>) => void;
+  /**
+   * Current response value. Inferred via {@link OpenAPIResponseType}
+   * from the operation's response schema for the supplied
+   * `responseStatus` (defaulting to the union of declared statuses)
+   * and `responseContentType` (defaulting to the union of declared
+   * media types). The same value is rendered against every response
+   * card the component emits.
+   */
+  responseValue?: OpenAPIResponseType<Doc, Path & string, Method & string, ResponseStatus & string, ResponseContentType & string>;
   meta?: SchemaMeta;
   /**
    * Media type whose request body schema drives `requestBodyFields`
@@ -185,11 +207,44 @@ interface ApiOperationProps<Doc = unknown, Path extends PathKeysOf<Doc> = PathKe
    * same precision as `<ApiRequestBody>`.
    */
   requestBodyContentType?: ContentType;
+  /**
+   * Status code whose response schema drives `responseValue`
+   * inference. Defaults to the union of declared statuses so
+   * callers can omit it; supply explicitly to narrow inference to
+   * a specific response (e.g. `"200"`).
+   */
+  responseStatus?: ResponseStatus;
+  /**
+   * Media type whose response schema drives `responseValue`
+   * inference. Defaults to the union of declared content types so
+   * callers can omit it; supply explicitly to narrow inference to
+   * a specific media type.
+   */
+  responseContentType?: ResponseContentType;
   requestBodyFields?: Doc extends Record<string, unknown> ? InferRequestBodyFields<Doc, Path & string, Method & string, ContentType & string> : Record<string, FieldOverride>;
   /** Instance-scoped widgets. */
   widgets?: WidgetMap;
 }
-declare function ApiOperation<Doc = unknown, Path extends PathKeysOf<Doc> = PathKeysOf<Doc>, Method extends MethodKeysOf<Doc, Path> = MethodKeysOf<Doc, Path>, ContentType extends RequestContentTypesOf<Doc, Path, Method> = RequestContentTypesOf<Doc, Path, Method>>({
+/**
+ * Render a single OpenAPI operation — header, parameters, request body,
+ * responses, callbacks, security, and external docs — picked out of a
+ * supplied document by `path` and `method`.
+ *
+ * When `schema` is typed `as const`, `requestBodyFields` autocomplete
+ * resolves from the operation's request body schema. The component
+ * works with OpenAPI 2.0, 3.0, and 3.1 inputs (Swagger 2.0 documents
+ * are normalised to 3.1 internally) and also resolves OpenAPI 3.1
+ * webhooks under the same code path.
+ *
+ * @group OpenAPI
+ * @example
+ * ```tsx
+ * import { ApiOperation } from "schema-components/openapi/components";
+ *
+ * <ApiOperation schema={petStore} path="/pets" method="post" />
+ * ```
+ */
+declare function ApiOperation<Doc = unknown, Path extends PathKeysOf<Doc> = PathKeysOf<Doc>, Method extends MethodKeysOf<Doc, Path> = MethodKeysOf<Doc, Path>, ContentType extends RequestContentTypesOf<Doc, Path, Method> = RequestContentTypesOf<Doc, Path, Method>, ResponseStatus extends StatusKeysOf<Doc, Path, Method> = StatusKeysOf<Doc, Path, Method>, ResponseContentType extends ResponseContentTypesOf<Doc, Path, Method, ResponseStatus> = ResponseContentTypesOf<Doc, Path, Method, ResponseStatus>>({
   schema: doc,
   path,
   method,
@@ -201,7 +256,12 @@ declare function ApiOperation<Doc = unknown, Path extends PathKeysOf<Doc> = Path
   widgets,
   onDiagnostic,
   strict
-}: ApiOperationProps<Doc, Path, Method, ContentType>): ReactNode;
+}: ApiOperationProps<Doc, Path, Method, ContentType, ResponseStatus, ResponseContentType>): ReactNode;
+/**
+ * Props accepted by {@link ApiParameters}.
+ *
+ * @group OpenAPI
+ */
 interface ApiParametersProps<Doc = unknown, Path extends PathKeysOf<Doc> = PathKeysOf<Doc>, Method extends MethodKeysOf<Doc, Path> = MethodKeysOf<Doc, Path>> extends ApiDiagnosticsProps {
   schema: Doc;
   path: Path;
@@ -211,6 +271,14 @@ interface ApiParametersProps<Doc = unknown, Path extends PathKeysOf<Doc> = PathK
   /** Instance-scoped widgets. */
   widgets?: WidgetMap;
 }
+/**
+ * Render the `parameters` of a single OpenAPI operation — path, query,
+ * header, and cookie parameters — picked out of `schema` by `path` and
+ * `method`. When the document is typed `as const`, the `overrides` prop
+ * autocompletes on each parameter name.
+ *
+ * @group OpenAPI
+ */
 declare function ApiParameters<Doc = unknown, Path extends PathKeysOf<Doc> = PathKeysOf<Doc>, Method extends MethodKeysOf<Doc, Path> = MethodKeysOf<Doc, Path>>({
   schema: doc,
   path,
@@ -221,6 +289,11 @@ declare function ApiParameters<Doc = unknown, Path extends PathKeysOf<Doc> = Pat
   onDiagnostic,
   strict
 }: ApiParametersProps<Doc, Path, Method>): ReactNode;
+/**
+ * Props accepted by {@link ApiRequestBody}.
+ *
+ * @group OpenAPI
+ */
 interface ApiRequestBodyProps<Doc = unknown, Path extends PathKeysOf<Doc> = PathKeysOf<Doc>, Method extends MethodKeysOf<Doc, Path> = MethodKeysOf<Doc, Path>, ContentType extends RequestContentTypesOf<Doc, Path, Method> = RequestContentTypesOf<Doc, Path, Method>> extends ApiDiagnosticsProps {
   schema: Doc;
   path: Path;
@@ -239,6 +312,17 @@ interface ApiRequestBodyProps<Doc = unknown, Path extends PathKeysOf<Doc> = Path
   /** Instance-scoped widgets. */
   widgets?: WidgetMap;
 }
+/**
+ * Render the request body of a single OpenAPI operation, picked out of
+ * `schema` by `path` and `method`. Returns `null` when the operation
+ * declares no request body or no resolvable schema.
+ *
+ * When `schema` is typed `as const`, `fields` autocomplete resolves
+ * from the request body schema; pass `contentType` to narrow inference
+ * to a specific media type.
+ *
+ * @group OpenAPI
+ */
 declare function ApiRequestBody<Doc = unknown, Path extends PathKeysOf<Doc> = PathKeysOf<Doc>, Method extends MethodKeysOf<Doc, Path> = MethodKeysOf<Doc, Path>, ContentType extends RequestContentTypesOf<Doc, Path, Method> = RequestContentTypesOf<Doc, Path, Method>>({
   schema: doc,
   path,
@@ -251,6 +335,11 @@ declare function ApiRequestBody<Doc = unknown, Path extends PathKeysOf<Doc> = Pa
   onDiagnostic,
   strict
 }: ApiRequestBodyProps<Doc, Path, Method, ContentType>): ReactNode;
+/**
+ * Props accepted by {@link ApiResponse}.
+ *
+ * @group OpenAPI
+ */
 interface ApiResponseProps<Doc = unknown, Path extends PathKeysOf<Doc> = PathKeysOf<Doc>, Method extends MethodKeysOf<Doc, Path> = MethodKeysOf<Doc, Path>, Status extends StatusKeysOf<Doc, Path, Method> = StatusKeysOf<Doc, Path, Method>, ContentType extends ResponseContentTypesOf<Doc, Path, Method, Status> = ResponseContentTypesOf<Doc, Path, Method, Status>> extends ApiDiagnosticsProps {
   schema: Doc;
   path: Path;
@@ -269,6 +358,18 @@ interface ApiResponseProps<Doc = unknown, Path extends PathKeysOf<Doc> = PathKey
   /** Instance-scoped widgets. */
   widgets?: WidgetMap;
 }
+/**
+ * Render the response schema for a single OpenAPI operation status —
+ * picked out of `schema` by `path`, `method`, and `status`.
+ *
+ * Status resolution follows the OpenAPI priority order: concrete code
+ * (e.g. `"200"`) > class wildcard (e.g. `"2XX"`) > `"default"`. When
+ * `schema` is typed `as const`, `fields` autocomplete resolves from
+ * the response schema; pass `contentType` to narrow inference to a
+ * specific media type.
+ *
+ * @group OpenAPI
+ */
 declare function ApiResponse<Doc = unknown, Path extends PathKeysOf<Doc> = PathKeysOf<Doc>, Method extends MethodKeysOf<Doc, Path> = MethodKeysOf<Doc, Path>, Status extends StatusKeysOf<Doc, Path, Method> = StatusKeysOf<Doc, Path, Method>, ContentType extends ResponseContentTypesOf<Doc, Path, Method, Status> = ResponseContentTypesOf<Doc, Path, Method, Status>>({
   schema: doc,
   path,
@@ -282,14 +383,9 @@ declare function ApiResponse<Doc = unknown, Path extends PathKeysOf<Doc> = PathK
   strict
 }: ApiResponseProps<Doc, Path, Method, Status, ContentType>): ReactNode;
 /**
- * Render a single OpenAPI 3.1 webhook by name. A webhook is a Path Item
- * Object under the document's top-level `webhooks` map; once resolved,
- * its operations are structurally identical to operations under `paths`.
+ * Props accepted by {@link ApiWebhook}.
  *
- * Internally, this delegates to `ApiOperation` for each method present
- * on the webhook's Path Item Object. The parser's `lookupPathItem`
- * resolves webhook names through the same code path as paths, so
- * `ApiOperation` works for both with no special-casing in the renderer.
+ * @group OpenAPI
  */
 interface ApiWebhookProps extends ApiDiagnosticsProps {
   schema: unknown;
@@ -299,6 +395,18 @@ interface ApiWebhookProps extends ApiDiagnosticsProps {
   widgets?: WidgetMap;
   meta?: SchemaMeta;
 }
+/**
+ * Render a single OpenAPI 3.1 webhook by name. A webhook is a Path Item
+ * Object under the document's top-level `webhooks` map; once resolved,
+ * its operations are structurally identical to operations under `paths`.
+ *
+ * Delegates to {@link ApiOperation} for each method present on the
+ * webhook's Path Item Object — the parser's `lookupPathItem` resolves
+ * webhook names through the same code path as paths, so `ApiOperation`
+ * works for both with no special-casing in the renderer.
+ *
+ * @group OpenAPI
+ */
 declare function ApiWebhook({
   schema: doc,
   name,
@@ -308,15 +416,22 @@ declare function ApiWebhook({
   strict
 }: ApiWebhookProps): ReactNode;
 /**
- * Render every OpenAPI 3.1 webhook declared on the document, one
- * `<ApiWebhook>` per entry. Returns `null` when the document has no
- * `webhooks` map or it is empty.
+ * Props accepted by {@link ApiWebhooks}.
+ *
+ * @group OpenAPI
  */
 interface ApiWebhooksProps extends ApiDiagnosticsProps {
   schema: unknown;
   widgets?: WidgetMap;
   meta?: SchemaMeta;
 }
+/**
+ * Render every OpenAPI 3.1 webhook declared on the document, one
+ * `<ApiWebhook>` per entry. Returns `null` when the document has no
+ * `webhooks` map or the map is empty.
+ *
+ * @group OpenAPI
+ */
 declare function ApiWebhooks({
   schema: doc,
   widgets,

package/dist/openapi/components.mjs

@@ -1,16 +1,17 @@
 import { isObject, toRecordOrUndefined } from "../core/guards.mjs";
 import { emitDiagnostic } from "../core/diagnostics.mjs";
+import { isSafeHyperlink } from "../core/uri.mjs";
 import { extractRootMetaFromJson } from "../core/adapter.mjs";
 import { walk } from "../core/walker.mjs";
-import { joinPath, renderField, sanitisePrefix } from "../react/SchemaComponent.mjs";
 import { ApiCallbacks } from "./ApiCallbacks.mjs";
 import { ApiLinks } from "./ApiLinks.mjs";
 import { ApiResponseHeaders } from "./ApiResponseHeaders.mjs";
 import { ApiSecurity } from "./ApiSecurity.mjs";
-import { getExternalDocs, getLinks, getSecurityRequirements, getSecuritySchemes, getXmlInfo, listCallbacks, listWebhooks } from "./parser.mjs";
-import { getParsed, resolveOperationFromParsed, resolveParametersFromParsed, resolveRequestBodyFromParsed, resolveResponseFromParsed, toDoc } from "./resolve.mjs";
-import { useId } from "react";
+import { extractExternalDocs, extractLinks, extractSecurityRequirements, extractSecuritySchemes, extractXmlInfo, listCallbacks, listWebhooks } from "./parser.mjs";
+import { joinPath, renderField, sanitisePrefix } from "../react/SchemaComponent.mjs";
+import { getParsed, resolveOperation, resolveParameters, resolveRequestBody, resolveResponse, toDoc } from "./resolve.mjs";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useId } from "react";
 //#region src/openapi/components.tsx
 /**
 * OpenAPI React components with type-safe generics.
@@ -78,11 +79,16 @@ function renderSchema(schema, rootDocument, options) {
 */
 function ExternalDocsLink({ externalDocs }) {
 	if (externalDocs === void 0) return null;
+	const label = externalDocs.description ?? externalDocs.url;
+	if (!isSafeHyperlink(externalDocs.url)) return /* @__PURE__ */ jsx("p", {
+		"data-external-docs": true,
+		children: /* @__PURE__ */ jsx("span", { children: label })
+	});
 	return /* @__PURE__ */ jsx("p", {
 		"data-external-docs": true,
 		children: /* @__PURE__ */ jsx("a", {
 			href: externalDocs.url,
-			children: externalDocs.description ?? externalDocs.url
+			children: label
 		})
 	});
 }
@@ -107,18 +113,37 @@ function SchemaXmlFootnote({ xml }) {
 		] })
 	});
 }
+/**
+* Render a single OpenAPI operation — header, parameters, request body,
+* responses, callbacks, security, and external docs — picked out of a
+* supplied document by `path` and `method`.
+*
+* When `schema` is typed `as const`, `requestBodyFields` autocomplete
+* resolves from the operation's request body schema. The component
+* works with OpenAPI 2.0, 3.0, and 3.1 inputs (Swagger 2.0 documents
+* are normalised to 3.1 internally) and also resolves OpenAPI 3.1
+* webhooks under the same code path.
+*
+* @group OpenAPI
+* @example
+* ```tsx
+* import { ApiOperation } from "schema-components/openapi/components";
+*
+* <ApiOperation schema={petStore} path="/pets" method="post" />
+* ```
+*/
 function ApiOperation({ schema: doc, path, method, requestBodyValue, onRequestBodyChange, responseValue, meta, requestBodyFields, widgets, onDiagnostic, strict }) {
 	const diagnostics = buildDiagnostics(onDiagnostic, strict);
 	const instancePrefix = sanitisePrefix(useId());
 	const rootDoc = resolveRootDoc(doc, diagnostics);
 	if (rootDoc === void 0) return null;
 	const parsed = getParsed(rootDoc, diagnostics);
-	const resolved = resolveOperationFromParsed(parsed, path, method, diagnostics);
-	const securityReqs = getSecurityRequirements(parsed, path, method);
-	const securitySchemes = getSecuritySchemes(parsed);
+	const resolved = resolveOperation(parsed, path, method, diagnostics);
+	const securityReqs = extractSecurityRequirements(parsed, path, method);
+	const securitySchemes = extractSecuritySchemes(parsed);
 	const callbacks = listCallbacks(parsed, path, method);
-	const operationExternalDocs = getExternalDocs(resolved.operation.operation);
-	const requestBodyXml = resolved.requestBody?.schema !== void 0 ? getXmlInfo(resolved.requestBody.schema) : void 0;
+	const operationExternalDocs = extractExternalDocs(resolved.operation.operation);
+	const requestBodyXml = resolved.requestBody?.schema !== void 0 ? extractXmlInfo(resolved.requestBody.schema) : void 0;
 	return /* @__PURE__ */ jsxs("section", {
 		"data-operation": `${method.toUpperCase()} ${path}`,
 		children: [
@@ -184,12 +209,20 @@ function ApiOperation({ schema: doc, path, method, requestBodyValue, onRequestBo
 		]
 	});
 }
+/**
+* Render the `parameters` of a single OpenAPI operation — path, query,
+* header, and cookie parameters — picked out of `schema` by `path` and
+* `method`. When the document is typed `as const`, the `overrides` prop
+* autocompletes on each parameter name.
+*
+* @group OpenAPI
+*/
 function ApiParameters({ schema: doc, path, method, meta, overrides, widgets, onDiagnostic, strict }) {
 	const diagnostics = buildDiagnostics(onDiagnostic, strict);
 	const instancePrefix = sanitisePrefix(useId());
 	const rootDoc = resolveRootDoc(doc, diagnostics);
 	if (rootDoc === void 0) return null;
-	const params = resolveParametersFromParsed(getParsed(rootDoc, diagnostics), path, method);
+	const params = resolveParameters(getParsed(rootDoc, diagnostics), path, method);
 	if (params.length === 0) return null;
 	return /* @__PURE__ */ jsxs("section", {
 		"data-parameters": true,
@@ -205,14 +238,25 @@ function ApiParameters({ schema: doc, path, method, meta, overrides, widgets, on
 		})]
 	});
 }
+/**
+* Render the request body of a single OpenAPI operation, picked out of
+* `schema` by `path` and `method`. Returns `null` when the operation
+* declares no request body or no resolvable schema.
+*
+* When `schema` is typed `as const`, `fields` autocomplete resolves
+* from the request body schema; pass `contentType` to narrow inference
+* to a specific media type.
+*
+* @group OpenAPI
+*/
 function ApiRequestBody({ schema: doc, path, method, value, onChange, meta, fields, widgets, onDiagnostic, strict }) {
 	const diagnostics = buildDiagnostics(onDiagnostic, strict);
 	const instancePrefix = sanitisePrefix(useId());
 	const rootDoc = resolveRootDoc(doc, diagnostics);
 	if (rootDoc === void 0) return null;
-	const requestBody = resolveRequestBodyFromParsed(getParsed(rootDoc, diagnostics), path, method);
+	const requestBody = resolveRequestBody(getParsed(rootDoc, diagnostics), path, method);
 	if (requestBody?.schema === void 0) return null;
-	const requestBodyXml = getXmlInfo(requestBody.schema);
+	const requestBodyXml = extractXmlInfo(requestBody.schema);
 	return /* @__PURE__ */ jsxs("section", {
 		"data-request-body": true,
 		children: [
@@ -237,13 +281,25 @@ function ApiRequestBody({ schema: doc, path, method, value, onChange, meta, fiel
 		]
 	});
 }
+/**
+* Render the response schema for a single OpenAPI operation status —
+* picked out of `schema` by `path`, `method`, and `status`.
+*
+* Status resolution follows the OpenAPI priority order: concrete code
+* (e.g. `"200"`) > class wildcard (e.g. `"2XX"`) > `"default"`. When
+* `schema` is typed `as const`, `fields` autocomplete resolves from
+* the response schema; pass `contentType` to narrow inference to a
+* specific media type.
+*
+* @group OpenAPI
+*/
 function ApiResponse({ schema: doc, path, method, status, value, meta, fields, widgets, onDiagnostic, strict }) {
 	const diagnostics = buildDiagnostics(onDiagnostic, strict);
 	const instancePrefix = sanitisePrefix(useId());
 	const rootDoc = resolveRootDoc(doc, diagnostics);
 	if (rootDoc === void 0) return null;
 	const parsed = getParsed(rootDoc, diagnostics);
-	const response = resolveResponseFromParsed(parsed, path, method, status);
+	const response = resolveResponse(parsed, path, method, status);
 	if (response.schema === void 0) return /* @__PURE__ */ jsxs("div", {
 		"data-status": status,
 		children: [
@@ -265,6 +321,18 @@ function ApiResponse({ schema: doc, path, method, status, value, meta, fields, w
 		idPrefix: instancePrefix
 	});
 }
+/**
+* Render a single OpenAPI 3.1 webhook by name. A webhook is a Path Item
+* Object under the document's top-level `webhooks` map; once resolved,
+* its operations are structurally identical to operations under `paths`.
+*
+* Delegates to {@link ApiOperation} for each method present on the
+* webhook's Path Item Object — the parser's `lookupPathItem` resolves
+* webhook names through the same code path as paths, so `ApiOperation`
+* works for both with no special-casing in the renderer.
+*
+* @group OpenAPI
+*/
 function ApiWebhook({ schema: doc, name, widgets, meta, onDiagnostic, strict }) {
 	const diagnostics = buildDiagnostics(onDiagnostic, strict);
 	const instancePrefix = sanitisePrefix(useId());
@@ -287,6 +355,13 @@ function ApiWebhook({ schema: doc, name, widgets, meta, onDiagnostic, strict })
 		})]
 	});
 }
+/**
+* Render every OpenAPI 3.1 webhook declared on the document, one
+* `<ApiWebhook>` per entry. Returns `null` when the document has no
+* `webhooks` map or the map is empty.
+*
+* @group OpenAPI
+*/
 function ApiWebhooks({ schema: doc, widgets, meta, onDiagnostic, strict }) {
 	const diagnostics = buildDiagnostics(onDiagnostic, strict);
 	const instancePrefix = sanitisePrefix(useId());
@@ -380,7 +455,7 @@ function ResponseCard({ response, rootDoc, parsed, value, fields, meta, widgets,
 		]
 	});
 	let links = [];
-	if (path !== void 0 && method !== void 0) links = getLinks(parsed, path, method, response.statusCode);
+	if (path !== void 0 && method !== void 0) links = extractLinks(parsed, path, method, response.statusCode);
 	return /* @__PURE__ */ jsxs("div", {
 		"data-status": response.statusCode,
 		children: [