perttool 0.1.0-alpha.2

package/dist/formatter/source-formatter.js

@@ -0,0 +1,210 @@
+import { checkDocument } from "../application/check.js";
+import { applyTextEdits, normalizeTextEdits, } from "../mutation/text-edits.js";
+const bareTagPattern = /^[A-Za-z][A-Za-z0-9_-]*$/;
+function splitPhysicalLines(text) {
+    if (text.length === 0)
+        return [];
+    const lines = [];
+    let start = 0;
+    let line = 0;
+    while (start < text.length) {
+        const newline = text.indexOf("\n", start);
+        const rawEnd = newline === -1 ? text.length : newline;
+        const end = rawEnd > start && text[rawEnd - 1] === "\r" ? rawEnd - 1 : rawEnd;
+        lines.push({ text: text.slice(start, end), start, end, line });
+        if (newline === -1)
+            break;
+        start = newline + 1;
+        line += 1;
+    }
+    return lines;
+}
+function majorLineEnding(text) {
+    let lf = 0;
+    let crlf = 0;
+    let first;
+    for (let index = 0; index < text.length; index += 1) {
+        if (text[index] !== "\n")
+            continue;
+        const ending = index > 0 && text[index - 1] === "\r" ? "\r\n" : "\n";
+        first ??= ending;
+        if (ending === "\r\n")
+            crlf += 1;
+        else
+            lf += 1;
+    }
+    if (crlf === lf)
+        return first ?? "\n";
+    return crlf > lf ? "\r\n" : "\n";
+}
+function canonicalDecimal(value) {
+    const digits = value.digits.toString().padStart(value.scale + 1, "0");
+    const wholeEnd = digits.length - value.scale;
+    const whole = digits.slice(0, wholeEnd).replace(/^0+(?=\d)/, "");
+    const fraction = digits.slice(wholeEnd).replace(/0+$/, "");
+    return fraction === "" ? whole : `${whole}.${fraction}`;
+}
+function canonicalDuration(value) {
+    return `${canonicalDecimal(value)}${value.suffix}`;
+}
+function isDurationValue(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "digits" in value &&
+        typeof value.digits === "bigint" &&
+        "scale" in value &&
+        typeof value.scale === "number" &&
+        "suffix" in value &&
+        (value.suffix === "d" || value.suffix === "h" || value.suffix === "p"));
+}
+function isVelocityValue(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "points" in value &&
+        isDurationValue(value.points) &&
+        value.points.suffix === "p" &&
+        "period" in value &&
+        isDurationValue(value.period) &&
+        (value.period.suffix === "d" || value.period.suffix === "h"));
+}
+function canonicalFieldValue(field) {
+    if (["title", "description", "owner", "source", "blocked_reason", "reason"].includes(field.name)) {
+        return typeof field.value === "string" ? JSON.stringify(field.value) : undefined;
+    }
+    if (["version", "capacity", "priority"].includes(field.name)) {
+        return typeof field.value === "number" ? String(field.value) : undefined;
+    }
+    if (["duration", "critical_epsilon", "target_duration", "optimistic", "most_likely", "pessimistic"].includes(field.name)) {
+        return isDurationValue(field.value) ? canonicalDuration(field.value) : undefined;
+    }
+    if (field.name === "velocity") {
+        return isVelocityValue(field.value)
+            ? `${canonicalDuration(field.value.points)}/${canonicalDuration(field.value.period)}`
+            : undefined;
+    }
+    if (field.name === "tags" && Array.isArray(field.value)) {
+        const tags = field.value.filter((value) => typeof value === "string");
+        if (tags.length !== field.value.length)
+            return undefined;
+        return `[${tags.map((tag) => (bareTagPattern.test(tag) ? tag : JSON.stringify(tag))).join(", ")}]`;
+    }
+    return field.rawValue === "" ? undefined : field.rawValue;
+}
+function requirementValues(field) {
+    if (field.name !== "requires" || !Array.isArray(field.value))
+        return [];
+    return field.value.filter((value) => typeof value === "object" &&
+        value !== null &&
+        "units" in value &&
+        typeof value.units === "number" &&
+        "unitsSpan" in value);
+}
+function pushEdit(edits, text, edit) {
+    if (text.slice(edit.startOffset, edit.endOffset) !== edit.replacement)
+        edits.push(edit);
+}
+export function formatDocument(text, options = {}) {
+    const checked = checkDocument(text, options);
+    if (!checked.ok) {
+        return {
+            ok: false,
+            documentId: checked.documentId,
+            changed: false,
+            formattedText: null,
+            edits: [],
+            diagnostics: checked.diagnostics,
+            diagnosticsTruncated: checked.diagnosticsTruncated,
+        };
+    }
+    const lines = splitPhysicalLines(text);
+    const lineEnding = majorLineEnding(text);
+    const edits = [];
+    for (const declaration of checked.document.declarations) {
+        pushEdit(edits, text, {
+            startOffset: declaration.headerSpan.start.offset,
+            endOffset: declaration.headerSpan.end.offset,
+            replacement: declaration.kind === "task" || declaration.kind === "gate"
+                ? `${declaration.kind} ${declaration.id} ${declaration.from} -> ${declaration.to}:`
+                : `${declaration.kind} ${declaration.id}:`,
+        });
+        for (const field of declaration.fields) {
+            const fieldLine = lines[field.span.start.line];
+            if (field.contentSpan !== undefined && typeof field.value === "string") {
+                const firstLine = lines[field.contentSpan.start.line];
+                const lastLine = lines[field.contentSpan.end.line];
+                const decodedLines = field.value.split("\n");
+                const physicalLines = lines.slice(firstLine.line, lastLine.line + 1);
+                if (decodedLines.length !== physicalLines.length) {
+                    throw new Error("block text decoded line count does not match its source span");
+                }
+                pushEdit(edits, text, {
+                    startOffset: fieldLine.start,
+                    endOffset: fieldLine.end,
+                    replacement: `  ${field.name} |`,
+                });
+                const replacement = decodedLines
+                    .map((decoded, index) => decoded === "" ? physicalLines[index].text : `    ${decoded}`)
+                    .join(lineEnding);
+                pushEdit(edits, text, {
+                    startOffset: firstLine.start,
+                    endOffset: lastLine.end,
+                    replacement,
+                });
+            }
+            else if (field.children !== undefined || field.name === "requires") {
+                pushEdit(edits, text, {
+                    startOffset: fieldLine.start,
+                    endOffset: fieldLine.end,
+                    replacement: `  ${field.name}:`,
+                });
+            }
+            else {
+                const replacement = canonicalFieldValue(field);
+                if (replacement !== undefined) {
+                    pushEdit(edits, text, {
+                        startOffset: fieldLine.start,
+                        endOffset: fieldLine.end,
+                        replacement: `  ${field.name} ${replacement}`,
+                    });
+                }
+            }
+            for (const child of field.children ?? []) {
+                const replacement = canonicalFieldValue(child);
+                if (replacement !== undefined) {
+                    const childLine = lines[child.span.start.line];
+                    pushEdit(edits, text, {
+                        startOffset: childLine.start,
+                        endOffset: childLine.end,
+                        replacement: `    ${child.name} ${replacement}`,
+                    });
+                }
+            }
+            for (const requirement of requirementValues(field)) {
+                const requirementLine = lines[requirement.span.start.line];
+                pushEdit(edits, text, {
+                    startOffset: requirementLine.start,
+                    endOffset: requirementLine.end,
+                    replacement: `    ${requirement.resourceId} ${requirement.units}`,
+                });
+            }
+        }
+    }
+    if (!text.endsWith("\n")) {
+        edits.push({ startOffset: text.length, endOffset: text.length, replacement: lineEnding });
+    }
+    const normalizedEdits = normalizeTextEdits(text, edits, "formatter");
+    const formattedText = applyTextEdits(text, normalizedEdits);
+    const candidate = checkDocument(formattedText, options);
+    if (!candidate.ok)
+        throw new Error("formatter produced an invalid candidate document");
+    return {
+        ok: true,
+        documentId: candidate.documentId,
+        changed: formattedText !== text,
+        formattedText,
+        edits: normalizedEdits,
+        diagnostics: candidate.diagnostics,
+        diagnosticsTruncated: candidate.diagnosticsTruncated,
+    };
+}
+//# sourceMappingURL=source-formatter.js.map

