@automaton-labs/aib 0.0.6 → 0.0.8

package/dist/commands/inspect-mixed-format.js

@@ -0,0 +1,524 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appendUsagesMixedBlock = appendUsagesMixedBlock;
+exports.formatUsagesDetailMixedAgentText = formatUsagesDetailMixedAgentText;
+exports.appendUsageLocationDetailMixedLines = appendUsageLocationDetailMixedLines;
+exports.formatUsageLocationDetailItemText = formatUsageLocationDetailItemText;
+exports.appendUsageCodeDetailMixedLines = appendUsageCodeDetailMixedLines;
+exports.formatUsageCodeDetailBlockText = formatUsageCodeDetailBlockText;
+exports.appendDuplicatesMixedBlock = appendDuplicatesMixedBlock;
+exports.appendMixedListSection = appendMixedListSection;
+exports.appendFileNonDeclarationText = appendFileNonDeclarationText;
+exports.appendCodeLikeMixedBlock = appendCodeLikeMixedBlock;
+exports.appendCodeLikeMixedBlocks = appendCodeLikeMixedBlocks;
+exports.isSavedCodeResult = isSavedCodeResult;
+exports.appendSavedCodeReference = appendSavedCodeReference;
+exports.isCodeOmittedFromStdoutResult = isCodeOmittedFromStdoutResult;
+exports.appendCodeOmittedFromStdout = appendCodeOmittedFromStdout;
+exports.appendCodeOmittedSummary = appendCodeOmittedSummary;
+exports.codeOmissionSummary = codeOmissionSummary;
+exports.formatSymbolListAgentText = formatSymbolListAgentText;
+exports.appendSymbolListBlock = appendSymbolListBlock;
+exports.formatMembersAgentText = formatMembersAgentText;
+exports.appendMembersBlock = appendMembersBlock;
+exports.formatDepsAgentText = formatDepsAgentText;
+exports.appendSectionBreak = appendSectionBreak;
+exports.createFileHeaderAppender = createFileHeaderAppender;
+exports.appendDepsBlocks = appendDepsBlocks;
+exports.appendDepsBlock = appendDepsBlock;
+exports.readStringArray = readStringArray;
+exports.isHomogeneousRawOp = isHomogeneousRawOp;
+const inspect_format_primitives_1 = require("./inspect-format-primitives");
+const inspect_usages_format_1 = require("./inspect-usages-format");
+const inspect_duplicates_format_1 = require("./inspect-duplicates-format");
+function appendUsagesMixedBlock(lines, item) {
+    const detail = typeof item.detail === "string" ? item.detail : "";
+    const text = detail === "locations" || detail === "code"
+        ? formatUsagesDetailMixedAgentText(item)
+        : (0, inspect_usages_format_1.formatUsagesAgentText)(item);
+    if (!text) {
+        return;
+    }
+    lines.push(...text.split(/\r?\n/));
+}
+function formatUsagesDetailMixedAgentText(row) {
+    const detail = typeof row.detail === "string" ? row.detail : "detail";
+    if ((0, inspect_format_primitives_1.numberOrZero)(row.referenceCount) === 0) {
+        const target = typeof row.target === "string" ? row.target : "";
+        const scope = typeof row.scopeLabel === "string" ? row.scopeLabel : "project";
+        const lines = [target ? `usages ${target}` : "usages", `0 refs in ${scope}`];
+        (0, inspect_usages_format_1.appendTargetLocalUsagesHint)(lines, row);
+        return lines.join("\n");
+    }
+    const lines = [`usages ${detail}`];
+    (0, inspect_usages_format_1.appendTargetLocalUsagesHint)(lines, row);
+    if (detail === "code") {
+        appendUsageCodeDetailMixedLines(lines, row);
+    }
+    else {
+        appendUsageLocationDetailMixedLines(lines, row);
+    }
+    (0, inspect_usages_format_1.appendUsageSummaryUnusedLines)(lines, row, Array.isArray(row.items) ? row.items.filter(inspect_format_primitives_1.isObject) : []);
+    const view = typeof row.view === "string" ? row.view : "";
+    if (view) {
+        appendSectionBreak(lines);
+        lines.push(`view: ${view}`);
+    }
+    return lines.join("\n").replace(/\n{3,}/g, "\n\n").trimEnd();
+}
+function appendUsageLocationDetailMixedLines(lines, row) {
+    const items = Array.isArray(row.items)
+        ? row.items.filter(inspect_format_primitives_1.isObject).filter((item) => (0, inspect_format_primitives_1.numberOrZero)(item.referenceCount) > 0)
+        : [];
+    if (items.length > 0) {
+        appendSectionBreak(lines);
+    }
+    const { ownerGroups, standalone } = (0, inspect_usages_format_1.groupUsageItemsByOwner)(items);
+    for (const [owner, ownerItems] of ownerGroups) {
+        lines.push("");
+        lines.push(`// ${owner}:`);
+        for (const item of ownerItems) {
+            lines.push(...formatUsageLocationDetailItemText(item, false));
+        }
+    }
+    if (standalone.length > 0 && ownerGroups.length > 0) {
+        lines.push("");
+    }
+    for (const item of standalone) {
+        lines.push(...formatUsageLocationDetailItemText(item, true));
+    }
+}
+function formatUsageLocationDetailItemText(item, includeOwner) {
+    const entity = typeof item.entity === "string" ? item.entity : "";
+    const reference = (0, inspect_usages_format_1.splitUsageEntityReference)(entity);
+    const name = includeOwner ? entity : reference.name;
+    const lines = [`${name}: ${(0, inspect_format_primitives_1.numberOrZero)(item.referenceCount)} refs`];
+    const usedBy = Array.isArray(item.usedBy) ? item.usedBy.filter(inspect_format_primitives_1.isObject) : [];
+    for (const usage of usedBy) {
+        const file = typeof usage.file === "string" ? usage.file : "";
+        if (file) {
+            lines.push(`${file}:`);
+        }
+        const locations = Array.isArray(usage.locations) ? usage.locations.filter(inspect_format_primitives_1.isObject) : [];
+        for (const location of locations) {
+            const line = typeof location.line === "number" ? ` l${location.line}` : "";
+            const container = typeof location.container === "string" ? location.container : "";
+            lines.push(`${container}${line}`.trim());
+        }
+    }
+    if (typeof item.hidden === "string") {
+        lines.push(item.hidden);
+    }
+    return lines;
+}
+function appendUsageCodeDetailMixedLines(lines, row) {
+    const blocks = Array.isArray(row.blocks) ? row.blocks.filter(inspect_format_primitives_1.isObject) : [];
+    if (blocks.length > 0) {
+        appendSectionBreak(lines);
+    }
+    const { ownerGroups, standalone } = (0, inspect_usages_format_1.groupUsageItemsByOwner)(blocks);
+    for (const [owner, ownerBlocks] of ownerGroups) {
+        lines.push(`// ${owner}:`);
+        for (const [entity, entityBlocks] of groupBy(ownerBlocks, (block) => (0, inspect_usages_format_1.splitUsageEntityReference)(typeof block.entity === "string" ? block.entity : "").name)) {
+            if (entity) {
+                lines.push(`// ${entity}`);
+            }
+            for (const block of entityBlocks) {
+                lines.push(...formatUsageCodeDetailBlockText(block, false, false));
+            }
+        }
+    }
+    if (standalone.length > 0 && ownerGroups.length > 0) {
+        lines.push("");
+    }
+    for (const [entity, entityBlocks] of groupBy(standalone, (block) => typeof block.entity === "string" ? block.entity : "")) {
+        if (entity) {
+            lines.push(`// ${entity}`);
+        }
+        for (const block of entityBlocks) {
+            lines.push(...formatUsageCodeDetailBlockText(block, false, false));
+        }
+    }
+    const hiddenBlocks = Array.isArray(row.hiddenBlocks) ? row.hiddenBlocks.filter(inspect_format_primitives_1.isObject) : [];
+    for (const hidden of hiddenBlocks) {
+        const entity = typeof hidden.entity === "string" ? hidden.entity : "";
+        const message = typeof hidden.hidden === "string" ? hidden.hidden : "";
+        if (message) {
+            lines.push(entity ? `${entity}: ${message}` : message);
+        }
+    }
+}
+function formatUsageCodeDetailBlockText(block, includeOwner, includeEntity = true) {
+    const entity = typeof block.entity === "string" ? block.entity : "";
+    const reference = (0, inspect_usages_format_1.splitUsageEntityReference)(entity);
+    const name = includeOwner ? entity : reference.name;
+    const lines = [];
+    if (includeEntity && name) {
+        lines.push(`// ${name}`);
+    }
+    const file = typeof block.file === "string" ? block.file : "";
+    const line = typeof block.line === "number" ? ` l${block.line}` : "";
+    if (file || line) {
+        lines.push(`// ${file}${line}`.trim());
+    }
+    if (typeof block.code === "string") {
+        lines.push(block.code.trimEnd());
+    }
+    else if ((0, inspect_format_primitives_1.isObject)(block.omitted)) {
+        const reason = typeof block.omitted.reason === "string" ? block.omitted.reason : "omitted";
+        lines.push(`// ${reason}`);
+    }
+    return lines;
+}
+function appendDuplicatesMixedBlock(lines, item) {
+    const text = (0, inspect_duplicates_format_1.formatDuplicatesAgentText)(item);
+    if (!text) {
+        return;
+    }
+    lines.push(...text.split(/\r?\n/));
+}
+function appendMixedListSection(lines, header, values) {
+    const items = readStringArray(values);
+    lines.push(header);
+    if (items.length === 0) {
+        lines.push(header === "exports:" ? "no exports" : "no top-level declarations");
+        return;
+    }
+    for (const item of items) {
+        lines.push(item);
+    }
+}
+function appendFileNonDeclarationText(lines, item) {
+    if (item.hasNonDeclarationText === true) {
+        lines.push("file has non-declaration text");
+    }
+}
+function appendCodeLikeMixedBlock(lines, op, item) {
+    const entity = typeof item.entity === "string" ? item.entity : "";
+    lines.push(`// ${[op, entity].filter((part) => part !== "").join(" ")}:`);
+    if ((0, inspect_format_primitives_1.isInspectSymbolNotFoundResult)(item)) {
+        lines.push(`not found symbols: ${(0, inspect_format_primitives_1.readNotFoundSymbols)(item).join(", ")}`);
+        return;
+    }
+    if (typeof item.meta === "string" && item.meta !== "") {
+        lines.push(`// ${item.meta}`);
+    }
+    if (typeof item.saved === "string" && item.saved !== "") {
+        lines.push(`saved: ${item.saved}`);
+    }
+    if (typeof item.code === "string") {
+        lines.push(item.code.trimEnd());
+    }
+    else if (isCodeOmittedFromStdoutResult(item)) {
+        appendCodeOmittedFromStdout(lines, item);
+    }
+    else if (isSavedCodeResult(item)) {
+        appendSavedCodeReference(lines, item);
+    }
+}
+function appendCodeLikeMixedBlocks(lines, op, items) {
+    const omitted = [];
+    for (const item of items) {
+        if (isCodeOmittedFromStdoutResult(item)) {
+            omitted.push(item);
+            continue;
+        }
+        appendCodeLikeMixedBlock(lines, op, item);
+    }
+    appendCodeOmittedSummary(lines, omitted, op);
+}
+function isSavedCodeResult(item) {
+    return typeof item.saved === "string" && item.saved !== "";
+}
+function appendSavedCodeReference(lines, item) {
+    lines.push(`saved: ${item.saved}`);
+    if (typeof item.next === "string" && item.next !== "") {
+        lines.push(`next: ${item.next}`);
+    }
+}
+function isCodeOmittedFromStdoutResult(item) {
+    return item.reason === "CODE_TOO_LARGE_FOR_STDOUT" || item.reason === "SLICE_TOO_LARGE_FOR_STDOUT";
+}
+function appendCodeOmittedFromStdout(lines, item) {
+    const reason = typeof item.reason === "string" ? item.reason : "CODE_TOO_LARGE_FOR_STDOUT";
+    const summary = codeOmissionSummary(item) ?? reason;
+    lines.push(`code omitted: ${summary}`);
+    if (typeof item.hint === "string" && item.hint !== "") {
+        lines.push(`hint: ${item.hint}`);
+    }
+}
+function appendCodeOmittedSummary(lines, items, op) {
+    if (items.length === 0) {
+        return;
+    }
+    const noun = op === "slice" ? "slice" : "code";
+    const limits = Array.from(new Set(items
+        .map((item) => typeof item.limit === "number" ? item.limit : null)
+        .filter((limit) => limit !== null)));
+    const limit = limits.length === 1 ? `; limit ${limits[0]} NEL` : "";
+    lines.push(`// ${noun} omitted${limit}`);
+    for (const item of items) {
+        const entity = typeof item.entity === "string" && item.entity !== "" ? item.entity : "unknown";
+        const meta = typeof item.meta === "string"
+            ? item.meta
+            : typeof item.rangeMeta === "string"
+                ? item.rangeMeta
+                : "";
+        const lineCount = typeof item.nonEmptyLines === "number" && item.nonEmptyLines > 0
+            ? item.nonEmptyLines
+            : typeof item.lineCount === "number" && item.lineCount > 0
+                ? item.lineCount
+                : 0;
+        const nonEmptyLines = lineCount > 0
+            ? `${lineCount} NEL`
+            : "";
+        lines.push(`// ${[entity, meta, nonEmptyLines].filter((part) => part !== "").join(" ")}`);
+    }
+    const views = Array.from(new Set(items
+        .map((item) => typeof item.view === "string" ? item.view : "")
+        .filter((view) => view !== "")));
+    for (const view of views) {
+        lines.push(`view: ${view}`);
+    }
+}
+function codeOmissionSummary(item) {
+    const hint = typeof item.hint === "string" ? item.hint : "";
+    const match = /^(?:Code|Slice) is ([^.]+)\./.exec(hint);
+    return match?.[1] ?? null;
+}
+function formatSymbolListAgentText(response, field, commonFile) {
+    const lines = [];
+    const appendFile = createFileHeaderAppender(lines);
+    if (Array.isArray(response.results)) {
+        for (const item of response.results) {
+            if (!(0, inspect_format_primitives_1.isObject)(item)) {
+                continue;
+            }
+            appendSymbolListBlock(lines, appendFile, item, field, commonFile);
+        }
+    }
+    else {
+        appendSymbolListBlock(lines, appendFile, response, field, commonFile);
+    }
+    return lines.length > 0 ? lines.join("\n") : null;
+}
+function appendSymbolListBlock(lines, appendFile, item, field, commonFile) {
+    appendFile(typeof item.file === "string" ? item.file : commonFile ?? "");
+    const values = readStringArray(item[field]).map((value) => (0, inspect_format_primitives_1.normalizeDuplicateSourceModuleSuffix)(value));
+    if (values.length === 0) {
+        lines.push(`${field === "exports" ? "exports" : "file"}:`);
+        lines.push(field === "exports" ? "no exports" : "no top-level declarations");
+    }
+    else {
+        for (const value of values) {
+            lines.push(value);
+        }
+    }
+    if (field === "symbols") {
+        appendFileNonDeclarationText(lines, item);
+    }
+    if (typeof item.summary === "string") {
+        lines.push(`summary: ${item.summary}`);
+    }
+    const reexports = readStringArray(item.reexports);
+    if (reexports.length > 0) {
+        lines.push(`reexports: ${reexports.join(", ")}`);
+    }
+    if (typeof item.page === "string") {
+        lines.push(`page: ${item.page}`);
+    }
+    if (typeof item.hint === "string") {
+        lines.push(`hint: ${item.hint}`);
+    }
+}
+function formatMembersAgentText(response, commonFile) {
+    const lines = [];
+    const appendFile = createFileHeaderAppender(lines);
+    if ((0, inspect_format_primitives_1.isObject)(response.members) && !Array.isArray(response.members)) {
+        appendFile(typeof response.file === "string" ? response.file : commonFile ?? "");
+        for (const [entity, payload] of Object.entries(response.members)) {
+            if (!(0, inspect_format_primitives_1.isObject)(payload)) {
+                continue;
+            }
+            appendMembersBlock(lines, entity, payload);
+        }
+    }
+    else if (Array.isArray(response.results)) {
+        for (const item of response.results) {
+            if (!(0, inspect_format_primitives_1.isObject)(item)) {
+                continue;
+            }
+            appendFile(typeof item.file === "string" ? item.file : commonFile ?? "");
+            appendMembersBlock(lines, typeof item.entity === "string" ? item.entity : "", item);
+        }
+    }
+    else {
+        appendFile(typeof response.file === "string" ? response.file : commonFile ?? "");
+        appendMembersBlock(lines, typeof response.entity === "string" ? response.entity : "", response);
+    }
+    return lines.length > 0 ? lines.join("\n") : null;
+}
+function appendMembersBlock(lines, entity, payload) {
+    if ((0, inspect_format_primitives_1.isInspectSymbolNotFoundResult)(payload)) {
+        lines.push("members:");
+        lines.push(`not found symbols: ${(0, inspect_format_primitives_1.readNotFoundSymbols)(payload).join(", ")}`);
+        return;
+    }
+    const members = readStringArray(payload.members);
+    if (!entity && members.length === 0) {
+        return;
+    }
+    if (entity) {
+        lines.push(`// ${entity}:`);
+    }
+    if (members.length === 0) {
+        lines.push("no members");
+        return;
+    }
+    if (typeof payload.count === "number") {
+        lines.push(`// count: ${payload.count}`);
+    }
+    if (typeof payload.page === "string") {
+        lines.push(`// page: ${payload.page}`);
+    }
+    for (const member of members) {
+        lines.push(member);
+    }
+    if (typeof payload.view === "string") {
+        lines.push(`view: ${payload.view}`);
+    }
+}
+function formatDepsAgentText(response, commonFile) {
+    const lines = [];
+    const appendFile = createFileHeaderAppender(lines);
+    if ((0, inspect_format_primitives_1.isObject)(response.deps)) {
+        appendFile(typeof response.file === "string" ? response.file : commonFile ?? "");
+        const blocks = [];
+        for (const [entity, depsValue] of Object.entries(response.deps)) {
+            if (!(0, inspect_format_primitives_1.isObject)(depsValue)) {
+                continue;
+            }
+            blocks.push({
+                entity,
+                type: depsValue.type,
+                value: depsValue.value,
+                unknown: depsValue.unknown
+            });
+        }
+        appendDepsBlocks(lines, blocks);
+    }
+    else if (Array.isArray(response.results)) {
+        const blocks = [];
+        for (const item of response.results) {
+            if (!(0, inspect_format_primitives_1.isObject)(item)) {
+                continue;
+            }
+            appendFile(typeof item.file === "string" ? item.file : commonFile ?? "");
+            blocks.push({
+                entity: typeof item.entity === "string" ? item.entity : "",
+                missingSymbols: (0, inspect_format_primitives_1.readNotFoundSymbols)(item),
+                type: item.depsType,
+                value: item.depsValue,
+                unknown: item.depsUnknown
+            });
+        }
+        appendDepsBlocks(lines, blocks);
+    }
+    else {
+        appendFile(typeof response.file === "string" ? response.file : commonFile ?? "");
+        appendDepsBlocks(lines, [{
+                entity: typeof response.entity === "string" ? response.entity : "",
+                missingSymbols: (0, inspect_format_primitives_1.readNotFoundSymbols)(response),
+                type: response.depsType,
+                value: response.depsValue,
+                unknown: response.depsUnknown
+            }]);
+    }
+    return lines.length > 0 ? lines.join("\n") : null;
+}
+function appendSectionBreak(lines) {
+    if (lines.length > 0 && lines[lines.length - 1] !== "") {
+        lines.push("");
+    }
+}
+function createFileHeaderAppender(lines) {
+    let currentFile = "";
+    return (file) => {
+        if (file && file !== currentFile) {
+            lines.push(`// ${file}`);
+            currentFile = file;
+        }
+    };
+}
+function groupBy(items, keyOf) {
+    const groups = new Map();
+    for (const item of items) {
+        const key = keyOf(item);
+        const group = groups.get(key) ?? [];
+        group.push(item);
+        groups.set(key, group);
+    }
+    return Array.from(groups.entries());
+}
+function appendDepsBlocks(lines, blocks) {
+    const emptyEntities = [];
+    const missingSymbols = [];
+    let wroteHeader = false;
+    for (const block of blocks) {
+        if (block.missingSymbols && block.missingSymbols.length > 0) {
+            missingSymbols.push(...block.missingSymbols);
+            continue;
+        }
+        const type = readStringArray(block.type);
+        const value = readStringArray(block.value);
+        const unknown = readStringArray(block.unknown);
+        const isEmpty = type.length === 0 && value.length === 0 && unknown.length === 0;
+        if (isEmpty) {
+            if (block.entity) {
+                emptyEntities.push(block.entity);
+            }
+            continue;
+        }
+        if (!wroteHeader) {
+            lines.push("deps");
+            wroteHeader = true;
+        }
+        appendDepsBlock(lines, block.entity, { type, value, unknown });
+    }
+    if (emptyEntities.length > 0) {
+        if (!wroteHeader) {
+            lines.push("deps");
+            wroteHeader = true;
+        }
+        lines.push(`No deps for: ${emptyEntities.join(", ")}`);
+    }
+    if (missingSymbols.length > 0) {
+        if (!wroteHeader) {
+            lines.push("deps");
+        }
+        lines.push(`not found symbols: ${missingSymbols.join(", ")}`);
+    }
+}
+function appendDepsBlock(lines, entity, groups) {
+    if (!entity && groups.type.length === 0 && groups.value.length === 0 && groups.unknown.length === 0) {
+        return;
+    }
+    if (entity) {
+        lines.push(`${entity}:`);
+    }
+    if (groups.type.length > 0) {
+        lines.push(`type: ${groups.type.join(", ")}`);
+    }
+    if (groups.value.length > 0) {
+        lines.push(`value: ${groups.value.join(", ")}`);
+    }
+    if (groups.unknown.length > 0) {
+        lines.push(`unknown: ${groups.unknown.join(", ")}`);
+    }
+}
+function readStringArray(value) {
+    return Array.isArray(value) ? value.filter((item) => typeof item === "string" && item !== "") : [];
+}
+function isHomogeneousRawOp(rawResults, op) {
+    return rawResults.length > 0 && rawResults.every((rawResult) => (0, inspect_format_primitives_1.isObject)(rawResult) && rawResult.op === op);
+}