@parhelia/core 0.3.12831 → 0.3.12833

package/dist/editor/validation/navigateToValidationIssue.js

@@ -0,0 +1,43 @@
+import { stripGuid } from "../utils";
+// All validation click-throughs open in this one shared slot (EditorSlot.tag).
+export const VALIDATION_SLOT_TAG = "validation";
+/**
+ * Opens the item a validation issue belongs to and focuses the field.
+ * Shared by the Validation sidebar rows and the issue popovers.
+ */
+export async function navigateToValidationIssue(editContext, target, setFocusedField) {
+    const itemDescriptor = {
+        id: target.itemId,
+        language: target.language,
+        version: target.version,
+    };
+    const slots = editContext.editorSlots ?? [];
+    const openSlot = slots.find((slot) => stripGuid(slot.itemDescriptor?.id ?? "") === stripGuid(itemDescriptor.id) &&
+        slot.itemDescriptor?.language?.toLowerCase() ===
+            itemDescriptor.language?.toLowerCase() &&
+        slot.itemDescriptor?.version === itemDescriptor.version);
+    if (openSlot) {
+        editContext.setActiveSlot(openSlot.slotId);
+    }
+    else {
+        // Open the result in the shared validation slot instead of replacing the
+        // reviewed page: replacing the page collapses the workbox scope and
+        // re-scopes the validation list to the single clicked item. Every click
+        // routes into the same tagged slot, so stepping through results never
+        // accumulates panes.
+        const validationSlot = slots.find((slot) => slot.tag === VALIDATION_SLOT_TAG);
+        const loadedItem = await editContext.loadItem(itemDescriptor, validationSlot
+            ? { targetSlotId: validationSlot.slotId }
+            : { openInNewSlot: true, newSlotTag: VALIDATION_SLOT_TAG });
+        if (!loadedItem)
+            return;
+    }
+    // Selection first: it keeps the component highlighted on its page canvas,
+    // and the focus-clearing effect only retains focusedField while
+    // selection[0] matches its item id.
+    editContext.select?.([target.itemId]);
+    if (target.fieldId) {
+        await setFocusedField?.({ item: itemDescriptor, fieldId: target.fieldId }, false);
+    }
+}
+//# sourceMappingURL=navigateToValidationIssue.js.map

package/dist/editor/validation/navigateToValidationIssue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigateToValidationIssue.js","sourceRoot":"","sources":["../../../src/editor/validation/navigateToValidationIssue.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,+EAA+E;AAC/E,MAAM,CAAC,MAAM,mBAAmB,GAAG,YAAY,CAAC;AAShD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,WAA4B,EAC5B,MAA6B,EAC7B,eAAqE;IAErE,MAAM,cAAc,GAAG;QACrB,EAAE,EAAE,MAAM,CAAC,MAAM;QACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC;IAEF,MAAM,KAAK,GAAG,WAAW,CAAC,WAAW,IAAI,EAAE,CAAC;IAC5C,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CACzB,CAAC,IAAI,EAAE,EAAE,CACP,SAAS,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,SAAS,CAAC,cAAc,CAAC,EAAE,CAAC;QACzE,IAAI,CAAC,cAAc,EAAE,QAAQ,EAAE,WAAW,EAAE;YAC1C,cAAc,CAAC,QAAQ,EAAE,WAAW,EAAE;QACxC,IAAI,CAAC,cAAc,EAAE,OAAO,KAAK,cAAc,CAAC,OAAO,CAC1D,CAAC;IAEF,IAAI,QAAQ,EAAE,CAAC;QACb,WAAW,CAAC,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;SAAM,CAAC;QACN,yEAAyE;QACzE,oEAAoE;QACpE,wEAAwE;QACxE,sEAAsE;QACtE,qBAAqB;QACrB,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAC/B,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,mBAAmB,CAC3C,CAAC;QACF,MAAM,UAAU,GAAG,MAAM,WAAW,CAAC,QAAQ,CAC3C,cAAc,EACd,cAAc;YACZ,CAAC,CAAC,EAAE,YAAY,EAAE,cAAc,CAAC,MAAM,EAAE;YACzC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,UAAU,EAAE,mBAAmB,EAAE,CAC7D,CAAC;QACF,IAAI,CAAC,UAAU;YAAE,OAAO;IAC1B,CAAC;IAED,0EAA0E;IAC1E,gEAAgE;IAChE,oCAAoC;IACpC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACtC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,eAAe,EAAE,CACrB,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,EACjD,KAAK,CACN,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/editor/validation/validationFixAgent.d.ts

