docmedown 0.1.7 → 0.9.0

package/dist/types/ui/doc-context.svelte.d.ts

@@ -0,0 +1,198 @@
+import { type HomeDocumentInput, type ResolvedHome } from "../runtime/home";
+import { type ParsedMarkdown } from "../runtime/markdown/parser";
+import { type HashRouter } from "../runtime/router";
+import { DocSearchIndex } from "../runtime/search/search-index";
+import type { DocConfig, DocFileItem, SidebarTreeNode } from "../runtime/types";
+export interface ActiveDocData extends ParsedMarkdown {
+    slug: string;
+    title: string;
+    rawContent: string;
+}
+export interface NavDocItem {
+    slug: string;
+    title: string;
+}
+/**
+ * Runes-based port of the React DocProvider. A single store instance drives
+ * the whole reader: configuration, routing, document loading, the sidebar
+ * tree, search, and prev/next navigation.
+ */
+export declare class DocStore {
+    config: {
+        name: string;
+        $schema?: string | undefined;
+        tagline?: string | undefined;
+        description?: string | undefined;
+        url?: string | undefined;
+        version?: string | undefined;
+        rootDoc?: string | undefined;
+        home?: string | undefined;
+        source?: {
+            type: "github";
+            repo: string;
+            branch?: string | undefined;
+            docsDir?: string | undefined;
+            token?: string | undefined;
+            baseUrl?: string | undefined;
+        } | {
+            type: "gitlab";
+            repo: string;
+            branch?: string | undefined;
+            docsDir?: string | undefined;
+            token?: string | undefined;
+            baseUrl?: string | undefined;
+        } | {
+            type: "raw";
+            baseUrl: string;
+            branch?: string | undefined;
+            docsDir?: string | undefined;
+            token?: string | undefined;
+        } | undefined;
+        theme?: {
+            family?: "atlas" | "blueprint" | "terminal" | "editorial" | undefined;
+            density?: "comfortable" | "compact" | undefined;
+            preset?: "indigo" | "emerald" | "sunset" | "violet" | "rose" | "slate" | "cyberpunk" | undefined;
+            defaultMode?: "light" | "dark" | "auto" | undefined;
+            accentColor?: string | undefined;
+            accentColorDark?: string | undefined;
+            fontFamily?: string | undefined;
+            codeTheme?: "github" | "dracula" | "one-dark" | "synthwave" | undefined;
+            logo?: {
+                light?: string | undefined;
+                dark?: string | undefined;
+                alt?: string | undefined;
+                text?: string | undefined;
+            } | undefined;
+            favicon?: string | undefined;
+        } | undefined;
+        nav?: {
+            label: string;
+            href: string;
+            external?: boolean | undefined;
+            icon?: string | undefined;
+        }[] | undefined;
+        socials?: {
+            type: "github" | "gitlab" | "twitter" | "x" | "discord" | "custom";
+            url: string;
+            label?: string | undefined;
+            icon?: string | undefined;
+        }[] | undefined;
+        sidebar?: import("../runtime/config-schema").SidebarItemConfigShape[] | undefined;
+        autoIndex?: {
+            enabled?: boolean | undefined;
+            exclude?: string[] | undefined;
+            sort?: "alphabetical" | "frontmatter" | "natural" | undefined;
+            defaultCollapsed?: boolean | undefined;
+        } | undefined;
+        search?: {
+            enabled?: boolean | undefined;
+            placeholder?: string | undefined;
+            maxResults?: number | undefined;
+        } | undefined;
+        offline?: {
+            embedNestedDocs?: boolean | undefined;
+        } | undefined;
+        footer?: {
+            copyright?: string | undefined;
+            links?: {
+                label: string;
+                href: string;
+                external?: boolean | undefined;
+                icon?: string | undefined;
+            }[] | undefined;
+            showBuiltWith?: boolean | undefined;
+        } | undefined;
+        componentsUrl?: string | undefined;
+        editUrl?: string | undefined;
+    } | null;
+    currentSlug: string;
+    currentDoc: ActiveDocData | null;
+    tree: SidebarTreeNode[];
+    isLoading: boolean;
+    /** True while a network navigation is in flight; the current article stays visible. */
+    isNavigating: boolean;
+    error: string | null;
+    isSearchOpen: boolean;
+    isMobileSidebarOpen: boolean;
+    isEditorOpen: boolean;
+    serverMode: "production" | "preview";
+    hasPreviewChanges: boolean;
+    isScrolled: boolean;
+    activeTagModal: string | null;
+    allDocs: DocFileItem[];
+    openTagModal(tag: string): void;
+    closeTagModal(): void;
+    getDocsWithTag(tag: string): DocFileItem[];
+    getAllTags(): Array<{
+        tag: string;
+        count: number;
+    }>;
+    getPossiblePaths(crumbIndex: number, _crumbSegment?: string): Array<{
+        slug: string;
+        title: string;
+        category?: string;
+        readingTimeMinutes?: number;
+    }>;
+    originalHome: ResolvedHome | null;
+    docPaths: HomeDocumentInput[];
+    basePath: string;
+    router: HashRouter | null;
+    readonly searchIndex: DocSearchIndex;
+    private localLoader;
+    private remoteGithub;
+    private remoteGitlab;
+    private unsubscribeRouter;
+    private homeCancelled;
+    private epoch;
+    /**
+     * Parsed-markdown cache keyed by slug. Rendering a page runs the whole
+     * markdown pipeline (marked + Prism + KaTeX + component bodies), which is the
+     * most expensive work per navigation. Revisiting a slug — back/forward,
+     * sidebar hops, or a same-page anchor change — reuses the parsed result. The
+     * raw source is stored alongside so a content change (e.g. a dev rebuild)
+     * invalidates the entry instead of serving stale HTML.
+     */
+    private parseCacheLimit;
+    private parseCache;
+    /** Remote documents fetched this session, so revisits resolve synchronously. */
+    private remoteCache;
+    flatDocs: NavDocItem[];
+    prevDoc: NavDocItem | null;
+    nextDoc: NavDocItem | null;
+    home: ResolvedHome | null;
+    navigate(slug: string, anchor?: string): void;
+    destroy(): void;
+    /** Bootstraps the store. Safe to call again after destroy() (SPA re-mount). */
+    init(initialConfig: DocConfig, basePath?: string): Promise<void>;
+    private initTree;
+    /** Returns the parsed document for a slug, reusing a recent parse when the source is unchanged. */
+    private parseMarkdownCached;
+    /** Applies a resolved document — the synchronous tail shared by both load paths. */
+    private renderDoc;
+    toggleEditor(open?: boolean): void;
+    updateDocContent(content: string, slug?: string, resetScroll?: boolean): void;
+    applyHmrUpdate(slug: string, content: string): void;
+    updateConfig(newConfig: Partial<DocConfig>): void;
+    private resetScroll;
+    /**
+     * Renders a page without awaiting anything when its content is already in
+     * memory — the embedded static/offline corpus or a document fetched earlier
+     * this session. Returns false when a network request is required so the caller
+     * can fall back to `loadDoc`.
+     *
+     * This is what removes the click-to-paint delay: no `isLoading` flip, no
+     * skeleton, no awaited microtask. The page swaps within the same frame.
+     */
+    private renderDocNow;
+    private loadDoc;
+    /**
+     * Pre-parses the embedded corpus during idle time so the first visit to any
+     * page is a synchronous cache hit — this is what makes navigation feel
+     * instant, most of all in offline and static builds where the whole corpus is
+     * already in memory. Work is time-sliced across idle callbacks so it never
+     * competes with interaction, and it aborts as soon as the store re-initialises.
+     */
+    private warmParseCache;
+    private initHome;
+}
+export declare const doc: DocStore;

