@inflexa-ai/harness 0.31.0 → 0.32.0

package/dist/report-render/page.d.ts

@@ -22,6 +22,14 @@ export declare const ASSET_HEAD: string;
  * whole directory.
  */
 export declare const GRID_ASSET_HEAD: string;
+/**
+ * The head reference of the provenance library.
+ *
+ * The library walks the chain of one pin, and a page with no provenance document holds no pin to walk.
+ * Thus the skeleton writes this tag only for a page that carries the document, and the manifest still
+ * stages the file for the whole directory.
+ */
+export declare const LINEAGE_ASSET_HEAD: string;
 /**
  * The name of the readiness event, and the name of the window sentinel that guards a late listener. The
  * bootstrap below emits both names, thus this module owns them. A capture that waits for the page reads the
@@ -181,3 +189,70 @@ export declare const TABLE_CELL_FORMATTER = "function formatCell(cell, kind, bou
  * it must never stop a sibling grid and it must never throw out of the page.
  */
 export declare const GRID_BOOTSTRAP: string;
+/**
+ * The name of the provenance library on the page.
+ *
+ * The browser bundle of the package declares this one global, and the page and the library meet there and
+ * nowhere else. The renderer imports no API of the library, thus the two ship apart.
+ *
+ * A page whose staged libraries were stripped registers no such global. That absence is a normal
+ * condition: the popover still opens, and it shows the pin as the last hop under an explicit note.
+ */
+export declare const TSPROV_GLOBAL = "tsprov";
+/** The note of a page that carries no lineage library. The chain then stops at the pin of the block. */
+export declare const LINEAGE_NO_LIBRARY_NOTE = "The lineage library is not on this page. Thus the chain stops at this pin.";
+/** The note of a library call that gave no answer. The pin stays the last hop that the page knows. */
+export declare const LINEAGE_NO_ANSWER_NOTE = "The lineage library gave no answer for this pin. Thus the chain stops here.";
+/** The note of a pin that the document holds no node for. */
+export declare const LINEAGE_NO_NODE_NOTE = "The document holds no node for this pin. Thus the chain stops here.";
+/** The note of a chain that the library cut at its own depth bound. */
+export declare const LINEAGE_TRUNCATED_NOTE = "The library cut this chain at its depth bound. Thus the chain continues past the last hop.";
+/** The note of an external record. A paper is no artifact, thus no data chain reaches it. */
+export declare const LINEAGE_RECORD_NOTE = "An external record has no data chain. Thus this reference ends at the record.";
+/**
+ * The footer note of a chain that reached the raw data.
+ *
+ * The signed form states the attestation, and the page carries one only where the source held one. Thus
+ * the footer never claims a signature that the page does not hold.
+ */
+export declare const LINEAGE_COMPLETE_NOTE = "The chain is complete \u00B7 each hop is content-addressed";
+export declare const LINEAGE_SIGNED_NOTE = "The chain is complete \u00B7 each hop is content-addressed \u00B7 an attestation covers it";
+/**
+ * The page-side script of the lineage popover.
+ *
+ * A grounded block stamps its block id and its keys. A control beside a marker names the place of its key
+ * in that stamp. Thus the script reads the markup for everything that it shows, and it holds no copy of the
+ * document model.
+ *
+ * One delegated listener serves the whole page. It opens the panel of the clicked control, it closes the
+ * open panel when a second control opens its own, and it closes on a click outside the panel and on the
+ * `Escape` key. As a result at most one panel stands at one time, and the page needs no listener for each
+ * control.
+ *
+ * The panel is a child of the body, positioned against the document. A card clips its own overflow, thus a
+ * panel inside a card would show as a strip. The position reads the box of the control, and it holds the
+ * panel inside the viewport on each side. The panel opens under the control, and it opens over the control
+ * where the space under it is short. It never covers the control that opened it: where neither side holds
+ * the whole panel, the body shrinks instead. A resize invalidates the measure, thus a resize places the
+ * open panel again.
+ *
+ * The rail comes from the edges of the walk and never from its node set. A `generated` edge binds an
+ * artifact to the command that made it, and a `used` edge binds that command to a file that it read. Each
+ * input file continues the rail with its own producer, down to a file that no command made. Thus the panel
+ * shows the chain and it shows nothing else: a sibling output collapses behind one count row, and a step,
+ * a run, and an agent never become a row.
+ *
+ * The panel takes the width of its longest row, up to the cap of the sheet. Thus a normal window shows each
+ * name whole, and the cut answers a window too narrow for the row. The fit measures against the width of the
+ * laid-out panel, which the open pins before the first cut. Without the pin a cut would shrink the panel and
+ * the next measure would read a narrower box, thus the rows would cut each other down.
+ *
+ * The hover of a row gives the whole path, and it answers for the run prefix and for a cut alike.
+ *
+ * The script builds each node and it writes each string as text. Thus a hostile path, a hostile command,
+ * and a hostile step of the document reach the panel as text and never as markup.
+ *
+ * The page makes no request. The document rides the page already, and the library reads it in memory. The
+ * graph builds one time, on the first click, thus a reader who opens no panel pays nothing for the parse.
+ */
+export declare const LINEAGE_POPOVER: string;