@@ -0,0 +1,26 @@
+import { SingleValidatorResult } from "../../types";
+import { EditContextType } from "../client/editContext";
+import { ItemDescriptor } from "../pageModel";
+export type ValidationFixTarget = {
+    /** The item the issues belong to (a page or an embedded component item). */
+    item: ItemDescriptor;
+    issues: readonly SingleValidatorResult[];
+    /** Set when the button was clicked on a single field of the item. */
+    field?: {
+        fieldId: string;
+        fieldName?: string;
+    };
+};
+export declare function hasAgentsPanel(editContext?: EditContextType): boolean;
+/**
+ * Prompt for the agent. The vocabulary (field, validator, level, message)
+ * mirrors the validate-items tool's findings so the agent can match them
+ * after re-running the validation.
+ */
+export declare function buildValidationFixPrompt(target: ValidationFixTarget): string;
+/**
+ * Opens the Agents panel and starts a new agent that fixes the given
+ * validation issues. Mirrors openAiAgentForComment (reviews/commentAi.ts).
+ * Returns false when nothing was started (no panel, quota exceeded, error).
+ */
+export declare function openAiAgentForValidationIssues(target: ValidationFixTarget, editContext?: EditContextType): boolean;

package/dist/editor/validation/validationFixAgent.js

@@ -0,0 +1,124 @@
+import { stripGuid } from "../utils";
+import { getValidationSeverity, validationSeverityStyles, } from "./validationSeverity";
+export function hasAgentsPanel(editContext) {
+    return !!editContext?.configuration?.editor?.sidebars?.some((sidebar) => sidebar.id === "agents-panel");
+}
+function describeItem(item, fallbackName) {
+    const name = item.displayName || item.name || fallbackName || item.id;
+    const details = [
+        item.path,
+        item.language ? `${item.language} v${item.version ?? 0}` : undefined,
+    ].filter(Boolean);
+    return details.length ? `"${name}" (${details.join(", ")})` : `"${name}"`;
+}
+/**
+ * Prompt for the agent. The vocabulary (field, validator, level, message)
+ * mirrors the validate-items tool's findings so the agent can match them
+ * after re-running the validation.
+ */
+export function buildValidationFixPrompt(target) {
+    const { item, issues, field } = target;
+    const scope = field
+        ? `, field "${field.fieldName || issues[0]?.fieldName || field.fieldId}"`
+        : "";
+    const lines = issues.map((issue) => {
+        const level = validationSeverityStyles[getValidationSeverity(issue.result)]
+            .label;
+        const fieldPart = !field && issue.fieldName ? ` — Field "${issue.fieldName}"` : "";
+        return `- [${level}] ${issue.validator}${fieldPart}: ${issue.message}`;
+    });
+    return [
+        `Fix the following validation ${issues.length === 1 ? "issue" : "issues"} on ${describeItem(item, issues[0]?.itemName)}${scope}:`,
+        ...lines,
+        "",
+        "Make the smallest content change that resolves each issue, then run validate-items on this item to confirm nothing is left, and summarize what you changed.",
+    ].join("\n");
+}
+/**
+ * Opens the Agents panel and starts a new agent that fixes the given
+ * validation issues. Mirrors openAiAgentForComment (reviews/commentAi.ts).
+ * Returns false when nothing was started (no panel, quota exceeded, error).
+ */
+export function openAiAgentForValidationIssues(target, editContext) {
+    if (!editContext)
+        return false;
+    if (!hasAgentsPanel(editContext))
+        return false;
+    if (target.issues.length === 0)
+        return false;
+    if (editContext.isQuotaExceeded) {
+        editContext.showToast?.("AI quota exceeded. Please try again later or adjust settings.");
+        return false;
+    }
+    try {
+        if (editContext.isMobile) {
+            editContext.openSidebar("agents-panel");
+        }
+        else {
+            editContext.setShowAgentsPanel(true);
+        }
+        const { item, issues, field } = target;
+        const itemName = item.name || issues[0]?.itemName;
+        const targetItem = {
+            id: item.id,
+            language: item.language,
+            version: item.version,
+            name: itemName,
+            path: item.path,
+        };
+        // The loaded page gives the agent the surrounding context when the
+        // issues sit on an embedded component item of that page.
+        const pageItem = editContext.item;
+        const pageDiffers = !!pageItem?.id && stripGuid(pageItem.id) !== stripGuid(item.id);
+        const items = pageDiffers
+            ? [
+                {
+                    id: pageItem.id,
+                    language: pageItem.language,
+                    version: pageItem.version,
+                    name: pageItem.name,
+                    path: pageItem.path,
+                },
+                targetItem,
+            ]
+            : [targetItem];
+        const metadata = {
+            items,
+            currentItemId: item.id,
+            field: field
+                ? {
+                    fieldId: field.fieldId,
+                    fieldName: field.fieldName || issues[0]?.fieldName,
+                    item: targetItem,
+                }
+                : undefined,
+            additionalData: {
+                initialPrompt: buildValidationFixPrompt(target),
+                profileId: editContext.parheliaSettings?.validationFixProfileId || undefined,
+                profileName: editContext.parheliaSettings?.validationFixProfileName || undefined,
+            },
+        };
+        const dispatchEvent = () => {
+            try {
+                window.dispatchEvent(new CustomEvent("editor:addNewAgent", {
+                    detail: { metadata },
+                }));
+            }
+            catch { }
+        };
+        if (editContext.isMobile) {
+            // Mobile: the sidebar needs a moment to mount and start listening.
+            setTimeout(dispatchEvent, 500);
+        }
+        else {
+            dispatchEvent();
+        }
+        return true;
+    }
+    catch (e) {
+        console.error("Failed to start agent for validation issues:", e);
+        editContext.showToast?.("Failed to start AI agent for these issues.");
+        return false;
+    }
+}
+//# sourceMappingURL=validationFixAgent.js.map

