@stainless-api/docs-ui 0.1.0-beta.8 → 0.1.0-beta.81

package/dist/contexts/index.js

@@ -0,0 +1,45 @@
+import { t as __exportAll } from "../chunk-BYypO7fO.js";
+import { DocsProvider, useAvailableLanguages, useContentPanelLayout, useDeclaration, useDocs, useIgnoredResources, useLanguage, useResource, useSettings, useSnippet, useSnippetIds, useSnippetResponse, useSnippets, useSpec } from "./docs.js";
+import "../use-strict-context-L0c8JKg4.js";
+import { ComponentProvider, customizeComponents, useComponentContext, useComponents } from "./component-generics.js";
+import { NavigationProvider, useNavigation } from "./navigation.js";
+import { MarkdownContext, MarkdownProvider, useHighlight, useMarkdownContext, useRenderMarkdown } from "./markdown.js";
+
+//#region src/contexts/index.tsx
+var contexts_exports = /* @__PURE__ */ __exportAll({
+	ComponentProvider: () => ComponentProvider,
+	DocsProvider: () => DocsProvider,
+	MarkdownContext: () => MarkdownContext,
+	MarkdownProvider: () => MarkdownProvider,
+	NavigationProvider: () => NavigationProvider,
+	customizeComponents: () => customizeComponents,
+	useAvailableLanguages: () => useAvailableLanguages,
+	useComponentContext: () => useComponentContext,
+	useComponents: () => useComponents,
+	useContentPanelLayout: () => useContentPanelLayout,
+	useDeclaration: () => useDeclaration,
+	useDocs: () => useDocs,
+	useHighlight: () => useHighlight,
+	useIgnoredResources: () => useIgnoredResources,
+	useLanguage: () => useLanguage,
+	useLanguageComponents: () => useLanguageComponents,
+	useMarkdownContext: () => useMarkdownContext,
+	useNavigation: () => useNavigation,
+	useRenderMarkdown: () => useRenderMarkdown,
+	useResource: () => useResource,
+	useSettings: () => useSettings,
+	useSnippet: () => useSnippet,
+	useSnippetIds: () => useSnippetIds,
+	useSnippetResponse: () => useSnippetResponse,
+	useSnippets: () => useSnippets,
+	useSpec: () => useSpec
+});
+function useLanguageComponents() {
+	const language = useLanguage();
+	const definition = useComponentContext().language[language];
+	if (!definition) throw new Error(`Language component definition not found for language: ${language}`);
+	return definition;
+}
+
+//#endregion
+export { ComponentProvider, DocsProvider, MarkdownContext, MarkdownProvider, NavigationProvider, customizeComponents, contexts_exports as t, useAvailableLanguages, useComponentContext, useComponents, useContentPanelLayout, useDeclaration, useDocs, useHighlight, useIgnoredResources, useLanguage, useLanguageComponents, useMarkdownContext, useNavigation, useRenderMarkdown, useResource, useSettings, useSnippet, useSnippetIds, useSnippetResponse, useSnippets, useSpec };

package/dist/contexts/markdown.d.ts

