specra 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,545 @@
+import { Doc, SpecraConfig, DocMeta, ParserType, TabGroup } from './lib/index.js';
+export { AnalyticsConfig, ApiAuthentication, ApiDocumentation, ApiEndpointSpec, ApiExample, ApiHeader, ApiParam, ApiParameter, ApiResponse, ApiSpecConfig, ApiSpecParser, BannerConfig, CategoryConfig, DeploymentConfig, EnvironmentVariables, FeaturesConfig, FooterConfig, GraphQLField, GraphQLQuery, GraphQLSchema, GraphQLType, HttpMethod, NavigationConfig, OpenApiParser, ParsedApiSpec, PerfTimer, PostmanParser, RedirectMapping, RestEndpoint, SearchConfig, SidebarGroup, SiteConfig, SocialLinks, SpecraApiResponse, SpecraApiSpec, SpecraParser, TOCItem, ThemeConfig, TocItem, WebSocketConnection, WebSocketEvent, buildRedirectMappings, buildSidebarStructure, clearAllCaches, cn, debugLog, defaultConfig, detectParserType, extractHeadings, extractTableOfContents, findRedirect, getAdjacentDocs, getAllCategoryConfigs, getAllDocs, getAssetPath, getCacheStats, getCachedAllDocs, getCachedDocBySlug, getCachedVersions, getCategoryConfig, getConfig, getConfigValue, getDocBySlug, getVersions, initConfig, isCategoryPage, loadConfig, logCacheOperation, logFsOperation, logMemoryUsage, parseApiSpec, processContentWithEnv, reloadConfig, replaceEnvVariables, sortSidebarGroups, sortSidebarItems, validateConfig } from './lib/index.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React$1 from 'react';
+import React__default, { ReactNode } from 'react';
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import { VariantProps } from 'class-variance-authority';
+import * as DialogPrimitive from '@radix-ui/react-dialog';
+export { default as RootLayout, generateMetadata as generateRootMetadata } from './app/layout.js';
+export { default as DocsPage, generateMetadata as generateDocsMetadata, generateStaticParams as generateDocsStaticParams } from './app/docs-page.js';
+import 'clsx';
+import 'next';
+
+interface AccordionItemProps {
+    title: string | React.ReactNode;
+    children: React.ReactNode;
+    defaultOpen?: boolean;
+    value?: string;
+}
+declare function AccordionItem({ title, children, defaultOpen }: AccordionItemProps): react_jsx_runtime.JSX.Element;
+interface AccordionProps {
+    children: React.ReactNode;
+    type?: "single" | "multiple";
+    collapsible?: boolean;
+    className?: string;
+}
+declare function Accordion({ children, type, className }: AccordionProps): react_jsx_runtime.JSX.Element;
+
+interface BadgeProps {
+    children: React.ReactNode;
+    variant?: "default" | "success" | "warning" | "error" | "info";
+}
+declare function Badge$1({ children, variant }: BadgeProps): react_jsx_runtime.JSX.Element;
+
+interface BreadcrumbProps {
+    version: string;
+    slug: string;
+    title: string;
+}
+declare function Breadcrumb({ version, slug, title }: BreadcrumbProps): react_jsx_runtime.JSX.Element;
+
+interface CalloutProps {
+    children: ReactNode;
+    type?: "info" | "warning" | "success" | "error" | "tip" | "note" | "danger";
+    title?: string;
+}
+declare function Callout({ children, type, title }: CalloutProps): react_jsx_runtime.JSX.Element;
+
+interface CardProps {
+    title: string;
+    description?: string;
+    href?: string;
+    icon?: string | React.ReactNode;
+    children?: React.ReactNode;
+    external?: boolean;
+}
+declare function Card({ title, description, href, icon, children, external }: CardProps): react_jsx_runtime.JSX.Element;
+interface CardGridProps {
+    children: React.ReactNode;
+    cols?: 1 | 2 | 3;
+}
+declare function CardGrid({ children, cols }: CardGridProps): react_jsx_runtime.JSX.Element;
+
+interface CategoryIndexProps {
+    categoryPath: string;
+    version: string;
+    allDocs: Doc[];
+    title: string;
+    description?: string;
+    content?: string;
+    config: SpecraConfig;
+}
+declare function CategoryIndex({ categoryPath, version, allDocs, title, description, content, config }: CategoryIndexProps): react_jsx_runtime.JSX.Element;
+
+interface CodeBlockProps {
+    code: string;
+    language: string;
+    filename?: string;
+}
+declare function CodeBlock({ code, language, filename }: CodeBlockProps): react_jsx_runtime.JSX.Element;
+
+interface ColumnsProps {
+    children: React.ReactNode;
+    cols?: {
+        sm?: 1 | 2 | 3 | 4;
+        md?: 1 | 2 | 3 | 4;
+        lg?: 1 | 2 | 3 | 4;
+        xl?: 1 | 2 | 3 | 4;
+    };
+}
+declare function Columns({ children, cols }: ColumnsProps): react_jsx_runtime.JSX.Element;
+interface ColumnProps {
+    children: React.ReactNode;
+    span?: 1 | 2 | 3 | 4;
+}
+declare function Column({ children, span }: ColumnProps): react_jsx_runtime.JSX.Element;
+
+declare const COMPONENT_TEXT_PROPS: Record<string, string[]>;
+declare function extractComponentPropsText(mdx: string): string;
+declare function extractSearchText(mdx: string): string;
+
+declare function DevModeBadge(): react_jsx_runtime.JSX.Element | null;
+
+interface DocLayoutProps {
+    meta: DocMeta;
+    content: string;
+    previousDoc?: {
+        title: string;
+        slug: string;
+    };
+    nextDoc?: {
+        title: string;
+        slug: string;
+    };
+    version: string;
+    slug: string;
+    config: SpecraConfig;
+}
+declare function DocLayout({ content, meta, previousDoc, nextDoc, version, slug, config }: DocLayoutProps): Promise<react_jsx_runtime.JSX.Element>;
+
+interface DocLayoutWrapperProps {
+    header: ReactNode;
+    docs: Doc[];
+    version: string;
+    content: ReactNode;
+    toc: ReactNode;
+    config: SpecraConfig;
+    currentPageTabGroup?: string;
+}
+declare function DocLayoutWrapper({ header, docs, version, content, toc, config, currentPageTabGroup }: DocLayoutWrapperProps): react_jsx_runtime.JSX.Element;
+
+declare function DocLoading(): react_jsx_runtime.JSX.Element;
+
+interface DocMetadataProps {
+    meta: DocMeta;
+    config: SpecraConfig;
+}
+declare function DocMetadata({ meta, config }: DocMetadataProps): react_jsx_runtime.JSX.Element | null;
+
+interface DocNavigationProps {
+    previousDoc?: {
+        title: string;
+        slug: string;
+    };
+    nextDoc?: {
+        title: string;
+        slug: string;
+    };
+    version: string;
+}
+declare function DocNavigation({ previousDoc, nextDoc, version }: DocNavigationProps): react_jsx_runtime.JSX.Element | null;
+
+interface DocTagsProps {
+    tags: string[];
+}
+declare function DocTags({ tags }: DocTagsProps): react_jsx_runtime.JSX.Element | null;
+
+declare function DraftBadge(): react_jsx_runtime.JSX.Element;
+
+declare function Footer({ config }: {
+    config: SpecraConfig;
+}): react_jsx_runtime.JSX.Element | null;
+
+interface FrameProps {
+    src: string;
+    title?: string;
+    height?: number | string;
+    width?: string;
+}
+declare function Frame({ src, title, height, width }: FrameProps): react_jsx_runtime.JSX.Element;
+
+interface HeaderProps {
+    currentVersion: string;
+    versions: string[];
+    onMenuClick?: () => void;
+    config: SpecraConfig;
+}
+declare function Header({ currentVersion, versions, onMenuClick, config }: HeaderProps): react_jsx_runtime.JSX.Element;
+
+declare function HotReloadIndicator(): react_jsx_runtime.JSX.Element | null;
+
+interface IconProps {
+    icon: string | React.ReactNode;
+    iconType?: "regular" | "solid" | "light" | "thin" | "sharp-solid" | "duotone" | "brands";
+    color?: string;
+    size?: number;
+    className?: string;
+}
+declare function Icon({ icon, iconType, color, size, className }: IconProps): react_jsx_runtime.JSX.Element;
+
+interface ImageCardProps {
+    src: string;
+    alt: string;
+    title?: string;
+    description?: string;
+    href?: string;
+    external?: boolean;
+    aspectRatio?: "square" | "video" | "portrait";
+}
+declare function ImageCard({ src, alt, title, description, href, external, aspectRatio, }: ImageCardProps): react_jsx_runtime.JSX.Element;
+interface ImageCardGridProps {
+    children: React.ReactNode;
+    cols?: 1 | 2 | 3 | 4;
+}
+declare function ImageCardGrid({ children, cols }: ImageCardGridProps): react_jsx_runtime.JSX.Element;
+
+interface ImageProps {
+    src: string;
+    alt: string;
+    caption?: string;
+    width?: number;
+    height?: number;
+    zoom?: boolean;
+}
+declare function Image({ src, alt, caption, width, height, zoom }: ImageProps): react_jsx_runtime.JSX.Element;
+
+interface MathProps {
+    children: string;
+    block?: boolean;
+}
+declare function Math({ children, block }: MathProps): react_jsx_runtime.JSX.Element;
+
+interface TabProps {
+    label: string;
+    children: React__default.ReactNode;
+}
+interface TabsProps {
+    children: React__default.ReactElement<TabProps> | React__default.ReactElement<TabProps>[];
+    defaultValue?: string;
+}
+declare function Tab({ children }: TabProps): react_jsx_runtime.JSX.Element;
+declare function Tabs({ children, defaultValue }: TabsProps): react_jsx_runtime.JSX.Element;
+
+interface VideoProps {
+    src: string;
+    caption?: string;
+    autoplay?: boolean;
+    loop?: boolean;
+    muted?: boolean;
+    controls?: boolean;
+    poster?: string;
+}
+declare function Video({ src, caption, autoplay, loop, muted, controls, poster, }: VideoProps): react_jsx_runtime.JSX.Element;
+
+interface StepsProps {
+    children: React.ReactNode;
+}
+interface StepProps {
+    title: string;
+    children: React.ReactNode;
+}
+declare function Steps({ children }: StepsProps): react_jsx_runtime.JSX.Element;
+declare function Step({ title, children }: StepProps): react_jsx_runtime.JSX.Element;
+
+interface MermaidProps {
+    chart: string;
+    caption?: string;
+}
+declare function Mermaid({ chart, caption }: MermaidProps): react_jsx_runtime.JSX.Element;
+
+interface TooltipProps {
+    children: React.ReactNode;
+    content: string;
+    position?: "top" | "bottom" | "left" | "right";
+}
+declare function Tooltip({ children, content, position }: TooltipProps): react_jsx_runtime.JSX.Element;
+
+interface ApiEndpointProps {
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    path: string;
+    summary?: string;
+    children?: ReactNode;
+    defaultOpen?: boolean;
+}
+declare function ApiEndpoint({ method, path, summary, children, defaultOpen }: ApiEndpointProps): react_jsx_runtime.JSX.Element;
+
+interface ApiParam {
+    name: string;
+    type: string;
+    required?: boolean;
+    description?: string;
+    default?: string;
+}
+interface ApiParamsProps {
+    title?: string;
+    params: ApiParam[];
+}
+declare function ApiParams({ title, params }: ApiParamsProps): react_jsx_runtime.JSX.Element | null;
+
+interface ApiResponseProps {
+    status: number;
+    description?: string;
+    example?: any;
+    schema?: any;
+}
+declare function ApiResponse({ status, description, example, schema }: ApiResponseProps): react_jsx_runtime.JSX.Element;
+
+interface PathParam {
+    name: string;
+    type: string;
+    example?: any;
+}
+interface ApiPlaygroundProps {
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    path: string;
+    baseUrl?: string;
+    headers?: Record<string, string>;
+    defaultBody?: string;
+    pathParams?: PathParam[];
+}
+declare function ApiPlayground({ method, path, baseUrl, headers, defaultBody, pathParams }: ApiPlaygroundProps): react_jsx_runtime.JSX.Element;
+
+interface ApiReferenceProps {
+    /**
+     * Path to the API spec JSON file (relative to /public)
+     * Example: "/api-specs/my-api.json"
+     */
+    spec: string;
+    /**
+     * Parser type - auto-detect by default
+     * - "auto": Auto-detect format (Specra, OpenAPI, or Postman)
+     * - "specra": Native Specra format
+     * - "openapi": OpenAPI 3.x / Swagger
+     * - "postman": Postman Collection v2.x
+     */
+    parser?: ParserType;
+    /**
+     * Show API playground for testing
+     */
+    showPlayground?: boolean;
+}
+declare function ApiReference({ spec, parser, showPlayground }: ApiReferenceProps): react_jsx_runtime.JSX.Element | null;
+
+declare const mdxComponents: {
+    h1: ({ children }: {
+        children: ReactNode;
+    }) => react_jsx_runtime.JSX.Element;
+    h2: ({ children, id }: {
+        children: ReactNode;
+        id?: string;
+    }) => react_jsx_runtime.JSX.Element;
+    h3: ({ children, id }: {
+        children: ReactNode;
+        id?: string;
+    }) => react_jsx_runtime.JSX.Element;
+    p: ({ children }: {
+        children: ReactNode;
+    }) => react_jsx_runtime.JSX.Element;
+    code: ({ children, className, meta, ...props }: {
+        children: ReactNode;
+        className?: string;
+        meta?: string;
+        [key: string]: any;
+    }) => react_jsx_runtime.JSX.Element;
+    pre: ({ children }: {
+        children: ReactNode;
+    }) => react_jsx_runtime.JSX.Element;
+    ul: ({ children }: {
+        children: ReactNode;
+    }) => react_jsx_runtime.JSX.Element;
+    ol: ({ children }: {
+        children: ReactNode;
+    }) => react_jsx_runtime.JSX.Element;
+    li: ({ children }: {
+        children: ReactNode;
+    }) => react_jsx_runtime.JSX.Element;
+    a: ({ children, href }: {
+        children: ReactNode;
+        href?: string;
+    }) => react_jsx_runtime.JSX.Element;
+    blockquote: ({ children }: {
+        children: ReactNode;
+    }) => react_jsx_runtime.JSX.Element;
+    table: ({ children }: {
+        children: ReactNode;
+    }) => react_jsx_runtime.JSX.Element;
+    th: ({ children }: {
+        children: ReactNode;
+    }) => react_jsx_runtime.JSX.Element;
+    td: ({ children }: {
+        children: ReactNode;
+    }) => react_jsx_runtime.JSX.Element;
+    Callout: typeof Callout;
+    Accordion: typeof Accordion;
+    AccordionItem: typeof AccordionItem;
+    Tabs: typeof Tabs;
+    Tab: typeof Tab;
+    Image: typeof Image;
+    Video: typeof Video;
+    Card: typeof Card;
+    CardGrid: typeof CardGrid;
+    ImageCard: typeof ImageCard;
+    ImageCardGrid: typeof ImageCardGrid;
+    Steps: typeof Steps;
+    Step: typeof Step;
+    Icon: typeof Icon;
+    Mermaid: typeof Mermaid;
+    Math: typeof Math;
+    Columns: typeof Columns;
+    Column: typeof Column;
+    Badge: typeof Badge$1;
+    Tooltip: typeof Tooltip;
+    Frame: typeof Frame;
+    ApiEndpoint: typeof ApiEndpoint;
+    ApiParams: typeof ApiParams;
+    ApiResponse: typeof ApiResponse;
+    ApiPlayground: typeof ApiPlayground;
+    ApiReference: typeof ApiReference;
+};
+
+declare function MdxHotReload(): null;
+
+interface MobileDocLayoutProps {
+    header: ReactNode;
+    docs: Doc[];
+    version: string;
+    content: ReactNode;
+    toc: ReactNode;
+    config: SpecraConfig;
+    activeTabGroup?: string;
+    onTabChange?: (tabId: string) => void;
+}
+declare function MobileDocLayout({ header, docs, version, content, toc, config, activeTabGroup, onTabChange }: MobileDocLayoutProps): react_jsx_runtime.JSX.Element;
+
+interface NotFoundContentProps {
+    version: string;
+}
+declare function NotFoundContent({ version }: NotFoundContentProps): react_jsx_runtime.JSX.Element;
+
+declare function SearchHighlight(): null;
+
+interface SearchModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+    config: SpecraConfig;
+}
+declare function SearchModal({ isOpen, onClose, config }: SearchModalProps): react_jsx_runtime.JSX.Element;
+
+declare function SidebarSkeleton(): react_jsx_runtime.JSX.Element;
+
+interface DocItem {
+    title: string;
+    slug: string;
+    filePath: string;
+    section?: string;
+    group?: string;
+    sidebar?: string;
+    sidebar_position?: number;
+    categoryLabel?: string;
+    categoryPosition?: number;
+    categoryCollapsible?: boolean;
+    categoryCollapsed?: boolean;
+    categoryIcon?: string;
+    categoryTabGroup?: string;
+    meta?: {
+        icon?: string;
+        tab_group?: string;
+        [key: string]: any;
+    };
+}
+interface SidebarProps {
+    docs: DocItem[];
+    version: string;
+    onLinkClick?: () => void;
+    config: SpecraConfig;
+    activeTabGroup?: string;
+}
+declare function Sidebar({ docs, version, onLinkClick, config, activeTabGroup }: SidebarProps): react_jsx_runtime.JSX.Element | null;
+
+interface SiteBannerProps {
+    config: SpecraConfig;
+}
+declare function SiteBanner({ config }: SiteBannerProps): react_jsx_runtime.JSX.Element | null;
+
+interface TabContextType {
+    activeTabGroup: string;
+    setActiveTabGroup: (tabId: string) => void;
+}
+declare function TabProvider({ children, defaultTab }: {
+    children: ReactNode;
+    defaultTab: string;
+}): react_jsx_runtime.JSX.Element;
+declare function useTabContext(): TabContextType;
+
+interface TabGroupsProps {
+    tabGroups: TabGroup[];
+    activeTabId?: string;
+    onTabChange?: (tabId: string) => void;
+}
+declare function TabGroups({ tabGroups, activeTabId, onTabChange }: TabGroupsProps): react_jsx_runtime.JSX.Element | null;
+
+interface TOCItem {
+    id: string;
+    title: string;
+    level: number;
+}
+interface TableOfContentsProps {
+    items: TOCItem[];
+    config: SpecraConfig;
+}
+declare function TableOfContents({ items, config }: TableOfContentsProps): react_jsx_runtime.JSX.Element | null;
+
+declare function ThemeToggle(): react_jsx_runtime.JSX.Element;
+
+interface VersionSwitcherProps {
+    currentVersion: string;
+    versions: string[];
+}
+declare function VersionSwitcher({ currentVersion, versions }: VersionSwitcherProps): react_jsx_runtime.JSX.Element;
+
+declare const badgeVariants: (props?: ({
+    variant?: "default" | "destructive" | "outline" | "secondary" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+declare function Badge({ className, variant, asChild, ...props }: React$1.ComponentProps<"span"> & VariantProps<typeof badgeVariants> & {
+    asChild?: boolean;
+}): react_jsx_runtime.JSX.Element;
+
+declare const buttonVariants: (props?: ({
+    variant?: "link" | "default" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
+    size?: "icon" | "default" | "sm" | "lg" | "icon-sm" | "icon-lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+declare function Button({ className, variant, size, asChild, ...props }: React$1.ComponentProps<'button'> & VariantProps<typeof buttonVariants> & {
+    asChild?: boolean;
+}): react_jsx_runtime.JSX.Element;
+
+declare function Dialog({ ...props }: React$1.ComponentProps<typeof DialogPrimitive.Root>): react_jsx_runtime.JSX.Element;
+declare function DialogTrigger({ ...props }: React$1.ComponentProps<typeof DialogPrimitive.Trigger>): react_jsx_runtime.JSX.Element;
+declare function DialogPortal({ ...props }: React$1.ComponentProps<typeof DialogPrimitive.Portal>): react_jsx_runtime.JSX.Element;
+declare function DialogClose({ ...props }: React$1.ComponentProps<typeof DialogPrimitive.Close>): react_jsx_runtime.JSX.Element;
+declare function DialogOverlay({ className, ...props }: React$1.ComponentProps<typeof DialogPrimitive.Overlay>): react_jsx_runtime.JSX.Element;
+declare function DialogContent({ className, children, showCloseButton, ...props }: React$1.ComponentProps<typeof DialogPrimitive.Content> & {
+    showCloseButton?: boolean;
+}): react_jsx_runtime.JSX.Element;
+declare function DialogHeader({ className, ...props }: React$1.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+declare function DialogFooter({ className, ...props }: React$1.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+declare function DialogTitle({ className, ...props }: React$1.ComponentProps<typeof DialogPrimitive.Title>): react_jsx_runtime.JSX.Element;
+declare function DialogDescription({ className, ...props }: React$1.ComponentProps<typeof DialogPrimitive.Description>): react_jsx_runtime.JSX.Element;
+
+declare function Input({ className, type, ...props }: React$1.ComponentProps<"input">): react_jsx_runtime.JSX.Element;
+
+declare function Textarea({ className, ...props }: React$1.ComponentProps<"textarea">): react_jsx_runtime.JSX.Element;
+
+declare function VersionNotFound(): react_jsx_runtime.JSX.Element;
+
+export { Accordion, AccordionItem, ApiEndpoint, ApiParams, ApiPlayground, ApiReference, ApiResponse as ApiResponseDisplay, Badge, Breadcrumb, Button, COMPONENT_TEXT_PROPS, Callout, Card, CardGrid, CategoryIndex, CodeBlock, Column, Columns, DevModeBadge, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Doc, Badge$1 as DocBadge, DocLayout, DocLayoutWrapper, DocLoading, DocMeta, DocMetadata, DocNavigation, DocTags, DraftBadge, Footer, Frame, Header, HotReloadIndicator, Icon, Image, ImageCard, ImageCardGrid, Input, Math, MdxHotReload, Mermaid, MobileDocLayout, NotFoundContent, ParserType, SearchHighlight, SearchModal, Sidebar, SidebarSkeleton, SiteBanner, SpecraConfig, Step, Steps, Tab, TabGroup, TabGroups, TabProvider, TableOfContents, Tabs, Textarea, ThemeToggle, Tooltip, VersionNotFound, VersionSwitcher, Video, badgeVariants, buttonVariants, extractComponentPropsText, extractSearchText, mdxComponents, useTabContext };