package/dist/editor/validation/validationFixAgent.js.map

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

package/dist/editor/validation/validationRulerIssues.d.ts

@@ -0,0 +1,17 @@
+import type { ValidationResult } from "../../types";
+import type { FieldDescriptor } from "../pageModel";
+import { type ValidationSeverity } from "./validationSeverity";
+/** The validation issues of one field, as the canvas overview ruler marks them. */
+export type ValidationRulerIssue = {
+    key: string;
+    field: FieldDescriptor;
+    severity: ValidationSeverity;
+    /** Distinct messages, worst first. */
+    messages: string[];
+};
+/**
+ * One entry per field with issues (results above "Valid"), carrying the worst
+ * severity and every distinct message. Issues without a field have no place
+ * on the canvas and are left to the Validation sidebar.
+ */
+export declare function collectValidationRulerIssues(validationResults: readonly ValidationResult[] | undefined): ValidationRulerIssue[];

package/dist/editor/validation/validationRulerIssues.js

@@ -0,0 +1,44 @@
+import { filterValidationIssues, getWorstValidationSeverity, } from "./validationSeverity";
+/**
+ * One entry per field with issues (results above "Valid"), carrying the worst
+ * severity and every distinct message. Issues without a field have no place
+ * on the canvas and are left to the Validation sidebar.
+ */
+export function collectValidationRulerIssues(validationResults) {
+    const byField = new Map();
+    for (const validation of validationResults ?? []) {
+        for (const result of filterValidationIssues(validation.results)) {
+            if (!result.fieldId)
+                continue;
+            const item = {
+                id: result.itemId || validation.item.id,
+                language: validation.item.language,
+                version: validation.item.version,
+            };
+            const key = [
+                item.id.toLowerCase(),
+                item.language,
+                item.version,
+                result.fieldId.toLowerCase(),
+            ].join("|");
+            const entry = byField.get(key) ?? {
+                field: { item, fieldId: result.fieldId },
+                results: [],
+            };
+            entry.results.push(result);
+            byField.set(key, entry);
+        }
+    }
+    return Array.from(byField, ([key, { field, results }]) => {
+        const worstFirst = filterValidationIssues(results);
+        return {
+            key,
+            field,
+            severity: getWorstValidationSeverity(worstFirst),
+            messages: Array.from(new Set(worstFirst
+                .map((result) => result.message?.trim())
+                .filter((message) => !!message))),
+        };
+    });
+}
+//# sourceMappingURL=validationRulerIssues.js.map

