@datalackey/update-markdown-uml 1.1.9 → 1.1.11

package/dist/cli/UmlRunConfig.d.ts

@@ -0,0 +1,5 @@
+import type { RunConfig } from "@datalackey/tooling-core";
+export interface UmlRunConfig extends RunConfig {
+    excludePackages: string[];
+    sourceRoot: string | undefined;
+}

package/dist/cli/UmlRunConfig.js

@@ -0,0 +1 @@
+export {};

package/dist/cli/descriptor.d.ts

@@ -0,0 +1,3 @@
+import type { PluginDescriptor } from "@datalackey/tooling-core";
+import type { UmlRunConfig } from "./UmlRunConfig.js";
+export declare const descriptor: PluginDescriptor<UmlRunConfig>;

package/dist/cli/descriptor.js

@@ -0,0 +1,22 @@
+import { parseUmlOptions } from "./parseUmlOptions.js";
+import { validateUmlConfig } from "./validateUmlConfig.js";
+export const descriptor = {
+    name: "update-markdown-uml",
+    description: "Generate and validate UML class and package diagrams for TypeScript source trees",
+    options: [
+        {
+            flag: "--exclude-packages",
+            description: "Leaf package directory names to exclude from diagram generation",
+            requiresValue: true,
+            valueName: "pkg1,pkg2,..."
+        },
+        {
+            flag: "--source",
+            description: "Override source root discovery (default: src/)",
+            requiresValue: true,
+            valueName: "path"
+        }
+    ],
+    parseOptions: parseUmlOptions,
+    validate: validateUmlConfig
+};

package/dist/cli/parseUmlOptions.d.ts

@@ -0,0 +1,3 @@
+import type { RunConfig } from "@datalackey/tooling-core";
+import type { UmlRunConfig } from "./UmlRunConfig.js";
+export declare function parseUmlOptions(standard: RunConfig, passthrough: Map<string, string | boolean>): UmlRunConfig;

package/dist/cli/parseUmlOptions.js

@@ -0,0 +1,13 @@
+export function parseUmlOptions(standard, passthrough) {
+    const rawExclude = passthrough.get("--exclude-packages");
+    const excludePackages = typeof rawExclude === "string" && rawExclude.length > 0
+        ? rawExclude.split(",").map((s) => s.trim()).filter((s) => s.length > 0)
+        : [];
+    const rawSource = passthrough.get("--source");
+    const sourceRoot = typeof rawSource === "string" ? rawSource : undefined;
+    return {
+        ...standard,
+        excludePackages: excludePackages,
+        sourceRoot: sourceRoot
+    };
+}

package/dist/cli/validateUmlConfig.d.ts

@@ -0,0 +1,2 @@
+import type { UmlRunConfig } from "./UmlRunConfig.js";
+export declare function validateUmlConfig(config: UmlRunConfig): void;

package/dist/cli/validateUmlConfig.js

@@ -0,0 +1,22 @@
+import fs from "node:fs";
+import path from "node:path";
+const DEFAULT_SOURCE_ROOT = "src";
+export function validateUmlConfig(config) {
+    if (config.excludePackages.length === 0) {
+        return;
+    }
+    const resolvedSourceRoot = path.resolve(process.cwd(), config.sourceRoot ?? DEFAULT_SOURCE_ROOT);
+    if (!fs.existsSync(resolvedSourceRoot)) {
+        return;
+    }
+    const leafDirs = new Set(fs.readdirSync(resolvedSourceRoot, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => entry.name));
+    for (const excluded of config.excludePackages) {
+        if (!leafDirs.has(excluded)) {
+            if (!config.quiet) {
+                console.log(`Warning: excluded package "${excluded}" not found under source root "${resolvedSourceRoot}"`);
+            }
+        }
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,3 @@
+export {};
+// @datalackey/update-markdown-uml
+// implementation pending

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datalackey/update-markdown-uml",
-  "version": "1.1.9",
+  "version": "1.1.11",
   "description": "Generates and validates UML class and package diagrams for TypeScript source trees, injecting them into Markdown documentation files",
   "license": "MIT",
   "type": "module",