@monoflake/sdk 0.0.0

package/dist/artifacts/src/resource.d.ts

@@ -0,0 +1,1391 @@
+import * as v from "valibot";
+//#region artifacts/src/resource.d.ts
+/**
+ * The envelope's own version, which moves only when one of its five keys moves.
+ *
+ * Adding a type, adding a layer or changing what a layer holds touches none of those names, so
+ * none of them is a 6. A version that rose for reasons unrelated to what a reader parses would
+ * teach the reader to ignore it. See spec/architecture/resource.md, "The record".
+ */
+export declare const RESOURCE_VERSION = 5;
+/**
+ * A resource id: five characters of lowercase base36.
+ *
+ * The other id entirely -- `HASH_PATTERN` above identifies a run of bytes, this identifies a
+ * thing, and nothing converts one into the other. Five is chosen for the address space and for a
+ * human reading article source, not for a birthday bound: collisions are not a probability here
+ * because allocation checks the register first. See spec/architecture/resource.md, "Two ids".
+ */
+export declare const RESOURCE_PATTERN: RegExp;
+export declare function isResourceId(value: string): boolean;
+/** A rid as every schema here spells one, beside `hash`, which is the other id. */
+declare const rid: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+export type ResourceId = v.InferOutput<typeof rid>;
+/**
+ * What a resource is derived from, including bytes nobody can fetch.
+ *
+ * A list, because re-scanning a subject adds an origin to the resource rather than making a
+ * second one. The originals are never published; the cid is kept so the next import of the same
+ * file is recognised and skipped. See spec/architecture/resource.md, "`source` and `origin`".
+ */
+export declare const MediaLayerSchema: v.ObjectSchema<{
+  readonly version: v.NumberSchema<undefined>;
+  readonly origin: v.ArraySchema<v.ObjectSchema<{
+    readonly blake3: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+    readonly mime: v.StringSchema<undefined>;
+    readonly bytes: v.NumberSchema<undefined>;
+  }, undefined>, undefined>;
+}, undefined>;
+/** The mimes that serve any size, named once so no caller has to repeat the condition. */
+export declare const SCALABLE_MIMES: Set<string>;
+/**
+ * One published encoding of a picture.
+ *
+ * `resolution` is absent on a vector for the same reason the layer's is: there are no pixels to
+ * report, and a caller that asks and receives nothing has its answer. `quality` is the normalised
+ * encoder setting, kept because re-deriving has to reproduce what was published.
+ */
+export declare const ImageVariantSchema: v.ObjectSchema<{
+  readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+  readonly mime: v.StringSchema<undefined>;
+  readonly bytes: v.NumberSchema<undefined>;
+  readonly resolution: v.OptionalSchema<v.ObjectSchema<{
+    readonly width: v.NumberSchema<undefined>;
+    readonly height: v.NumberSchema<undefined>;
+  }, undefined>, undefined>;
+  readonly quality: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+}, undefined>;
+/**
+ * Two facts about a picture, and only one of them is universal.
+ *
+ * `dimension` is the intrinsic box -- an SVG's `viewBox`, a bitmap's pixels -- and is what layout
+ * is computed from. `resolution` is actual pixels and bitmaps only: **absent is the answer**, so
+ * a vector needs no second field saying it is one. The variants bind here because this is the
+ * first layer at which content is a fact. See spec/architecture/resource.md, "four steps".
+ */
+export declare const ImageLayerSchema: v.ObjectSchema<{
+  readonly version: v.NumberSchema<undefined>;
+  /**
+   * Base64 thumbhash: the compact canonical placeholder, and what `placeholder` decodes from.
+   *
+   * Optional, because a picture is not the only thing this layer describes. An icon binds two
+   * files under `icon` and has no single picture to stand in for -- **absent is the answer**
+   * there, exactly as it is for `resolution`, and a placeholder invented for one of the two
+   * tones would be painted under the other.
+   */
+  readonly thumbhash: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+  /**
+   * The same placeholder decoded, as a `data:image/webp` URI a page paints directly.
+   *
+   * Carried rather than derived where it is wanted, and the reason is not size: this record is
+   * read by a **universal** load, and the decode is a WebP codec reached through `node:fs`,
+   * which no browser bundle may contain. One decode at import serves both halves. Measured at
+   * 167 characters median here, about 8% of a photograph's record. Additive, so the layer
+   * keeps its version -- see the parsing table in spec/architecture/resource.md.
+   */
+  readonly placeholder: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+  readonly dimension: v.ObjectSchema<{
+    readonly width: v.NumberSchema<undefined>;
+    readonly height: v.NumberSchema<undefined>;
+    readonly aspect: v.StringSchema<undefined>;
+  }, undefined>;
+  readonly resolution: v.OptionalSchema<v.ObjectSchema<{
+    readonly width: v.NumberSchema<undefined>;
+    readonly height: v.NumberSchema<undefined>;
+  }, undefined>, undefined>;
+  readonly variants: v.ArraySchema<v.ObjectSchema<{
+    readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+    readonly mime: v.StringSchema<undefined>;
+    readonly bytes: v.NumberSchema<undefined>;
+    readonly resolution: v.OptionalSchema<v.ObjectSchema<{
+      readonly width: v.NumberSchema<undefined>;
+      readonly height: v.NumberSchema<undefined>;
+    }, undefined>, undefined>;
+    readonly quality: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+  }, undefined>, undefined>;
+}, undefined>;
+/** A camera pointed at the world, which is the whole of what this layer brings. */
+export declare const PhotoLayerSchema: v.ObjectSchema<{
+  readonly version: v.NumberSchema<undefined>;
+  readonly captured: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+  readonly camera: v.OptionalSchema<v.ObjectSchema<{
+    readonly model: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly manufacturer: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+  }, undefined>, undefined>;
+  readonly lens: v.OptionalSchema<v.ObjectSchema<{
+    readonly model: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly manufacturer: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly focal_length: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    readonly focal_length_35mm: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    readonly f_number: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+  }, undefined>, undefined>;
+  readonly exposure: v.OptionalSchema<v.ObjectSchema<{
+    readonly time: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly iso: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    readonly bias_ev: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    readonly mode: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly program: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly metering: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly white_balance: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly flash: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+  }, undefined>, undefined>;
+  readonly location: v.OptionalSchema<v.ObjectSchema<{
+    readonly latitude: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    readonly longitude: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    readonly altitude: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    readonly accuracy: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    readonly direction: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+  }, undefined>, undefined>;
+  readonly address: v.OptionalSchema<v.ObjectSchema<{
+    readonly continent: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly country: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly country_code: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly region: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly subregion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly city: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly district: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly postal_code: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly timezone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+  }, undefined>, undefined>;
+  readonly software: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+  readonly color_space: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+  /** Read and honoured on the way in: ignoring it turns every derived image. */
+  readonly orientation: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+}, undefined>;
+/**
+ * A capture of a screen, which is what a picture with no camera turns out to be.
+ *
+ * The scale is what earns this its own layer: a screenshot is taken at a device pixel ratio, and
+ * without it nothing can say whether a 2560px capture is a wide screen or a retina one. The rest
+ * is the same account a photograph carries -- ten records here hold `color_space` and `software`,
+ * and a layer with no home for them would drop them on the way past.
+ */
+export declare const ScreenshotLayerSchema: v.ObjectSchema<{
+  readonly version: v.NumberSchema<undefined>;
+  readonly captured: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+  readonly camera: v.OptionalSchema<v.ObjectSchema<{
+    readonly model: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly manufacturer: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+  }, undefined>, undefined>;
+  readonly lens: v.OptionalSchema<v.ObjectSchema<{
+    readonly model: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly manufacturer: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly focal_length: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    readonly focal_length_35mm: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    readonly f_number: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+  }, undefined>, undefined>;
+  readonly exposure: v.OptionalSchema<v.ObjectSchema<{
+    readonly time: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly iso: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    readonly bias_ev: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    readonly mode: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly program: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly metering: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly white_balance: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly flash: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+  }, undefined>, undefined>;
+  readonly location: v.OptionalSchema<v.ObjectSchema<{
+    readonly latitude: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    readonly longitude: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    readonly altitude: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    readonly accuracy: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    readonly direction: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+  }, undefined>, undefined>;
+  readonly address: v.OptionalSchema<v.ObjectSchema<{
+    readonly continent: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly country: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly country_code: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly region: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly subregion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly city: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly district: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly postal_code: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly timezone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+  }, undefined>, undefined>;
+  readonly software: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+  readonly color_space: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+  /** Read and honoured on the way in: ignoring it turns every derived image. */
+  readonly orientation: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+  readonly scale: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+}, undefined>;
+/**
+ * A still cut from a clip, pointing back at what it was cut from.
+ *
+ * The clip's `cover` points here and this points there, and that is not a cycle to remove:
+ * replacing the cover leaves this a frame of that clip. See spec/architecture/resource.md,
+ * "References resolve lazily".
+ */
+export declare const FrameLayerSchema: v.ObjectSchema<{
+  readonly version: v.NumberSchema<undefined>;
+  readonly source: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+  /** Seconds into the clip, which is the one thing the picture itself cannot say. */
+  readonly at: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+}, undefined>;
+/** Which shade an icon is drawn for. Closed, and the axis this layer exists to carry. */
+export declare const TONES: readonly ['light', 'dark'];
+export type Tone = (typeof TONES)[number];
+/**
+ * Another site's mark: one resource per domain, one file per tone.
+ *
+ * Light and dark are two pictures, not two encodings of one, so they bind here and not in
+ * `image.variants`. Each is described as an image variant is; what differs is the axis. A site
+ * with one mark carries one key, and absence is the answer as it is for `resolution`. See
+ * spec/architecture/resource.md, "Content binds at the layer that has it".
+ */
+export declare const IconLayerSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+  readonly version: v.NumberSchema<undefined>;
+  readonly domain: v.StringSchema<undefined>;
+  readonly tones: v.ObjectSchema<{
+    readonly light: v.OptionalSchema<v.ObjectSchema<{
+      readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+      readonly mime: v.StringSchema<undefined>;
+      readonly bytes: v.NumberSchema<undefined>;
+      readonly resolution: v.OptionalSchema<v.ObjectSchema<{
+        readonly width: v.NumberSchema<undefined>;
+        readonly height: v.NumberSchema<undefined>;
+      }, undefined>, undefined>;
+      readonly quality: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    }, undefined>, undefined>;
+    readonly dark: v.OptionalSchema<v.ObjectSchema<{
+      readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+      readonly mime: v.StringSchema<undefined>;
+      readonly bytes: v.NumberSchema<undefined>;
+      readonly resolution: v.OptionalSchema<v.ObjectSchema<{
+        readonly width: v.NumberSchema<undefined>;
+        readonly height: v.NumberSchema<undefined>;
+      }, undefined>, undefined>;
+      readonly quality: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    }, undefined>, undefined>;
+  }, undefined>;
+}, undefined>, v.CheckAction<{
+  version: number;
+  domain: string;
+  tones: {
+    light?: {
+      content: string;
+      mime: string;
+      bytes: number;
+      resolution?: {
+        width: number;
+        height: number;
+      } | undefined;
+      quality?: number | undefined;
+    } | undefined;
+    dark?: {
+      content: string;
+      mime: string;
+      bytes: number;
+      resolution?: {
+        width: number;
+        height: number;
+      } | undefined;
+      quality?: number | undefined;
+    } | undefined;
+  };
+}, "an icon names no file for any tone">]>;
+/**
+ * This site's own mark: one thing, six files.
+ *
+ * A map under fixed names rather than a variant list, because each of these is asked for by name
+ * -- a favicon, a touch icon, a BIMI mark -- and never by size. See
+ * spec/architecture/delivery.md, "A name is resolved, never stored".
+ */
+export declare const MarkLayerSchema: v.ObjectSchema<{
+  readonly version: v.NumberSchema<undefined>;
+  readonly files: v.RecordSchema<v.StringSchema<undefined>, v.ObjectSchema<{
+    readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+    readonly mime: v.StringSchema<undefined>;
+    readonly bytes: v.NumberSchema<undefined>;
+  }, undefined>, undefined>;
+}, undefined>;
+/**
+ * A moving picture: what the source was, what was published of it, and what is read over it.
+ *
+ * The source numbers are kept because a rung is a re-encode and none of them can be read back off
+ * one. `codec` is the full RFC 6381 string and names every track, since that is what a browser
+ * reads to decide whether it can play the file at all. See web's
+ * spec/architecture/video/pipeline.md.
+ */
+export declare const VideoLayerSchema: v.ObjectSchema<{
+  readonly version: v.NumberSchema<undefined>;
+  readonly source: v.ObjectSchema<{
+    readonly mime: v.StringSchema<undefined>;
+    readonly width: v.NumberSchema<undefined>;
+    readonly height: v.NumberSchema<undefined>;
+    readonly aspect: v.StringSchema<undefined>;
+    readonly bytes: v.NumberSchema<undefined>;
+    readonly duration: v.NumberSchema<undefined>;
+    readonly frame_rate: v.NumberSchema<undefined>;
+    readonly frames: v.NumberSchema<undefined>;
+    readonly audio: v.BooleanSchema<undefined>;
+    readonly loudness: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    readonly peak: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+  }, undefined>;
+  /** The poster frame, which is a resource of its own because it is referred to from two places. */
+  readonly cover: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+  readonly variants: v.ArraySchema<v.ObjectSchema<{
+    readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+    readonly mime: v.StringSchema<undefined>;
+    readonly bytes: v.NumberSchema<undefined>;
+    readonly resolution: v.ObjectSchema<{
+      readonly width: v.NumberSchema<undefined>;
+      readonly height: v.NumberSchema<undefined>;
+    }, undefined>;
+    readonly codec: v.StringSchema<undefined>;
+  }, undefined>, undefined>;
+  readonly tracks: v.ArraySchema<v.ObjectSchema<{
+    readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+    readonly mime: v.StringSchema<undefined>;
+    readonly language: v.StringSchema<undefined>;
+    readonly kind: v.PicklistSchema<["captions", "subtitles", "descriptions"], undefined>;
+    readonly bytes: v.NumberSchema<undefined>;
+  }, undefined>, undefined>;
+}, undefined>;
+/**
+ * A clip, which is a video cut from a longer one.
+ *
+ * The excerpt is what the layer brings: seconds into the original, which no derived file records
+ * and which is the difference between a clip and the thing it came out of.
+ */
+export declare const ClipLayerSchema: v.ObjectSchema<{
+  readonly version: v.NumberSchema<undefined>;
+  readonly excerpt: v.OptionalSchema<v.ObjectSchema<{
+    readonly from: v.NumberSchema<undefined>;
+    readonly to: v.NumberSchema<undefined>;
+  }, undefined>, undefined>;
+}, undefined>;
+/**
+ * Written prose: one source, and the views compiled out of it.
+ *
+ * The nine locale bodies are what the document is made of rather than nine things, so they bind
+ * here and none of them has a rid. `slug` is the identity and the address is the root's to say.
+ * See spec/architecture/resource.md, "The catalogue".
+ */
+export declare const DocumentLayerSchema: v.ObjectSchema<{
+  readonly version: v.NumberSchema<undefined>;
+  readonly slug: v.StringSchema<undefined>;
+  readonly source: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+  readonly locales: Omit<v.ObjectSchema<Record<"de" | "en" | "es" | "fr" | "ja" | "ko" | "mw" | "tw" | "zh", v.ObjectSchema<{
+    readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+    readonly card: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+    /** False when this locale is showing the source as a safe fallback. */
+    readonly translated: v.BooleanSchema<undefined>;
+  }, undefined>>, undefined>, "entries" | "~run" | "~standard" | "~types"> & {
+    readonly entries: {
+      de: v.OptionalSchema<v.ObjectSchema<{
+        readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+        readonly card: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+        /** False when this locale is showing the source as a safe fallback. */
+        readonly translated: v.BooleanSchema<undefined>;
+      }, undefined>, undefined>;
+      en: v.OptionalSchema<v.ObjectSchema<{
+        readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+        readonly card: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+        /** False when this locale is showing the source as a safe fallback. */
+        readonly translated: v.BooleanSchema<undefined>;
+      }, undefined>, undefined>;
+      es: v.OptionalSchema<v.ObjectSchema<{
+        readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+        readonly card: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+        /** False when this locale is showing the source as a safe fallback. */
+        readonly translated: v.BooleanSchema<undefined>;
+      }, undefined>, undefined>;
+      fr: v.OptionalSchema<v.ObjectSchema<{
+        readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+        readonly card: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+        /** False when this locale is showing the source as a safe fallback. */
+        readonly translated: v.BooleanSchema<undefined>;
+      }, undefined>, undefined>;
+      ja: v.OptionalSchema<v.ObjectSchema<{
+        readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+        readonly card: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+        /** False when this locale is showing the source as a safe fallback. */
+        readonly translated: v.BooleanSchema<undefined>;
+      }, undefined>, undefined>;
+      ko: v.OptionalSchema<v.ObjectSchema<{
+        readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+        readonly card: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+        /** False when this locale is showing the source as a safe fallback. */
+        readonly translated: v.BooleanSchema<undefined>;
+      }, undefined>, undefined>;
+      mw: v.OptionalSchema<v.ObjectSchema<{
+        readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+        readonly card: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+        /** False when this locale is showing the source as a safe fallback. */
+        readonly translated: v.BooleanSchema<undefined>;
+      }, undefined>, undefined>;
+      tw: v.OptionalSchema<v.ObjectSchema<{
+        readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+        readonly card: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+        /** False when this locale is showing the source as a safe fallback. */
+        readonly translated: v.BooleanSchema<undefined>;
+      }, undefined>, undefined>;
+      zh: v.OptionalSchema<v.ObjectSchema<{
+        readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+        readonly card: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+        /** False when this locale is showing the source as a safe fallback. */
+        readonly translated: v.BooleanSchema<undefined>;
+      }, undefined>, undefined>;
+    };
+    readonly "~standard": v.StandardProps<{
+      de?: {
+        content: string;
+        card?: string | undefined;
+        translated: boolean;
+      } | undefined;
+      en?: {
+        content: string;
+        card?: string | undefined;
+        translated: boolean;
+      } | undefined;
+      es?: {
+        content: string;
+        card?: string | undefined;
+        translated: boolean;
+      } | undefined;
+      fr?: {
+        content: string;
+        card?: string | undefined;
+        translated: boolean;
+      } | undefined;
+      ja?: {
+        content: string;
+        card?: string | undefined;
+        translated: boolean;
+      } | undefined;
+      ko?: {
+        content: string;
+        card?: string | undefined;
+        translated: boolean;
+      } | undefined;
+      mw?: {
+        content: string;
+        card?: string | undefined;
+        translated: boolean;
+      } | undefined;
+      tw?: {
+        content: string;
+        card?: string | undefined;
+        translated: boolean;
+      } | undefined;
+      zh?: {
+        content: string;
+        card?: string | undefined;
+        translated: boolean;
+      } | undefined;
+    }, {
+      de?: {
+        content: string;
+        card?: string | undefined;
+        translated: boolean;
+      } | undefined;
+      en?: {
+        content: string;
+        card?: string | undefined;
+        translated: boolean;
+      } | undefined;
+      es?: {
+        content: string;
+        card?: string | undefined;
+        translated: boolean;
+      } | undefined;
+      fr?: {
+        content: string;
+        card?: string | undefined;
+        translated: boolean;
+      } | undefined;
+      ja?: {
+        content: string;
+        card?: string | undefined;
+        translated: boolean;
+      } | undefined;
+      ko?: {
+        content: string;
+        card?: string | undefined;
+        translated: boolean;
+      } | undefined;
+      mw?: {
+        content: string;
+        card?: string | undefined;
+        translated: boolean;
+      } | undefined;
+      tw?: {
+        content: string;
+        card?: string | undefined;
+        translated: boolean;
+      } | undefined;
+      zh?: {
+        content: string;
+        card?: string | undefined;
+        translated: boolean;
+      } | undefined;
+    }>;
+    readonly "~run": (dataset: v.UnknownDataset, config: v.Config<v.BaseIssue<unknown>>) => v.OutputDataset<{
+      de?: {
+        content: string;
+        card?: string | undefined;
+        translated: boolean;
+      } | undefined;
+      en?: {
+        content: string;
+        card?: string | undefined;
+        translated: boolean;
+      } | undefined;
+      es?: {
+        content: string;
+        card?: string | undefined;
+        translated: boolean;
+      } | undefined;
+      fr?: {
+        content: string;
+        card?: string | undefined;
+        translated: boolean;
+      } | undefined;
+      ja?: {
+        content: string;
+        card?: string | undefined;
+        translated: boolean;
+      } | undefined;
+      ko?: {
+        content: string;
+        card?: string | undefined;
+        translated: boolean;
+      } | undefined;
+      mw?: {
+        content: string;
+        card?: string | undefined;
+        translated: boolean;
+      } | undefined;
+      tw?: {
+        content: string;
+        card?: string | undefined;
+        translated: boolean;
+      } | undefined;
+      zh?: {
+        content: string;
+        card?: string | undefined;
+        translated: boolean;
+      } | undefined;
+    }, v.BooleanIssue | v.ObjectIssue | v.RegexIssue<string> | v.StringIssue>;
+    readonly "~types"?: {
+      readonly input: {
+        de?: {
+          content: string;
+          card?: string | undefined;
+          translated: boolean;
+        } | undefined;
+        en?: {
+          content: string;
+          card?: string | undefined;
+          translated: boolean;
+        } | undefined;
+        es?: {
+          content: string;
+          card?: string | undefined;
+          translated: boolean;
+        } | undefined;
+        fr?: {
+          content: string;
+          card?: string | undefined;
+          translated: boolean;
+        } | undefined;
+        ja?: {
+          content: string;
+          card?: string | undefined;
+          translated: boolean;
+        } | undefined;
+        ko?: {
+          content: string;
+          card?: string | undefined;
+          translated: boolean;
+        } | undefined;
+        mw?: {
+          content: string;
+          card?: string | undefined;
+          translated: boolean;
+        } | undefined;
+        tw?: {
+          content: string;
+          card?: string | undefined;
+          translated: boolean;
+        } | undefined;
+        zh?: {
+          content: string;
+          card?: string | undefined;
+          translated: boolean;
+        } | undefined;
+      };
+      readonly output: {
+        de?: {
+          content: string;
+          card?: string | undefined;
+          translated: boolean;
+        } | undefined;
+        en?: {
+          content: string;
+          card?: string | undefined;
+          translated: boolean;
+        } | undefined;
+        es?: {
+          content: string;
+          card?: string | undefined;
+          translated: boolean;
+        } | undefined;
+        fr?: {
+          content: string;
+          card?: string | undefined;
+          translated: boolean;
+        } | undefined;
+        ja?: {
+          content: string;
+          card?: string | undefined;
+          translated: boolean;
+        } | undefined;
+        ko?: {
+          content: string;
+          card?: string | undefined;
+          translated: boolean;
+        } | undefined;
+        mw?: {
+          content: string;
+          card?: string | undefined;
+          translated: boolean;
+        } | undefined;
+        tw?: {
+          content: string;
+          card?: string | undefined;
+          translated: boolean;
+        } | undefined;
+        zh?: {
+          content: string;
+          card?: string | undefined;
+          translated: boolean;
+        } | undefined;
+      };
+      readonly issue: v.BooleanIssue | v.ObjectIssue | v.RegexIssue<string> | v.StringIssue;
+    } | undefined;
+  };
+}, undefined>;
+/** An article: the document, plus the two things a page without a date does not carry. */
+export declare const ArticleLayerSchema: v.ObjectSchema<{
+  readonly version: v.NumberSchema<undefined>;
+  readonly dates: v.ObjectSchema<{
+    readonly created: v.StringSchema<undefined>;
+    readonly published: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly lastmod: v.StringSchema<undefined>;
+  }, undefined>;
+  readonly tags: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+}, undefined>;
+/**
+ * The attribution text, which is the one document nobody writes.
+ *
+ * Rewritten whenever the dependency tree moves, so when it was last derived is the fact that
+ * distinguishes it from prose someone sat down and wrote.
+ */
+export declare const NoticeLayerSchema: v.ObjectSchema<{
+  readonly version: v.NumberSchema<undefined>;
+  readonly generated: v.StringSchema<undefined>;
+}, undefined>;
+/**
+ * The register a `type` segment selects a parser from, and the highest version each build reads.
+ *
+ * The version is held beside the schema rather than inside it: a layer numbered above what is
+ * here is a shape from a newer producer, and the answer is to stop at that segment rather than to
+ * fail the whole record. See spec/architecture/resource.md, "Parsing is optimistic".
+ */
+export declare const LAYERS: {
+  readonly media: {
+    readonly version: 1;
+    readonly schema: v.ObjectSchema<{
+      readonly version: v.NumberSchema<undefined>;
+      readonly origin: v.ArraySchema<v.ObjectSchema<{
+        readonly blake3: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+        readonly mime: v.StringSchema<undefined>;
+        readonly bytes: v.NumberSchema<undefined>;
+      }, undefined>, undefined>;
+    }, undefined>;
+  };
+  readonly image: {
+    readonly version: 1;
+    readonly schema: v.ObjectSchema<{
+      readonly version: v.NumberSchema<undefined>;
+      /**
+       * Base64 thumbhash: the compact canonical placeholder, and what `placeholder` decodes from.
+       *
+       * Optional, because a picture is not the only thing this layer describes. An icon binds two
+       * files under `icon` and has no single picture to stand in for -- **absent is the answer**
+       * there, exactly as it is for `resolution`, and a placeholder invented for one of the two
+       * tones would be painted under the other.
+       */
+      readonly thumbhash: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+      /**
+       * The same placeholder decoded, as a `data:image/webp` URI a page paints directly.
+       *
+       * Carried rather than derived where it is wanted, and the reason is not size: this record is
+       * read by a **universal** load, and the decode is a WebP codec reached through `node:fs`,
+       * which no browser bundle may contain. One decode at import serves both halves. Measured at
+       * 167 characters median here, about 8% of a photograph's record. Additive, so the layer
+       * keeps its version -- see the parsing table in spec/architecture/resource.md.
+       */
+      readonly placeholder: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+      readonly dimension: v.ObjectSchema<{
+        readonly width: v.NumberSchema<undefined>;
+        readonly height: v.NumberSchema<undefined>;
+        readonly aspect: v.StringSchema<undefined>;
+      }, undefined>;
+      readonly resolution: v.OptionalSchema<v.ObjectSchema<{
+        readonly width: v.NumberSchema<undefined>;
+        readonly height: v.NumberSchema<undefined>;
+      }, undefined>, undefined>;
+      readonly variants: v.ArraySchema<v.ObjectSchema<{
+        readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+        readonly mime: v.StringSchema<undefined>;
+        readonly bytes: v.NumberSchema<undefined>;
+        readonly resolution: v.OptionalSchema<v.ObjectSchema<{
+          readonly width: v.NumberSchema<undefined>;
+          readonly height: v.NumberSchema<undefined>;
+        }, undefined>, undefined>;
+        readonly quality: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+      }, undefined>, undefined>;
+    }, undefined>;
+  };
+  readonly photo: {
+    readonly version: 1;
+    readonly schema: v.ObjectSchema<{
+      readonly version: v.NumberSchema<undefined>;
+      readonly captured: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+      readonly camera: v.OptionalSchema<v.ObjectSchema<{
+        readonly model: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly manufacturer: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+      }, undefined>, undefined>;
+      readonly lens: v.OptionalSchema<v.ObjectSchema<{
+        readonly model: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly manufacturer: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly focal_length: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly focal_length_35mm: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly f_number: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+      }, undefined>, undefined>;
+      readonly exposure: v.OptionalSchema<v.ObjectSchema<{
+        readonly time: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly iso: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly bias_ev: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly mode: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly program: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly metering: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly white_balance: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly flash: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+      }, undefined>, undefined>;
+      readonly location: v.OptionalSchema<v.ObjectSchema<{
+        readonly latitude: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly longitude: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly altitude: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly accuracy: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly direction: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+      }, undefined>, undefined>;
+      readonly address: v.OptionalSchema<v.ObjectSchema<{
+        readonly continent: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly country: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly country_code: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly region: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly subregion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly city: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly district: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly postal_code: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly timezone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+      }, undefined>, undefined>;
+      readonly software: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+      readonly color_space: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+      /** Read and honoured on the way in: ignoring it turns every derived image. */
+      readonly orientation: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    }, undefined>;
+  };
+  readonly screenshot: {
+    readonly version: 1;
+    readonly schema: v.ObjectSchema<{
+      readonly version: v.NumberSchema<undefined>;
+      readonly captured: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+      readonly camera: v.OptionalSchema<v.ObjectSchema<{
+        readonly model: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly manufacturer: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+      }, undefined>, undefined>;
+      readonly lens: v.OptionalSchema<v.ObjectSchema<{
+        readonly model: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly manufacturer: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly focal_length: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly focal_length_35mm: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly f_number: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+      }, undefined>, undefined>;
+      readonly exposure: v.OptionalSchema<v.ObjectSchema<{
+        readonly time: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly iso: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly bias_ev: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly mode: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly program: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly metering: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly white_balance: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly flash: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+      }, undefined>, undefined>;
+      readonly location: v.OptionalSchema<v.ObjectSchema<{
+        readonly latitude: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly longitude: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly altitude: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly accuracy: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly direction: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+      }, undefined>, undefined>;
+      readonly address: v.OptionalSchema<v.ObjectSchema<{
+        readonly continent: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly country: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly country_code: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly region: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly subregion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly city: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly district: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly postal_code: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly timezone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+      }, undefined>, undefined>;
+      readonly software: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+      readonly color_space: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+      /** Read and honoured on the way in: ignoring it turns every derived image. */
+      readonly orientation: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+      readonly scale: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    }, undefined>;
+  };
+  readonly frame: {
+    readonly version: 1;
+    readonly schema: v.ObjectSchema<{
+      readonly version: v.NumberSchema<undefined>;
+      readonly source: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+      /** Seconds into the clip, which is the one thing the picture itself cannot say. */
+      readonly at: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    }, undefined>;
+  };
+  readonly icon: {
+    readonly version: 1;
+    readonly schema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+      readonly version: v.NumberSchema<undefined>;
+      readonly domain: v.StringSchema<undefined>;
+      readonly tones: v.ObjectSchema<{
+        readonly light: v.OptionalSchema<v.ObjectSchema<{
+          readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+          readonly mime: v.StringSchema<undefined>;
+          readonly bytes: v.NumberSchema<undefined>;
+          readonly resolution: v.OptionalSchema<v.ObjectSchema<{
+            readonly width: v.NumberSchema<undefined>;
+            readonly height: v.NumberSchema<undefined>;
+          }, undefined>, undefined>;
+          readonly quality: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        }, undefined>, undefined>;
+        readonly dark: v.OptionalSchema<v.ObjectSchema<{
+          readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+          readonly mime: v.StringSchema<undefined>;
+          readonly bytes: v.NumberSchema<undefined>;
+          readonly resolution: v.OptionalSchema<v.ObjectSchema<{
+            readonly width: v.NumberSchema<undefined>;
+            readonly height: v.NumberSchema<undefined>;
+          }, undefined>, undefined>;
+          readonly quality: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        }, undefined>, undefined>;
+      }, undefined>;
+    }, undefined>, v.CheckAction<{
+      version: number;
+      domain: string;
+      tones: {
+        light?: {
+          content: string;
+          mime: string;
+          bytes: number;
+          resolution?: {
+            width: number;
+            height: number;
+          } | undefined;
+          quality?: number | undefined;
+        } | undefined;
+        dark?: {
+          content: string;
+          mime: string;
+          bytes: number;
+          resolution?: {
+            width: number;
+            height: number;
+          } | undefined;
+          quality?: number | undefined;
+        } | undefined;
+      };
+    }, "an icon names no file for any tone">]>;
+  };
+  readonly mark: {
+    readonly version: 1;
+    readonly schema: v.ObjectSchema<{
+      readonly version: v.NumberSchema<undefined>;
+      readonly files: v.RecordSchema<v.StringSchema<undefined>, v.ObjectSchema<{
+        readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+        readonly mime: v.StringSchema<undefined>;
+        readonly bytes: v.NumberSchema<undefined>;
+      }, undefined>, undefined>;
+    }, undefined>;
+  };
+  readonly video: {
+    readonly version: 1;
+    readonly schema: v.ObjectSchema<{
+      readonly version: v.NumberSchema<undefined>;
+      readonly source: v.ObjectSchema<{
+        readonly mime: v.StringSchema<undefined>;
+        readonly width: v.NumberSchema<undefined>;
+        readonly height: v.NumberSchema<undefined>;
+        readonly aspect: v.StringSchema<undefined>;
+        readonly bytes: v.NumberSchema<undefined>;
+        readonly duration: v.NumberSchema<undefined>;
+        readonly frame_rate: v.NumberSchema<undefined>;
+        readonly frames: v.NumberSchema<undefined>;
+        readonly audio: v.BooleanSchema<undefined>;
+        readonly loudness: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly peak: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+      }, undefined>;
+      /** The poster frame, which is a resource of its own because it is referred to from two places. */
+      readonly cover: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+      readonly variants: v.ArraySchema<v.ObjectSchema<{
+        readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+        readonly mime: v.StringSchema<undefined>;
+        readonly bytes: v.NumberSchema<undefined>;
+        readonly resolution: v.ObjectSchema<{
+          readonly width: v.NumberSchema<undefined>;
+          readonly height: v.NumberSchema<undefined>;
+        }, undefined>;
+        readonly codec: v.StringSchema<undefined>;
+      }, undefined>, undefined>;
+      readonly tracks: v.ArraySchema<v.ObjectSchema<{
+        readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+        readonly mime: v.StringSchema<undefined>;
+        readonly language: v.StringSchema<undefined>;
+        readonly kind: v.PicklistSchema<["captions", "subtitles", "descriptions"], undefined>;
+        readonly bytes: v.NumberSchema<undefined>;
+      }, undefined>, undefined>;
+    }, undefined>;
+  };
+  readonly clip: {
+    readonly version: 1;
+    readonly schema: v.ObjectSchema<{
+      readonly version: v.NumberSchema<undefined>;
+      readonly excerpt: v.OptionalSchema<v.ObjectSchema<{
+        readonly from: v.NumberSchema<undefined>;
+        readonly to: v.NumberSchema<undefined>;
+      }, undefined>, undefined>;
+    }, undefined>;
+  };
+  readonly document: {
+    readonly version: 1;
+    readonly schema: v.ObjectSchema<{
+      readonly version: v.NumberSchema<undefined>;
+      readonly slug: v.StringSchema<undefined>;
+      readonly source: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+      readonly locales: Omit<v.ObjectSchema<Record<"de" | "en" | "es" | "fr" | "ja" | "ko" | "mw" | "tw" | "zh", v.ObjectSchema<{
+        readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+        readonly card: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+        /** False when this locale is showing the source as a safe fallback. */
+        readonly translated: v.BooleanSchema<undefined>;
+      }, undefined>>, undefined>, "entries" | "~run" | "~standard" | "~types"> & {
+        readonly entries: {
+          de: v.OptionalSchema<v.ObjectSchema<{
+            readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+            readonly card: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+            /** False when this locale is showing the source as a safe fallback. */
+            readonly translated: v.BooleanSchema<undefined>;
+          }, undefined>, undefined>;
+          en: v.OptionalSchema<v.ObjectSchema<{
+            readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+            readonly card: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+            /** False when this locale is showing the source as a safe fallback. */
+            readonly translated: v.BooleanSchema<undefined>;
+          }, undefined>, undefined>;
+          es: v.OptionalSchema<v.ObjectSchema<{
+            readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+            readonly card: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+            /** False when this locale is showing the source as a safe fallback. */
+            readonly translated: v.BooleanSchema<undefined>;
+          }, undefined>, undefined>;
+          fr: v.OptionalSchema<v.ObjectSchema<{
+            readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+            readonly card: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+            /** False when this locale is showing the source as a safe fallback. */
+            readonly translated: v.BooleanSchema<undefined>;
+          }, undefined>, undefined>;
+          ja: v.OptionalSchema<v.ObjectSchema<{
+            readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+            readonly card: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+            /** False when this locale is showing the source as a safe fallback. */
+            readonly translated: v.BooleanSchema<undefined>;
+          }, undefined>, undefined>;
+          ko: v.OptionalSchema<v.ObjectSchema<{
+            readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+            readonly card: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+            /** False when this locale is showing the source as a safe fallback. */
+            readonly translated: v.BooleanSchema<undefined>;
+          }, undefined>, undefined>;
+          mw: v.OptionalSchema<v.ObjectSchema<{
+            readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+            readonly card: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+            /** False when this locale is showing the source as a safe fallback. */
+            readonly translated: v.BooleanSchema<undefined>;
+          }, undefined>, undefined>;
+          tw: v.OptionalSchema<v.ObjectSchema<{
+            readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+            readonly card: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+            /** False when this locale is showing the source as a safe fallback. */
+            readonly translated: v.BooleanSchema<undefined>;
+          }, undefined>, undefined>;
+          zh: v.OptionalSchema<v.ObjectSchema<{
+            readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+            readonly card: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+            /** False when this locale is showing the source as a safe fallback. */
+            readonly translated: v.BooleanSchema<undefined>;
+          }, undefined>, undefined>;
+        };
+        readonly "~standard": v.StandardProps<{
+          de?: {
+            content: string;
+            card?: string | undefined;
+            translated: boolean;
+          } | undefined;
+          en?: {
+            content: string;
+            card?: string | undefined;
+            translated: boolean;
+          } | undefined;
+          es?: {
+            content: string;
+            card?: string | undefined;
+            translated: boolean;
+          } | undefined;
+          fr?: {
+            content: string;
+            card?: string | undefined;
+            translated: boolean;
+          } | undefined;
+          ja?: {
+            content: string;
+            card?: string | undefined;
+            translated: boolean;
+          } | undefined;
+          ko?: {
+            content: string;
+            card?: string | undefined;
+            translated: boolean;
+          } | undefined;
+          mw?: {
+            content: string;
+            card?: string | undefined;
+            translated: boolean;
+          } | undefined;
+          tw?: {
+            content: string;
+            card?: string | undefined;
+            translated: boolean;
+          } | undefined;
+          zh?: {
+            content: string;
+            card?: string | undefined;
+            translated: boolean;
+          } | undefined;
+        }, {
+          de?: {
+            content: string;
+            card?: string | undefined;
+            translated: boolean;
+          } | undefined;
+          en?: {
+            content: string;
+            card?: string | undefined;
+            translated: boolean;
+          } | undefined;
+          es?: {
+            content: string;
+            card?: string | undefined;
+            translated: boolean;
+          } | undefined;
+          fr?: {
+            content: string;
+            card?: string | undefined;
+            translated: boolean;
+          } | undefined;
+          ja?: {
+            content: string;
+            card?: string | undefined;
+            translated: boolean;
+          } | undefined;
+          ko?: {
+            content: string;
+            card?: string | undefined;
+            translated: boolean;
+          } | undefined;
+          mw?: {
+            content: string;
+            card?: string | undefined;
+            translated: boolean;
+          } | undefined;
+          tw?: {
+            content: string;
+            card?: string | undefined;
+            translated: boolean;
+          } | undefined;
+          zh?: {
+            content: string;
+            card?: string | undefined;
+            translated: boolean;
+          } | undefined;
+        }>;
+        readonly "~run": (dataset: v.UnknownDataset, config: v.Config<v.BaseIssue<unknown>>) => v.OutputDataset<{
+          de?: {
+            content: string;
+            card?: string | undefined;
+            translated: boolean;
+          } | undefined;
+          en?: {
+            content: string;
+            card?: string | undefined;
+            translated: boolean;
+          } | undefined;
+          es?: {
+            content: string;
+            card?: string | undefined;
+            translated: boolean;
+          } | undefined;
+          fr?: {
+            content: string;
+            card?: string | undefined;
+            translated: boolean;
+          } | undefined;
+          ja?: {
+            content: string;
+            card?: string | undefined;
+            translated: boolean;
+          } | undefined;
+          ko?: {
+            content: string;
+            card?: string | undefined;
+            translated: boolean;
+          } | undefined;
+          mw?: {
+            content: string;
+            card?: string | undefined;
+            translated: boolean;
+          } | undefined;
+          tw?: {
+            content: string;
+            card?: string | undefined;
+            translated: boolean;
+          } | undefined;
+          zh?: {
+            content: string;
+            card?: string | undefined;
+            translated: boolean;
+          } | undefined;
+        }, v.BooleanIssue | v.ObjectIssue | v.RegexIssue<string> | v.StringIssue>;
+        readonly "~types"?: {
+          readonly input: {
+            de?: {
+              content: string;
+              card?: string | undefined;
+              translated: boolean;
+            } | undefined;
+            en?: {
+              content: string;
+              card?: string | undefined;
+              translated: boolean;
+            } | undefined;
+            es?: {
+              content: string;
+              card?: string | undefined;
+              translated: boolean;
+            } | undefined;
+            fr?: {
+              content: string;
+              card?: string | undefined;
+              translated: boolean;
+            } | undefined;
+            ja?: {
+              content: string;
+              card?: string | undefined;
+              translated: boolean;
+            } | undefined;
+            ko?: {
+              content: string;
+              card?: string | undefined;
+              translated: boolean;
+            } | undefined;
+            mw?: {
+              content: string;
+              card?: string | undefined;
+              translated: boolean;
+            } | undefined;
+            tw?: {
+              content: string;
+              card?: string | undefined;
+              translated: boolean;
+            } | undefined;
+            zh?: {
+              content: string;
+              card?: string | undefined;
+              translated: boolean;
+            } | undefined;
+          };
+          readonly output: {
+            de?: {
+              content: string;
+              card?: string | undefined;
+              translated: boolean;
+            } | undefined;
+            en?: {
+              content: string;
+              card?: string | undefined;
+              translated: boolean;
+            } | undefined;
+            es?: {
+              content: string;
+              card?: string | undefined;
+              translated: boolean;
+            } | undefined;
+            fr?: {
+              content: string;
+              card?: string | undefined;
+              translated: boolean;
+            } | undefined;
+            ja?: {
+              content: string;
+              card?: string | undefined;
+              translated: boolean;
+            } | undefined;
+            ko?: {
+              content: string;
+              card?: string | undefined;
+              translated: boolean;
+            } | undefined;
+            mw?: {
+              content: string;
+              card?: string | undefined;
+              translated: boolean;
+            } | undefined;
+            tw?: {
+              content: string;
+              card?: string | undefined;
+              translated: boolean;
+            } | undefined;
+            zh?: {
+              content: string;
+              card?: string | undefined;
+              translated: boolean;
+            } | undefined;
+          };
+          readonly issue: v.BooleanIssue | v.ObjectIssue | v.RegexIssue<string> | v.StringIssue;
+        } | undefined;
+      };
+    }, undefined>;
+  };
+  readonly article: {
+    readonly version: 1;
+    readonly schema: v.ObjectSchema<{
+      readonly version: v.NumberSchema<undefined>;
+      readonly dates: v.ObjectSchema<{
+        readonly created: v.StringSchema<undefined>;
+        readonly published: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly lastmod: v.StringSchema<undefined>;
+      }, undefined>;
+      readonly tags: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>;
+  };
+  readonly notice: {
+    readonly version: 1;
+    readonly schema: v.ObjectSchema<{
+      readonly version: v.NumberSchema<undefined>;
+      readonly generated: v.StringSchema<undefined>;
+    }, undefined>;
+  };
+};
+export type LayerName = keyof typeof LAYERS;
+export type LayerOf<N extends LayerName> = v.InferOutput<(typeof LAYERS)[N]['schema']>;
+export type MediaLayer = v.InferOutput<typeof MediaLayerSchema>;
+export type ImageLayer = v.InferOutput<typeof ImageLayerSchema>;
+export type ImageVariant = v.InferOutput<typeof ImageVariantSchema>;
+export type PhotoLayer = v.InferOutput<typeof PhotoLayerSchema>;
+export type ScreenshotLayer = v.InferOutput<typeof ScreenshotLayerSchema>;
+export type FrameLayer = v.InferOutput<typeof FrameLayerSchema>;
+export type IconLayer = v.InferOutput<typeof IconLayerSchema>;
+export type MarkLayer = v.InferOutput<typeof MarkLayerSchema>;
+export type VideoLayer = v.InferOutput<typeof VideoLayerSchema>;
+export type ClipLayer = v.InferOutput<typeof ClipLayerSchema>;
+export type DocumentLayer = v.InferOutput<typeof DocumentLayerSchema>;
+export type ArticleLayer = v.InferOutput<typeof ArticleLayerSchema>;
+export type NoticeLayer = v.InferOutput<typeof NoticeLayerSchema>;
+export declare function isLayerName(value: string): value is LayerName;
+/**
+ * What a bare resource id means, written as a scheme rather than as an address.
+ *
+ * An absolute URL here would bake a hostname into every record, so changing one would mean
+ * rewriting all of them. A scheme is expanded by whoever answers, from `@monoflake/sdk`, which is
+ * the one place a hostname is declared. `services/libs/fonts` already does this with `__CDN_URL__`.
+ */
+export declare const CANONICAL_PATTERN: RegExp;
+/**
+ * Six fields and a container, which is the whole record.
+ *
+ * `layers` is read loosely here on purpose: the envelope's job is to find the layers and say how
+ * old each one is, and which schema a layer is then read under is its segment's to decide. A
+ * strict object at this level would strip every field the register is about to ask for.
+ */
+export declare const ResourceSchema: v.ObjectSchema<{
+  readonly version: v.LiteralSchema<5, undefined>;
+  readonly resource: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+  readonly type: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+  readonly created: v.StringSchema<undefined>;
+  readonly updated: v.StringSchema<undefined>;
+  readonly canonical: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+  readonly layers: v.RecordSchema<v.StringSchema<undefined>, v.LooseObjectSchema<{
+    readonly version: v.NumberSchema<undefined>;
+  }, undefined>, undefined>;
+}, undefined>;
+export type Resource = v.InferOutput<typeof ResourceSchema>;
+/**
+ * A canonical scheme expanded against the hosts this deployment knows.
+ *
+ * `cid:` names an object and `slug:` names an article, and neither carries a hostname -- which is
+ * what lets a domain move without a record being touched. A slug needs no lookup: the site
+ * resolves a bare name to the article's real path itself.
+ */
+export declare function expandCanonical(canonical: string, hosts: {
+  cdn: string;
+  site: string;
+}): string | undefined;
+/** The segments of a type, in the order they narrow. `media.image.photo` is three claims. */
+export declare function parseType(type: string): string[];
+/**
+ * A record as this build understands it, which may be less than the record declares.
+ *
+ * `segments` is what parsed rather than what was claimed, so a consumer asking whether it got
+ * what it needed asks that list and not `type`.
+ */
+export type ParsedResource = {
+  resource: ResourceId;
+  type: string;
+  created: string;
+  updated: string;
+  segments: LayerName[];
+  layers: { [N in LayerName]?: LayerOf<N>; };
+};
+/**
+ * Read a record for as much of it as this build knows, and stop rather than fall over.
+ *
+ * Both sides of a change are pushed together and the only skew is minutes, which does not justify
+ * a compatibility contract -- it justifies not falling over. So an unknown segment or a layer
+ * numbered too high ends the chain and keeps what came before it. See
+ * spec/architecture/resource.md, "Parsing is optimistic, not compatible".
+ */
+export declare function parseResource(value: unknown): ParsedResource;
+/**
+ * The layer a caller cannot proceed without, or an error naming what it got instead.
+ *
+ * The one strict reading in the file, and the difference is worth stating: everything above is "I
+ * do not know about this", which is survivable, and this is "this is not the thing you asked
+ * for", which is not. Answering it with a blank is how a missing image becomes a missing image
+ * nobody reports. See spec/architecture/resource.md, "Parsing is optimistic, not compatible".
+ */
+export declare function requireSegment<N extends LayerName>(resource: ParsedResource, segment: N): LayerOf<N>;
+//#endregion