package/dist/editor/validation/validationRulerIssues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validationRulerIssues.js","sourceRoot":"","sources":["../../../src/editor/validation/validationRulerIssues.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,sBAAsB,EACtB,0BAA0B,GAE3B,MAAM,sBAAsB,CAAC;AAW9B;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAC1C,iBAA0D;IAE1D,MAAM,OAAO,GAAG,IAAI,GAAG,EAGpB,CAAC;IAEJ,KAAK,MAAM,UAAU,IAAI,iBAAiB,IAAI,EAAE,EAAE,CAAC;QACjD,KAAK,MAAM,MAAM,IAAI,sBAAsB,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAChE,IAAI,CAAC,MAAM,CAAC,OAAO;gBAAE,SAAS;YAC9B,MAAM,IAAI,GAAG;gBACX,EAAE,EAAE,MAAM,CAAC,MAAM,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE;gBACvC,QAAQ,EAAE,UAAU,CAAC,IAAI,CAAC,QAAQ;gBAClC,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,OAAO;aACjC,CAAC;YACF,MAAM,GAAG,GAAG;gBACV,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE;gBACrB,IAAI,CAAC,QAAQ;gBACb,IAAI,CAAC,OAAO;gBACZ,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE;aAC7B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACZ,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI;gBAChC,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE;gBACxC,OAAO,EAAE,EAA6B;aACvC,CAAC;YACF,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE;QACvD,MAAM,UAAU,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;QACnD,OAAO;YACL,GAAG;YACH,KAAK;YACL,QAAQ,EAAE,0BAA0B,CAAC,UAAU,CAAE;YACjD,QAAQ,EAAE,KAAK,CAAC,IAAI,CAClB,IAAI,GAAG,CACL,UAAU;iBACP,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;iBACvC,MAAM,CAAC,CAAC,OAAO,EAAqB,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CACrD,CACF;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/editor/validation/validationSeverity.d.ts

@@ -0,0 +1,15 @@
+import { AlertCircle } from "lucide-react";
+import { SingleValidatorResult } from "../../types";
+export type ValidationSeverity = "suggestion" | "warning" | "error";
+export declare function getValidationSeverity(result: SingleValidatorResult["result"] | number): ValidationSeverity;
+export declare const validationSeverityStyles: Record<ValidationSeverity, {
+    label: string;
+    icon: typeof AlertCircle;
+    text: string;
+    badge: string;
+    bar: string;
+}>;
+/** Keeps only results above "Valid", worst first. */
+export declare function filterValidationIssues<T extends SingleValidatorResult>(results: readonly T[] | undefined): T[];
+export declare function getWorstValidationSeverity(issues: readonly SingleValidatorResult[]): ValidationSeverity | undefined;
+export declare function formatValidationIssueCount(count: number): string;

package/dist/editor/validation/validationSeverity.js

@@ -0,0 +1,47 @@
+import { AlertCircle, AlertTriangle, Lightbulb } from "lucide-react";
+export function getValidationSeverity(result) {
+    if (result >= 4)
+        return "error";
+    if (result === 3)
+        return "warning";
+    return "suggestion";
+}
+export const validationSeverityStyles = {
+    error: {
+        label: "Error",
+        icon: AlertCircle,
+        text: "text-feedback-red",
+        badge: "bg-feedback-red-light text-feedback-red",
+        bar: "border-feedback-red",
+    },
+    warning: {
+        label: "Warning",
+        icon: AlertTriangle,
+        text: "text-feedback-orange",
+        badge: "bg-feedback-orange-light text-feedback-orange",
+        bar: "border-feedback-orange",
+    },
+    suggestion: {
+        label: "Suggestion",
+        icon: Lightbulb,
+        text: "text-feedback-blue",
+        badge: "bg-feedback-blue-light text-feedback-blue",
+        bar: "border-feedback-blue",
+    },
+};
+/** Keeps only results above "Valid", worst first. */
+export function filterValidationIssues(results) {
+    return [...(results ?? [])]
+        .filter((x) => x.result > 1)
+        .sort((a, b) => b.result - a.result);
+}
+export function getWorstValidationSeverity(issues) {
+    if (issues.length === 0)
+        return undefined;
+    const worst = issues.reduce((max, issue) => Math.max(max, issue.result), 0);
+    return getValidationSeverity(worst);
+}
+export function formatValidationIssueCount(count) {
+    return `${count} ${count === 1 ? "issue" : "issues"}`;
+}
+//# sourceMappingURL=validationSeverity.js.map

