keepset 0.23.0 → 0.25.0

package/dist/{categories-BGjPWXpS.d.ts → categories-zC2eMs6y.d.ts}

@@ -70,28 +70,29 @@ declare const ArchiveMemberSchema: z.ZodUnion<readonly [z.ZodObject<{
   extensions: z.ZodArray<z.ZodString>;
 }, z.core.$strict>]>;
 type ArchiveMember = z.infer<typeof ArchiveMemberSchema>;
-/** How the downloaded bytes unpack into the one file the parser reads. A workbook (`xlsx`) is read as the CSV of its named sheet, with dates as ISO 8601 text, for the `csv-table` parser. */
-declare const ArchiveSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+/** How the downloaded bytes unpack into the file the parser reads, or for a collection the files it reads one by one. A `members` selector gives every member it matches, at least one, in path order. A workbook (`xlsx`) is read as the CSV of its named sheet, with dates as ISO 8601 text, for the `csv-table` parser. */
+declare const ArchiveSchema: z.ZodUnion<readonly [z.ZodObject<{
   kind: z.ZodLiteral<"none">;
 }, z.core.$strict>, z.ZodObject<{
   kind: z.ZodLiteral<"gzip">;
 }, z.core.$strict>, z.ZodObject<{
-  kind: z.ZodLiteral<"zip">;
-  member: z.ZodUnion<readonly [z.ZodObject<{
-    path: z.ZodString;
-  }, z.core.$strict>, z.ZodObject<{
-    extensions: z.ZodArray<z.ZodString>;
-  }, z.core.$strict>]>;
-}, z.core.$strict>, z.ZodObject<{
-  kind: z.ZodLiteral<"tar">;
+  kind: z.ZodEnum<{
+    zip: "zip";
+    tar: "tar";
+    "tar.gz": "tar.gz";
+  }>;
   member: z.ZodUnion<readonly [z.ZodObject<{
     path: z.ZodString;
   }, z.core.$strict>, z.ZodObject<{
     extensions: z.ZodArray<z.ZodString>;
   }, z.core.$strict>]>;
 }, z.core.$strict>, z.ZodObject<{
-  kind: z.ZodLiteral<"tar.gz">;
-  member: z.ZodUnion<readonly [z.ZodObject<{
+  kind: z.ZodEnum<{
+    zip: "zip";
+    tar: "tar";
+    "tar.gz": "tar.gz";
+  }>;
+  members: z.ZodUnion<readonly [z.ZodObject<{
     path: z.ZodString;
   }, z.core.$strict>, z.ZodObject<{
     extensions: z.ZodArray<z.ZodString>;
@@ -99,7 +100,7 @@ declare const ArchiveSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strict>, z.ZodObject<{
   kind: z.ZodLiteral<"xlsx">;
   sheet: z.ZodString;
-}, z.core.$strict>], "kind">;
+}, z.core.$strict>]>;
 type Archive = z.infer<typeof ArchiveSchema>;
 /** A column of a table as the table parser names it: the header with every run of characters outside letters, digits and underscore replaced by one underscore, so it is a valid segment of a twindex path. */
 declare const ColumnNameSchema: z.ZodString;
@@ -139,6 +140,24 @@ declare const ParserSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     "utf-8": "utf-8";
     latin1: "latin1";
   }>;
+}, z.core.$strict>, z.ZodObject<{
+  format: z.ZodLiteral<"solomon">;
+  encoding: z.ZodEnum<{
+    "utf-8": "utf-8";
+    latin1: "latin1";
+  }>;
+}, z.core.$strict>, z.ZodObject<{
+  format: z.ZodLiteral<"top">;
+  encoding: z.ZodEnum<{
+    "utf-8": "utf-8";
+    latin1: "latin1";
+  }>;
+}, z.core.$strict>, z.ZodObject<{
+  format: z.ZodLiteral<"toptw">;
+  encoding: z.ZodEnum<{
+    "utf-8": "utf-8";
+    latin1: "latin1";
+  }>;
 }, z.core.$strict>, z.ZodObject<{
   format: z.ZodLiteral<"csv-table">;
   encoding: z.ZodEnum<{
@@ -187,27 +206,28 @@ declare const RecipeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"openfema">;
     pageSize: z.ZodInt;
   }, z.core.$strict>], "kind">>;
-  archive: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  archive: z.ZodUnion<readonly [z.ZodObject<{
     kind: z.ZodLiteral<"none">;
   }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"gzip">;
   }, z.core.$strict>, z.ZodObject<{
-    kind: z.ZodLiteral<"zip">;
-    member: z.ZodUnion<readonly [z.ZodObject<{
-      path: z.ZodString;
-    }, z.core.$strict>, z.ZodObject<{
-      extensions: z.ZodArray<z.ZodString>;
-    }, z.core.$strict>]>;
-  }, z.core.$strict>, z.ZodObject<{
-    kind: z.ZodLiteral<"tar">;
+    kind: z.ZodEnum<{
+      zip: "zip";
+      tar: "tar";
+      "tar.gz": "tar.gz";
+    }>;
     member: z.ZodUnion<readonly [z.ZodObject<{
       path: z.ZodString;
     }, z.core.$strict>, z.ZodObject<{
       extensions: z.ZodArray<z.ZodString>;
     }, z.core.$strict>]>;
   }, z.core.$strict>, z.ZodObject<{
-    kind: z.ZodLiteral<"tar.gz">;
-    member: z.ZodUnion<readonly [z.ZodObject<{
+    kind: z.ZodEnum<{
+      zip: "zip";
+      tar: "tar";
+      "tar.gz": "tar.gz";
+    }>;
+    members: z.ZodUnion<readonly [z.ZodObject<{
       path: z.ZodString;
     }, z.core.$strict>, z.ZodObject<{
       extensions: z.ZodArray<z.ZodString>;
@@ -215,7 +235,7 @@ declare const RecipeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"xlsx">;
     sheet: z.ZodString;
-  }, z.core.$strict>], "kind">;
+  }, z.core.$strict>]>;
   parser: z.ZodDiscriminatedUnion<[z.ZodObject<{
     format: z.ZodLiteral<"edge-list">;
     encoding: z.ZodEnum<{
@@ -251,6 +271,24 @@ declare const RecipeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       "utf-8": "utf-8";
       latin1: "latin1";
     }>;
+  }, z.core.$strict>, z.ZodObject<{
+    format: z.ZodLiteral<"solomon">;
+    encoding: z.ZodEnum<{
+      "utf-8": "utf-8";
+      latin1: "latin1";
+    }>;
+  }, z.core.$strict>, z.ZodObject<{
+    format: z.ZodLiteral<"top">;
+    encoding: z.ZodEnum<{
+      "utf-8": "utf-8";
+      latin1: "latin1";
+    }>;
+  }, z.core.$strict>, z.ZodObject<{
+    format: z.ZodLiteral<"toptw">;
+    encoding: z.ZodEnum<{
+      "utf-8": "utf-8";
+      latin1: "latin1";
+    }>;
   }, z.core.$strict>, z.ZodObject<{
     format: z.ZodLiteral<"csv-table">;
     encoding: z.ZodEnum<{
@@ -309,6 +347,7 @@ declare const EntrySchema: z.ZodObject<{
   category: z.ZodEnum<{
     "graph/v1": "graph/v1";
     "or/v1": "or/v1";
+    "or-set/v1": "or-set/v1";
   }>;
   sources: z.ZodArray<z.ZodObject<{
     url: z.ZodURL;
@@ -353,27 +392,28 @@ declare const EntrySchema: z.ZodObject<{
       kind: z.ZodLiteral<"openfema">;
       pageSize: z.ZodInt;
     }, z.core.$strict>], "kind">>;
-    archive: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    archive: z.ZodUnion<readonly [z.ZodObject<{
       kind: z.ZodLiteral<"none">;
     }, z.core.$strict>, z.ZodObject<{
       kind: z.ZodLiteral<"gzip">;
     }, z.core.$strict>, z.ZodObject<{
-      kind: z.ZodLiteral<"zip">;
-      member: z.ZodUnion<readonly [z.ZodObject<{
-        path: z.ZodString;
-      }, z.core.$strict>, z.ZodObject<{
-        extensions: z.ZodArray<z.ZodString>;
-      }, z.core.$strict>]>;
-    }, z.core.$strict>, z.ZodObject<{
-      kind: z.ZodLiteral<"tar">;
+      kind: z.ZodEnum<{
+        zip: "zip";
+        tar: "tar";
+        "tar.gz": "tar.gz";
+      }>;
       member: z.ZodUnion<readonly [z.ZodObject<{
         path: z.ZodString;
       }, z.core.$strict>, z.ZodObject<{
         extensions: z.ZodArray<z.ZodString>;
       }, z.core.$strict>]>;
     }, z.core.$strict>, z.ZodObject<{
-      kind: z.ZodLiteral<"tar.gz">;
-      member: z.ZodUnion<readonly [z.ZodObject<{
+      kind: z.ZodEnum<{
+        zip: "zip";
+        tar: "tar";
+        "tar.gz": "tar.gz";
+      }>;
+      members: z.ZodUnion<readonly [z.ZodObject<{
         path: z.ZodString;
       }, z.core.$strict>, z.ZodObject<{
         extensions: z.ZodArray<z.ZodString>;
@@ -381,7 +421,7 @@ declare const EntrySchema: z.ZodObject<{
     }, z.core.$strict>, z.ZodObject<{
       kind: z.ZodLiteral<"xlsx">;
       sheet: z.ZodString;
-    }, z.core.$strict>], "kind">;
+    }, z.core.$strict>]>;
     parser: z.ZodDiscriminatedUnion<[z.ZodObject<{
       format: z.ZodLiteral<"edge-list">;
       encoding: z.ZodEnum<{
@@ -417,6 +457,24 @@ declare const EntrySchema: z.ZodObject<{
         "utf-8": "utf-8";
         latin1: "latin1";
       }>;
+    }, z.core.$strict>, z.ZodObject<{
+      format: z.ZodLiteral<"solomon">;
+      encoding: z.ZodEnum<{
+        "utf-8": "utf-8";
+        latin1: "latin1";
+      }>;
+    }, z.core.$strict>, z.ZodObject<{
+      format: z.ZodLiteral<"top">;
+      encoding: z.ZodEnum<{
+        "utf-8": "utf-8";
+        latin1: "latin1";
+      }>;
+    }, z.core.$strict>, z.ZodObject<{
+      format: z.ZodLiteral<"toptw">;
+      encoding: z.ZodEnum<{
+        "utf-8": "utf-8";
+        latin1: "latin1";
+      }>;
     }, z.core.$strict>, z.ZodObject<{
       format: z.ZodLiteral<"csv-table">;
       encoding: z.ZodEnum<{
@@ -463,7 +521,7 @@ declare const EntrySchema: z.ZodObject<{
     id: string;
     name: string;
     tags: string[];
-    category: "graph/v1" | "or/v1";
+    category: "graph/v1" | "or/v1" | "or-set/v1";
     sources: {
       url: string;
       retrieved: string;
@@ -492,25 +550,18 @@ declare const EntrySchema: z.ZodObject<{
       status: "fetchable";
       source: number;
       archive: {
-        kind: "none";
-      } | {
-        kind: "gzip";
-      } | {
-        kind: "zip";
-        member: {
+        kind: "zip" | "tar" | "tar.gz";
+        members: {
           path: string;
         } | {
           extensions: string[];
         };
       } | {
-        kind: "tar";
-        member: {
-          path: string;
-        } | {
-          extensions: string[];
-        };
+        kind: "none";
+      } | {
+        kind: "gzip";
       } | {
-        kind: "tar.gz";
+        kind: "zip" | "tar" | "tar.gz";
         member: {
           path: string;
         } | {
@@ -559,6 +610,15 @@ declare const EntrySchema: z.ZodObject<{
       } | {
         format: "pajek";
         encoding: "utf-8" | "latin1";
+      } | {
+        format: "solomon";
+        encoding: "utf-8" | "latin1";
+      } | {
+        format: "top";
+        encoding: "utf-8" | "latin1";
+      } | {
+        format: "toptw";
+        encoding: "utf-8" | "latin1";
       };
       paging?: {
         kind: "arcgis-query";
@@ -692,6 +752,7 @@ declare const CatalogueIndexSchema: z.ZodObject<{
     category: z.ZodEnum<{
       "graph/v1": "graph/v1";
       "or/v1": "or/v1";
+      "or-set/v1": "or-set/v1";
     }>;
     sources: z.ZodArray<z.ZodObject<{
       url: z.ZodURL;
@@ -736,27 +797,28 @@ declare const CatalogueIndexSchema: z.ZodObject<{
         kind: z.ZodLiteral<"openfema">;
         pageSize: z.ZodInt;
       }, z.core.$strict>], "kind">>;
-      archive: z.ZodDiscriminatedUnion<[z.ZodObject<{
+      archive: z.ZodUnion<readonly [z.ZodObject<{
         kind: z.ZodLiteral<"none">;
       }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"gzip">;
       }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"zip">;
-        member: z.ZodUnion<readonly [z.ZodObject<{
-          path: z.ZodString;
-        }, z.core.$strict>, z.ZodObject<{
-          extensions: z.ZodArray<z.ZodString>;
-        }, z.core.$strict>]>;
-      }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"tar">;
+        kind: z.ZodEnum<{
+          zip: "zip";
+          tar: "tar";
+          "tar.gz": "tar.gz";
+        }>;
         member: z.ZodUnion<readonly [z.ZodObject<{
           path: z.ZodString;
         }, z.core.$strict>, z.ZodObject<{
           extensions: z.ZodArray<z.ZodString>;
         }, z.core.$strict>]>;
       }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"tar.gz">;
-        member: z.ZodUnion<readonly [z.ZodObject<{
+        kind: z.ZodEnum<{
+          zip: "zip";
+          tar: "tar";
+          "tar.gz": "tar.gz";
+        }>;
+        members: z.ZodUnion<readonly [z.ZodObject<{
           path: z.ZodString;
         }, z.core.$strict>, z.ZodObject<{
           extensions: z.ZodArray<z.ZodString>;
@@ -764,7 +826,7 @@ declare const CatalogueIndexSchema: z.ZodObject<{
       }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"xlsx">;
         sheet: z.ZodString;
-      }, z.core.$strict>], "kind">;
+      }, z.core.$strict>]>;
       parser: z.ZodDiscriminatedUnion<[z.ZodObject<{
         format: z.ZodLiteral<"edge-list">;
         encoding: z.ZodEnum<{
@@ -800,6 +862,24 @@ declare const CatalogueIndexSchema: z.ZodObject<{
           "utf-8": "utf-8";
           latin1: "latin1";
         }>;
+      }, z.core.$strict>, z.ZodObject<{
+        format: z.ZodLiteral<"solomon">;
+        encoding: z.ZodEnum<{
+          "utf-8": "utf-8";
+          latin1: "latin1";
+        }>;
+      }, z.core.$strict>, z.ZodObject<{
+        format: z.ZodLiteral<"top">;
+        encoding: z.ZodEnum<{
+          "utf-8": "utf-8";
+          latin1: "latin1";
+        }>;
+      }, z.core.$strict>, z.ZodObject<{
+        format: z.ZodLiteral<"toptw">;
+        encoding: z.ZodEnum<{
+          "utf-8": "utf-8";
+          latin1: "latin1";
+        }>;
       }, z.core.$strict>, z.ZodObject<{
         format: z.ZodLiteral<"csv-table">;
         encoding: z.ZodEnum<{
@@ -846,7 +926,7 @@ declare const CatalogueIndexSchema: z.ZodObject<{
       id: string;
       name: string;
       tags: string[];
-      category: "graph/v1" | "or/v1";
+      category: "graph/v1" | "or/v1" | "or-set/v1";
       sources: {
         url: string;
         retrieved: string;
@@ -875,25 +955,18 @@ declare const CatalogueIndexSchema: z.ZodObject<{
         status: "fetchable";
         source: number;
         archive: {
-          kind: "none";
-        } | {
-          kind: "gzip";
-        } | {
-          kind: "zip";
-          member: {
+          kind: "zip" | "tar" | "tar.gz";
+          members: {
             path: string;
           } | {
             extensions: string[];
           };
         } | {
-          kind: "tar";
-          member: {
-            path: string;
-          } | {
-            extensions: string[];
-          };
+          kind: "none";
+        } | {
+          kind: "gzip";
         } | {
-          kind: "tar.gz";
+          kind: "zip" | "tar" | "tar.gz";
           member: {
             path: string;
           } | {
@@ -942,6 +1015,15 @@ declare const CatalogueIndexSchema: z.ZodObject<{
         } | {
           format: "pajek";
           encoding: "utf-8" | "latin1";
+        } | {
+          format: "solomon";
+          encoding: "utf-8" | "latin1";
+        } | {
+          format: "top";
+          encoding: "utf-8" | "latin1";
+        } | {
+          format: "toptw";
+          encoding: "utf-8" | "latin1";
         };
         paging?: {
           kind: "arcgis-query";
@@ -991,7 +1073,7 @@ declare const CatalogueIndexSchema: z.ZodObject<{
       id: string;
       name: string;
       tags: string[];
-      category: "graph/v1" | "or/v1";
+      category: "graph/v1" | "or/v1" | "or-set/v1";
       sources: {
         url: string;
         retrieved: string;
@@ -1020,25 +1102,18 @@ declare const CatalogueIndexSchema: z.ZodObject<{
         status: "fetchable";
         source: number;
         archive: {
-          kind: "none";
-        } | {
-          kind: "gzip";
-        } | {
-          kind: "zip";
-          member: {
+          kind: "zip" | "tar" | "tar.gz";
+          members: {
             path: string;
           } | {
             extensions: string[];
           };
         } | {
-          kind: "tar";
-          member: {
-            path: string;
-          } | {
-            extensions: string[];
-          };
+          kind: "none";
+        } | {
+          kind: "gzip";
         } | {
-          kind: "tar.gz";
+          kind: "zip" | "tar" | "tar.gz";
           member: {
             path: string;
           } | {
@@ -1087,6 +1162,15 @@ declare const CatalogueIndexSchema: z.ZodObject<{
         } | {
           format: "pajek";
           encoding: "utf-8" | "latin1";
+        } | {
+          format: "solomon";
+          encoding: "utf-8" | "latin1";
+        } | {
+          format: "top";
+          encoding: "utf-8" | "latin1";
+        } | {
+          format: "toptw";
+          encoding: "utf-8" | "latin1";
         };
         paging?: {
           kind: "arcgis-query";
@@ -1222,6 +1306,62 @@ declare const GraphV1Schema: z.ZodObject<{
 };
 type GraphV1 = z.infer<typeof GraphV1Schema>;
 //#endregion
+//#region src/targets/or-set-v1.d.ts
+/**
+ * The or-set/v1 normalisation target: `{ meta, instances }`, a collection of operations-research instances such as a benchmark suite, each instance an or/v1 document (`{ meta, nodes }`) under an id of its own. Beyond the shapes it checks that instance ids are unique in the set and node ids unique within each instance. A node id need not be unique across instances, because every instance numbers its own nodes.
+ */
+declare const OrSetV1Schema: z.ZodObject<{
+  meta: z.ZodPreprocess<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>, unknown>;
+  instances: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    meta: z.ZodPreprocess<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>, unknown>;
+    nodes: z.ZodArray<z.ZodObject<{
+      id: z.ZodString;
+      lat: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      lon: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      x: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      y: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      prize: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      prizeProbability: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      duration: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      travelTime: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      skill: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      territory: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      opened: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      closed: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      deadline: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+    }, z.core.$loose>>;
+  }, z.core.$strict>>;
+}, z.core.$strict> & {
+  is: (value: unknown) => value is {
+    meta: Record<string, string | number | boolean | null>;
+    instances: {
+      id: string;
+      meta: Record<string, string | number | boolean | null>;
+      nodes: {
+        [x: string]: unknown;
+        id: string;
+        lat?: number | null | undefined;
+        lon?: number | null | undefined;
+        x?: number | null | undefined;
+        y?: number | null | undefined;
+        prize?: number | null | undefined;
+        prizeProbability?: number | null | undefined;
+        duration?: number | null | undefined;
+        travelTime?: number | null | undefined;
+        skill?: string | null | undefined;
+        territory?: string | null | undefined;
+        status?: string | null | undefined;
+        opened?: string | null | undefined;
+        closed?: string | null | undefined;
+        deadline?: string | number | null | undefined;
+      }[];
+    }[];
+  };
+};
+type OrSetV1 = z.infer<typeof OrSetV1Schema>;
+//#endregion
 //#region src/targets/or-v1.d.ts
 /**
  * A node of an operations-research instance: a place or case a route may visit, flat so a twindex crosswalk can map a table's columns onto it (a wildcard path must keep the same shape on both sides). The target fixes only what the datasets share and lets a crosswalk map any further column through under its own name, as graph/v1 does. `lat` and `lon` are WGS84 degrees and `x` and `y` are planar coordinates in the dataset's own system; `duration` and `travelTime` are seconds, `prize` is the dataset's own reward measure, and `prizeProbability` is the chance the reward is collected. `skill` and `territory` name what is needed to serve the node and where it sits, `status` is where it is in its lifecycle, and `opened`, `closed` and `deadline` are its lifecycle times as the source writes them, a deadline being a number where the source gives a time of day.
@@ -1296,21 +1436,26 @@ type OrV1 = z.infer<typeof OrV1Schema>;
 declare const CategoryIdSchema: z.ZodEnum<{
   "graph/v1": "graph/v1";
   "or/v1": "or/v1";
+  "or-set/v1": "or-set/v1";
 }>;
 type CategoryId = z.infer<typeof CategoryIdSchema>;
 /** The normalisation target each category resolves to, keyed by category id. */
 interface CategoryTargets {
   readonly "graph/v1": GraphV1;
   readonly "or/v1": OrV1;
+  readonly "or-set/v1": OrSetV1;
 }
 /** The normalised shape of any category: what `fetchDataset` can resolve to. */
 type CategoryTarget = CategoryTargets[CategoryId];
 /** The keys of a target whose values are arrays: the collections an entry's `expectedCounts` may name. */
 type CountedKey<Target> = { readonly [Key in keyof Target]: Target[Key] extends readonly unknown[] ? Key : never; }[keyof Target] & string;
-/** One category: its id, what it holds, the schema of its normalisation target, and which of the target's arrays an entry may record expected counts for. */
+/** What one fetch of an entry in a category reads: a single document, or a set of documents, one per member of the archive the source unpacks to. */
+type CategoryShape = "document" | "collection";
+/** One category: its id, what it holds, whether an entry is one document or a collection of them, the schema of its normalisation target, and which of the target's arrays an entry may record expected counts for. */
 interface CategoryOf<Id extends CategoryId> {
   readonly id: Id;
   readonly description: string;
+  readonly shape: CategoryShape;
   readonly target: z.ZodType<CategoryTargets[Id]>;
   readonly counted: readonly CountedKey<CategoryTargets[Id]>[];
 }

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { $ as Parser, A as LineageSchema, B as Citation, C as CatalogueIndex, D as NamespaceNode, E as DatasetQuery, F as AliasSchema, G as Entry, H as ColumnNameSchema, I as Archive, J as IdSchema, K as EntrySchema, L as ArchiveMember, M as ManifestSchema, N as SemVerSchema, O as createCatalogue, P as parseManifest, Q as NamespaceSchema, R as ArchiveMemberSchema, S as Catalogue, T as Dataset, U as CrosswalkReference, V as CitationSchema, W as CrosswalkReferenceSchema, X as LicenceSchema, Y as Licence, Z as Namespace, _ as GraphEdgeSchema, a as CategoryTargets, at as Snapshot, b as GraphV1, c as getCategory, ct as SourceSchema, d as listCategories, dt as waybackUrl, et as ParserSchema, f as OrNode, g as GraphEdge, h as OrV1Schema, i as CategoryTarget, it as RelativePathSchema, j as Manifest, k as Lineage, l as getTarget, lt as WaybackTimestampSchema, m as OrV1, n as CategoryId, nt as Recipe, o as CountedKey, ot as SnapshotSchema, p as OrNodeSchema, q as HttpUrlSchema, r as CategoryIdSchema, rt as RecipeSchema, s as countTarget, st as Source, t as Category, tt as RESERVED_META_KEYS, u as kindOf, ut as parseEntry, v as GraphNode, w as CatalogueIndexSchema, x as GraphV1Schema, y as GraphNodeSchema, z as ArchiveSchema } from "./categories-BGjPWXpS.js";
+import { $ as Parser, A as LineageSchema, B as Citation, C as CatalogueIndex, D as NamespaceNode, E as DatasetQuery, F as AliasSchema, G as Entry, H as ColumnNameSchema, I as Archive, J as IdSchema, K as EntrySchema, L as ArchiveMember, M as ManifestSchema, N as SemVerSchema, O as createCatalogue, P as parseManifest, Q as NamespaceSchema, R as ArchiveMemberSchema, S as Catalogue, T as Dataset, U as CrosswalkReference, V as CitationSchema, W as CrosswalkReferenceSchema, X as LicenceSchema, Y as Licence, Z as Namespace, _ as GraphEdgeSchema, a as CategoryTargets, at as Snapshot, b as GraphV1, c as getCategory, ct as SourceSchema, d as listCategories, dt as waybackUrl, et as ParserSchema, f as OrNode, g as GraphEdge, h as OrV1Schema, i as CategoryTarget, it as RelativePathSchema, j as Manifest, k as Lineage, l as getTarget, lt as WaybackTimestampSchema, m as OrV1, n as CategoryId, nt as Recipe, o as CountedKey, ot as SnapshotSchema, p as OrNodeSchema, q as HttpUrlSchema, r as CategoryIdSchema, rt as RecipeSchema, s as countTarget, st as Source, t as Category, tt as RESERVED_META_KEYS, u as kindOf, ut as parseEntry, v as GraphNode, w as CatalogueIndexSchema, x as GraphV1Schema, y as GraphNodeSchema, z as ArchiveSchema } from "./categories-zC2eMs6y.js";
 import { Crosswalk } from "twindex";
 import { z } from "zod";
 //#region src/errors.d.ts

package/dist/index.js

@@ -1,4 +1,4 @@
-import { $ as NativeParseError, A as toIssues, B as kindOf, C as RESERVED_META_KEYS, D as SourceSchema, E as SnapshotSchema, G as GraphNodeSchema, H as OrNodeSchema, I as CategoryIdSchema, J as ArchiveError, K as GraphV1Schema, L as countTarget, M as NAME_SEPARATOR, N as groupsOf, O as WaybackTimestampSchema, P as namesOf, Q as KeepsetError, R as getCategory, S as ParserSchema, T as RelativePathSchema, U as OrV1Schema, V as listCategories, W as GraphEdgeSchema, X as DatasetAmbiguousError, Y as CatalogueSyntaxError, Z as DatasetNotFoundError, _ as EntrySchema, a as CatalogueIndexSchema, b as LicenceSchema, c as ManifestSchema, d as AliasSchema, et as RecipeError, f as ArchiveMemberSchema, g as CrosswalkReferenceSchema, h as ColumnNameSchema, i as listNamespaces, j as waybackUrl, k as parseEntry, l as SemVerSchema, m as CitationSchema, n as getManifest, o as createCatalogue, p as ArchiveSchema, q as JsonScalarSchema, r as listDatasets, s as LineageSchema, t as getDataset, tt as UnknownCategoryError, u as parseManifest, v as HttpUrlSchema, w as RecipeSchema, x as NamespaceSchema, y as IdSchema, z as getTarget } from "./bundled-BKl0C7kF.js";
+import { $ as NativeParseError, A as toIssues, B as kindOf, C as RESERVED_META_KEYS, D as SourceSchema, E as SnapshotSchema, G as GraphNodeSchema, H as OrNodeSchema, I as CategoryIdSchema, J as ArchiveError, K as GraphV1Schema, L as countTarget, M as NAME_SEPARATOR, N as groupsOf, O as WaybackTimestampSchema, P as namesOf, Q as KeepsetError, R as getCategory, S as ParserSchema, T as RelativePathSchema, U as OrV1Schema, V as listCategories, W as GraphEdgeSchema, X as DatasetAmbiguousError, Y as CatalogueSyntaxError, Z as DatasetNotFoundError, _ as EntrySchema, a as CatalogueIndexSchema, b as LicenceSchema, c as ManifestSchema, d as AliasSchema, et as RecipeError, f as ArchiveMemberSchema, g as CrosswalkReferenceSchema, h as ColumnNameSchema, i as listNamespaces, j as waybackUrl, k as parseEntry, l as SemVerSchema, m as CitationSchema, n as getManifest, o as createCatalogue, p as ArchiveSchema, q as JsonScalarSchema, r as listDatasets, s as LineageSchema, t as getDataset, tt as UnknownCategoryError, u as parseManifest, v as HttpUrlSchema, w as RecipeSchema, x as NamespaceSchema, y as IdSchema, z as getTarget } from "./bundled-Dkvod55t.js";
 import { validateCrosswalk } from "twindex";
 //#region src/serialise.ts
 /**

package/dist/node/fetch-dataset.d.ts

@@ -1,4 +1,4 @@
-import { G as Entry, T as Dataset, at as Snapshot, i as CategoryTarget, st as Source } from "../categories-BGjPWXpS.js";
+import { G as Entry, T as Dataset, at as Snapshot, i as CategoryTarget, st as Source } from "../categories-zC2eMs6y.js";
 //#region src/node/fetch-dataset.d.ts
 /** The network port a recipe downloads through: `downloadRaw` by default, which returns the bytes exactly as served, or a stand-in under test. */
 export type FetchPort = (url: string, init: {
@@ -24,7 +24,10 @@ export interface Provenance {
   readonly retrievedAt: string;
   readonly sha256: string;
   readonly byteLength: number;
+  /** The archive member a document was read from. */
   readonly member?: string;
+  /** The archive members a collection was read from, in the order they were read. */
+  readonly members?: readonly string[];
 }
 /** A fetched dataset: the resolved category target, the provenance of the bytes it came from, and any warnings, such as a count that differs from the one the entry records. */
 export interface FetchedDataset {