@mdsnai/sdk 0.1.0

package/dist/web/page-render.js

@@ -0,0 +1,92 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderBlockPanelHtml = renderBlockPanelHtml;
+exports.createPageRenderModel = createPageRenderModel;
+const markdown_it_1 = __importDefault(require("markdown-it"));
+const page_bootstrap_1 = require("./page-bootstrap");
+const block_runtime_1 = require("./block-runtime");
+const headless_1 = require("./headless");
+function escapeHtml(value) {
+    return value
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&#39;");
+}
+function createMarkdownRenderer(options) {
+    return new markdown_it_1.default({
+        html: true,
+        linkify: options?.linkify ?? true,
+        typographer: options?.typographer ?? false,
+    });
+}
+function renderInput(block) {
+    if (block.inputs.length === 0)
+        return "";
+    const items = block.inputs.map((input) => {
+        const required = input.required ? " required" : "";
+        const requiredFlag = input.required ? ' data-required="true"' : "";
+        const secretFlag = input.secret ? ' data-secret="true"' : "";
+        const inputType = input.type === "boolean"
+            ? "checkbox"
+            : input.secret
+                ? "password"
+                : input.type === "number"
+                    ? "number"
+                    : input.type === "file"
+                        ? "file"
+                        : "text";
+        if (input.type === "choice") {
+            const options = (input.options ?? [])
+                .map((option) => `<option value="${escapeHtml(option)}">${escapeHtml(option)}</option>`)
+                .join("");
+            return `<label>${escapeHtml(input.name)}<select id="${escapeHtml(input.id)}" data-mdsn-input="${escapeHtml(input.id)}" data-input-name="${escapeHtml(input.name)}" data-input-type="${escapeHtml(input.type)}"${requiredFlag}${secretFlag}${required}><option value=""></option>${options}</select></label>`;
+        }
+        if (input.type === "json") {
+            return `<label>${escapeHtml(input.name)}<textarea id="${escapeHtml(input.id)}" data-mdsn-input="${escapeHtml(input.id)}" data-input-name="${escapeHtml(input.name)}" data-input-type="${escapeHtml(input.type)}"${requiredFlag}${secretFlag}${required} rows="8" spellcheck="false"></textarea></label>`;
+        }
+        return `<label>${escapeHtml(input.name)}<input id="${escapeHtml(input.id)}" type="${inputType}" data-mdsn-input="${escapeHtml(input.id)}" data-input-name="${escapeHtml(input.name)}" data-input-type="${escapeHtml(input.type)}"${requiredFlag}${secretFlag}${required} /></label>`;
+    }).join("");
+    return `<div class="mdsn-block-inputs">${items}</div>`;
+}
+function renderActions(block, options) {
+    const readButtons = block.reads.map((read) => `<button type="button" data-mdsn-read="${escapeHtml(read.id)}" data-target="${escapeHtml(options?.mapActionTarget?.(read.target) ?? read.target)}">${escapeHtml(read.name)}</button>`);
+    const writeButtons = block.writes.map((write) => `<button type="button" data-mdsn-write="${escapeHtml(write.id)}" data-target="${escapeHtml(options?.mapActionTarget?.(write.target) ?? write.target)}">${escapeHtml(write.name)}</button>`);
+    const redirectButtons = block.redirects.map((redirect) => `<button type="button" data-mdsn-redirect="${escapeHtml(redirect.id)}" data-target="${escapeHtml(options?.mapActionTarget?.(redirect.target) ?? redirect.target)}">${escapeHtml(`redirect ${redirect.target}`)}</button>`);
+    const buttons = [...readButtons, ...writeButtons, ...redirectButtons].join("");
+    return buttons.length > 0 ? `<div class="mdsn-block-actions">${buttons}</div>` : "";
+}
+function renderBlockPanelContent(block, options) {
+    return `<section class="mdsn-block-panel" data-mdsn-block-panel="${escapeHtml(block.name)}"><header><strong>${escapeHtml(block.name)}</strong></header>${renderInput(block)}${renderActions(block, options)}</section>`;
+}
+function renderBlockPanelHtml(block, options, mode = "region") {
+    const content = renderBlockPanelContent(block, options);
+    return mode === "plain" ? content : (0, block_runtime_1.createBlockRegionMarkup)(block.name, content);
+}
+function renderMarkdownContainer(container, renderer) {
+    return renderer.render(container.markdown);
+}
+function renderParsedPage(page, options) {
+    const renderer = createMarkdownRenderer(options?.markdown);
+    const blockByName = new Map(page.blocks.map((block) => [block.name, block]));
+    return page.segments.map((segment) => {
+        if (segment.type === "container") {
+            return renderMarkdownContainer(segment.container, renderer);
+        }
+        const block = blockByName.get(segment.anchor.name);
+        return block ? renderBlockPanelHtml(block, options, "region") : "";
+    }).join("");
+}
+function createPageRenderModel(document, options) {
+    const page = (0, headless_1.createParsedPage)(document);
+    return {
+        markdownHtml: renderParsedPage(page, options),
+        bootstrap: (0, page_bootstrap_1.createPageBootstrap)(document),
+        document,
+        page,
+    };
+}

package/dist/web/public-client-runtime.d.ts