package/dist/types/ui/index.d.ts

@@ -0,0 +1,33 @@
+import "./components/MermaidDiagram.svelte";
+import type { DocMeDownInitOptions, DocMeDownInstance } from "../runtime/types";
+import "./builtins/Accordion.svelte";
+import "./builtins/AccordionItem.svelte";
+import "./builtins/Alert.svelte";
+import "./builtins/Callout.svelte";
+import "./builtins/Badge.svelte";
+import "./builtins/Button.svelte";
+import "./builtins/Card.svelte";
+import "./builtins/CardGrid.svelte";
+import "./builtins/Columns.svelte";
+import "./builtins/Column.svelte";
+import "./builtins/Details.svelte";
+import "./builtins/Item.svelte";
+import "./builtins/Kbd.svelte";
+import "./builtins/Step.svelte";
+import "./builtins/Steps.svelte";
+import "./builtins/Tab.svelte";
+import "./builtins/Tabs.svelte";
+import "./builtins/Timeline.svelte";
+import "./builtins/TimelineItem.svelte";
+import "./builtins/Media.svelte";
+export { loadDocConfig, normalizeConfig } from "../runtime/config";
+export { docConfigSchema, docSearchConfigSchema, docThemeConfigSchema, formatConfigIssues, navLinkSchema, normalizedDocConfigSchema, parseDocConfig, remoteSourceSchema, sidebarItemSchema, socialLinkSchema, } from "../runtime/config-schema";
+export * as motionLib from "../runtime/motion";
+export { animate, collapse, expand, fade, getMotionOptions, motion, prefersReducedMotion, scale, slide, smoothScroll, stagger, useMotion, } from "../runtime/motion";
+export { createOfflineDownload, downloadOfflineCopy, isOfflineDocumentation, sanitizeDownloadName, } from "../runtime/offline-export";
+export { createRouter, getStaticRuntimeContext, isStaticRuntime, joinStaticBase, StaticRouter, } from "../runtime/router";
+export * from "../runtime/types";
+export { doc } from "./doc-context.svelte";
+export { ComponentRegistry, createElementBridge, createReactBridge, defineDmd, defineReactDmd, defineWebComponentDmd, detectComponentKind, dmdTag, registerWebComponent, } from "./registry";
+export { theme } from "./theme.svelte";
+export declare function initDocMeDown(options?: DocMeDownInitOptions): Promise<DocMeDownInstance | null>;

