@x12i/mdreports-docs 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 x12i
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,25 @@
+# `@x12i/mdreports-docs`
+
+Knowledge SDK for **Markdown Reports Studio**. Install as a **devDependency** only.
+
+```bash
+npm i -D @x12i/mdreports-docs
+```
+
+```ts
+import { mdreportsDocs } from "@x12i/mdreports-docs";
+
+mdreportsDocs.listUseCases();
+mdreportsDocs.getUseCaseMarkdown("render-with-sdk");
+mdreportsDocs.getBookMarkdown("03-sdk", "developers");
+```
+
+CLI:
+
+```bash
+npx mdreports-docs list-use-cases
+npx mdreports-docs use-case pick-a-surface
+npx mdreports-docs book 07-templates builders
+```
+
+Content and human site live in `mdreports-docs/` in the monorepo. Preview: `pnpm docs` from the repo root.

package/bin/mdreports-docs.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import("../dist/cli.js");

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+import { mdreportsDocs } from "./index.js";
+const [cmd, id, audience] = process.argv.slice(2);
+function usage() {
+    console.error(`Usage:
+  mdreports-docs use-case <id>          Print assembled use-case markdown
+  mdreports-docs book <id> <audience>   Print book markdown
+  mdreports-docs list-use-cases         List use case ids
+  mdreports-docs list-books             List book ids
+`);
+}
+if (!cmd || cmd === "help" || cmd === "--help") {
+    usage();
+    process.exit(cmd ? 0 : 1);
+}
+if (cmd === "list-use-cases") {
+    for (const uc of mdreportsDocs.listUseCases()) {
+        console.log(`${uc.id}\t${uc.title}`);
+    }
+    process.exit(0);
+}
+if (cmd === "list-books") {
+    for (const b of mdreportsDocs.listBooks()) {
+        console.log(`${b.id}\t${b.title}\t${b.audiences.join(",")}`);
+    }
+    process.exit(0);
+}
+if (cmd === "use-case") {
+    if (!id) {
+        usage();
+        process.exit(1);
+    }
+    const md = mdreportsDocs.getUseCaseMarkdown(id);
+    if (!md) {
+        console.error(`Unknown use case: ${id}`);
+        process.exit(1);
+    }
+    process.stdout.write(md);
+    process.exit(0);
+}
+if (cmd === "book") {
+    if (!id || !audience) {
+        usage();
+        process.exit(1);
+    }
+    const md = mdreportsDocs.getBookMarkdown(id, audience);
+    if (!md) {
+        console.error(`Unknown book/audience: ${id} ${audience}`);
+        process.exit(1);
+    }
+    process.stdout.write(md);
+    process.exit(0);
+}
+usage();
+process.exit(1);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,CAAC,GAAG,EAAE,EAAE,EAAE,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAElD,SAAS,KAAK;IACZ,OAAO,CAAC,KAAK,CAAC;;;;;CAKf,CAAC,CAAC;AACH,CAAC;AAED,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;IAC/C,KAAK,EAAE,CAAC;IACR,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5B,CAAC;AAED,IAAI,GAAG,KAAK,gBAAgB,EAAE,CAAC;IAC7B,KAAK,MAAM,EAAE,IAAI,aAAa,CAAC,YAAY,EAAE,EAAE,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,aAAa,CAAC,SAAS,EAAE,EAAE,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,KAAK,EAAE,CAAC;QACR,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,EAAE,GAAG,aAAa,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;IAChD,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;QACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACzB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACrB,KAAK,EAAE,CAAC;QACR,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,EAAE,GAAG,aAAa,CAAC,eAAe,CAAC,EAAE,EAAE,QAAqC,CAAC,CAAC;IACpF,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,IAAI,QAAQ,EAAE,CAAC,CAAC;QAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACzB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,KAAK,EAAE,CAAC;AACR,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC"}

package/dist/generated/bundle.d.ts

@@ -0,0 +1,7 @@
+import type { AgentManifest, Catalog, SiteConfig, UseCasesFile } from "@x12i/docify-core";
+export declare const catalog: Catalog;
+export declare const useCases: UseCasesFile;
+export declare const site: SiteConfig;
+export declare const manifest: AgentManifest;
+export declare const files: Record<string, string>;
+//# sourceMappingURL=bundle.d.ts.map

package/dist/generated/bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../../src/generated/bundle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE1F,eAAO,MAAM,OAAO,EAkLf,OAAO,CAAC;AAEb,eAAO,MAAM,QAAQ,EA+QhB,YAAY,CAAC;AAElB,eAAO,MAAM,IAAI,EAkDZ,UAAU,CAAC;AAEhB,eAAO,MAAM,QAAQ,EA4UhB,aAAa,CAAC;AAEnB,eAAO,MAAM,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAoGxC,CAAC"}