@@ -0,0 +1 @@
+export { getPageClientRuntimeScript as getClientRuntimeScript } from "./page-client-script";

package/dist/web/public-client-runtime.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getClientRuntimeScript = void 0;
+var page_client_script_1 = require("./page-client-script");
+Object.defineProperty(exports, "getClientRuntimeScript", { enumerable: true, get: function () { return page_client_script_1.getPageClientRuntimeScript; } });

package/dist/web/public-render.d.ts

@@ -0,0 +1,12 @@
+import type { DocumentDefinition } from "../core/model/document";
+import { type PageRenderModel } from "./page-render";
+export interface CreateRenderModelOptions {
+    mapTarget?: (target: string) => string;
+}
+export type RenderModel = PageRenderModel;
+export declare function createRenderModel(document: DocumentDefinition, options?: CreateRenderModelOptions): RenderModel;
+export declare function renderDefaultHtmlDocument(model: RenderModel, options?: {
+    title?: string;
+    lang?: string;
+}): string;
+export declare function renderPageHtml(document: DocumentDefinition, options?: CreateRenderModelOptions): string;

package/dist/web/public-render.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRenderModel = createRenderModel;
+exports.renderDefaultHtmlDocument = renderDefaultHtmlDocument;
+exports.renderPageHtml = renderPageHtml;
+const page_html_1 = require("./page-html");
+const page_render_1 = require("./page-render");
+function createRenderModel(document, options) {
+    return (0, page_render_1.createPageRenderModel)(document, {
+        mapActionTarget: options?.mapTarget,
+    });
+}
+function renderDefaultHtmlDocument(model, options) {
+    return (0, page_html_1.renderPageHtmlDocument)(model, options);
+}
+function renderPageHtml(document, options) {
+    return renderDefaultHtmlDocument(createRenderModel(document, options));
+}

package/dist/web/target-path.d.ts

@@ -0,0 +1 @@
+export declare function mapTargetToHttpPath(target: string): string;

package/dist/web/target-path.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapTargetToHttpPath = mapTargetToHttpPath;
+function normalizeRoutePath(routePath) {
+    if (!routePath || routePath === "/") {
+        return "/";
+    }
+    return routePath.startsWith("/")
+        ? (routePath.replace(/\/+$/, "") || "/")
+        : (`/${routePath}`.replace(/\/+$/, "") || "/");
+}
+function markdownPathToRoutePath(pathname) {
+    if (!pathname || !pathname.toLowerCase().endsWith(".md")) {
+        return null;
+    }
+    const normalized = normalizeRoutePath(pathname);
+    if (normalized === "/index.md") {
+        return "/";
+    }
+    const stripped = normalized.slice(0, -3);
+    if (stripped.endsWith("/index")) {
+        return stripped.slice(0, -6) || "/";
+    }
+    return stripped.length > 0 ? stripped : "/";
+}
+function mapTargetToHttpPath(target) {
+    if (/^https?:\/\//i.test(target)) {
+        return target;
+    }
+    const markdownRoutePath = markdownPathToRoutePath(target);
+    if (markdownRoutePath) {
+        return markdownRoutePath;
+    }
+    return target;
+}

package/package.json

@@ -0,0 +1,91 @@
+{
+  "name": "@mdsnai/sdk",
+  "version": "0.1.0",
+  "private": false,
+  "description": "SDK, framework host, parser, renderer, and CLI for building MDSN sites.",
+  "license": "MIT",
+  "homepage": "https://docs.mdsn.ai",
+  "bugs": {
+    "url": "https://github.com/mdsn-ai/mdsn/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mdsn-ai/mdsn.git"
+  },
+  "keywords": [
+    "mdsn",
+    "markdown",
+    "sdk",
+    "ai",
+    "agent",
+    "agentic",
+    "workflow",
+    "interactive-documents",
+    "skills-app",
+    "agent-app",
+    "framework",
+    "cli"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "mdsn": "./dist/cli/entry.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.js",
+      "require": "./dist/core/index.js",
+      "default": "./dist/core/index.js"
+    },
+    "./web": {
+      "types": "./dist/web/index.d.ts",
+      "import": "./dist/web/index.js",
+      "require": "./dist/web/index.js",
+      "default": "./dist/web/index.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.js",
+      "require": "./dist/server/index.js",
+      "default": "./dist/server/index.js"
+    },
+    "./framework": {
+      "types": "./dist/framework/index.d.ts",
+      "import": "./dist/framework/index.js",
+      "require": "./dist/framework/index.js",
+      "default": "./dist/framework/index.js"
+    },
+    "./cli": {
+      "types": "./dist/cli/index.d.ts",
+      "import": "./dist/cli/index.js",
+      "require": "./dist/cli/index.js",
+      "default": "./dist/cli/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\" && tsc -p tsconfig.build.json",
+    "framework:dev": "tsx src/cli/entry.ts dev",
+    "framework:start": "tsx src/cli/entry.ts start",
+    "framework:build": "tsx src/cli/entry.ts build",
+    "framework:create": "tsx src/cli/entry.ts create",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "npm run build && cd .. && vitest run --exclude='.worktrees/**'"
+  },
+  "dependencies": {
+    "express": "^4.21.2",
+    "markdown-it": "^14.1.0"
+  }
+}