@overcrow/mcp 0.0.0 → 0.1.1

package/dist/audit/project.js

@@ -0,0 +1,200 @@
+// Reads a widget directory for the audit, as data: a bounded walk that
+// follows no link and skips what is never submitted (node_modules, dist,
+// tests/output, hidden folders), the manifest, the logic's tokens, the
+// view's handlers and the images' sizes.
+import { lstat, open, readdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { tokenize } from "./lexer.js";
+const MAX_FILES = 2000;
+/** The CLI's own bounds of view.ocml and style.ocss: larger ones are refused anyway. */
+const MAX_VIEW_BYTES = 256 * 1024;
+const MAX_STYLE_BYTES = 128 * 1024;
+/** Longest line the view rules read; longer lines are cut (bounded regular expressions). */
+const MAX_LINE_CHARS = 4096;
+const MAX_DEPTH = 8;
+const MAX_TEXT_BYTES = 1 << 20;
+const SKIPPED_DIRECTORIES = new Set(["node_modules", "dist", ".git"]);
+const TEXT = /\.(json|ts|mts|cts|js|mjs|cjs|ocml|ocss|md|txt|env|npmrc|yml|yaml|toml|html|css|sh)$|^(LICENSE|README|\.env.*|\.npmrc)$/i;
+const IMAGE = /\.(png|jpe?g|webp)$/i;
+function isPackaged(path) {
+    return (["manifest.json", "view.ocml", "style.ocss", "logic.ts", "logic.js", "LICENSE"].includes(path) ||
+        /^locales\/[a-z]{2}(-[A-Z]{2})?\.json$/.test(path) ||
+        (path.startsWith("assets/") && IMAGE.test(path)));
+}
+/** Width and height from a PNG's IHDR, or null for anything else. */
+async function pngSize(path) {
+    const handle = await open(path, "r");
+    try {
+        const header = Buffer.alloc(24);
+        const { bytesRead } = await handle.read(header, 0, 24, 0);
+        if (bytesRead < 24 ||
+            header.readUInt32BE(0) !== 0x89504e47 ||
+            header.toString("latin1", 12, 16) !== "IHDR") {
+            return null;
+        }
+        return { width: header.readUInt32BE(16), height: header.readUInt32BE(20) };
+    }
+    finally {
+        await handle.close();
+    }
+}
+function parseObject(text) {
+    if (text === null)
+        return { value: null, error: "missing" };
+    try {
+        const value = JSON.parse(text);
+        if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+            return { value: value, error: null };
+        }
+        return { value: null, error: "not a JSON object" };
+    }
+    catch (error) {
+        return { value: null, error: error.message };
+    }
+}
+export async function readWidget(directory) {
+    const files = [];
+    let truncated = false;
+    const walk = async (relative, depth) => {
+        if (depth > MAX_DEPTH) {
+            truncated = true;
+            return;
+        }
+        const entries = await readdir(join(directory, relative), { withFileTypes: true });
+        entries.sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+        for (const entry of entries) {
+            if (files.length >= MAX_FILES) {
+                truncated = true;
+                return;
+            }
+            const path = relative ? `${relative}/${entry.name}` : entry.name;
+            if (entry.isSymbolicLink())
+                continue;
+            if (entry.isDirectory()) {
+                if (SKIPPED_DIRECTORIES.has(entry.name) || path === "tests/output")
+                    continue;
+                if (entry.name.startsWith("."))
+                    continue;
+                await walk(path, depth + 1);
+                continue;
+            }
+            if (!entry.isFile())
+                continue;
+            const absolute = join(directory, path);
+            const info = await lstat(absolute);
+            const isText = TEXT.test(entry.name) && info.size <= MAX_TEXT_BYTES;
+            const file = {
+                path,
+                bytes: info.size,
+                text: isText ? await readFile(absolute, "utf8") : null,
+                packaged: isPackaged(path),
+            };
+            if (/\.png$/i.test(entry.name))
+                file.image = await pngSize(absolute);
+            files.push(file);
+        }
+    };
+    await walk("", 0);
+    const text = (path) => files.find((file) => file.path === path)?.text ?? null;
+    const manifest = parseObject(text("manifest.json"));
+    const logicPath = text("logic.ts") !== null ? "logic.ts" : text("logic.js") !== null ? "logic.js" : null;
+    const logic = logicPath ? text(logicPath) : null;
+    return {
+        directory,
+        files,
+        truncated,
+        manifest: manifest.value,
+        manifestError: manifest.error,
+        logicPath,
+        logic,
+        tokens: logic ? tokenize(logic) : [],
+        view: text("view.ocml"),
+        style: text("style.ocss"),
+        listing: parseObject(text("listing.json")).value,
+        packageJson: parseObject(text("package.json")).value,
+    };
+}
+/** What the view says about handlers, forms, classes and images. */
+export function viewFacts(view) {
+    const facts = {
+        handlers: new Map(),
+        intents: [],
+        unconditionalClasses: new Map(),
+        images: [],
+    };
+    if (!view || view.length > MAX_VIEW_BYTES)
+        return facts;
+    let conditional = 0;
+    view.split("\n").forEach((full, index) => {
+        const text = full.slice(0, MAX_LINE_CHARS);
+        const line = index + 1;
+        for (const match of text.matchAll(/<\/?(if|else-if|else)\b[^>]*?(\/?)>/g)) {
+            if (match[0].startsWith("</"))
+                conditional = Math.max(0, conditional - 1);
+            else if (match[2] !== "/")
+                conditional += 1;
+        }
+        for (const match of text.matchAll(/on:([a-z]+)=\{\s*([A-Za-z_$][\w$]*)/g)) {
+            const name = match[2];
+            const events = facts.handlers.get(name) ?? new Set();
+            events.add(match[1]);
+            facts.handlers.set(name, events);
+        }
+        for (const match of text.matchAll(/\bintent="([a-z][\w.]*)"/g))
+            facts.intents.push({ name: match[1], line });
+        for (const match of text.matchAll(/<image\b[^>]*\bsrc="(assets\/[^"]+)"/g))
+            facts.images.push({ src: match[1], line });
+        if (conditional === 0) {
+            for (const match of text.matchAll(/\bclass="([^"]+)"/g)) {
+                for (const name of match[1].split(/\s+/)) {
+                    if (name && !facts.unconditionalClasses.has(name))
+                        facts.unconditionalClasses.set(name, line);
+                }
+            }
+        }
+    });
+    return facts;
+}
+/** Classes of the style whose animation repeats forever: class → line. */
+export function infiniteAnimations(style) {
+    const out = new Map();
+    if (!style || style.length > MAX_STYLE_BYTES)
+        return out;
+    const text = style.replace(/\/\*[\s\S]*?\*\//g, (comment) => comment.replace(/[^\n]/g, " "));
+    // One linear pass over the braces (no backtracking regular expression).
+    let depth = 0;
+    let line = 1;
+    let selectorStart = 0;
+    let selectorLine = 1;
+    let selector = "";
+    let bodyStart = 0;
+    for (let index = 0; index < text.length; index += 1) {
+        const char = text[index];
+        if (char === "\n")
+            line += 1;
+        else if (char === "{") {
+            if (depth === 0) {
+                selector = text.slice(selectorStart, index);
+                selectorLine =
+                    line -
+                        (selector.match(/\n/g)?.length ?? 0) +
+                        (selector.match(/^\s*\n/)?.[0].split("\n").length ?? 1) -
+                        1;
+                bodyStart = index + 1;
+            }
+            depth += 1;
+        }
+        else if (char === "}") {
+            depth -= 1;
+            if (depth <= 0) {
+                if (depth === 0 && /animation\s*:[^;]*\binfinite\b/.test(text.slice(bodyStart, index))) {
+                    for (const match of selector.matchAll(/\.([A-Za-z_][\w-]*)/g))
+                        out.set(match[1], selectorLine);
+                }
+                depth = 0;
+                selectorStart = index + 1;
+            }
+        }
+    }
+    return out;
+}