package/dist/editor/validation/validationSeverity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validationSeverity.js","sourceRoot":"","sources":["../../../src/editor/validation/validationSeverity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAQrE,MAAM,UAAU,qBAAqB,CACnC,MAAgD;IAEhD,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,OAAO,CAAC;IAChC,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACnC,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,CAAC,MAAM,wBAAwB,GASjC;IACF,KAAK,EAAE;QACL,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,mBAAmB;QACzB,KAAK,EAAE,yCAAyC;QAChD,GAAG,EAAE,qBAAqB;KAC3B;IACD,OAAO,EAAE;QACP,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,sBAAsB;QAC5B,KAAK,EAAE,+CAA+C;QACtD,GAAG,EAAE,wBAAwB;KAC9B;IACD,UAAU,EAAE;QACV,KAAK,EAAE,YAAY;QACnB,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,oBAAoB;QAC1B,KAAK,EAAE,2CAA2C;QAClD,GAAG,EAAE,sBAAsB;KAC5B;CACF,CAAC;AAEF,qDAAqD;AACrD,MAAM,UAAU,sBAAsB,CACpC,OAAiC;IAEjC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;SACxB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;SAC3B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,MAAwC;IAExC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CACzB,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,EAC3C,CAAW,CACZ,CAAC;IACF,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,KAAa;IACtD,OAAO,GAAG,KAAK,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;AACxD,CAAC"}

package/dist/lib/viewportClip.d.ts

@@ -0,0 +1,18 @@
+export type ViewportClipBounds = {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+};
+export type ViewportClipRect = {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+};
+export type ViewportClipOptions = {
+    horizontal?: boolean;
+    vertical?: boolean;
+};
+/** Clips a fixed-position overlay to the viewport that owns its anchor. */
+export declare function getViewportClipPath(rect: ViewportClipRect, bounds: ViewportClipBounds | undefined, options?: ViewportClipOptions): string | undefined;

package/dist/lib/viewportClip.js

@@ -0,0 +1,22 @@
+/** Clips a fixed-position overlay to the viewport that owns its anchor. */
+export function getViewportClipPath(rect, bounds, options = {}) {
+    if (!bounds)
+        return undefined;
+    const clipHorizontal = options.horizontal !== false;
+    const clipVertical = options.vertical !== false;
+    const right = rect.left + rect.width;
+    const bottom = rect.top + rect.height;
+    if ((clipHorizontal && (right <= bounds.left || rect.left >= bounds.right)) ||
+        (clipVertical && (bottom <= bounds.top || rect.top >= bounds.bottom))) {
+        return "inset(100%)";
+    }
+    const top = clipVertical ? Math.max(0, bounds.top - rect.top) : 0;
+    const rightInset = clipHorizontal ? Math.max(0, right - bounds.right) : 0;
+    const bottomInset = clipVertical ? Math.max(0, bottom - bounds.bottom) : 0;
+    const left = clipHorizontal ? Math.max(0, bounds.left - rect.left) : 0;
+    if (top === 0 && rightInset === 0 && bottomInset === 0 && left === 0) {
+        return undefined;
+    }
+    return `inset(${top}px ${rightInset}px ${bottomInset}px ${left}px)`;
+}
+//# sourceMappingURL=viewportClip.js.map

