@knkcs/contenthub-ui 0.2.0 → 0.3.1

package/dist/testing.d.ts

@@ -182,6 +182,11 @@ declare interface ChangeSetStatusInfo {
     name: string;
     /** Its colour as statushub holds it (a CSS colour); absent for none. */
     color?: string;
+    /**
+     * statushub's default for the catalogue: what a Change Set without a
+     * status reads as (ADR 0014 D9). At most one status has it.
+     */
+    isDefault?: boolean;
 }
 
 /** What `updateChangeSet` changes of a Change Set. */
@@ -660,6 +665,14 @@ declare interface ContenthubClient {
      * `ServiceUnavailableError` while blueprinthub gives no answer.
      */
     listBlueprintReleases(blueprintId: string): Promise<BlueprintReleaseInfo[]>;
+    /**
+     * Names the Blueprints of these ids, archived ones and ones without a
+     * Release included, so existing Content stays readable after its
+     * Blueprint is retired (#241). An unknown id, or one of another
+     * workspace, is left out. At most `MAX_BLUEPRINT_IDS`. Rejects with
+     * `ServiceUnavailableError` while blueprinthub gives no answer.
+     */
+    getBlueprints(ids: string[]): Promise<BlueprintInfo[]>;
     /**
      * Creates a Content in an open Change Set, pinning a Blueprint Release,
      * with empty data: its one Chain has one Branch, opened in the Branch
@@ -706,12 +719,15 @@ declare interface ContenthubClient {
     }): Promise<Content>;
     /**
      * One Content with its Blueprint Release and attributes: on Main, or
-     * inside `changeSetId`. Content born in an open Change Set exists only
-     * there, so read anywhere else it is a NotFound ConnectError.
+     * inside `changeSetId`, at the head of its Chain's last Branch, or of
+     * `branchId`, a Branch of that Chain, when given (#252). Content born in
+     * an open Change Set exists only there, so read anywhere else it is a
+     * NotFound ConnectError, as is a Branch outside the Chain.
      */
     getContent(input: {
         id: string;
         changeSetId?: string;
+        branchId?: string;
     }): Promise<ContentDetail>;
     /** Its Timeline, with the Planned Releases of open Change Sets beside it. */
     getTimeline(contentId: string): Promise<ContentTimeline>;
@@ -1313,7 +1329,8 @@ declare interface RevisionList {
  * The port a host fills with statushub (ADR 0020): the workspace's Change Set
  * statuses, for their display names and colours. contenthub-ui depends on no
  * statushub package. A host without statushub leaves the port empty, and the
- * screens then show the bare slug and offer no status picker.
+ * screens then show the bare slug and offer no status picker. The status
+ * marked `isDefault` names a Change Set that has none yet (ADR 0014 D9).
  */
 declare interface StatusSource {
     /** Every status of the workspace's `contenthub/change_set` catalogue, in its order. */
@@ -1434,10 +1451,13 @@ export declare interface StubContenthubClientOptions {
     /** The workspace's Content, every way it can be read; the fixtures' by default. */
     contents?: StubContent[];
     /**
-     * The workspace's content Blueprints Content can be made from, as
-     * `searchBlueprints` lists them; the fixtures' by default.
+     * The workspace's content Blueprints, as `getBlueprints` names them;
+     * the fixtures' by default. `searchBlueprints` lists those Content can
+     * be made from: not `archived`, with a Release.
      */
-    blueprints?: BlueprintInfo[];
+    blueprints?: (BlueprintInfo & {
+        archived?: boolean;
+    })[];
     /**
      * The Blueprint Releases, newest first per Blueprint, as
      * `listBlueprintReleases` lists them; the fixtures' by default.