@wgtechlabs/mdd-engine 0.1.0-pr.55ddedf → 0.1.0-pr.8fa2dc9

package/README.md

@@ -133,20 +133,6 @@ Use GitHub-style alerts with `NOTE`, `TIP`, `IMPORTANT`, `WARNING`, or `CAUTION`
 
 `:::details[More information]` remains supported and becomes `details`/`summary`; its label is optional, attributes are errors, and its readable Markdown uses a blockquote with a bold label. The old `:::note`, `:::tip`, and `:::warning` directives now fail with a `REMOVED_COMPONENT` migration diagnostic. See [alerts and migration](docs/ALERTS.md) for all five types, theme hooks, and how to preserve custom titles and bodies.
 
-Document an API endpoint with a leaf directive, then use ordinary Markdown for parameters and request/response examples:
-
-```markdown
-## Retrieve a widget
-
-::endpoint{method="GET" path="/v1/widgets/{id}"}
-
-| Parameter | Type | Description |
-| --- | --- | --- |
-| `id` | string | Widget identifier. |
-```
-
-The required `method` accepts GET, HEAD, POST, PUT, PATCH, DELETE, OPTIONS, TRACE, or CONNECT, normalizing lowercase/mixed case to uppercase. The required `path` starts with a single `/` and contains no whitespace or control characters; braces and query punctuation remain literal text. Labels, extra attributes, and inline/container forms are errors. The engine emits a `div.mdd-endpoint` containing `strong.mdd-endpoint-method.mdd-method-get` (or the corresponding lowercase method) and `code.mdd-endpoint-path`. Normalized Markdown contains `**GET**` followed by the code-formatted path, so the signature stays readable and searchable. Endpoint paths are not rewritten with the documentation base path. This is documentation only: no HTTP requests run. MDD and its themes provide presentation.
-
 Title precedence is frontmatter title, first H1, then readable filename. Navigation uses `navTitle` when supplied. Explicit `order` sorts first; remaining siblings sort deterministically by label and path.
 
 Local `.md` links, extensionless routes, reference links, and images resolve from their source document. A leading slash addresses the documentation root. `basePath` prefixes public links, including `/docs/` and `/repository/docs/`. When a file-style URL matches both an existing supported asset and a page route, the asset wins: `chart.png` selects the image, while `/chart.png/` explicitly selects the page. If no regular asset exists, dotted page routes still resolve. External links are preserved without network requests. Headings have `mdd-`-prefixed GitHub-style slugs; author links such as `#installation` are rewritten to `#mdd-installation`. Duplicate headings receive `-1`, `-2`, and subsequent suffixes.

package/dist/markdown.js

@@ -13,7 +13,6 @@ import { unified } from "unified";
 import { SKIP, visit } from "unist-util-visit";
 import { parseDocument as parseYaml } from "yaml";
 import { transformAlerts } from "./alerts.js";
-import { endpointParagraph } from "./endpoints.js";
 const parser = unified()
     .use(remarkParse)
     .use(remarkGfm)
@@ -30,20 +29,10 @@ const htmlRenderer = unified()
         ...defaultSchema.attributes,
         aside: [["className", /^mdd-/]],
         details: [["className", "mdd-details"]],
-        div: [["className", "mdd-endpoint"]],
         p: [
             ...(defaultSchema.attributes?.p ?? []),
             ["className", "mdd-component-label"],
         ],