package/dist/formatter/source-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-formatter.js","sourceRoot":"","sources":["../../src/formatter/source-formatter.ts"],"names":[],"mappings":"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"}

package/dist/help/registry.d.ts

@@ -0,0 +1,37 @@
+import type { Diagnostic } from "../model/diagnostics.js";
+export type HelpLevel = "index" | "quick" | "detail";
+export interface HelpSection {
+    readonly id: string;
+    readonly title: string;
+    readonly body: string;
+}
+export interface HelpExample {
+    readonly id: string;
+    readonly title: string;
+    readonly text: string;
+}
+export interface HelpNode {
+    readonly id: string;
+    readonly title: string;
+    readonly summary: string;
+    readonly quick: readonly HelpSection[];
+    readonly detail: readonly HelpSection[];
+    readonly syntax: readonly string[];
+    readonly examples: readonly HelpExample[];
+    readonly related: readonly string[];
+}
+export interface HelpResult {
+    readonly ok: boolean;
+    readonly topicId: string | null;
+    readonly level: HelpLevel;
+    readonly title: string;
+    readonly summary: string;
+    readonly sections: readonly HelpSection[];
+    readonly syntax: readonly string[];
+    readonly examples: readonly HelpExample[];
+    readonly related: readonly string[];
+    readonly topics: readonly Pick<HelpNode, "id" | "title" | "summary">[];
+    readonly diagnostics: readonly Diagnostic[];
+}
+export declare function getHelp(topicId: string | null, level: HelpLevel): HelpResult;
+//# sourceMappingURL=registry.d.ts.map

package/dist/help/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/help/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,SAAS,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,CAAC,EAAE,CAAC;IACvE,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;CAC7C;AA6lBD,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,SAAS,GAAG,UAAU,CAsD5E"}