package/dist/types/ui/registry.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Component registry v2 (Svelte runtime).
+ *
+ * Markdown components are **custom elements**: the markdown pipeline emits
+ * PascalCase tags (`<Tabs>`, `<CardGrid>`, user `.dmd` components) and the
+ * markdown body renames them to registered kebab-case element names
+ * (`<dmd-tabs>`, `<dmd-card-grid>`, …). The browser upgrades them natively,
+ * so nested component trees work without any framework mounting logic.
+ */
+import { type ComponentKind, createElementBridge, createReactBridge, type DynamicComponent, detectComponentKind, registerWebComponent } from "../runtime/bridges";
+import { dmdTag } from "../runtime/svelte-tag";
+export type DmdElementClass = new () => HTMLElement;
+export { type ComponentKind, createElementBridge, createReactBridge, type DynamicComponent, detectComponentKind, dmdTag, registerWebComponent, };
+export declare class ComponentRegistry {
+    private static instance;
+    /** Component name (any case) → custom element tag. */
+    private tags;
+    static getInstance(): ComponentRegistry;
+    private constructor();
+    /**
+     * Registers a markdown component. `element` may be a custom element class
+     * (defined automatically under the derived tag), or omitted when the class
+     * was already defined (e.g. Svelte `<svelte:options customElement>`).
+     * Returns the element tag used in the DOM.
+     */
+    register(name: string, element?: DmdElementClass | string, tag?: string): string;
+    /**
+     * Registers a React component function/class, wrapping it via ReactBridge.
+     */
+    registerReact(name: string, component: any, tag?: string): string;
+    /**
+     * Registers a Web Component or Lit class, wrapping it via ElementBridge.
+     */
+    registerWebComponent(name: string, elementClass: CustomElementConstructor, tag?: string): string;
+    registerMultiple(map: Record<string, DmdElementClass | string>): void;
+    /** Resolves a PascalCase markdown tag (any case) to its custom element tag. */
+    resolveTag(tagName: string): string | null;
+    getAll(): Record<string, string>;
+    /**
+     * Loads user components from the `.dmd` directory (or the embedded
+     * `componentsSource` blob produced by the build). Components may be
+     * AOT-compiled `.svelte` custom elements, runtime-compiled `.svelte` files,
+     * or legacy custom element classes.
+     */
+    loadDmdDirectory(basePath?: string): Promise<void>;
+}
+/** Convenience helper for `.dmd` Svelte component modules: `defineDmd("CounterWidget", CounterWidgetElement)`. */
+export declare function defineDmd(name: string, element: DmdElementClass | string, tag?: string): string;
+/** Convenience helper for `.dmd` React component modules: `defineReactDmd("ReactMetric", ReactMetricComponent)`. */
+export declare function defineReactDmd(name: string, component: any, tag?: string): string;
+/** Convenience helper for `.dmd` Web Component / Lit modules: `defineWebComponentDmd("UserBadge", UserBadgeElement)`. */
+export declare function defineWebComponentDmd(name: string, elementClass: CustomElementConstructor, tag?: string): string;

