deepspace 0.19.5 → 0.21.0

package/dist/documentation-server-core.d.ts

@@ -1,6 +1,7 @@
-import { D as DocumentationRuntimeData, a as DocumentationPageComponent, b as DocumentationSiteComponent } from './public-CFAj1hL2.js';
-export { A as Accordion, c as AccordionGroup, C as Card, d as CodeGroup, e as DefaultDocumentation, f as DocumentationApp, g as DocumentationAppProps, h as DocumentationContent, i as DocumentationSiteProps, I as Info, N as Note, S as Step, j as Steps, T as Tab, k as Tabs, l as Tip, W as Warning } from './public-CFAj1hL2.js';
+import { D as DocumentationRuntimeData, a as DocumentationPageComponent, b as DocumentationSiteComponent } from './public-DenQ1TsZ.js';
+export { A as Accordion, c as AccordionGroup, C as Card, d as CodeGroup, e as DefaultDocumentation, f as DocumentationApp, g as DocumentationAppProps, h as DocumentationContent, i as DocumentationSiteProps, I as Info, N as Note, S as Step, j as Steps, T as Tab, k as Tabs, l as Tip, W as Warning } from './public-DenQ1TsZ.js';
 import 'react';
+import 'zod';
 
 declare function renderDocumentation({ data, Page, Site, }: {
     data: DocumentationRuntimeData;

package/dist/documentation-server-core.js

@@ -14,7 +14,7 @@ import {
   Tabs,
   Tip,
   Warning
-} from "./chunk-A7UFIOWO.js";
+} from "./chunk-KDCDRHBA.js";
 
 // src/documentation/runtime/server.tsx
 import { createElement } from "react";

package/dist/documentation.d.ts

@@ -1,3 +1,24 @@
+import { z } from 'zod';
+
+declare const themeObjectSchema: z.ZodObject<{
+    accent: z.ZodOptional<z.ZodString>;
+    accentDark: z.ZodOptional<z.ZodString>;
+    background: z.ZodOptional<z.ZodString>;
+    density: z.ZodOptional<z.ZodEnum<{
+        comfortable: "comfortable";
+        compact: "compact";
+    }>>;
+    logo: z.ZodOptional<z.ZodString>;
+    logoDark: z.ZodOptional<z.ZodString>;
+    favicon: z.ZodOptional<z.ZodString>;
+    defaultMode: z.ZodOptional<z.ZodEnum<{
+        light: "light";
+        dark: "dark";
+        system: "system";
+    }>>;
+    strictMode: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+
 declare const DOCUMENTATION_CONFIG_FILE = "documentation.json";
 declare const DOCUMENTATION_MANIFEST_VERSION = 2;
 type DocumentationAssistantAccess = 'disabled' | 'public' | 'authenticated';
@@ -11,11 +32,21 @@ interface DocumentationFontConfig {
     source?: string;
     format?: string;
 }
-interface DocumentationThemeConfig {
-    preset?: string;
-    accent?: string;
-    accentDark?: string;
-    background?: string;
+/**
+ * The `theme` object as authored in documentation.json — exactly the keys
+ * the config schema accepts under `theme.*`, derived from that schema so
+ * the two can never drift. Everything else (fonts, background decoration,
+ * styling, logo href) is configured through the Mintlify-style top-level
+ * keys and only exists on the resolved theme.
+ */
+type DocumentationThemeConfig = z.infer<typeof themeObjectSchema>;
+/**
+ * The fully resolved theme after config loading merges `theme.*` with the
+ * Mintlify top-level keys (`colors`, `logo`, `favicon`, `appearance`,
+ * `background`, `fonts`, `styling`). This is what the template and runtime
+ * consume; it is an output shape, never accepted as `theme.*` input.
+ */
+interface ResolvedDocumentationTheme extends DocumentationThemeConfig {
     backgroundDark?: string;
     backgroundDecoration?: 'none' | 'gradient' | 'grid';
     bodyFont?: DocumentationFontConfig;
@@ -23,12 +54,7 @@ interface DocumentationThemeConfig {
     monoFont?: DocumentationFontConfig;
     codeBlockMode?: 'dark' | 'system';
     eyebrowStyle?: 'section' | 'breadcrumbs' | 'none';
-    logo?: string;
-    logoDark?: string;
     logoHref?: string;
-    favicon?: string;
-    defaultMode?: 'light' | 'dark' | 'system';
-    strictMode?: boolean;
 }
 interface DocumentationLinkConfig {
     label: string;
@@ -85,7 +111,7 @@ interface DocumentationConfig {
     url?: string;
     /** Explicit custom hostnames that mount this documentation at `/`. */
     domains: string[];
-    theme: DocumentationThemeConfig;
+    theme: ResolvedDocumentationTheme;
     navigation?: DocumentationNavigationItem[];
     links: DocumentationLinkConfig[];
     footer: DocumentationLinkConfig[];
@@ -200,6 +226,8 @@ interface DocumentationBuildManifest {
     version: typeof DOCUMENTATION_MANIFEST_VERSION;
     sourceHash: string;
     outputHash: string;
+    /** Version of the `deepspace` package that compiled this output. */
+    sdkVersion: string;
     name: string;
     pageCount: number;
     /** Authored pages plus configured redirect entry points. */
@@ -364,4 +392,4 @@ declare function deepSpaceDocumentation(): {
     configureServer(server: DocumentationViteServer): void;
 };
 
-export { AGENT_SKILLS_SCHEMA, type BuildDocumentationOptions, DEFAULT_DOCUMENTATION_CONTEXTUAL_ACTIONS, DEFAULT_DOCUMENTATION_OPENAPI_EXAMPLES, DOCUMENTATION_CONFIG_FILE, DOCUMENTATION_CONTEXTUAL_ACTIONS, DOCUMENTATION_MANIFEST_VERSION, DOCUMENTATION_OPENAPI_SAMPLE_LANGUAGES, type DocumentationAssistantAccess, type DocumentationAssistantChunk, type DocumentationAssistantConfig, type DocumentationBuildManifest, type DocumentationBuildResult, type DocumentationConfig, type DocumentationContextualAction, type DocumentationContextualConfig, type DocumentationDiagnostic, DocumentationError, type DocumentationFontConfig, type DocumentationFrontmatter, type DocumentationGraph, type DocumentationHeading, type DocumentationLinkConfig, type DocumentationMcpAccess, type DocumentationMcpConfig, type DocumentationNavGroup, type DocumentationNavigationGroup, type DocumentationNavigationItem, type DocumentationNavigationLink, type DocumentationNavigationNode, type DocumentationNavigationPage, type DocumentationOpenApiCodeSample, type DocumentationOpenApiConfig, type DocumentationOpenApiExamplesConfig, type DocumentationOpenApiOperation, type DocumentationOpenApiParameter, type DocumentationOpenApiResponse, type DocumentationOpenApiSampleDefaults, type DocumentationOpenApiSampleLanguage, type DocumentationPage, type DocumentationRuntimeData, type DocumentationRuntimePage, type DocumentationRuntimePageLink, type DocumentationRuntimeRouteData, type DocumentationRuntimeRouteDocument, type DocumentationSearchEntry, type DocumentationSeoConfig, type DocumentationSkillArtifacts, type DocumentationThemeConfig, type DocumentationValidationResult, type LoadedDocumentationConfig, buildDocumentation, createDocumentationSkillArtifacts, deepSpaceDocumentation, documentationSkillName, htmlToText, loadDocumentationConfig, normalizeRoute, parseFrontmatter, parseMarkdown, routeFromRelativePath, slugify, validateDocumentation };
+export { AGENT_SKILLS_SCHEMA, type BuildDocumentationOptions, DEFAULT_DOCUMENTATION_CONTEXTUAL_ACTIONS, DEFAULT_DOCUMENTATION_OPENAPI_EXAMPLES, DOCUMENTATION_CONFIG_FILE, DOCUMENTATION_CONTEXTUAL_ACTIONS, DOCUMENTATION_MANIFEST_VERSION, DOCUMENTATION_OPENAPI_SAMPLE_LANGUAGES, type DocumentationAssistantAccess, type DocumentationAssistantChunk, type DocumentationAssistantConfig, type DocumentationBuildManifest, type DocumentationBuildResult, type DocumentationConfig, type DocumentationContextualAction, type DocumentationContextualConfig, type DocumentationDiagnostic, DocumentationError, type DocumentationFontConfig, type DocumentationFrontmatter, type DocumentationGraph, type DocumentationHeading, type DocumentationLinkConfig, type DocumentationMcpAccess, type DocumentationMcpConfig, type DocumentationNavGroup, type DocumentationNavigationGroup, type DocumentationNavigationItem, type DocumentationNavigationLink, type DocumentationNavigationNode, type DocumentationNavigationPage, type DocumentationOpenApiCodeSample, type DocumentationOpenApiConfig, type DocumentationOpenApiExamplesConfig, type DocumentationOpenApiOperation, type DocumentationOpenApiParameter, type DocumentationOpenApiResponse, type DocumentationOpenApiSampleDefaults, type DocumentationOpenApiSampleLanguage, type DocumentationPage, type DocumentationRuntimeData, type DocumentationRuntimePage, type DocumentationRuntimePageLink, type DocumentationRuntimeRouteData, type DocumentationRuntimeRouteDocument, type DocumentationSearchEntry, type DocumentationSeoConfig, type DocumentationSkillArtifacts, type DocumentationThemeConfig, type DocumentationValidationResult, type LoadedDocumentationConfig, type ResolvedDocumentationTheme, buildDocumentation, createDocumentationSkillArtifacts, deepSpaceDocumentation, documentationSkillName, htmlToText, loadDocumentationConfig, normalizeRoute, parseFrontmatter, parseMarkdown, routeFromRelativePath, slugify, validateDocumentation };

package/dist/documentation.js

@@ -3,6 +3,9 @@ import { buildSync as buildSync3 } from "esbuild";
 import { readFileSync as readFileSync7 } from "fs";
 import { resolve as resolve7 } from "path";
 
+// package.json
+var version = "0.21.0";
+
 // src/documentation/markdown.ts
 import hljs from "highlight.js/lib/core";
 import bash from "highlight.js/lib/languages/bash";
@@ -889,15 +892,17 @@ var openapiItemSchema = z.union([
   })
 ]);
 var themeObjectSchema = z.object({
-  preset: z.string().trim().min(1).optional(),
   accent: z.string().trim().optional(),
   accentDark: z.string().trim().optional(),
   background: z.string().trim().optional(),
+  density: z.enum(["comfortable", "compact"]).optional(),
   logo: z.string().trim().optional(),
   logoDark: z.string().trim().optional(),
   favicon: z.string().trim().optional(),
-  defaultMode: z.enum(["light", "dark", "system"]).optional()
+  defaultMode: z.enum(["light", "dark", "system"]).optional(),
+  strictMode: z.boolean().optional()
 });
+var THEME_CONFIG_KEYS = new Set(Object.keys(themeObjectSchema.shape));
 var fontSpecSchema = z.union([
   z.string().trim().min(1).transform((family) => ({ family })),
   z.object({
@@ -1192,8 +1197,20 @@ function loadDocumentationConfig(appDir) {
         });
       }
     }
+    const rawTheme = input.theme;
+    if (rawTheme && typeof rawTheme === "object" && !Array.isArray(rawTheme)) {
+      for (const key of Object.keys(rawTheme)) {
+        if (!THEME_CONFIG_KEYS.has(key)) {
+          warnings.push({
+            code: "unsupported_config_key",
+            message: `Unsupported theme configuration key 'theme.${key}' was ignored`,
+            file: configPath
+          });
+        }
+      }
+    }
   }
-  const themeInput = typeof data.theme === "string" ? { preset: data.theme } : data.theme;
+  const themeInput = typeof data.theme === "string" ? {} : data.theme;
   if (typeof data.theme === "string") {
     warnings.push({
       code: "mintlify_theme_normalized",
@@ -1248,7 +1265,7 @@ function loadDocumentationConfig(appDir) {
       logoHref: logo?.href,
       favicon: themeInput.favicon ?? data.favicon,
       defaultMode: data.appearance?.default ?? themeInput.defaultMode,
-      strictMode: data.appearance?.strict
+      strictMode: themeInput.strictMode ?? data.appearance?.strict
     },
     navigation,
     links: data.links.length > 0 ? data.links : navbarLinks,
@@ -3097,6 +3114,10 @@ var DOCUMENTATION_BASE_CSS = String.raw`
   --documentation-glass-bg: color-mix(in srgb, var(--documentation-surface-raised) 86%, transparent);
   --documentation-glass-border: color-mix(in srgb, var(--documentation-border-strong) 90%, var(--documentation-accent));
   --documentation-glass-highlight: rgba(255, 255, 255, .6);
+  --documentation-font-size: 17px;
+  --documentation-line-height: 1.65;
+  --documentation-content-width: 720px;
+  --documentation-reader-pad: 62px 52px 96px;
   --documentation-header-height: 66px;
   --documentation-sidebar-width: 292px;
   --documentation-assistant-width: 420px;
@@ -3133,9 +3154,20 @@ var DOCUMENTATION_BASE_CSS = String.raw`
   color-scheme: dark;
 }
 
+/* theme.density, stamped by the template as data-density. Compact reworks the
+ * whole reading measure through the tokens alone so no layout rule forks. */
+:root[data-density="compact"] {
+  --documentation-font-size: 15px;
+  --documentation-line-height: 1.6;
+  --documentation-content-width: 680px;
+  --documentation-reader-pad: 44px 44px 80px;
+  --documentation-header-height: 58px;
+  --documentation-sidebar-width: 264px;
+}
+
 * { box-sizing: border-box; }
 html { scroll-behavior: smooth; scroll-padding-top: 96px; scrollbar-gutter: stable; }
-body { margin: 0; background: var(--documentation-brand-bg); color: var(--documentation-text); font-family: var(--documentation-font-body); font-size: 17px; line-height: 1.65; text-rendering: optimizeLegibility; -webkit-font-smoothing: antialiased; -moz-osx-font-smoothing: grayscale; }
+body { margin: 0; background: var(--documentation-brand-bg); color: var(--documentation-text); font-family: var(--documentation-font-body); font-size: var(--documentation-font-size); line-height: var(--documentation-line-height); text-rendering: optimizeLegibility; -webkit-font-smoothing: antialiased; -moz-osx-font-smoothing: grayscale; }
 :root[data-background-decoration="gradient"] body { background-image: radial-gradient(circle at 58% 7%, color-mix(in srgb, var(--documentation-accent) 7%, transparent), transparent 32%); background-attachment: fixed; }
 :root[data-background-decoration="grid"] body { background-image: linear-gradient(color-mix(in srgb, var(--documentation-border) 26%, transparent) 1px, transparent 1px), linear-gradient(90deg, color-mix(in srgb, var(--documentation-border) 26%, transparent) 1px, transparent 1px); background-attachment: fixed; background-size: 32px 32px; }
 body:has(.documentation-modal-layer), body:has(.documentation-mobile-nav) { overflow: hidden; }
@@ -3164,7 +3196,7 @@ button:focus-visible, a:focus-visible, input:focus-visible, textarea:focus-visib
 // src/documentation/runtime/styles/content.ts
 var DOCUMENTATION_CONTENT_CSS = String.raw`
 .documentation-main { min-width: 0; margin-left: var(--documentation-sidebar-width); margin-right: 0; transition: margin-right .24s ease; }
-.documentation-reader-grid { display: grid; grid-template-columns: minmax(0, 720px) 250px; justify-content: center; gap: 70px; width: 100%; padding: 62px 52px 96px; }
+.documentation-reader-grid { display: grid; grid-template-columns: minmax(0, var(--documentation-content-width)) 250px; justify-content: center; gap: 70px; width: 100%; padding: var(--documentation-reader-pad); }
 .documentation-reader-column { display: flex; min-width: 0; min-height: calc(100vh - var(--documentation-header-height) - 158px); flex-direction: column; }
 .documentation-article { display: flex; min-width: 0; flex: 1; flex-direction: column; }
 .documentation-breadcrumbs { display: none; align-items: center; gap: 5px; margin-bottom: 24px; color: var(--documentation-muted); font-size: 13px; }
@@ -3640,7 +3672,7 @@ function renderPage(options, assets = {}, runtime = createPageRuntime(options))
   const assetRoot = documentationPublicPath(options.basePath, "/assets");
   const favicon = theme.favicon ?? documentationPublicPath(options.basePath, "/assets/favicon.svg");
   return `<!doctype html>
-<html lang="en" data-theme-mode="${defaultMode}" data-theme-strict="${theme.strictMode ? "true" : "false"}" data-code-mode="${theme.codeBlockMode ?? "dark"}" data-background-decoration="${theme.backgroundDecoration ?? "none"}" data-eyebrow-style="${theme.eyebrowStyle ?? "section"}">
+<html lang="en" data-theme-mode="${defaultMode}" data-theme-strict="${theme.strictMode ? "true" : "false"}" data-code-mode="${theme.codeBlockMode ?? "dark"}" data-density="${theme.density ?? "comfortable"}" data-background-decoration="${theme.backgroundDecoration ?? "none"}" data-eyebrow-style="${theme.eyebrowStyle ?? "section"}">
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1">
@@ -3938,6 +3970,7 @@ function buildDocumentation(options) {
     version: DOCUMENTATION_MANIFEST_VERSION,
     sourceHash: validation.graph.sourceHash,
     outputHash,
+    sdkVersion: version,
     name: validation.graph.config.name,
     pageCount: validation.graph.pages.length,
     routes: [