package/dist/lib/viewportClip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewportClip.js","sourceRoot":"","sources":["../../src/lib/viewportClip.ts"],"names":[],"mappings":"AAmBA,2EAA2E;AAC3E,MAAM,UAAU,mBAAmB,CACjC,IAAsB,EACtB,MAAsC,EACtC,OAAO,GAAwB,EAAE;IAEjC,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAE9B,MAAM,cAAc,GAAG,OAAO,CAAC,UAAU,KAAK,KAAK,CAAC;IACpD,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,KAAK,KAAK,CAAC;IAChD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;IACtC,IACE,CAAC,cAAc,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,CAAC,YAAY,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,EACrE,CAAC;QACD,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,MAAM,GAAG,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClE,MAAM,UAAU,GAAG,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1E,MAAM,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3E,MAAM,IAAI,GAAG,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEvE,IAAI,GAAG,KAAK,CAAC,IAAI,UAAU,KAAK,CAAC,IAAI,WAAW,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;QACrE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,SAAS,GAAG,MAAM,UAAU,MAAM,WAAW,MAAM,IAAI,KAAK,CAAC;AACtE,CAAC"}

package/dist/revision.d.ts

@@ -1,2 +1,2 @@
-export declare const version = "0.3.12831";
-export declare const buildDate = "2026-09-03 14:25:47";
+export declare const version = "0.3.12833";
+export declare const buildDate = "2026-10-06 15:19:23";

package/dist/revision.js

@@ -1,3 +1,3 @@
-export const version = "0.3.12831";
-export const buildDate = "2026-09-03 14:25:47";
+export const version = "0.3.12833";
+export const buildDate = "2026-10-06 15:19:23";
 //# sourceMappingURL=revision.js.map

package/dist/task-board/components/AttentionPromptDialog.d.ts

@@ -0,0 +1,13 @@
+import type { TaskItem } from "../types";
+/**
+ * Semi-modal prompt shown on the dashboard when tasks newly need the user
+ * (tool approval, questions, review, errors). It does not block the page:
+ * `modal={false}` keeps the rest of the board clickable and scrollable, and
+ * focus is left where it is when the user is typing somewhere else.
+ */
+export declare function AttentionPromptDialog({ tasks, onReview, onDismiss, }: {
+    /** Tasks to prompt for. An empty list closes the dialog. */
+    tasks: TaskItem[];
+    onReview: (taskId: string) => void;
+    onDismiss: () => void;
+}): import("react").JSX.Element;

package/dist/task-board/components/AttentionPromptDialog.js

