@rackbops/ac-plugin-contract 2.0.0-alpha.43 → 2.0.0-alpha.45

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/dist/slots.d.ts +12 -0
  2. package/package.json +1 -1
package/dist/slots.d.ts CHANGED
@@ -119,6 +119,18 @@ export interface ArtifactNode {
119
119
  * serves it from its docroot), else the `.md` source path, which that route does not serve (it reads the
120
120
  * docroot only; read the text through `source`). Report nodes only (#97). */
121
121
  href?: string;
122
+ /** A report's render status, as the provider's own `GET /tree` reports it (#99). `state` is `rendered`
123
+ * when the page is current with its markdown source, `stale` when the markdown changed after the page
124
+ * was rendered, `missing` when there is no rendered page, `unknown` when the provider cannot say.
125
+ * `sourceHash` is the hash the rendered page records of the markdown it was rendered from (weft's
126
+ * content-hash recipe: a leading BOM dropped, CRLF turned into LF, SHA-256 of the UTF-8 text, the first
127
+ * 16 hex characters); absent when the page records none or has no markdown source. `reason` is
128
+ * `unstamped` when `state` is `unknown` because the page records no hash at all. Report nodes only. */
129
+ render?: {
130
+ state: "rendered" | "stale" | "missing" | "unknown";
131
+ sourceHash?: string;
132
+ reason?: "unstamped";
133
+ };
122
134
  }
123
135
  /** One `search` result: a section of one report. */
124
136
  export interface ArtifactSearchHit {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@rackbops/ac-plugin-contract",
3
- "version": "2.0.0-alpha.43",
3
+ "version": "2.0.0-alpha.45",
4
4
  "private": false,
5
5
  "type": "module",
6
6
  "description": "The artifact-console plugin ABI for out-of-repo plugin authors: HostApi, the acPlugin manifest contribution points, the generated manifest JSON Schema, and the @ac/host ambient browser declaration.",