skrypt-ai 0.4.2 → 0.6.0

package/dist/template/src/app/docs/[...slug]/page.tsx

@@ -3,7 +3,60 @@ import { readFile, readdir } from 'fs/promises'
 import { join } from 'path'
 import { compileMDX } from 'next-mdx-remote/rsc'
 import remarkGfm from 'remark-gfm'
-import * as components from '@/components/mdx'
+import * as mdxComponents from '@/components/mdx'
+import { findPageInNavigation, type Navigation } from '@/lib/navigation'
+import { Children, isValidElement, type ReactNode } from 'react'
+
+/** Wrapper for <pre> that routes mermaid code blocks to the Mermaid component */
+function PreWithMermaid(props: { children: ReactNode; className?: string }) {
+  let isMermaid = false
+  let codeText = ''
+
+  Children.forEach(props.children, (child) => {
+    if (isValidElement(child) && child.type === 'code') {
+      const childProps = child.props as { className?: string; children?: string }
+      if (childProps.className?.includes('language-mermaid')) {
+        isMermaid = true
+        codeText = childProps.children || ''
+      }
+    }
+  })
+
+  if (isMermaid) {
+    return <mdxComponents.Mermaid chart={codeText} />
+  }
+
+  return <mdxComponents.HighlightedCode {...props} />
+}
+
+/** Passthrough component for generated content that references unknown JSX tags */
+function Passthrough({ children }: { children?: ReactNode }) {
+  return <>{children}</>
+}
+
+/** Strip empty <a id="..."></a> anchor tags — headings already have IDs from the Heading component */
+function AnchorOrLink(props: { id?: string; href?: string; children?: ReactNode; className?: string }) {
+  // Empty anchor-only elements (e.g. <a id="pluginmanager"></a>) — strip them
+  if (props.id && !props.href && !props.children) {
+    return null
+  }
+  // Regular links — render normally
+  return <a {...props} />
+}
+
+const components = {
+  ...mdxComponents,
+  pre: PreWithMermaid,
+  h1: mdxComponents.H1,
+  h2: mdxComponents.H2,
+  h3: mdxComponents.H3,
+  h4: mdxComponents.H4,
+  a: AnchorOrLink,
+  // Passthrough for JSX tags that appear in generated code examples
+  Tabs: Passthrough,
+  TabItem: Passthrough,
+  Details: Passthrough,
+}
 import type { Metadata } from 'next'
 
 interface PageProps {
@@ -23,6 +76,13 @@ function getDocsConfig() {
 
 async function getContent(slug: string[]) {
   const contentDir = join(process.cwd(), 'content', 'docs')
+
+  // Skip metadata files (llms.txt, llms-full.md, _navigation.json, _sidebars.json, README)
+  const lastName = slug[slug.length - 1]
+  if (lastName.startsWith('_') || lastName.startsWith('llms') || lastName === 'README') {
+    return null
+  }
+
   const filePath = join(contentDir, ...slug)
 
   // Try .mdx first, then .md
@@ -72,17 +132,11 @@ export async function generateMetadata({ params }: PageProps): Promise<Metadata>
 
   const frontmatter = await getFrontmatter(slug)
 
-  // Fall back to nav config title
+  // Fall back to nav config title (works with both flat and tabbed navigation)
   if (!frontmatter.title) {
     const path = '/docs/' + slug.join('/')
-    for (const group of docsConfig.navigation || []) {
-      for (const page of group.pages || []) {
-        if (page.path === path) {
-          frontmatter.title = page.title
-          break
-        }
-      }
-    }
+    const pageInfo = findPageInNavigation(docsConfig.navigation as Navigation || [], path)
+    if (pageInfo.title) frontmatter.title = pageInfo.title
   }
 
   const title = frontmatter.title || slug[slug.length - 1].replace(/-/g, ' ').replace(/\b\w/g, (c: string) => c.toUpperCase())
@@ -93,18 +147,12 @@ export async function generateMetadata({ params }: PageProps): Promise<Metadata>
   }
 }
 
-/** Look up page title from docs.json navigation by pathname */
+/** Look up page title from docs.json navigation by pathname (works with both formats) */
 function getNavTitle(slug: string[]): string | undefined {
   const docsConfig = getDocsConfig()
   const path = '/docs/' + slug.join('/')
-  for (const group of docsConfig.navigation || []) {
-    for (const page of group.pages || []) {
-      if (page.path === path) {
-        return page.title
-      }
-    }
-  }
-  return undefined
+  const pageInfo = findPageInNavigation(docsConfig.navigation as Navigation || [], path)
+  return pageInfo.title
 }
 
 export default async function DocPage({ params }: PageProps) {
@@ -121,8 +169,11 @@ export default async function DocPage({ params }: PageProps) {
   const pageDescription = frontmatter.description
 
   try {
+    // Strip empty <a id="..."></a> anchors from generated content — headings already have IDs
+    const cleanedSource = result.content.replace(/<a\s+id="[^"]*"\s*><\/a>\s*/g, '')
+
     const { content } = await compileMDX({
-      source: result.content,
+      source: cleanedSource,
       components: components as any,
       options: {
         parseFrontmatter: true,
@@ -160,6 +211,8 @@ export default async function DocPage({ params }: PageProps) {
         {pageDescription && (
           <div data-page-description={pageDescription} className="hidden" />
         )}
+        {/* Raw content for copy page button */}
+        <script id="raw-page-content" type="text/plain" data-content={Buffer.from(result.content).toString('base64')} />
         <div className="prose max-w-none">
           {content}
         </div>
@@ -189,6 +242,8 @@ export async function generateStaticParams() {
           await walkDir(join(dir, entry.name), [...prefix, entry.name])
         } else if (entry.name.endsWith('.md') || entry.name.endsWith('.mdx')) {
           const name = entry.name.replace(/\.(mdx?|md)$/, '')
+          // Skip metadata files
+          if (name.startsWith('_') || name.startsWith('llms') || name === 'README') continue
           if (name === 'index') {
             if (prefix.length > 0) {
               slugs.push({ slug: prefix })

package/dist/template/src/app/docs/llms-full.md

@@ -5,11 +5,17 @@
 ## getAuthConfig
 function getAuthConfig(): AuthConfig
 
+## getAuthConfigAsync
+async function getAuthConfigAsync(): Promise<AuthConfig>
+
 ## saveAuthConfig
-function saveAuthConfig(config: AuthConfig): void
+async function saveAuthConfig(config: AuthConfig): Promise<void>
 
 ## clearAuth
-function clearAuth(): void
+async function clearAuth(): Promise<void>
+
+## getKeyStorageMethod
+async function getKeyStorageMethod(): Promise<'keychain' | 'file' | 'env' | 'none'>
 
 ## checkPlan
 async function checkPlan(apiKey: string): Promise<PlanCheckResponse>
@@ -17,8 +23,29 @@ async function checkPlan(apiKey: string): Promise<PlanCheckResponse>
 ## requirePro
 async function requirePro(commandName: string): Promise<boolean>
 
-## isProCommand
-function isProCommand(command: string): boolean
+## keychainAvailable
+async function keychainAvailable(): Promise<boolean>
+
+## keychainStore
+async function keychainStore(key: string): Promise<boolean>
+
+## keychainRetrieve
+async function keychainRetrieve(): Promise<string | null>
+
+## keychainDelete
+async function keychainDelete(): Promise<boolean>
+
+## getKeychainPlatformName
+function getKeychainPlatformName(): string
+
+## hasSeenNotice
+function hasSeenNotice(id: string): boolean
+
+## markNoticeSeen
+function markNoticeSeen(id: string): void
+
+## showSecurityNotice
+function showSecurityNotice(): void
 
 ## autoFixExample
 async function autoFixExample(example: CodeExample, client: LLMClient, options: AutoFixOptions = {}): Promise<FixResult>
@@ -92,6 +119,105 @@ async function postInlineComments(config: PRCommentConfig, issues: Documentation
 ## analyzePRForDocs
 async function analyzePRForDocs(config: PRCommentConfig, _options: { checkExamples?: boolean } = {}): Promise<DocumentationIssue[]>
 
+## importConfluence
+function importConfluence(dir: string, name?: string): ImportResult
+
+## detectFormat
+function detectFormat(dir: string): ImportFormat
+
+## isGitHubUrl
+function isGitHubUrl(input: string): boolean
+
+## parseGitHubUrl
+function parseGitHubUrl(url: string): { owner: string; repo: string; path: string; ref: string }
+
+## importDocusaurus
+function importDocusaurus(dir: string, name?: string): ImportResult
+
+## importGitBook
+function importGitBook(dir: string, name?: string): ImportResult
+
+## importFromGitHub
+async function importFromGitHub(owner: string, repo: string, path: string, ref: string, options?: { format?: ImportFormat; name?: string }): Promise<ImportResult>
+
+## runImport
+function runImport(dir: string, format: ImportFormat, name?: string): ImportResult
+
+## importMarkdown
+function importMarkdown(dir: string, name?: string): ImportResult
+
+## importMintlify
+function importMintlify(dir: string, name?: string): ImportResult
+
+## importNotion
+function importNotion(dir: string, name?: string): ImportResult
+
+## importReadme
+function importReadme(dir: string, name?: string): ImportResult
+
+## transformMintlifyCallouts
+function transformMintlifyCallouts(content: string): string
+
+## transformDocusaurusAdmonitions
+function transformDocusaurusAdmonitions(content: string): string
+
+## transformGitBookHints
+function transformGitBookHints(content: string): string
+
+## transformReadmeCallouts
+function transformReadmeCallouts(content: string): string
+
+## transformNotionCallouts
+function transformNotionCallouts(content: string): string
+
+## transformConfluenceCallouts
+function transformConfluenceCallouts(content: string): string
+
+## transformMintlifyTabs
+function transformMintlifyTabs(content: string): string
+
+## transformDocusaurusTabs
+function transformDocusaurusTabs(content: string): string
+
+## transformGitBookTabs
+function transformGitBookTabs(content: string): string
+
+## transformReadmeCodeBlocks
+function transformReadmeCodeBlocks(content: string): string
+
+## transformGitBookSteps
+function transformGitBookSteps(content: string): string
+
+## transformGitBookExpandable
+function transformGitBookExpandable(content: string): string
+
+## transformGitBookContentRef
+function transformGitBookContentRef(content: string): string
+
+## transformGitBookEmbed
+function transformGitBookEmbed(content: string): string
+
+## transformNotionToggles
+function transformNotionToggles(content: string): string
+
+## transformConfluenceHtml
+function transformConfluenceHtml(content: string): string
+
+## stripDocusaurusImports
+function stripDocusaurusImports(content: string): string
+
+## normalizeFrontmatter
+function normalizeFrontmatter(content: string, defaults?: FrontmatterDefaults): string
+
+## rewriteImagePaths
+function rewriteImagePaths(content: string, mapping: Map<string, string>): string
+
+## stripNotionUUIDs
+function stripNotionUUIDs(filename: string): string
+
+## getSortWeight
+function getSortWeight(content: string): number
+
 ## AnthropicClient
 class AnthropicClient implements LLMClient
 
@@ -254,3 +380,24 @@ canHandle(filePath: string): boolean
 ## scanFile
 async scanFile(filePath: string): Promise<ScanResult>
 
+## findMdxFiles
+function findMdxFiles(dir: string): string[]
+
+## slugify
+function slugify(str: string): string
+
+## parseFrontmatter
+function parseFrontmatter(content: string): { data: Record<string, unknown>; content: string }
+
+## validatePath
+function validatePath(input: string, mustExist = true): string
+
+## validateUrl
+function validateUrl(input: string): string
+
+## validateSlug
+function validateSlug(input: string): string
+
+## sanitizeForShell
+function sanitizeForShell(input: string): string
+