@@ -0,0 +1,45 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useMemo } from "react";
+import { AlertCircle, HelpCircle } from "lucide-react";
+import { Button } from "../../components/ui/button";
+import { Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, } from "../../components/ui/dialog";
+import { cn } from "../../lib/utils";
+import { describeAttention, isFailedTask, } from "../utils/projectDashboardModel";
+function isEditableElement(element) {
+    if (!element)
+        return false;
+    const tag = element.tagName;
+    if (tag === "INPUT" || tag === "TEXTAREA" || tag === "SELECT")
+        return true;
+    return element.isContentEditable === true;
+}
+/**
+ * Semi-modal prompt shown on the dashboard when tasks newly need the user
+ * (tool approval, questions, review, errors). It does not block the page:
+ * `modal={false}` keeps the rest of the board clickable and scrollable, and
+ * focus is left where it is when the user is typing somewhere else.
+ */
+export function AttentionPromptDialog({ tasks, onReview, onDismiss, }) {
+    const entries = useMemo(() => tasks.map((task) => ({ task, ...describeAttention(task) })), [tasks]);
+    const open = entries.length > 0;
+    const description = entries.length === 1
+        ? "An agent needs you before it can continue."
+        : `${entries.length} agents need you before they can continue.`;
+    return (_jsx(Dialog, { open: open, modal: false, onOpenChange: (nextOpen) => {
+            if (!nextOpen)
+                onDismiss();
+        }, children: _jsxs(DialogContent, { "data-testid": "taskboard-attention-prompt", className: "max-w-md shadow-2xl", onOpenAutoFocus: (event) => {
+                // Never pull focus out of a field the user is typing in.
+                if (isEditableElement(document.activeElement)) {
+                    event.preventDefault();
+                }
+            }, children: [_jsxs(DialogHeader, { children: [_jsx(DialogTitle, { children: "Waiting for you" }), _jsx(DialogDescription, { children: description })] }), _jsx("div", { className: "flex flex-col px-8 py-4", children: entries.map(({ task, description: reason, action }) => {
+                        const asksQuestion = task.executionState === "Questions" ||
+                            task.executionState === "WaitingForInput";
+                        const Icon = asksQuestion ? HelpCircle : AlertCircle;
+                        return (_jsxs("div", { "data-testid": `taskboard-attention-prompt-task-${task.taskId}`, className: "border-border-default/70 grid grid-cols-[auto_minmax(0,1fr)_auto] items-center gap-3 border-t py-3 first:border-t-0", children: [_jsx(Icon, { strokeWidth: 1.5, "aria-hidden": "true", className: cn("size-4 shrink-0", isFailedTask(task)
+                                        ? "text-feedback-red"
+                                        : "text-feedback-orange") }), _jsxs("span", { className: "min-w-0", children: [_jsxs("span", { className: "text-neutral-grey-100 block truncate text-sm font-medium", children: [task.taskKey?.trim() ? (_jsx("span", { className: "text-neutral-grey-50 mr-1.5 text-[10px] font-medium tracking-widest", children: task.taskKey.trim() })) : null, task.title] }), _jsx("span", { className: "text-neutral-grey-50 block truncate text-xs", children: reason })] }), _jsx(Button, { type: "button", size: "sm", "data-testid": `taskboard-attention-prompt-review-${task.taskId}`, onClick: () => onReview(task.taskId), children: action })] }, task.taskId));
+                    }) }), _jsx(DialogFooter, { children: _jsx(Button, { type: "button", variant: "outline", "data-testid": "taskboard-attention-prompt-later", onClick: onDismiss, children: "Later" }) })] }) }));
+}
+//# sourceMappingURL=AttentionPromptDialog.js.map

package/dist/task-board/components/AttentionPromptDialog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AttentionPromptDialog.js","sourceRoot":"","sources":["../../../src/task-board/components/AttentionPromptDialog.tsx"],"names":[],"mappings":"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"}

package/dist/task-board/components/GoalFindingsTable.d.ts

@@ -0,0 +1,43 @@
+import type { Subgoal } from "../types";
+import { type GoalRecommendation, type GoalSeverity } from "./GoalDataView";
+/** One recommendation of one subgoal, flattened for a cross-page table. */
+export type GoalFinding = {
+    key: string;
+    subgoalId: string;
+    /** The page the finding belongs to: the subgoal's item path, else its title. */
+    page: string | null;
+    /** The subgoal's own item, opened from the page column. */
+    pageItemId: string | null;
+    /** The item the recommendation points at (often a component), else the page. */
+    itemId: string | null;
+    language: string | null;
+    severity: GoalSeverity | null;
+    text: string;
+    recommendation: GoalRecommendation;
+};
+/**
+ * Flattens the `recommendations` of every subgoal into findings, ordered by
+ * severity, then page, then the order the subgoal listed them in. Subgoals
+ * whose data carries no recommendations contribute nothing, so goal templates
+ * that never write them simply get no table.
+ */
+export declare function collectGoalFindings(subgoals: Subgoal[]): GoalFinding[];
+/** RFC 4180 CSV with a header row; one line per finding. */
+export declare function findingsToCsv(findings: GoalFinding[]): string;
+/**
+ * Every finding of the given subgoals as one flat, sortable table with a
+ * severity filter and a CSV export. Callers pass the subgoals that survive
+ * their own page-level filters, so a check or text filter narrows this too.
+ */
+export declare function GoalFindingsTable({ subgoals, query, exportName, onOpenItem, onCreateTaskFromRecommendation, }: {
+    subgoals: Subgoal[];
+    /** Whitespace-separated terms; every term must occur in the page or text. */
+    query?: string;
+    /** Base name for the CSV download, e.g. the goal title. */
+    exportName: string;
+    onOpenItem?: (ref: {
+        itemId: string;
+        language?: string | null;
+    }) => void;
+    onCreateTaskFromRecommendation?: (recommendation: GoalRecommendation) => void;
+}): import("react").JSX.Element;