@@ -0,0 +1,22 @@
+import * as React$1 from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/contexts/markdown.d.ts
+type MarkdownContext = {
+  highlight: (content: string, language: string) => string | Promise<string>;
+  render: (content: string) => string | Promise<string>;
+};
+declare const MarkdownContext: React$1.Context<MarkdownContext>;
+declare const useMarkdownContext: () => MarkdownContext;
+declare function useRenderMarkdown(content?: string): string | undefined;
+declare function useHighlight(content: string, language?: string): string;
+type MarkdownProviderProps = MarkdownContext & {
+  children: React$1.ReactNode;
+};
+declare function MarkdownProvider({
+  render,
+  highlight,
+  children
+}: MarkdownProviderProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { MarkdownContext, MarkdownProvider, MarkdownProviderProps, useHighlight, useMarkdownContext, useRenderMarkdown };

package/dist/contexts/markdown.js

@@ -0,0 +1,49 @@
+import { useLanguage } from "./docs.js";
+import * as React$1 from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/contexts/markdown.tsx
+const HighlightLanguageMappings = {
+	node: "typescript",
+	http: "bash",
+	cli: "bash"
+};
+const MarkdownContext = React$1.createContext({
+	highlight: (content) => content,
+	render: (content) => content
+});
+const useMarkdownContext = () => React$1.useContext(MarkdownContext);
+function useRenderMarkdown(content) {
+	const { render } = React$1.useContext(MarkdownContext);
+	return React$1.useMemo(() => {
+		if (!content) return void 0;
+		const rendered = render(content);
+		return typeof rendered === "string" ? rendered : React$1.use(rendered);
+	}, [content, render]);
+}
+function useHighlight(content, language) {
+	const { highlight } = React$1.useContext(MarkdownContext);
+	const defaultLanguage = useLanguage();
+	const lang = language ?? defaultLanguage;
+	return React$1.useMemo(() => {
+		if (lang === "none") return content;
+		const rendered = highlight(content, HighlightLanguageMappings[lang] ?? lang);
+		return typeof rendered === "string" ? rendered : React$1.use(rendered);
+	}, [
+		content,
+		highlight,
+		lang
+	]);
+}
+function MarkdownProvider({ render, highlight, children }) {
+	return /* @__PURE__ */ jsx(MarkdownContext.Provider, {
+		value: {
+			render,
+			highlight
+		},
+		children
+	});
+}
+
+//#endregion
+export { MarkdownContext, MarkdownProvider, useHighlight, useMarkdownContext, useRenderMarkdown };

package/dist/contexts/navigation.d.ts

@@ -0,0 +1,29 @@
+import { DocsLanguage } from "../routing.js";
+import * as React$1 from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/contexts/navigation.d.ts
+type NavigationHandler = (ev: React$1.MouseEvent | null, opts: {
+  href: string;
+  language: DocsLanguage;
+  stainlessPath: string;
+  scroll: boolean;
+}) => void;
+type NavigationContextType = {
+  basePath?: string;
+  selectedPath?: string;
+  navigationPath?: string[];
+  onNavigate?: NavigationHandler;
+};
+declare function useNavigation(): NavigationContextType;
+type NavigationProviderProps = NavigationContextType & {
+  children: React$1.ReactNode;
+};
+declare function NavigationProvider({
+  basePath,
+  selectedPath,
+  onNavigate,
+  children
+}: NavigationProviderProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { NavigationContextType, NavigationHandler, NavigationProvider, NavigationProviderProps, useNavigation };

package/dist/contexts/navigation.js

@@ -0,0 +1,24 @@
+import * as React$1 from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/contexts/navigation.tsx
+const Defaults = { basePath: "/" };
+const NavigationContext = React$1.createContext(Defaults);
+function useNavigation() {
+	return React$1.useContext(NavigationContext);
+}
+function NavigationProvider({ basePath, selectedPath, onNavigate, children }) {
+	const value = {
+		...Defaults,
+		onNavigate,
+		basePath,
+		selectedPath
+	};
+	return /* @__PURE__ */ jsx(NavigationContext.Provider, {
+		value,
+		children
+	});
+}
+
+//#endregion
+export { NavigationProvider, useNavigation };

package/dist/contexts/use-components.d.ts

@@ -0,0 +1,6 @@
+import { t as index_d_exports } from "../components/index.js";
+
+//#region src/contexts/use-components.d.ts
+declare const useComponents: () => typeof index_d_exports;
+//#endregion
+export { useComponents };

package/dist/contexts/use-components.js

@@ -0,0 +1,8 @@
+import "../use-strict-context-L0c8JKg4.js";
+import { useComponents as useComponents$1 } from "./component-generics.js";
+
+//#region src/contexts/use-components.tsx
+const useComponents = () => useComponents$1();
+
+//#endregion
+export { useComponents };