@apiboost/omnispec 1.0.0

package/dist/esm/chunks/ErrorBoundary-posRNrbt.js

@@ -0,0 +1,34 @@
+import { jsx } from 'react/jsx-runtime';
+import { Component } from 'react';
+import { E as ErrorMessage } from './useSpecFetcher-CZvAnU7Z.js';
+
+class ErrorBoundary extends Component {
+  constructor(props) {
+    super(props);
+    this.state = { error: null };
+  }
+  static getDerivedStateFromError(error) {
+    return { error };
+  }
+  componentDidCatch(error, info) {
+    this.props.onError?.(error, info);
+    console.error("[omnispec] Render error caught by ErrorBoundary:", error, info);
+  }
+  render() {
+    const { error } = this.state;
+    if (error) {
+      if (this.props.fallback) return this.props.fallback(error);
+      return /* @__PURE__ */ jsx(
+        ErrorMessage,
+        {
+          title: this.props.title ?? "Something went wrong",
+          message: error.message || "An unexpected error occurred while rendering the documentation."
+        }
+      );
+    }
+    return this.props.children;
+  }
+}
+
+export { ErrorBoundary as E };
+//# sourceMappingURL=ErrorBoundary-posRNrbt.js.map

package/dist/esm/chunks/ErrorBoundary-posRNrbt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorBoundary-posRNrbt.js","sources":["../../../src/core/components/common/ErrorBoundary.tsx"],"sourcesContent":["/**\n * This source file is part of the Apiboost(R) OmniSpec Core.\n *\n * Copyright (c) Apiboost, Inc.\n *\n * SPDX-License-Identifier: Apache-2.0\n *\n * See LICENSE.md and LICENSING.md in the project root for license information.\n */\n\nimport { Component } from 'react'\nimport type { ErrorInfo, ReactNode } from 'react'\nimport { ErrorMessage } from './ErrorMessage'\n\ninterface ErrorBoundaryProps {\n  children: ReactNode\n  /** Title shown in the fallback UI. */\n  title?: string\n  /**\n   * Custom fallback. Receives the caught error. When omitted, a themed\n   * `ErrorMessage` is rendered so a render-phase crash never takes down the\n   * host page (required hardening for the embeddable widget).\n   */\n  fallback?: (error: Error) => ReactNode\n  /** Optional hook for logging/telemetry when a render crash is caught. */\n  onError?: (error: Error, info: ErrorInfo) => void\n}\n\ninterface ErrorBoundaryState {\n  error: Error | null\n}\n\n/**\n * Catches render-phase exceptions from any descendant and renders a graceful\n * fallback instead of crashing the whole React tree. React error boundaries\n * must be class components — there is no hooks equivalent.\n */\nexport class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {\n  constructor(props: ErrorBoundaryProps) {\n    super(props)\n    this.state = { error: null }\n  }\n\n  static getDerivedStateFromError(error: Error): ErrorBoundaryState {\n    return { error }\n  }\n\n  componentDidCatch(error: Error, info: ErrorInfo): void {\n    this.props.onError?.(error, info)\n    // eslint-disable-next-line no-console\n    console.error('[omnispec] Render error caught by ErrorBoundary:', error, info)\n  }\n\n  render(): ReactNode {\n    const { error } = this.state\n    if (error) {\n      if (this.props.fallback) return this.props.fallback(error)\n      return (\n        <ErrorMessage\n          title={this.props.title ?? 'Something went wrong'}\n          message={error.message || 'An unexpected error occurred while rendering the documentation.'}\n        />\n      )\n    }\n    return this.props.children\n  }\n}\n"],"names":[],"mappings":";;;;AAqCO,MAAM,sBAAsB,SAAA,CAAkD;AAAA,EACnF,YAAY,KAAA,EAA2B;AACrC,IAAA,KAAA,CAAM,KAAK,CAAA;AACX,IAAA,IAAA,CAAK,KAAA,GAAQ,EAAE,KAAA,EAAO,IAAA,EAAK;AAAA,EAC7B;AAAA,EAEA,OAAO,yBAAyB,KAAA,EAAkC;AAChE,IAAA,OAAO,EAAE,KAAA,EAAM;AAAA,EACjB;AAAA,EAEA,iBAAA,CAAkB,OAAc,IAAA,EAAuB;AACrD,IAAA,IAAA,CAAK,KAAA,CAAM,OAAA,GAAU,KAAA,EAAO,IAAI,CAAA;AAEhC,IAAA,OAAA,CAAQ,KAAA,CAAM,kDAAA,EAAoD,KAAA,EAAO,IAAI,CAAA;AAAA,EAC/E;AAAA,EAEA,MAAA,GAAoB;AAClB,IAAA,MAAM,EAAE,KAAA,EAAM,GAAI,IAAA,CAAK,KAAA;AACvB,IAAA,IAAI,KAAA,EAAO;AACT,MAAA,IAAI,KAAK,KAAA,CAAM,QAAA,SAAiB,IAAA,CAAK,KAAA,CAAM,SAAS,KAAK,CAAA;AACzD,MAAA,uBACE,GAAA;AAAA,QAAC,YAAA;AAAA,QAAA;AAAA,UACC,KAAA,EAAO,IAAA,CAAK,KAAA,CAAM,KAAA,IAAS,sBAAA;AAAA,UAC3B,OAAA,EAAS,MAAM,OAAA,IAAW;AAAA;AAAA,OAC5B;AAAA,IAEJ;AACA,IAAA,OAAO,KAAK,KAAA,CAAM,QAAA;AAAA,EACpB;AACF;;;;"}

package/dist/esm/chunks/OmniSpecRenderer-MqsQFXro.js

@@ -0,0 +1,102 @@
+import { jsx } from 'react/jsx-runtime';
+import { lazy, useMemo, Suspense } from 'react';
+import { a as useSpecFetcher, T as ThemeProvider, L as LoadingScreen, b as SpecStatusScreen, E as ErrorMessage } from './useSpecFetcher-CZvAnU7Z.js';
+import { u as useSpecDetector, U as UpgradePrompt } from './useSpecDetector-5SGcKnJx.js';
+import { E as ErrorBoundary } from './ErrorBoundary-posRNrbt.js';
+
+const OpenApiSpec = lazy(
+  () => import('./OpenApiSpec-Cy-oW6jA.js').then(function (n) { return n.b; }).then((m) => ({ default: m.OpenApiSpec }))
+);
+const AsyncApiSpec = lazy(
+  () => import('./AsyncApiSpec-C3lsUpZk.js').then((m) => ({ default: m.AsyncApiSpec }))
+);
+function OmniSpecRenderer({ specType, spec, theme, docsUrl, upgradeUrl, pro, ...props }) {
+  const { data: rawContent, state } = useSpecFetcher(spec);
+  const detected = useSpecDetector(rawContent, specType);
+  const proRenderers = useMemo(() => pro?.renderers ?? /* @__PURE__ */ new Map(), [pro?.renderers]);
+  if (state.status === "loading") {
+    return /* @__PURE__ */ jsx(ThemeProvider, { theme, children: /* @__PURE__ */ jsx(LoadingScreen, {}) });
+  }
+  if (state.status === "error") {
+    return /* @__PURE__ */ jsx(
+      SpecStatusScreen,
+      {
+        theme,
+        layout: props.layout,
+        sidebarPosition: props.sidebarPosition,
+        slots: props.slots,
+        sidebarNav: props.sidebarNav,
+        premiumThemingEnabled: pro?.premiumThemingEnabled ?? false,
+        children: /* @__PURE__ */ jsx(ErrorMessage, { title: "Failed to load specification", message: state.error })
+      }
+    );
+  }
+  if (!detected) {
+    return /* @__PURE__ */ jsx(
+      SpecStatusScreen,
+      {
+        theme,
+        layout: props.layout,
+        sidebarPosition: props.sidebarPosition,
+        slots: props.slots,
+        sidebarNav: props.sidebarNav,
+        premiumThemingEnabled: pro?.premiumThemingEnabled ?? false,
+        children: /* @__PURE__ */ jsx(
+          ErrorMessage,
+          {
+            title: "Unable to detect specification type",
+            message: "The provided content could not be recognized as a supported API specification (OpenAPI, AsyncAPI, GraphQL, SOAP, or gRPC)."
+          }
+        )
+      }
+    );
+  }
+  const specProps = { ...props, spec, theme, pro };
+  return /* @__PURE__ */ jsx(
+    ErrorBoundary,
+    {
+      fallback: (error) => /* @__PURE__ */ jsx(ThemeProvider, { theme, children: /* @__PURE__ */ jsx(
+        ErrorMessage,
+        {
+          title: "Failed to render specification",
+          message: error.message || "An unexpected error occurred while rendering the documentation."
+        }
+      ) }),
+      children: /* @__PURE__ */ jsx(
+        Suspense,
+        {
+          fallback: /* @__PURE__ */ jsx(ThemeProvider, { theme, children: /* @__PURE__ */ jsx(LoadingScreen, {}) }),
+          children: /* @__PURE__ */ jsx(
+            SpecRenderer,
+            {
+              type: detected.type,
+              props: specProps,
+              registeredRenderers: proRenderers,
+              docsUrl,
+              upgradeUrl
+            }
+          )
+        }
+      )
+    }
+  );
+}
+function SpecRenderer({ type, props, registeredRenderers, docsUrl, upgradeUrl }) {
+  const RegisteredRenderer = registeredRenderers.get(type);
+  if (RegisteredRenderer) {
+    return /* @__PURE__ */ jsx(RegisteredRenderer, { ...props });
+  }
+  switch (type) {
+    case "openapi-2":
+    case "openapi-3":
+      return /* @__PURE__ */ jsx(OpenApiSpec, { ...props });
+    case "asyncapi-2":
+    case "asyncapi-3":
+      return /* @__PURE__ */ jsx(AsyncApiSpec, { ...props });
+    default:
+      return /* @__PURE__ */ jsx(ThemeProvider, { theme: props.theme, children: /* @__PURE__ */ jsx(UpgradePrompt, { specType: type, docsUrl, upgradeUrl }) });
+  }
+}
+
+export { OmniSpecRenderer as O };
+//# sourceMappingURL=OmniSpecRenderer-MqsQFXro.js.map

package/dist/esm/chunks/OmniSpecRenderer-MqsQFXro.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OmniSpecRenderer-MqsQFXro.js","sources":["../../../src/unified/OmniSpecRenderer.tsx"],"sourcesContent":["/**\n * This source file is part of the Apiboost(R) OmniSpec Core.\n *\n * Copyright (c) Apiboost, Inc.\n *\n * SPDX-License-Identifier: Apache-2.0\n *\n * See LICENSE.md and LICENSING.md in the project root for license information.\n */\n\nimport { lazy, Suspense, useMemo } from 'react'\nimport type { ComponentType } from 'react'\nimport type { BaseSpecProps } from '../core/types/common.types'\nimport type { SpecType } from '../core/types/spec-detection.types'\nimport { useSpecFetcher } from '../core/hooks/useSpecFetcher'\nimport { useSpecDetector } from '../core/hooks/useSpecDetector'\nimport { ThemeProvider } from '../core/themes/ThemeProvider'\nimport { LoadingScreen } from '../core/components/common/LoadingScreen'\nimport { ErrorMessage } from '../core/components/common/ErrorMessage'\nimport { ErrorBoundary } from '../core/components/common/ErrorBoundary'\nimport { UpgradePrompt } from '../core/components/common/UpgradePrompt'\nimport { SpecStatusScreen } from '../core/components/Layout/SpecStatusScreen'\n\nconst OpenApiSpec = lazy(() =>\n  import('../openapi/OpenApiSpec').then((m) => ({ default: m.OpenApiSpec })),\n)\nconst AsyncApiSpec = lazy(() =>\n  import('../asyncapi/AsyncApiSpec').then((m) => ({ default: m.AsyncApiSpec })),\n)\n\nexport interface OmniSpecRendererProps extends BaseSpecProps {\n  specType?: SpecType\n  docsUrl?: string\n  upgradeUrl?: string\n}\n\nexport function OmniSpecRenderer({ specType, spec, theme, docsUrl, upgradeUrl, pro, ...props }: OmniSpecRendererProps) {\n  const { data: rawContent, state } = useSpecFetcher<string>(spec)\n  const detected = useSpecDetector(rawContent, specType)\n  const proRenderers = useMemo(() => pro?.renderers ?? new Map(), [pro?.renderers])\n\n  if (state.status === 'loading') {\n    return (\n      <ThemeProvider theme={theme}>\n        <LoadingScreen />\n      </ThemeProvider>\n    )\n  }\n\n  // Non-fatal spec problems (failed load, unrecognized content) render in the\n  // content area while the host's nav/chrome stays put, so the user can\n  // navigate away. Fatal render errors still use the ErrorBoundary fallback.\n  if (state.status === 'error') {\n    return (\n      <SpecStatusScreen\n        theme={theme}\n        layout={props.layout}\n        sidebarPosition={props.sidebarPosition}\n        slots={props.slots}\n        sidebarNav={props.sidebarNav}\n        premiumThemingEnabled={pro?.premiumThemingEnabled ?? false}\n      >\n        <ErrorMessage title=\"Failed to load specification\" message={state.error} />\n      </SpecStatusScreen>\n    )\n  }\n\n  if (!detected) {\n    return (\n      <SpecStatusScreen\n        theme={theme}\n        layout={props.layout}\n        sidebarPosition={props.sidebarPosition}\n        slots={props.slots}\n        sidebarNav={props.sidebarNav}\n        premiumThemingEnabled={pro?.premiumThemingEnabled ?? false}\n      >\n        <ErrorMessage\n          title=\"Unable to detect specification type\"\n          message=\"The provided content could not be recognized as a supported API specification (OpenAPI, AsyncAPI, GraphQL, SOAP, or gRPC).\"\n        />\n      </SpecStatusScreen>\n    )\n  }\n\n  const specProps = { ...props, spec, theme, pro }\n\n  return (\n    <ErrorBoundary\n      fallback={(error) => (\n        <ThemeProvider theme={theme}>\n          <ErrorMessage\n            title=\"Failed to render specification\"\n            message={error.message || 'An unexpected error occurred while rendering the documentation.'}\n          />\n        </ThemeProvider>\n      )}\n    >\n      <Suspense\n        fallback={\n          <ThemeProvider theme={theme}>\n            <LoadingScreen />\n          </ThemeProvider>\n        }\n      >\n        <SpecRenderer\n          type={detected.type}\n          props={specProps}\n          registeredRenderers={proRenderers}\n          docsUrl={docsUrl}\n          upgradeUrl={upgradeUrl}\n        />\n      </Suspense>\n    </ErrorBoundary>\n  )\n}\n\ninterface SpecRendererProps {\n  type: SpecType\n  props: BaseSpecProps\n  registeredRenderers: Map<SpecType, ComponentType<BaseSpecProps>>\n  docsUrl?: string\n  upgradeUrl?: string\n}\n\nfunction SpecRenderer({ type, props, registeredRenderers, docsUrl, upgradeUrl }: SpecRendererProps) {\n  const RegisteredRenderer = registeredRenderers.get(type)\n  if (RegisteredRenderer) {\n    return <RegisteredRenderer {...props} />\n  }\n\n  switch (type) {\n    case 'openapi-2':\n    case 'openapi-3':\n      return <OpenApiSpec {...props} />\n    case 'asyncapi-2':\n    case 'asyncapi-3':\n      return <AsyncApiSpec {...props} />\n    default:\n      return (\n        <ThemeProvider theme={props.theme}>\n          <UpgradePrompt specType={type} docsUrl={docsUrl} upgradeUrl={upgradeUrl} />\n        </ThemeProvider>\n      )\n  }\n}\n"],"names":[],"mappings":"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"}