flex-md 3.2.0 → 4.0.0

package/dist/tokens/validator.js

@@ -0,0 +1,59 @@
+import { parseSystemPart } from './parser.js';
+export function validateSystemParts(spec) {
+    const errors = [];
+    const warnings = [];
+    for (const section of spec.sections) {
+        const isRequired = section.required !== false;
+        const kind = section.kind || 'text';
+        if (!section.instruction) {
+            if (isRequired) {
+                warnings.push({
+                    sectionName: section.name,
+                    message: 'Required section has no instruction. Token estimation will use fallback.'
+                });
+            }
+            continue;
+        }
+        const systemPart = parseSystemPart(section.instruction, kind);
+        if (!systemPart) {
+            warnings.push({
+                sectionName: section.name,
+                message: `No valid system part found. Expected pattern for '${kind}' kind.`
+            });
+            continue;
+        }
+        // Validate ranges
+        if (systemPart.parsed.type === 'items' || systemPart.parsed.type === 'lines') {
+            const { min, max } = systemPart.parsed;
+            if (max !== null && max < min) {
+                errors.push({
+                    sectionName: section.name,
+                    message: `Invalid range: max (${max}) is less than min (${min})`,
+                    instruction: section.instruction
+                });
+            }
+        }
+        if (systemPart.parsed.type === 'table') {
+            const { rows, columns } = systemPart.parsed;
+            if (rows.max !== null && rows.max < rows.min) {
+                errors.push({
+                    sectionName: section.name,
+                    message: `Invalid rows range: max (${rows.max}) < min (${rows.min})`,
+                    instruction: section.instruction
+                });
+            }
+            if (columns.max !== null && columns.max < columns.min) {
+                errors.push({
+                    sectionName: section.name,
+                    message: `Invalid columns range: max (${columns.max}) < min (${columns.min})`,
+                    instruction: section.instruction
+                });
+            }
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings
+    };
+}

package/dist/validate/connection.d.ts

@@ -0,0 +1,12 @@
+export interface ConnectionResult {
+    connected: boolean;
+    key: string;
+    normalizedKey: string;
+    path?: string[];
+    alternativeMatches?: string[];
+    suggestion?: string;
+}
+/**
+ * Checks if a specific key (section) is "connected" in the given markdown.
+ */
+export declare function checkConnection(md: string, key: string): ConnectionResult;

package/dist/validate/connection.js

@@ -0,0 +1,44 @@
+import { buildOutline } from "../md/outline.js";
+import { normalizeName } from "../md/parse.js";
+/**
+ * Checks if a specific key (section) is "connected" in the given markdown.
+ */
+export function checkConnection(md, key) {
+    const outline = buildOutline(md);
+    const normKey = normalizeName(key);
+    const path = [];
+    // Breadth-first search for the key
+    const queue = outline.nodes.map(n => ({ node: n, currentPath: [n.title] }));
+    const alternatives = [];
+    while (queue.length > 0) {
+        const { node, currentPath } = queue.shift();
+        if (node.key === normKey) {
+            return {
+                connected: true,
+                key,
+                normalizedKey: normKey,
+                path: currentPath
+            };
+        }
+        // Collect alternatives (any heading that exists)
+        alternatives.push(node.title);
+        for (const child of node.children) {
+            queue.push({ node: child, currentPath: [...currentPath, child.title] });
+        }
+    }
+    // Not found, look for fuzzy matches or common issues
+    const suggestions = [];
+    if (alternatives.length === 0) {
+        suggestions.push("The document appears to have no headings.");
+    }
+    else {
+        suggestions.push(`Available sections: ${alternatives.join(", ")}`);
+    }
+    return {
+        connected: false,
+        key,
+        normalizedKey: normKey,
+        alternativeMatches: alternatives,
+        suggestion: suggestions.join(" ")
+    };
+}