@openpkg-ts/ui 0.6.2 → 0.7.0

package/dist/docskit/index.d.ts

@@ -45,7 +45,7 @@ interface APICodePanelProps {
 * Right-side sticky code panel for API documentation.
 * Features language dropdown and syntax highlighting via docskit.
 */
-declare function APICodePanel({ languages, examples, externalLink, title, className }: APICodePanelProps): React3.ReactNode;
+declare function APICodePanel({ languages, examples, externalLink: _externalLink, title, className }: APICodePanelProps): React3.ReactNode;
 import { ReactNode as ReactNode2 } from "react";
 interface APIReferenceLayoutProps {
 	/** Left column content (documentation) */
@@ -70,6 +70,8 @@ interface APIReferencePageProps {
 	title: string;
 	/** Optional page description */
 	description?: React4.ReactNode;
+	/** Theme variant */
+	theme?: "default" | "single";
 	/** API sections as children */
 	children: React4.ReactNode;
 	/** Custom className */
@@ -79,7 +81,7 @@ interface APIReferencePageProps {
 * Full page wrapper for API reference documentation.
 * Provides max-width container and consistent spacing.
 */
-declare function APIReferencePage({ title, description, children, className }: APIReferencePageProps): React4.ReactNode;
+declare function APIReferencePage({ title, description, theme, children, className }: APIReferencePageProps): React4.ReactNode;
 import * as React5 from "react";
 interface APISectionProps {
 	/** Section title (e.g., "Create a customer", "The Customer object") */
@@ -106,6 +108,39 @@ interface APISectionProps {
 * Docs/params on left, sticky code panel on right.
 */
 declare function APISection({ title, id, description, children, languages, examples, externalLink, codePanelTitle, className }: APISectionProps): React5.ReactNode;
+import { SpecSchema } from "@openpkg-ts/spec";
+import * as React6 from "react";
+interface APISectionSingleProps {
+	/** Section title (e.g., "createCustomer") */
+	title: string;
+	/** Optional anchor id for deep linking */
+	id?: string;
+	/** Optional description */
+	description?: React6.ReactNode;
+	/** Code example */
+	example: {
+		code: string;
+		lang?: string;
+	};
+	/** Package name for install command */
+	packageName: string;
+	/** Parameters content (ExpandableParameter children) */
+	parameters?: React6.ReactNode;
+	/** Return type info */
+	returns?: {
+		type: string;
+		description?: React6.ReactNode;
+	};
+	/** Callback to resolve $ref schemas */
+	resolveRef?: (ref: string) => SpecSchema | undefined;
+	/** Custom className */
+	className?: string;
+}
+/**
+* Single-column API section for MoneyKit-style docs.
+* Vertical layout with code example, install command, parameters accordion, returns.
+*/
+declare function APISectionSingle({ title, id, description, example, packageName, parameters, returns, className }: APISectionSingleProps): React6.ReactNode;
 import { ReactNode as ReactNode3 } from "react";
 interface CodeBlockProps {
 	/** Code content */
@@ -142,7 +177,7 @@ interface CollapsiblePanelProps {
 * Uses CSS grid-rows transition for smooth open/close.
 */
 declare function CollapsiblePanel({ title, children, defaultExpanded, expanded: controlledExpanded, onExpandedChange, className }: CollapsiblePanelProps): ReactNode4;
-import * as React6 from "react";
+import * as React7 from "react";
 type HttpMethod = "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
 type EndpointBadgeSize = "sm" | "md";
 declare const endpointBadgeVariants: (props?: {
@@ -151,13 +186,13 @@ declare const endpointBadgeVariants: (props?: {
 	class?: string;
 	className?: string;
 }) => string;
-interface EndpointBadgeProps extends React6.HTMLAttributes<HTMLSpanElement> {
+interface EndpointBadgeProps extends React7.HTMLAttributes<HTMLSpanElement> {
 	method: HttpMethod;
 	size?: EndpointBadgeSize | null;
 }
-declare const EndpointBadge: React6.ForwardRefExoticComponent<EndpointBadgeProps & React6.RefAttributes<HTMLSpanElement>>;
-import * as React7 from "react";
-interface EndpointHeaderProps extends React7.HTMLAttributes<HTMLDivElement> {
+declare const EndpointBadge: React7.ForwardRefExoticComponent<EndpointBadgeProps & React7.RefAttributes<HTMLSpanElement>>;
+import * as React8 from "react";
+interface EndpointHeaderProps extends React8.HTMLAttributes<HTMLDivElement> {
 	/** HTTP method */
 	method: HttpMethod;
 	/** API path (e.g., "/v1/customers") */
@@ -165,7 +200,7 @@ interface EndpointHeaderProps extends React7.HTMLAttributes<HTMLDivElement> {
 	/** Show copy button on hover */
 	copyable?: boolean;
 }
-declare const EndpointHeader: React7.ForwardRefExoticComponent<EndpointHeaderProps & React7.RefAttributes<HTMLDivElement>>;
+declare const EndpointHeader: React8.ForwardRefExoticComponent<EndpointHeaderProps & React8.RefAttributes<HTMLDivElement>>;
 import { ReactNode as ReactNode5 } from "react";
 interface EnumValue {
 	/** Enum value */
@@ -238,7 +273,7 @@ interface ExampleSectionProps {
 * Integrates with SyncScrollProvider for synchronized scrolling.
 */
 declare function ExampleSection({ id, examples, dataSource, response, notes, className }: ExampleSectionProps): ReactNode7;
-import { SpecSchema, SpecSignatureParameter } from "@openpkg-ts/spec";
+import { SpecSchema as SpecSchema2, SpecSignatureParameter } from "@openpkg-ts/spec";
 import { ReactNode as ReactNode8 } from "react";
 interface ExpandableParameterProps {
 	/** Parameter from spec */
@@ -256,7 +291,7 @@ interface ExpandableParameterProps {
 	/** Custom className */
 	className?: string;
 	/** Callback to resolve $ref schemas */
-	resolveRef?: (ref: string) => SpecSchema | undefined;
+	resolveRef?: (ref: string) => SpecSchema2 | undefined;
 }
 /**
 * Compound component combining APIParameterItem + NestedParameterToggle + NestedParameterContainer.
@@ -357,22 +392,22 @@ interface APIParameterItemProps {
 * Displays name, type, required badge (orange text), description, and optional nested content.
 */
 declare function APIParameterItem({ name, parentPath, type, required, optional, description, children, anchorId, className }: APIParameterItemProps): ReactNode12;
-import * as React8 from "react";
+import * as React9 from "react";
 interface ParameterListProps {
 	/** Title above the list (e.g., "Body parameters") */
 	title?: string;
 	/** Number of items to show before collapsing */
 	collapseAfter?: number;
 	/** Child parameter items */
-	children: React8.ReactNode;
+	children: React9.ReactNode;
 	/** Custom className */
 	className?: string;
 }
 /**
 * Container for parameter items with optional "More parameters" collapse.
 */
-declare function ParameterList({ title, collapseAfter, children, className }: ParameterListProps): React8.ReactNode;
-import * as React9 from "react";
+declare function ParameterList({ title, collapseAfter, children, className }: ParameterListProps): React9.ReactNode;
+import * as React10 from "react";
 interface ResponseBlockProps {
 	/** Response JSON data */
 	data: object;
@@ -385,41 +420,23 @@ interface ResponseBlockProps {
 * JSON response preview with syntax highlighting.
 * Displays formatted JSON with copy functionality.
 */
-declare function ResponseBlock({ data, title, className }: ResponseBlockProps): React9.ReactNode;
-import { ReactNode as ReactNode13, RefObject } from "react";
-interface SyncScrollContextValue {
-	/** Currently visible section ID */
-	activeSection: string | null;
-	/** Register a section to track */
-	registerSection: (id: string, ref: RefObject<HTMLElement | null>) => void;
-	/** Unregister a section */
-	unregisterSection: (id: string) => void;
-	/** Scroll right column to section */
-	scrollToSection: (id: string) => void;
-	/** Register the right column container */
-	registerRightColumn: (ref: RefObject<HTMLElement | null>) => void;
-}
-interface SyncScrollProviderProps {
+declare function ResponseBlock({ data, title, className }: ResponseBlockProps): React10.ReactNode;
+import { ReactNode as ReactNode13 } from "react";
+interface SectionAccordionProps {
+	/** Section title (e.g., "PARAMETERS") */
+	title: string;
+	/** Section content */
 	children: ReactNode13;
-	/** Root margin for intersection observer (default: '-20% 0px -60% 0px') */
-	rootMargin?: string;
-	/** Scroll behavior (default: 'smooth') */
-	scrollBehavior?: ScrollBehavior;
+	/** Default expanded state */
+	defaultExpanded?: boolean;
+	/** Custom className */
+	className?: string;
 }
 /**
-* Provider for synchronized scrolling between left and right columns.
-* Uses IntersectionObserver to track visible sections on the left,
-* and auto-scrolls the right column to matching examples.
-*/
-declare function SyncScrollProvider({ children, rootMargin, scrollBehavior }: SyncScrollProviderProps): ReactNode13;
-/**
-* Hook to access sync scroll context.
+* Collapsible section with header toggle.
+* MoneyKit-style accordion for single-theme API docs.
 */
-declare function useSyncScroll(): SyncScrollContextValue;
-/**
-* Hook to register a section for scroll tracking.
-*/
-declare function useSyncSection(id: string): RefObject<HTMLElement | null>;
+declare function SectionAccordion({ title, children, defaultExpanded, className }: SectionAccordionProps): ReactNode13;
 import { AnnotationHandler } from "codehike/code";
 declare const callout: AnnotationHandler;
 import { AnnotationHandler as AnnotationHandler2, RawCode } from "codehike/code";
@@ -617,20 +634,65 @@ import { AnnotationHandler as AnnotationHandler6 } from "codehike/code";
 declare const collapse: readonly AnnotationHandler6[];
 import { AnnotationHandler as AnnotationHandler7 } from "codehike/code";
 declare const diff: AnnotationHandler7;
-import React10 from "react";
-declare function addDocsKit<T extends Record<string, React10.ElementType | string>>(components: T): T;
+import React11 from "react";
+declare function addDocsKit<T extends Record<string, React11.ElementType | string>>(components: T): T;
 import { AnnotationHandler as AnnotationHandler8 } from "codehike/code";
 declare const expandable: AnnotationHandler8;
+import { ReactNode as ReactNode14, RefObject } from "react";
+interface SyncScrollContextValue {
+	/** Currently visible section ID */
+	activeSection: string | null;
+	/** Register a section to track */
+	registerSection: (id: string, ref: RefObject<HTMLElement | null>) => void;
+	/** Unregister a section */
+	unregisterSection: (id: string) => void;
+	/** Scroll right column to section */
+	scrollToSection: (id: string) => void;
+	/** Register the right column container */
+	registerRightColumn: (ref: RefObject<HTMLElement | null>) => void;
+}
+interface SyncScrollProviderProps {
+	children: ReactNode14;
+	/** Root margin for intersection observer (default: '-20% 0px -60% 0px') */
+	rootMargin?: string;
+	/** Scroll behavior (default: 'smooth') */
+	scrollBehavior?: ScrollBehavior;
+}
+/**
+* Provider for synchronized scrolling between left and right columns.
+* Uses IntersectionObserver to track visible sections on the left,
+* and auto-scrolls the right column to matching examples.
+*/
+declare function SyncScrollProvider({ children, rootMargin, scrollBehavior }: SyncScrollProviderProps): ReactNode14;
+/**
+* Hook to access sync scroll context.
+*/
+declare function useSyncScroll(): SyncScrollContextValue;
+/**
+* Hook to register a section for scroll tracking.
+*/
+declare function useSyncSection(id: string): RefObject<HTMLElement | null>;
 import { AnnotationHandler as AnnotationHandler9 } from "codehike/code";
-import React11 from "react";
+import React12 from "react";
 declare function WithHover(props: {
-	children: React11.ReactNode;
-}): React11.ReactNode;
+	children: React12.ReactNode;
+}): React12.ReactNode;
 declare function HoverLink(props: {
 	href?: string;
-	children?: React11.ReactNode;
-}): React11.ReactNode;
+	children?: React12.ReactNode;
+}): React12.ReactNode;
 declare const hover: AnnotationHandler9;
+interface ImportSectionProps {
+	/** Import statement text */
+	importStatement: string;
+	/** Custom className */
+	className?: string;
+}
+/**
+* Displays a copyable import statement with one-click copy.
+* Monospace styling with copy button.
+*/
+declare function ImportSection({ importStatement, className }: ImportSectionProps): React.ReactNode;
 import { AnnotationHandler as AnnotationHandler10 } from "codehike/code";
 declare const lineNumbers2: AnnotationHandler10;
 import { AnnotationHandler as AnnotationHandler11 } from "codehike/code";
@@ -640,32 +702,38 @@ declare const mark: AnnotationHandler12;
 declare function WithNotes({ children,...rest }: {
 	children: React.ReactNode;
 }): React.ReactNode;
+interface RunnableSnippetProps {
+	/** Code to display */
+	code: string;
+	/** Language for syntax highlighting */
+	language?: string;
+	/** Optional title */
+	title?: string;
+	/** For demo: mock execution state */
+	mockState?: "idle" | "running" | "success" | "error";
+	/** For demo: mock output data */
+	mockOutput?: string;
+	/** Custom className */
+	className?: string;
+}
+/**
+* Interactive code block with run button and output display.
+* Currently uses mock states; will be wired to sandbox execution in Phase 2.
+*/
+declare function RunnableSnippet({ code, language, title, mockState, mockOutput, className }: RunnableSnippetProps): React.ReactNode;
 import * as TabsPrimitive from "@radix-ui/react-tabs";
-import * as React12 from "react";
-declare function Tabs({ className,...props }: React12.ComponentProps<typeof TabsPrimitive.Root>): React12.ReactNode;
-declare function TabsList({ className,...props }: React12.ComponentProps<typeof TabsPrimitive.List>): React12.ReactNode;
-declare function TabsTrigger({ className,...props }: React12.ComponentProps<typeof TabsPrimitive.Trigger>): React12.ReactNode;
-declare function TabsContent({ className,...props }: React12.ComponentProps<typeof TabsPrimitive.Content>): React12.ReactNode;
+import * as React13 from "react";
+declare function Tabs({ className,...props }: React13.ComponentProps<typeof TabsPrimitive.Root>): React13.ReactNode;
+declare function TabsList({ className,...props }: React13.ComponentProps<typeof TabsPrimitive.List>): React13.ReactNode;
+declare function TabsTrigger({ className,...props }: React13.ComponentProps<typeof TabsPrimitive.Trigger>): React13.ReactNode;
+declare function TabsContent({ className,...props }: React13.ComponentProps<typeof TabsPrimitive.Content>): React13.ReactNode;
 import { AnnotationHandler as AnnotationHandler13 } from "codehike/code";
 declare const tooltip: AnnotationHandler13;
 declare function TooltipLink(props: {
 	href?: string;
 	children?: React.ReactNode;
 }): React.ReactNode;
-import { AnnotationHandler as AnnotationHandler14 } from "codehike/code";
-declare const wordWrap2: AnnotationHandler14;
-interface ImportSectionProps {
-	/** Import statement text */
-	importStatement: string;
-	/** Custom className */
-	className?: string;
-}
-/**
-* Displays a copyable import statement with one-click copy.
-* Monospace styling with copy button.
-*/
-declare function ImportSection({ importStatement, className }: ImportSectionProps): React.ReactNode;
-import * as React13 from "react";
+import * as React14 from "react";
 type TypeColor = "string" | "number" | "boolean" | "null" | "undefined" | "object" | "array" | "function" | "union" | "generic" | "default";
 /**
 * Type coloring for syntax display.
@@ -676,7 +744,7 @@ declare const typeBadgeVariants: (props?: {
 	class?: string;
 	className?: string;
 }) => string;
-interface TypeBadgeProps extends React13.HTMLAttributes<HTMLSpanElement> {
+interface TypeBadgeProps extends React14.HTMLAttributes<HTMLSpanElement> {
 	/** Type string to display */
 	type: string;
 	/** Override color detection */
@@ -686,24 +754,7 @@ interface TypeBadgeProps extends React13.HTMLAttributes<HTMLSpanElement> {
 * Inline type display with syntax coloring.
 * Automatically detects type category and applies appropriate color.
 */
-declare const TypeBadge: React13.ForwardRefExoticComponent<TypeBadgeProps & React13.RefAttributes<HTMLSpanElement>>;
-interface RunnableSnippetProps {
-	/** Code to display */
-	code: string;
-	/** Language for syntax highlighting */
-	language?: string;
-	/** Optional title */
-	title?: string;
-	/** For demo: mock execution state */
-	mockState?: "idle" | "running" | "success" | "error";
-	/** For demo: mock output data */
-	mockOutput?: string;
-	/** Custom className */
-	className?: string;
-}
-/**
-* Interactive code block with run button and output display.
-* Currently uses mock states; will be wired to sandbox execution in Phase 2.
-*/
-declare function RunnableSnippet({ code, language, title, mockState, mockOutput, className }: RunnableSnippetProps): React.ReactNode;
-export { wordWrap2 as wordWrap, useSyncSection, useSyncScroll, typeBadgeVariants, tooltip, toCodeGroup, theme, mark, link, lineNumbers2 as lineNumbers, hover, flagsToOptions, expandable, endpointBadgeVariants, diff, collapse, callout, addDocsKit, WithNotes, WithHover, TypeColor, TypeBadgeProps, TypeBadge, TooltipLink, TerminalSkeleton, Terminal, TabsTrigger, TabsList, TabsContent, Tabs, SyncScrollProviderProps, SyncScrollProvider, SyncScrollContextValue, SingleCode, RunnableSnippetProps, RunnableSnippet, ResponseBlockProps, ResponseBlock, ParameterListProps, ParameterList, PackageInstall, NestedParameterToggleProps, NestedParameterToggle, NestedParameterContainerProps, NestedParameterContainer, MultiCode, MethodSectionProps, MethodSection, LanguageSelectorProps, LanguageSelector, Language, InlineCodeSkeleton, ImportSectionProps, ImportSection, HttpMethod, HoverLink, ExpandableParameterProps, ExpandableParameter, ExampleSectionProps, CodeExample2 as ExampleSectionCodeExample, ExampleSection, ExampleChipsProps, ExampleChips, ExampleChip, EnumValuesSectionProps, EnumValuesSection, EnumValue, EndpointHeaderProps, EndpointHeader, EndpointBadgeProps, EndpointBadge, DocsKitInlineCode, DocsKitCode, DiffStats, CopyButton, CollapsiblePanelProps, CollapsiblePanel, CodeTabsSkeleton, CodeInfo, CodeIcon, CodeGroup, CodeExample, CodeBlockSkeleton, CodeBlockProps, CodeBlock, Code, ClientTerminal, ClientInlineCode, ClientDocsKitCode, ClientDiffCodeProps, ClientDiffCode, ClientCode, APISectionProps, APISection, APIReferencePageProps, APIReferencePage, APIReferenceLayoutProps, APIReferenceLayout, APIParameterSchema, APIParameterItemProps, APIParameterItem, APICodePanelProps, APICodePanel };
+declare const TypeBadge: React14.ForwardRefExoticComponent<TypeBadgeProps & React14.RefAttributes<HTMLSpanElement>>;
+import { AnnotationHandler as AnnotationHandler14 } from "codehike/code";
+declare const wordWrap2: AnnotationHandler14;
+export { wordWrap2 as wordWrap, useSyncSection, useSyncScroll, typeBadgeVariants, tooltip, toCodeGroup, theme, mark, link, lineNumbers2 as lineNumbers, hover, flagsToOptions, expandable, endpointBadgeVariants, diff, collapse, callout, addDocsKit, WithNotes, WithHover, TypeColor, TypeBadgeProps, TypeBadge, TooltipLink, TerminalSkeleton, Terminal, TabsTrigger, TabsList, TabsContent, Tabs, SyncScrollProviderProps, SyncScrollProvider, SyncScrollContextValue, SingleCode, SectionAccordionProps, SectionAccordion, RunnableSnippetProps, RunnableSnippet, ResponseBlockProps, ResponseBlock, ParameterListProps, ParameterList, PackageInstall, NestedParameterToggleProps, NestedParameterToggle, NestedParameterContainerProps, NestedParameterContainer, MultiCode, MethodSectionProps, MethodSection, LanguageSelectorProps, LanguageSelector, Language, InlineCodeSkeleton, ImportSectionProps, ImportSection, HttpMethod, HoverLink, ExpandableParameterProps, ExpandableParameter, ExampleSectionProps, CodeExample2 as ExampleSectionCodeExample, ExampleSection, ExampleChipsProps, ExampleChips, ExampleChip, EnumValuesSectionProps, EnumValuesSection, EnumValue, EndpointHeaderProps, EndpointHeader, EndpointBadgeProps, EndpointBadge, DocsKitInlineCode, DocsKitCode, DiffStats, CopyButton, CollapsiblePanelProps, CollapsiblePanel, CodeTabsSkeleton, CodeInfo, CodeIcon, CodeGroup, CodeExample, CodeBlockSkeleton, CodeBlockProps, CodeBlock, Code, ClientTerminal, ClientInlineCode, ClientDocsKitCode, ClientDiffCodeProps, ClientDiffCode, ClientCode, APISectionSingleProps, APISectionSingle, APISectionProps, APISection, APIReferencePageProps, APIReferencePage, APIReferenceLayoutProps, APIReferenceLayout, APIParameterSchema, APIParameterItemProps, APIParameterItem, APICodePanelProps, APICodePanel };