package/dist/types/ui/theme.svelte.d.ts

@@ -0,0 +1,32 @@
+import type { ColorMode, ThemeDensity, ThemeFamily } from "../runtime/types";
+export interface ThemeInitOptions {
+    defaultMode?: ColorMode;
+    defaultFamily?: ThemeFamily;
+    defaultDensity?: ThemeDensity;
+    /** Optional brand override for --dmd-accent in light mode. */
+    accentColor?: string;
+    /** Optional brand override for --dmd-accent in dark mode. */
+    accentColorDark?: string;
+}
+/** Runes-based theme store: family, color mode, and density with persisted preferences. */
+export declare class ThemeStore {
+    mode: "light" | "dark" | "auto";
+    family: "atlas" | "blueprint" | "terminal" | "editorial";
+    density: "comfortable" | "compact";
+    motion: "reduced" | "full";
+    systemDark: boolean;
+    /** Brand overrides applied by the app as inline `--dmd-accent` tokens. */
+    accentColor: string | undefined;
+    accentColorDark: string | undefined;
+    resolvedMode: "light" | "dark";
+    private mediaQuery;
+    private mediaHandler;
+    init(options?: ThemeInitOptions): void;
+    setMode(newMode: ColorMode): void;
+    setFamily(newFamily: ThemeFamily): void;
+    setDensity(newDensity: ThemeDensity): void;
+    setMotion(newMotion: "full" | "reduced"): void;
+    toggleMode(): void;
+    destroy(): void;
+}
+export declare const theme: ThemeStore;

package/dist/wardley-WFR3VGLG-BK9BA6h6.mjs

@@ -0,0 +1,2 @@
+import { r as e } from "./mermaid-Cx9uSfoz.mjs";
+export { e as createWardleyServices };

package/dist/wardley-WFR3VGLG-Cbs7W-dU.js

@@ -0,0 +1 @@
+const e=require("./mermaid-BvOI3ZSW.js");exports.createWardleyServices=e.r;

package/package.json

@@ -1,13 +1,46 @@
 {
   "name": "docmedown",
-  "version": "0.1.7",
-  "description": "The simplest MarkDown documenter yet. CLI & Web Script React SPA documentation engine.",
+  "version": "0.9.0",
+  "description": "The simplest MarkDown documenter yet. CLI, web script, and static-site compiler with AI-native distribution.",
+  "author": "Gabriel M. P. da Silva",
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/gabrielmsilva00/docmedown#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gabrielmsilva00/docmedown.git"
+  },
+  "bugs": {
+    "url": "https://github.com/gabrielmsilva00/docmedown/issues"
+  },
+  "keywords": [
+    "markdown",
+    "documentation",
+    "docs",
+    "docusaurus",
+    "docsify",
+    "svelte",
+    "spa",
+    "cli",
+    "offline-docs",
+    "github-docs",
+    "mcp",
+    "model-context-protocol"
+  ],
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "packageManager": "npm@11.16.0",
   "main": "./dist/docmedown.cjs",
   "module": "./dist/docmedown.mjs",
-  "types": "./dist/types/runtime/index.d.ts",
+  "types": "./dist/types/ui/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/types/runtime/index.d.ts",
+      "types": "./dist/types/ui/index.d.ts",
+      "import": "./dist/docmedown.mjs",
+      "require": "./dist/docmedown.cjs"
+    },
+    "./motion": {
+      "types": "./dist/types/runtime/motion.d.ts",
       "import": "./dist/docmedown.mjs",
       "require": "./dist/docmedown.cjs"
     },
