deepspace 0.9.2 → 0.10.0

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

@@ -0,0 +1,11 @@
+import { D as DocsRuntimeData, a as DocsPageComponent, b as DocsSiteComponent } from './public-Cp1X8ZQ3.js';
+export { A as Accordion, c as AccordionGroup, C as Card, d as CodeGroup, e as DefaultDocs, f as DocsApp, g as DocsAppProps, h as DocsContent, i as DocsSiteProps, 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-Cp1X8ZQ3.js';
+import 'react';
+
+declare function renderDocs({ data, Page, Site, }: {
+    data: DocsRuntimeData;
+    Page?: DocsPageComponent;
+    Site?: DocsSiteComponent;
+}): string;
+
+export { DocsPageComponent, DocsSiteComponent, renderDocs };

package/dist/docs-server-core.js

@@ -0,0 +1,48 @@
+import {
+  Accordion,
+  AccordionGroup,
+  Card,
+  CodeGroup,
+  DefaultDocs,
+  DocsApp,
+  DocsContent,
+  Info,
+  Note,
+  Step,
+  Steps,
+  Tab,
+  Tabs,
+  Tip,
+  Warning
+} from "./chunk-DQ4G6VL6.js";
+
+// src/docs/runtime/server.tsx
+import { createElement } from "react";
+import { renderToString } from "react-dom/server";
+function renderDocs({
+  data,
+  Page,
+  Site = DefaultDocs
+}) {
+  const content = createElement(DocsContent, { data, Page });
+  return renderToString(createElement(Site, { children: content, data }));
+}
+export {
+  Accordion,
+  AccordionGroup,
+  Card,
+  CodeGroup,
+  DefaultDocs,
+  DocsApp,
+  DocsContent,
+  Info,
+  Note,
+  Step,
+  Steps,
+  Tab,
+  Tabs,
+  Tip,
+  Warning,
+  renderDocs
+};
+//# sourceMappingURL=docs-server-core.js.map

package/dist/docs-server-core.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/docs/runtime/server.tsx"],"sourcesContent":["import { createElement, type ReactElement } from 'react'\nimport { renderToString } from 'react-dom/server'\nimport type { DocsRuntimeData } from '../types'\nimport {\n  DefaultDocs,\n  DocsContent,\n  type DocsPageComponent,\n  type DocsSiteComponent,\n} from './public'\nexport * from './public'\n\nexport function renderDocs({\n  data,\n  Page,\n  Site = DefaultDocs as DocsSiteComponent,\n}: {\n  data: DocsRuntimeData\n  Page?: DocsPageComponent\n  Site?: DocsSiteComponent\n}): string {\n  const content: ReactElement = createElement(DocsContent, { data, Page })\n  return renderToString(createElement(Site, { children: content, data }))\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAwC;AACjD,SAAS,sBAAsB;AAUxB,SAAS,WAAW;AAAA,EACzB;AAAA,EACA;AAAA,EACA,OAAO;AACT,GAIW;AACT,QAAM,UAAwB,cAAc,aAAa,EAAE,MAAM,KAAK,CAAC;AACvE,SAAO,eAAe,cAAc,MAAM,EAAE,UAAU,SAAS,KAAK,CAAC,CAAC;AACxE;","names":[]}

package/dist/docs.d.ts

@@ -0,0 +1,350 @@
+import { IncomingMessage, ServerResponse } from 'node:http';
+
+declare const DOCS_CONFIG_FILE = "docs.json";
+declare const DOCS_MANIFEST_VERSION = 1;
+type DocsAssistantAccess = 'disabled' | 'public' | 'authenticated';
+type DocsMcpAccess = 'disabled' | 'public';
+declare const DOCS_CONTEXTUAL_ACTIONS: readonly ["copy", "view", "assistant", "chatgpt", "claude", "mcp", "add-mcp", "cursor", "vscode"];
+type DocsContextualAction = (typeof DOCS_CONTEXTUAL_ACTIONS)[number];
+declare const DEFAULT_DOCS_CONTEXTUAL_ACTIONS: readonly DocsContextualAction[];
+interface DocsFontConfig {
+    family: string;
+    weight?: number | string;
+    source?: string;
+    format?: string;
+}
+interface DocsThemeConfig {
+    preset?: string;
+    accent?: string;
+    background?: string;
+    backgroundDark?: string;
+    backgroundDecoration?: 'none' | 'gradient' | 'grid';
+    bodyFont?: DocsFontConfig;
+    headingFont?: DocsFontConfig;
+    monoFont?: DocsFontConfig;
+    codeBlockMode?: 'dark' | 'system';
+    eyebrowStyle?: 'section' | 'breadcrumbs' | 'none';
+    logo?: string;
+    logoDark?: string;
+    logoHref?: string;
+    favicon?: string;
+    defaultMode?: 'light' | 'dark' | 'system';
+    strictMode?: boolean;
+}
+interface DocsLinkConfig {
+    label: string;
+    href: string;
+}
+interface DocsNavGroup {
+    group: string;
+    pages: DocsNavigationItem[];
+}
+type DocsNavigationItem = string | DocsLinkConfig | DocsNavGroup;
+declare const DOCS_OPENAPI_SAMPLE_LANGUAGES: readonly ["curl", "javascript", "python", "go"];
+type DocsOpenApiSampleLanguage = (typeof DOCS_OPENAPI_SAMPLE_LANGUAGES)[number];
+type DocsOpenApiSampleDefaults = 'required' | 'all';
+interface DocsOpenApiExamplesConfig {
+    languages: DocsOpenApiSampleLanguage[];
+    defaults: DocsOpenApiSampleDefaults;
+    autogenerate: boolean;
+}
+declare const DEFAULT_DOCS_OPENAPI_EXAMPLES: {
+    readonly languages: readonly ["curl", "python", "javascript", "go"];
+    readonly defaults: "all";
+    readonly autogenerate: true;
+};
+interface DocsOpenApiConfig {
+    source: string;
+    route?: string;
+    label?: string;
+    playground?: boolean;
+    baseUrl?: string;
+    examples?: DocsOpenApiExamplesConfig;
+}
+interface DocsAssistantConfig {
+    access: DocsAssistantAccess;
+    model?: string;
+    suggestions?: string[];
+}
+interface DocsMcpConfig {
+    access: DocsMcpAccess;
+}
+interface DocsContextualConfig {
+    actions: DocsContextualAction[];
+}
+interface DocsSeoConfig {
+    noindex?: boolean;
+    ogImage?: string;
+    metaTags?: Record<string, string>;
+}
+interface DocsConfig {
+    $schema?: string;
+    name: string;
+    description?: string;
+    source: string;
+    output: string;
+    url?: string;
+    theme: DocsThemeConfig;
+    navigation?: DocsNavigationItem[];
+    links: DocsLinkConfig[];
+    footer: DocsLinkConfig[];
+    redirects: Record<string, string>;
+    openapi: DocsOpenApiConfig[];
+    assistant: DocsAssistantConfig;
+    mcp: DocsMcpConfig;
+    contextual: DocsContextualConfig;
+    seo: DocsSeoConfig;
+}
+interface DocsFrontmatter {
+    title?: string;
+    description?: string;
+    slug?: string;
+    hidden?: boolean;
+    noindex?: boolean;
+}
+interface DocsHeading {
+    depth: number;
+    id: string;
+    text: string;
+}
+interface DocsPage {
+    sourcePath: string;
+    relativePath: string;
+    route: string;
+    title: string;
+    description?: string;
+    hidden: boolean;
+    noindex: boolean;
+    markdown: string;
+    html: string;
+    text: string;
+    headings: DocsHeading[];
+    sourceFormat: 'markdown' | 'mdx' | 'generated';
+    kind: 'page' | 'openapi';
+    openapi?: DocsOpenApiOperation;
+}
+interface DocsNavigationPage {
+    kind: 'page';
+    route: string;
+    label: string;
+}
+interface DocsNavigationLink {
+    kind: 'link';
+    href: string;
+    label: string;
+}
+interface DocsNavigationGroup {
+    kind: 'group';
+    label: string;
+    items: DocsNavigationNode[];
+}
+type DocsNavigationNode = DocsNavigationPage | DocsNavigationLink | DocsNavigationGroup;
+interface DocsOpenApiParameter {
+    name: string;
+    in: string;
+    required: boolean;
+    description?: string;
+    schema?: unknown;
+    example?: unknown;
+}
+interface DocsOpenApiResponse {
+    status: string;
+    description: string;
+    schema?: unknown;
+}
+interface DocsOpenApiCodeSample {
+    language: string;
+    label: string;
+    syntax: string;
+    code: string;
+    generated: boolean;
+}
+interface DocsOpenApiOperation {
+    method: string;
+    path: string;
+    operationId: string;
+    summary: string;
+    description?: string;
+    tags: string[];
+    parameters: DocsOpenApiParameter[];
+    requestBody?: unknown;
+    responses: DocsOpenApiResponse[];
+    security?: unknown;
+    baseUrl?: string;
+    playground: boolean;
+    codeSamples: DocsOpenApiCodeSample[];
+}
+interface DocsSearchEntry {
+    route: string;
+    title: string;
+    description?: string;
+    headings: string[];
+    text: string;
+}
+interface DocsAssistantChunk {
+    id: string;
+    route: string;
+    title: string;
+    heading?: string;
+    text: string;
+}
+interface DocsGraph {
+    config: DocsConfig;
+    pages: DocsPage[];
+    navigation: DocsNavigationNode[];
+    sourceHash: string;
+}
+interface DocsBuildManifest {
+    version: typeof DOCS_MANIFEST_VERSION;
+    sourceHash: string;
+    outputHash: string;
+    name: string;
+    pageCount: number;
+    routes: string[];
+    assistant: DocsAssistantConfig;
+    mcp: DocsMcpConfig;
+}
+interface DocsDiagnostic {
+    code: string;
+    message: string;
+    file?: string;
+    line?: number;
+}
+interface DocsValidationResult {
+    appDir: string;
+    configPath: string;
+    sourceDir: string;
+    outputDir: string;
+    graph: DocsGraph;
+    warnings: DocsDiagnostic[];
+}
+interface DocsBuildResult extends DocsValidationResult {
+    manifest: DocsBuildManifest;
+    files: string[];
+}
+interface DocsRuntimePageLink {
+    route: string;
+    title: string;
+}
+interface DocsRuntimePage {
+    route: string;
+    title: string;
+    description?: string;
+    html: string;
+    headings: DocsHeading[];
+    kind: DocsPage['kind'];
+    markdownUrl: string;
+    openapi?: DocsOpenApiOperation;
+}
+interface DocsRuntimeData {
+    config: Pick<DocsConfig, 'name' | 'description' | 'theme' | 'links' | 'footer' | 'assistant' | 'mcp' | 'contextual'>;
+    page: DocsRuntimePage;
+    navigation: DocsNavigationNode[];
+    breadcrumbs: string[];
+    previous?: DocsRuntimePageLink;
+    next?: DocsRuntimePageLink;
+}
+type DocsRuntimeRouteData = Omit<DocsRuntimeData, 'config' | 'navigation'>;
+/** Small per-route payload used by the hydrated docs router. */
+interface DocsRuntimeRouteDocument {
+    canonical: string | null;
+    data: DocsRuntimeRouteData;
+    description: string | null;
+    openGraph: Record<'og:title' | 'og:description' | 'og:url', string | null>;
+    robots: string | null;
+    title: string;
+}
+declare class DocsError extends Error {
+    readonly code: string;
+    readonly diagnostics: DocsDiagnostic[];
+    constructor(message: string, code: string, diagnostics?: DocsDiagnostic[]);
+}
+
+interface BuildDocsOptions {
+    appDir: string;
+    outputDir?: string;
+    baseUrl?: string;
+}
+declare function buildDocs(options: BuildDocsOptions): DocsBuildResult;
+
+interface LoadedDocsConfig {
+    config: DocsConfig;
+    configPath: string;
+    sourceDir: string;
+    outputDir: string;
+    raw: string;
+    warnings: DocsDiagnostic[];
+}
+declare function loadDocsConfig(appDir: string): LoadedDocsConfig;
+
+declare function validateDocs(appDir: string): DocsValidationResult;
+
+/** Normalize and validate every public documentation route in one place. */
+declare function normalizeRoute(value: string): string;
+declare function routeFromRelativePath(relativePath: string): string;
+
+declare function slugify(value: string): string;
+
+interface ParsedMarkdown {
+    frontmatter: DocsFrontmatter;
+    markdown: string;
+    html: string;
+    text: string;
+    headings: DocsHeading[];
+}
+declare function parseMarkdown(source: string, file: string): ParsedMarkdown;
+declare function parseFrontmatter(source: string, file: string): {
+    frontmatter: DocsFrontmatter;
+    body: string;
+};
+
+declare function htmlToText(html: string): string;
+
+declare const AGENT_SKILLS_SCHEMA = "https://schemas.agentskills.io/discovery/0.2.0/schema.json";
+interface DocsSkillArtifacts {
+    name: string;
+    description: string;
+    markdown: string;
+    legacyIndex: Record<string, unknown>;
+    discoveryIndex: Record<string, unknown>;
+}
+/** Build one deterministic, installable skill from the same graph as the site. */
+declare function createDocsSkillArtifacts(graph: DocsGraph, baseUrl?: string): DocsSkillArtifacts;
+declare function docsSkillName(value: string): string;
+
+interface DocsViteServer {
+    middlewares: {
+        use(handler: (request: IncomingMessage, response: ServerResponse, next: () => void) => void): void;
+    };
+    watcher: {
+        add(paths: string[]): void;
+        on(event: 'all', handler: (event: string, path: string) => void): void;
+    };
+    config: {
+        logger: {
+            info(message: string): void;
+            error(message: string): void;
+        };
+    };
+}
+/**
+ * Vite development bridge for the app Worker's ASSETS binding.
+ *
+ * Deployed docs are bundled after the app build. In development the Worker is
+ * already live, so this plugin compiles the same graph into an ignored cache
+ * and serves only the reserved `/_docs/*` asset namespace through Vite.
+ */
+declare function deepSpaceDocs(): {
+    name: string;
+    apply: 'serve';
+    config(config: {
+        root?: string;
+    }): void;
+    configResolved(config: {
+        root: string;
+    }): void;
+    configureServer(server: DocsViteServer): void;
+};
+declare function serveDocsDevAsset(outputDir: string, request: IncomingMessage, response: ServerResponse): boolean;
+
+export { AGENT_SKILLS_SCHEMA, type BuildDocsOptions, DEFAULT_DOCS_CONTEXTUAL_ACTIONS, DEFAULT_DOCS_OPENAPI_EXAMPLES, DOCS_CONFIG_FILE, DOCS_CONTEXTUAL_ACTIONS, DOCS_MANIFEST_VERSION, DOCS_OPENAPI_SAMPLE_LANGUAGES, type DocsAssistantAccess, type DocsAssistantChunk, type DocsAssistantConfig, type DocsBuildManifest, type DocsBuildResult, type DocsConfig, type DocsContextualAction, type DocsContextualConfig, type DocsDiagnostic, DocsError, type DocsFontConfig, type DocsFrontmatter, type DocsGraph, type DocsHeading, type DocsLinkConfig, type DocsMcpAccess, type DocsMcpConfig, type DocsNavGroup, type DocsNavigationGroup, type DocsNavigationItem, type DocsNavigationLink, type DocsNavigationNode, type DocsNavigationPage, type DocsOpenApiCodeSample, type DocsOpenApiConfig, type DocsOpenApiExamplesConfig, type DocsOpenApiOperation, type DocsOpenApiParameter, type DocsOpenApiResponse, type DocsOpenApiSampleDefaults, type DocsOpenApiSampleLanguage, type DocsPage, type DocsRuntimeData, type DocsRuntimePage, type DocsRuntimePageLink, type DocsRuntimeRouteData, type DocsRuntimeRouteDocument, type DocsSearchEntry, type DocsSeoConfig, type DocsSkillArtifacts, type DocsThemeConfig, type DocsValidationResult, type LoadedDocsConfig, buildDocs, createDocsSkillArtifacts, deepSpaceDocs, docsSkillName, htmlToText, loadDocsConfig, normalizeRoute, parseFrontmatter, parseMarkdown, routeFromRelativePath, serveDocsDevAsset, slugify, validateDocs };