skrypt-ai 0.8.0 → 0.8.1

package/dist/template/src/components/search-dialog.tsx

@@ -123,7 +123,12 @@ export function SearchDialog({ open, onClose }: SearchDialogProps) {
       setSelectedIndex(0)
       setRecentSearches(getRecentSearches())
 
+      // Lock body scroll while dialog is open
+      const previousOverflow = document.body.style.overflow
+      document.body.style.overflow = 'hidden'
+
       return () => {
+        document.body.style.overflow = previousOverflow
         previouslyFocused?.focus()
       }
     }

package/dist/template/src/instrumentation.ts

@@ -0,0 +1,11 @@
+export async function register() {
+  if (process.env.NEXT_RUNTIME === 'nodejs') {
+    await import('../sentry.server.config')
+  }
+
+  if (process.env.NEXT_RUNTIME === 'edge') {
+    await import('../sentry.edge.config')
+  }
+}
+
+export { captureRequestError as onRequestError } from '@sentry/nextjs'

package/dist/template/src/lib/docs-config.ts

@@ -0,0 +1,235 @@
+/**
+ * Centralized docs.json config loader with validation.
+ *
+ * Instead of raw JSON.parse scattered across files, all config
+ * access goes through loadDocsConfig() which validates, warns
+ * on bad values, and falls back to safe defaults.
+ */
+
+import { readFileSync } from 'fs'
+import { join } from 'path'
+import { SUPPORTED_SANS_FONTS, SUPPORTED_MONO_FONTS } from './fonts'
+import type { Navigation } from './navigation'
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+export interface DocsConfig {
+  $schema?: string
+  name: string
+  description?: string
+  favicon?: string
+  siteUrl?: string
+  logo?: string
+  headerLinks?: Array<{ title: string; path: string }>
+  fonts?: {
+    sans?: string
+    mono?: string
+  }
+  theme?: {
+    primaryColor?: string
+    font?: string // legacy
+  }
+  navigation: Navigation
+  footer?: {
+    links?: Array<{ title: string; url: string }>
+    social?: {
+      github?: string
+      twitter?: string
+      discord?: string
+      linkedin?: string
+    }
+    copyright?: string
+  }
+  editLink?: {
+    repoUrl?: string
+    branch?: string
+    docsPath?: string
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Defaults
+// ---------------------------------------------------------------------------
+
+const DEFAULT_CONFIG: DocsConfig = {
+  name: 'Documentation',
+  navigation: [],
+}
+
+// ---------------------------------------------------------------------------
+// Validation helpers
+// ---------------------------------------------------------------------------
+
+const HEX_COLOR_RE = /^#[0-9a-fA-F]{3}(?:[0-9a-fA-F]{3})?$/
+
+function isNonEmptyString(value: unknown): value is string {
+  return typeof value === 'string' && value.trim().length > 0
+}
+
+function isHexColor(value: unknown): value is string {
+  return typeof value === 'string' && HEX_COLOR_RE.test(value)
+}
+
+function isArray(value: unknown): value is unknown[] {
+  return Array.isArray(value)
+}
+
+// ---------------------------------------------------------------------------
+// Loader
+// ---------------------------------------------------------------------------
+
+/** Module-level cache so we only read + validate once per build */
+let _cached: DocsConfig | null = null
+
+/**
+ * Load and validate docs.json. Returns a typed DocsConfig with safe defaults.
+ *
+ * - Missing or unreadable file: returns defaults, logs warning.
+ * - Invalid JSON: returns defaults, logs warning.
+ * - Invalid field values: uses defaults for that field, logs warning.
+ *
+ * Result is cached for the lifetime of the process (one Next.js build).
+ */
+export function loadDocsConfig(): DocsConfig {
+  if (_cached) return _cached
+
+  const configPath = join(process.cwd(), 'docs.json')
+
+  // --- Read file ---
+  let raw: string
+  try {
+    raw = readFileSync(configPath, 'utf-8')
+  } catch {
+    console.warn('[docs.json] File not found or unreadable at', configPath, '— using defaults.')
+    _cached = { ...DEFAULT_CONFIG }
+    return _cached
+  }
+
+  // --- Parse JSON ---
+  let parsed: Record<string, unknown>
+  try {
+    parsed = JSON.parse(raw)
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err)
+    console.warn(`[docs.json] Invalid JSON: ${message} — using defaults.`)
+    _cached = { ...DEFAULT_CONFIG }
+    return _cached
+  }
+
+  if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+    console.warn('[docs.json] Expected a JSON object, got', typeof parsed, '— using defaults.')
+    _cached = { ...DEFAULT_CONFIG }
+    return _cached
+  }
+
+  // --- Validate individual fields ---
+  const warnings: string[] = []
+
+  // name (required string)
+  let name = DEFAULT_CONFIG.name
+  if (isNonEmptyString(parsed.name)) {
+    name = parsed.name as string
+  } else if (parsed.name !== undefined) {
+    warnings.push(`"name" must be a non-empty string, got ${JSON.stringify(parsed.name)} — using "${DEFAULT_CONFIG.name}".`)
+  }
+
+  // description (optional string)
+  const description = isNonEmptyString(parsed.description) ? (parsed.description as string) : undefined
+
+  // favicon (optional string)
+  const favicon = isNonEmptyString(parsed.favicon) ? (parsed.favicon as string) : undefined
+
+  // siteUrl (optional string)
+  const siteUrl = isNonEmptyString(parsed.siteUrl) ? (parsed.siteUrl as string) : undefined
+
+  // logo (optional string)
+  const logo = isNonEmptyString(parsed.logo) ? (parsed.logo as string) : undefined
+
+  // headerLinks (optional array)
+  const headerLinks = isArray(parsed.headerLinks)
+    ? (parsed.headerLinks as Array<{ title: string; path: string }>)
+    : undefined
+
+  // navigation (required non-empty array)
+  let navigation: Navigation = DEFAULT_CONFIG.navigation
+  if (isArray(parsed.navigation) && parsed.navigation.length > 0) {
+    navigation = parsed.navigation as Navigation
+  } else if (!isArray(parsed.navigation)) {
+    warnings.push(`"navigation" must be an array, got ${typeof parsed.navigation} — using empty navigation.`)
+  } else if (parsed.navigation.length === 0) {
+    warnings.push('"navigation" is empty — the sidebar will have no links.')
+  }
+
+  // theme (optional object)
+  let theme: DocsConfig['theme'] = undefined
+  if (parsed.theme && typeof parsed.theme === 'object' && !Array.isArray(parsed.theme)) {
+    const rawTheme = parsed.theme as Record<string, unknown>
+    const primaryColor = isHexColor(rawTheme.primaryColor) ? rawTheme.primaryColor : undefined
+    const font = isNonEmptyString(rawTheme.font) ? (rawTheme.font as string) : undefined
+
+    if (rawTheme.primaryColor !== undefined && !primaryColor) {
+      warnings.push(`"theme.primaryColor" must be a valid hex color (e.g. "#171717"), got ${JSON.stringify(rawTheme.primaryColor)} — ignoring.`)
+    }
+
+    theme = { primaryColor, font }
+  }
+
+  // fonts (optional object with known font names)
+  let fonts: DocsConfig['fonts'] = undefined
+  if (parsed.fonts && typeof parsed.fonts === 'object' && !Array.isArray(parsed.fonts)) {
+    const rawFonts = parsed.fonts as Record<string, unknown>
+    let sans: string | undefined
+    let mono: string | undefined
+
+    if (isNonEmptyString(rawFonts.sans)) {
+      if (rawFonts.sans in SUPPORTED_SANS_FONTS) {
+        sans = rawFonts.sans as string
+      } else {
+        warnings.push(`"fonts.sans" value "${rawFonts.sans}" is not a supported font — falling back to default. Supported: ${Object.keys(SUPPORTED_SANS_FONTS).join(', ')}.`)
+      }
+    }
+
+    if (isNonEmptyString(rawFonts.mono)) {
+      if (rawFonts.mono in SUPPORTED_MONO_FONTS) {
+        mono = rawFonts.mono as string
+      } else {
+        warnings.push(`"fonts.mono" value "${rawFonts.mono}" is not a supported font — falling back to default. Supported: ${Object.keys(SUPPORTED_MONO_FONTS).join(', ')}.`)
+      }
+    }
+
+    fonts = { sans, mono }
+  }
+
+  // footer (optional)
+  const footer = parsed.footer && typeof parsed.footer === 'object' && !Array.isArray(parsed.footer)
+    ? (parsed.footer as DocsConfig['footer'])
+    : undefined
+
+  // editLink (optional)
+  const editLink = parsed.editLink && typeof parsed.editLink === 'object' && !Array.isArray(parsed.editLink)
+    ? (parsed.editLink as DocsConfig['editLink'])
+    : undefined
+
+  // --- Log warnings ---
+  for (const w of warnings) {
+    console.warn(`[docs.json] ${w}`)
+  }
+
+  _cached = {
+    name,
+    description,
+    favicon,
+    siteUrl,
+    logo,
+    headerLinks,
+    fonts,
+    theme,
+    navigation,
+    footer,
+    editLink,
+  }
+
+  return _cached
+}

