@mdwrk/lander-markdown-content-adapter 0.1.1

package/README.md

@@ -0,0 +1,38 @@
+# @mdwrk/lander-markdown-content-adapter
+
+**Markdown and frontmatter adapter**
+
+<p align="center">
+  <a href="https://github.com/groupsum/markdown_workspace/blob/master/packages/lander/lander-markdown-content-adapter/README.md"><img alt="Hits" src="https://visitor-badge.laobi.icu/badge?page_id=groupsum.markdown_workspace.packages_lander_lander_markdown_content_adapter_README&amp;left_text=hits" /></a>
+  <a href="https://www.npmjs.com/package/@mdwrk/lander-markdown-content-adapter"><img alt="Downloads" src="https://img.shields.io/npm/dm/%40mdwrk%2Flander-markdown-content-adapter?label=downloads" /></a>
+  <a href="../../../package.json"><img alt="Node" src="https://img.shields.io/badge/node-20.x%20%7C%2021.x%20%7C%2022.x-339933?logo=node.js&amp;logoColor=white" /></a>
+  <a href="../../../LICENSE"><img alt="License: Apache-2.0" src="https://img.shields.io/badge/license-Apache--2.0-blue.svg" /></a>
+</p>
+
+This package converts frontmatter-plus-body markdown into lander page specs.
+
+## Why
+Use it when your source of truth is markdown files and you still want to target the lander content contract cleanly.
+
+## What
+- Frontmatter splitting and simple parsing.
+- Markdown body adaptation into a page-spec structure.
+- A bridge between source markdown files and the lander compiler.
+
+## Installation
+Node.js 20.x through 22.x, matching the workspace engine contract in the root package manifest.
+
+```bash
+npm install @mdwrk/lander-markdown-content-adapter @mdwrk/lander-core
+```
+
+## Usage
+```ts
+import { markdownToPageSpec } from "@mdwrk/lander-markdown-content-adapter";
+
+const parsed = markdownToPageSpec("---\ntitle: Hello\nslug: /hello/\n---\nMdWrk body copy.");
+```
+
+## Related
+- [Packages index](../../README.md) - family and package navigation
+- [Root README](../../../README.md) - repo overview

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+import type { PageSpec } from "@mdwrk/lander-content-contract";
+import { LANDER_MARKDOWN_CONTENT_ADAPTER_VERSION } from "./version.js";
+export { LANDER_MARKDOWN_CONTENT_ADAPTER_VERSION };
+export interface ParsedMarkdownPage {
+    metadata: Record<string, unknown>;
+    body: string;
+    page: PageSpec;
+}
+export declare function splitFrontmatter(raw: string): {
+    frontmatter: string;
+    body: string;
+};
+export declare function parseSimpleFrontmatter(frontmatter: string): Record<string, unknown>;
+export declare function markdownToPageSpec(raw: string): ParsedMarkdownPage;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAElF,OAAO,EAAE,uCAAuC,EAAE,MAAM,cAAc,CAAC;AAEvE,OAAO,EAAE,uCAAuC,EAAE,CAAC;AAEnD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;CAChB;AAUD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAKnF;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASnF;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CA2BlE"}

package/dist/index.js

@@ -0,0 +1,60 @@
+import { normalizeRouteSlug } from "@mdwrk/lander-core";
+import { LANDER_MARKDOWN_CONTENT_ADAPTER_VERSION } from "./version.js";
+export { LANDER_MARKDOWN_CONTENT_ADAPTER_VERSION };
+const parseScalar = (value) => {
+    const trimmed = value.trim();
+    if (trimmed === "true")
+        return true;
+    if (trimmed === "false")
+        return false;
+    if (/^["'].*["']$/.test(trimmed))
+        return trimmed.slice(1, -1);
+    return trimmed;
+};
+export function splitFrontmatter(raw) {
+    const normalized = String(raw ?? "").replace(/^\uFEFF/, "").replace(/\r\n?/g, "\n");
+    const match = /^---\n([\s\S]*?)\n---\n?/.exec(normalized);
+    if (!match)
+        return { frontmatter: "", body: normalized.trim() };
+    return { frontmatter: match[1] ?? "", body: normalized.slice(match[0].length).trim() };
+}
+export function parseSimpleFrontmatter(frontmatter) {
+    const output = {};
+    const lines = frontmatter.split("\n");
+    for (const line of lines) {
+        const match = /^([A-Za-z0-9_-]+):\s*(.*)$/.exec(line);
+        if (!match)
+            continue;
+        output[match[1]] = parseScalar(match[2] ?? "");
+    }
+    return output;
+}
+export function markdownToPageSpec(raw) {
+    const { frontmatter, body } = splitFrontmatter(raw);
+    const metadata = parseSimpleFrontmatter(frontmatter);
+    const title = String(metadata.title ?? metadata.h1 ?? "Untitled Page");
+    const h1 = String(metadata.h1 ?? title);
+    const slug = normalizeRouteSlug(String(metadata.slug ?? `/${title.toLowerCase().replace(/[^a-z0-9]+/g, "-")}/`));
+    const kind = String(metadata.kind ?? metadata.contentType ?? "docs_bridge");
+    const description = String(metadata.description ?? body.split(/\n\s*\n/)[0] ?? title);
+    const intro = String(metadata.intro ?? description);
+    const faqs = Array.isArray(metadata.faq) ? metadata.faq : undefined;
+    const page = {
+        kind,
+        slug,
+        title,
+        description,
+        h1,
+        intro,
+        sections: [
+            {
+                id: "content",
+                kind: "markdown",
+                body,
+            },
+        ],
+        faq: faqs,
+    };
+    return { metadata, body, page };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const LANDER_MARKDOWN_CONTENT_ADAPTER_VERSION = "0.1.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uCAAuC,UAAU,CAAC"}

package/dist/version.js

@@ -0,0 +1,2 @@
+export const LANDER_MARKDOWN_CONTENT_ADAPTER_VERSION = "0.1.0";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uCAAuC,GAAG,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@mdwrk/lander-markdown-content-adapter",
+  "version": "0.1.1",
+  "type": "module",
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20 <23"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "keywords": [
+    "lander",
+    "markdown",
+    "frontmatter"
+  ],
+  "description": "Markdown frontmatter and body adapter for portable lander content specs.",
+  "dependencies": {
+    "@mdwrk/lander-content-contract": "^0.1.2",
+    "@mdwrk/lander-core": "^0.1.2"
+  },
+  "scripts": {
+    "build": "npm run build -w @mdwrk/lander-core && tsc -p tsconfig.json",
+    "typecheck": "npm run build -w @mdwrk/lander-core && tsc --noEmit -p tsconfig.json",
+    "lint": "npm run typecheck",
+    "test": "npm run typecheck",
+    "prepack": "npm run build"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./version": {
+      "types": "./dist/version.d.ts",
+      "import": "./dist/version.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "author": "Jacob Stewart <jacob@swarmauri.com>",
+  "homepage": "https://mdwrk.com"
+}