-        strong: [
-            ...(defaultSchema.attributes?.strong ?? []),
-            [
-                "className",
-                "mdd-endpoint-method",
-                /^mdd-method-(get|head|post|put|patch|delete|options|trace|connect)$/,
-            ],
-        ],
-        code: [["className", /^language-./, "mdd-endpoint-path"]],
         summary: [
             ...(defaultSchema.attributes?.summary ?? []),
             ["className", "mdd-component-label"],
@@ -217,16 +206,8 @@ export function parseDocument(source, file, diagnostics) {
             report("REMOVED_COMPONENT", `The ${node.name} directive was removed; use > [!${node.name.toUpperCase()}] followed by quoted body lines. Keep any optional custom title as bold text in the alert body.`, node);
             return;
         }
-        if (node.name === "endpoint") {
-            const paragraph = endpointParagraph(node, source, (message) => report("INVALID_COMPONENT", message, node));
-            if (paragraph && parent && index !== undefined) {
-                parent.children[index] = paragraph;
-                return [SKIP, index];
-            }
-            return;
-        }
         if (node.type !== "containerDirective" || node.name !== "details") {
-            report("UNKNOWN_COMPONENT", `Unsupported component ${node.name}; use a GitHub alert, details container, or endpoint leaf.`, node);
+            report("UNKNOWN_COMPONENT", `Unsupported component ${node.name}; use a GitHub alert or a details container.`, node);
             return;
         }
         if (Object.keys(node.attributes ?? {}).length) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wgtechlabs/mdd-engine",
-  "version": "0.1.0-pr.55ddedf",
+  "version": "0.1.0-pr.8fa2dc9",
   "description": "Headless Markdown documentation compiler for mdd",
   "type": "module",
   "license": "MIT",

package/dist/endpoints.d.ts

@@ -1,3 +0,0 @@
-import type { Nodes, Paragraph } from "mdast";
-/** Endpoint signatures are documentation text, never links or executable requests. */
-export declare function endpointParagraph(node: Nodes, source: string, report: (message: string) => void): Paragraph | undefined;

package/dist/endpoints.js

@@ -1,68 +0,0 @@
-const methods = new Set([
-    "GET",
-    "HEAD",
-    "POST",
-    "PUT",
-    "PATCH",
-    "DELETE",
-    "OPTIONS",
-    "TRACE",
-    "CONNECT",
-]);
-/** Endpoint signatures are documentation text, never links or executable requests. */
-export function endpointParagraph(node, source, report) {
-    if (node.type !== "leafDirective") {
-        report('Use the leaf form ::endpoint{method="GET" path="/example"}.');
-        return;
-    }
-    const offset = node.position?.start.offset;
-    if (node.children.length ||
-        (offset !== undefined && source.startsWith("::endpoint[", offset))) {
-        report("The endpoint component does not support a label.");
-        return;
-    }
-    const attributes = node.attributes ?? {};
-    if (Object.keys(attributes).some((key) => key !== "method" && key !== "path")) {
-        report("The endpoint component supports only method and path attributes.");
-        return;
-    }
-    const method = (attributes.method ?? "").toUpperCase();
-    if (!methods.has(method)) {
-        report("The endpoint method must be GET, HEAD, POST, PUT, PATCH, DELETE, OPTIONS, TRACE, or CONNECT.");
-        return;
-    }
-    const path = attributes.path ?? "";
-    if (!path.startsWith("/") ||
-        path.startsWith("//") ||
-        // biome-ignore lint/suspicious/noControlCharactersInRegex: Endpoint text cannot contain invisible controls or whitespace.
-        /[\s\u0000-\u001f\u007f-\u009f]/u.test(path)) {
-        report("The endpoint path must start with a single / and contain no whitespace or control characters.");
-        return;
-    }
-    return {
-        type: "paragraph",
-        position: node.position,
-        // Tight lists unwrap ordinary paragraphs; retain the signature's block hook.
-        data: { hName: "div", hProperties: { className: ["mdd-endpoint"] } },
-        children: [
-            {
-                type: "strong",
-                data: {
-                    hProperties: {
-                        className: [
-                            "mdd-endpoint-method",
-                            `mdd-method-${method.toLowerCase()}`,
-                        ],
-                    },
-                },
-                children: [{ type: "text", value: method }],
-            },
-            { type: "text", value: " " },
-            {
-                type: "inlineCode",
-                value: path,
-                data: { hProperties: { className: ["mdd-endpoint-path"] } },
-            },
-        ],
-    };
-}