package/dist/template/src/lib/fonts.ts

@@ -83,9 +83,9 @@ function sanitize(name: string): string {
  *
  * Unrecognized font names fall back to defaults.
  */
-export function resolveFonts(docsConfig: Record<string, unknown>): ResolvedFonts {
-  const fonts = docsConfig.fonts as { sans?: string; mono?: string } | undefined
-  const legacyFont = (docsConfig.theme as { font?: string } | undefined)?.font
+export function resolveFonts(docsConfig: { fonts?: { sans?: string; mono?: string }; theme?: { font?: string } }): ResolvedFonts {
+  const fonts = docsConfig.fonts
+  const legacyFont = docsConfig.theme?.font
 
   // Resolve sans font
   const rawSans = fonts?.sans || legacyFont || DEFAULT_SANS

package/dist/testing/runner.js

@@ -159,7 +159,7 @@ async function installNodeDeps(deps, tempDir, envVars) {
     }
     writeFileSync(join(tempDir, 'package.json'), JSON.stringify(pkg));
     const env = buildCleanEnv(envVars);
-    await executeWithTimeout('npm', ['install', '--prefix', tempDir, '--no-audit', '--no-fund'], 30000, tempDir, env);
+    await executeWithTimeout('npm', ['install', '--prefix', tempDir, '--no-audit', '--no-fund', '--ignore-scripts'], 30000, tempDir, env);
 }
 /**
  * Install Python dependencies in a temp directory using pip
@@ -184,6 +184,7 @@ function executeWithTimeout(command, args, timeoutMs, cwd, env) {
         let stdout = '';
         let stderr = '';
         let timedOut = false;
+        let resolved = false;
         const MAX_BUFFER = 1024 * 1024; // 1MB cap to prevent OOM
         const timeout = setTimeout(() => {
             timedOut = true;
@@ -204,6 +205,9 @@ function executeWithTimeout(command, args, timeoutMs, cwd, env) {
             }
         });
         proc.on('close', (code) => {
+            if (resolved)
+                return;
+            resolved = true;
             clearTimeout(timeout);
             resolve({
                 exitCode: timedOut ? 1 : (code ?? 1),
@@ -213,6 +217,9 @@ function executeWithTimeout(command, args, timeoutMs, cwd, env) {
             });
         });
         proc.on('error', (err) => {
+            if (resolved)
+                return;
+            resolved = true;
             clearTimeout(timeout);
             resolve({
                 exitCode: 1,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skrypt-ai",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "AI-powered documentation generator with code examples",
   "type": "module",
   "main": "dist/cli.js",
@@ -48,6 +48,7 @@
   "license": "Elastic-2.0",
   "dependencies": {
     "@anthropic-ai/sdk": "^0.78.0",
+    "@sentry/node": "^10.45.0",
     "chokidar": "^5.0.0",
     "commander": "^14.0.3",
     "js-yaml": "^4.1.1",