@@ -28,63 +61,41 @@
     "LICENSE"
   ],
   "scripts": {
+    "build": "node ./scripts/build.mjs",
+    "build:fast": "node ./scripts/build.mjs --fast",
+    "build:docs": "node ./bin/docmedown.js build ./docs",
+    "build:docs:watch": "node ./bin/docmedown.js build ./docs --watch",
+    "dev": "node ./bin/docmedown.js serve ./docs",
     "dev:runtime": "vite build --watch",
-    "build:runtime": "vite build",
-    "build:cli": "tsup",
+    "dev:mcp": "node ./bin/docmedown.js mcp ./docs",
+    "serve": "node ./bin/docmedown.js serve ./docs",
+    "check": "npm run typecheck && npm run lint",
     "typecheck": "tsc --noEmit",
     "lint": "biome check .",
     "lint:fix": "biome check --write .",
     "format": "biome format --write .",
-    "build:types": "tsc -p tsconfig.runtime.json",
-    "build": "npm run build:runtime && npm run build:cli && npm run build:types",
-    "docmedown": "node ./bin/docmedown.js",
-    "dmd": "node ./bin/docmedown.js",
-    "init:docs": "node ./bin/docmedown.js init",
-    "serve": "node ./bin/docmedown.js serve ./docs",
-    "dev": "node ./bin/docmedown.js serve ./docs",
-    "build:docs": "node ./bin/docmedown.js build ./docs",
-    "build:docs:watch": "node ./bin/docmedown.js build ./docs --watch",
-    "build:offline": "node ./bin/docmedown.js build ./docs",
-    "config:docs": "node ./bin/docmedown.js config ./docs/docs.json",
-    "test": "npx tsx --test tests/parser.test.ts tests/scanner.test.ts tests/theme-schema.test.ts tests/runtime-integration.test.ts tests/package-smoke.test.ts tests/hosting.test.ts tests/deploy.test.ts tests/home.test.ts",
+    "test": "node ./scripts/test-unit.mjs",
+    "test:mcp": "npx tsx --test tests/mcp.test.ts",
+    "test:mcp:client": "node ./scripts/test-mcp-client.mjs",
     "test:artifacts": "npx tsx --test tests/offline-artifact.test.ts",
-    "test:release": "npm run typecheck && npm run lint && npm run test && npm run build && npm run build:docs && npm run test:artifacts && npm pack --dry-run",
+    "test:bundle": "npx tsx --test tests/bundle-size.test.ts",
+    "test:release": "npm run typecheck && npm run lint && npm run test && npm run test:mcp && npm run build && npm run build:docs && npm run test:artifacts && npm run test:bundle && npm pack --dry-run",
+    "doctor": "node ./bin/docmedown.js doctor ./docs",
+    "doctor:project": "node ./scripts/doctor-project.mjs",
+    "validate": "node ./bin/docmedown.js validate ./docs",
+    "config:docs": "node ./bin/docmedown.js config ./docs/docs.json",
+    "clean": "node -e \"fs.rmSync('dist', { recursive: true, force: true }); fs.rmSync('docs/.dist', { recursive: true, force: true })\"",
     "deploy": "node ./scripts/deploy.mjs",
     "deploy:dry-run": "npm run deploy -- --dry-run",
     "prepublishOnly": "npm run test:release"
   },
-  "keywords": [
-    "markdown",
-    "documentation",
-    "docs",
-    "docusaurus",
-    "docsify",
-    "react",
-    "spa",
-    "cli",
-    "offline-docs",
-    "github-docs"
-  ],
-  "author": "Gabriel M. Silva",
-  "license": "MIT",
-  "engines": {
-    "node": ">=20.19.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/gabrielmsilva00/docmedown.git"
-  },
-  "bugs": {
-    "url": "https://github.com/gabrielmsilva00/docmedown/issues"
-  },
-  "homepage": "https://github.com/gabrielmsilva00/docmedown#readme",
-  "packageManager": "npm@11.16.0",
   "overrides": {
     "tsup": {
       "esbuild": "0.28.2"
     }
   },
   "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
     "chalk": "^4.1.2",
     "chokidar": "^3.6.0",
     "commander": "^12.1.0",
@@ -93,22 +104,24 @@
     "mime-types": "^2.1.35",
     "open": "^10.1.0",
     "prompts": "^2.4.2",
+    "svelte": "^5.57.0",
     "ws": "^8.18.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.5.10",
+    "@sveltejs/vite-plugin-svelte": "^7.3.0",
     "@types/node": "^22.5.0",
     "@types/prismjs": "^1.26.6",
     "@types/prompts": "^2.4.9",
-    "@types/react": "^18.3.5",
-    "@types/react-dom": "^18.3.0",
+    "@types/react": "^18.3.31",
+    "@types/react-dom": "^18.3.7",
     "@types/ws": "^8.5.12",
-    "@vitejs/plugin-react": "^6.1.0",
     "katex": "^0.16.11",
     "marked": "^14.1.1",
     "mermaid": "^11.17.2",
     "minisearch": "^7.1.0",
+    "motion": "^13.4.4",
     "prismjs": "^1.29.0",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",