@kensio/colophon 2.2.0 → 2.4.0

package/dist/types.d.ts

@@ -9,8 +9,10 @@ export interface Dimensions {
  * A named output size. The `name` identifies the size in output filenames
  * (e.g. `og`, `square`) and must be unique within a config, so every
  * generated image gets a distinct, descriptive filename.
+ *
+ * A size may also carry {@link SizeOverrides}, applied only when rendering it.
  */
-export interface OutputSize {
+export interface OutputSize extends SizeOverrides {
     readonly name: string;
     readonly width: number;
     readonly height: number;
@@ -24,7 +26,37 @@ export interface GradientStop {
     readonly color: string;
 }
 /**
- * Background fill for an image: a flat colour or a linear gradient.
+ * A raster or SVG image to draw into a generated one, given either as a file
+ * path or as its bytes. It mirrors {@link FontSource}, and for the same
+ * reasons: a path is checked when the config is resolved rather than when the
+ * image is drawn, and the bytes are what the rebuild stamp hashes, so replacing
+ * a logo at the same path re-renders everything drawn with it.
+ *
+ * PNG, JPEG, GIF, WebP and SVG are understood. Text inside an SVG is not
+ * rendered, because a nested document is drawn without the fonts the build
+ * loaded; convert it to paths first, or use a raster image.
+ */
+export type ImageSource = {
+    /** Resolved from the working directory when relative. */
+    readonly path: string;
+} | {
+    /**
+     * The image file's bytes. The format is read from them, so there is
+     * nothing to declare and nothing to get wrong.
+     */
+    readonly data: Uint8Array;
+};
+/** A wash of colour over a background image, so that text stays legible. */
+export interface Scrim {
+    /** Defaults to black. */
+    readonly color?: string;
+    /** Opacity at the top edge. Defaults to `0.25`. */
+    readonly from?: number;
+    /** Opacity at the bottom edge. Defaults to `0.65`. */
+    readonly to?: number;
+}
+/**
+ * Background fill for an image: a flat colour, a linear gradient, or a photo.
  *
  * Gradient coordinates use SVG object-bounding-box units (0–1); the default
  * runs diagonally from the top-left `(0, 0)` to the bottom-right `(1, 1)`.
@@ -43,10 +75,41 @@ export type Background = {
         readonly x: number;
         readonly y: number;
     };
+} | {
+    readonly type: "image";
+    readonly source: ImageSource;
+    /**
+     * `cover` fills the image and crops the overflow, which is what a photo
+     * behind a headline wants. `contain` fits the whole picture in and shows
+     * `color` in what is left over.
+     */
+    readonly fit?: "cover" | "contain";
+    /** Behind the image, and either side of a `contain` fit. */
+    readonly color?: string;
+    /**
+     * Defaults to a gentle shade towards the bottom. A photograph is light
+     * and dark wherever it likes, and white text over a bright sky cannot be
+     * read, so this is what makes the difference between a designed image and
+     * text sitting on a picture. Set `to: 0` for none.
+     */
+    readonly scrim?: Scrim;
 };
+/**
+ * An image that has been loaded and is ready to draw: the `data:` URI a
+ * template hands to `image`, and the shape of the picture behind it.
+ */
+export interface ImageAsset {
+    readonly href: string;
+    /**
+     * Width divided by height. `1` where the format is one whose dimensions
+     * cannot be read, so a template reserves a square and the picture sits
+     * inside it rather than being stretched.
+     */
+    readonly aspect: number;
+}
 /**
  * Brand colours used to derive the default gradient and text colour. All are
- * configurable per project — nothing here is tied to a specific site.
+ * configurable per project, and nothing here is tied to a specific site.
  */
 export interface BrandColors {
     readonly brand: string;
@@ -75,14 +138,11 @@ export interface Badge {
 export interface CodeStyle {
     /** Shiki theme name, e.g. `github-dark`, `monokai`, `catppuccin-mocha`. */
     readonly theme?: string;
-    /** Monospace font stack. Must resolve to a font available to `sharp`. */
-    readonly fontFamily?: string;
     /**
-     * Glyph advance width as a fraction of the font size. `0.6` matches most
-     * monospace faces (Source Code Pro, Menlo, DejaVu Sans Mono); narrower faces
-     * such as Consolas want ~`0.55`.
+     * Monospace font stack. Must resolve to a configured font, or to an
+     * installed one when `systemFonts` is on.
      */
-    readonly charWidthRatio?: number;
+    readonly fontFamily?: string;
     /** Line advance as a multiple of the font size. Default `1.55`. */
     readonly lineHeight?: number;
     /** Spaces a tab expands to before layout. Default `2`. */
@@ -92,14 +152,39 @@ export interface CodeStyle {
     /** Upper bound on the auto-fitted font size, as a fraction of image width. */
     readonly maxFontScale?: number;
     /**
-     * Lower bound on the auto-fitted font size, as a fraction of image width —
-     * width, because that is what a feed scales a share image to. Code too long
+     * Lower bound on the auto-fitted font size, as a fraction of image width.
+     * Width, because that is what a feed scales a share image to. Code too long
      * to fit at this size is truncated with an ellipsis rather than shrunk into
      * illegibility, so raising this trades lines of code for readability and
      * lowering it does the reverse.
      */
     readonly minFontScale?: number;
 }
+/**
+ * A font to load into the rasteriser, given either as a file path or as the
+ * font's bytes. Supply one entry per font file: weight and style are read from
+ * the file itself, so a bold and a regular face are two entries, and the SVG's
+ * `font-weight` picks between them.
+ *
+ * `family` is optional and does not affect matching, since the family name in
+ * the font file does that. When given on the first font it seeds `fontFamily`,
+ * which saves repeating the name for the common single-font case.
+ */
+export type FontSource = {
+    readonly family?: string;
+    /**
+     * Path to a `.ttf`, `.otf`, `.ttc` or `.otc` file, resolved from the
+     * current working directory when relative.
+     */
+    readonly path: string;
+} | {
+    readonly family?: string;
+    /**
+     * The font file's bytes, for fonts loaded from a bundle or fetched at
+     * build time rather than read from disk.
+     */
+    readonly data: Uint8Array;
+};
 /**
  * Image properties, typically read from a post's frontmatter. The schema is
  * intentionally open: templates read whatever fields they understand, so a
@@ -111,15 +196,236 @@ export interface MetaImageProps {
     readonly title?: string;
     readonly subtitle?: string;
     readonly version?: string | number;
+    /**
+     * An author photo, as a path to an image file or its `data:` URI. Named here
+     * with the other well-known props because the renderer has to load it before
+     * a template can draw it, which it cannot do for a prop it does not know.
+     */
+    readonly avatar?: string;
     readonly [key: string]: unknown;
 }
 /**
- * Reports something a template had to compromise on — code truncated to stay
- * legible, so far. Rendering carries on regardless: a share image is worth
- * having even when the input did not quite fit, but the author should hear
- * about it rather than discover it in someone else's timeline.
+ * Build image props from a post's whole frontmatter, so a project can use the
+ * fields it already has rather than adding a props block to every file.
+ *
+ * Return `undefined` to leave a post without images. That is the filter for
+ * drafts, section indexes and anything else in the tree that is not a page
+ * worth sharing. Without it, mapping frontmatter would mean an image for every
+ * markdown file there is. It only settles posts that say nothing for
+ * themselves, though: one declaring a props block is rendered either way, since
+ * asking for an image outright beats a blanket rule.
+ *
+ * The returned fields need not be complete: they are merged under whatever the
+ * post declares explicitly, and a missing template falls back to
+ * {@link ContentOptions.defaultTemplate}.
+ */
+export type PropsFromFrontmatter = (frontmatter: Record<string, unknown>) => Record<string, unknown> | undefined;
+/**
+ * How a post's slug, the base name for its images, is derived from its path
+ * when the frontmatter does not declare one.
+ *
+ * - `basename`: the filename without extension, or the parent directory for
+ *   `index.*`. Suits page bundles, where the image sits beside the content.
+ * - `route`: the whole path without extension, with `index.*` standing for its
+ *   directory, so `services/iam/index.md` becomes `services/iam` and a root
+ *   `index.md` becomes `index`. Suits a site addressed by route.
+ */
+export type SlugStrategy = "basename" | "route";
+/**
+ * How to read image props out of a content tree. Every field is optional.
+ *
+ * This is the host-project half of the job, finding posts and understanding
+ * their frontmatter. It is deliberately absent from {@link ResolvedConfig},
+ * which is what a template is handed, and where the props came from is none of
+ * a template's business.
+ */
+export interface ContentOptions {
+    /** Frontmatter key holding the image props object. Default `meta_img_props`. */
+    readonly propsKey?: string;
+    /** Field within the props object naming the template. Default `template`. */
+    readonly templateField?: string;
+    /** Template to use when the template field is absent. */
+    readonly defaultTemplate?: string;
+    /**
+     * Derive props from a post's existing frontmatter, for a site whose posts
+     * already carry the fields an image needs under different names. An explicit
+     * props object still wins field by field, so per-post overrides keep working.
+     */
+    readonly props?: PropsFromFrontmatter;
+    /**
+     * Top-level frontmatter field to read the post slug from (used as the base
+     * filename). Default `slug`; falls back to the file/directory name.
+     */
+    readonly slugField?: string;
+    /**
+     * How to derive a slug from a post's path when its frontmatter declares
+     * none. Default `basename`.
+     */
+    readonly slugStrategy?: SlugStrategy;
+    /** File extensions to include. Default `.md` and `.markdown`. */
+    readonly extensions?: readonly string[];
+}
+/**
+ * A discovered content file with the image props read from its frontmatter.
+ *
+ * It lives here rather than with the walker so that {@link Placement} can name
+ * it without the config module depending on the content module, for the reason
+ * {@link ContentOptions} does.
+ */
+export interface ContentFile {
+    /** Path relative to the walk `dir`. */
+    readonly contentPath: string;
+    /** Absolute path on disk. */
+    readonly absolutePath: string;
+    /** Base filename for this post's images (frontmatter slug, or path-derived). */
+    readonly slug: string;
+    readonly props: MetaImageProps;
+}
+/**
+ * Where an image is written, and the URL it is served at once it is.
+ *
+ * `outputPath` alone says where the bytes go and nothing about how anyone
+ * reaches them, so every site ends up rebuilding that mapping in its own
+ * templates, from information Colophon had at generate time and threw away.
+ *
+ * - `beside-content`: next to the post, which is the page-bundle convention
+ *   and what Colophon has always done. Still the default.
+ * - `public-dir`: gathered into one directory, as Astro, Eleventy and Vite
+ *   expect. A slug carrying directories keeps them underneath it.
+ * - `custom`: for a site whose mapping is its own, such as images under a
+ *   dated directory.
+ *
+ * `urlBase` is what makes a URL: it is prefixed to the image's path under the
+ * root that placed it, and without one there is no URL, because no directory
+ * on disk says by itself how it is served. It can be a site-relative path
+ * (`/og`) or an absolute one, for images served from a CDN.
+ *
+ * `hash` puts a digest of the image's inputs in its filename, so that changing
+ * a post gives its image a URL nobody has cached yet. It is opt-in because it
+ * also means the filename moves whenever the image does, which not every setup
+ * wants. `custom` has no say in it: a placement naming its own paths is the
+ * one that can hash them itself.
+ */
+export type Placement = {
+    readonly strategy: "beside-content";
+    readonly urlBase?: string;
+    readonly hash?: boolean;
+} | {
+    readonly strategy: "public-dir";
+    /** Directory to gather images into, relative to the working directory. */
+    readonly dir: string;
+    readonly urlBase?: string;
+    readonly hash?: boolean;
+} | {
+    readonly strategy: "custom";
+    readonly path: (file: ContentFile, size: OutputSize) => string;
+    /** Omit for images that are written but not served. */
+    readonly url?: (file: ContentFile, size: OutputSize) => string | undefined;
+};
+/**
+ * One image in the manifest.
+ *
+ * The dimensions are the ones it was actually rendered at, which is the point:
+ * sites hardcode 1200 and 630 into their meta tags because nothing told them
+ * otherwise, and a size they later change leaves the tags behind.
+ */
+export interface ManifestImage {
+    /** Absent where the placement knows no URL. See {@link Placement}. */
+    readonly url?: string;
+    readonly width: number;
+    readonly height: number;
+}
+/** One page's images, keyed by output size name. */
+export interface ManifestPage {
+    readonly images: Readonly<Record<string, ManifestImage>>;
+    /**
+     * The name of the most landscape image, by aspect ratio, with ties going to
+     * the first size configured. It is what a `summary_large_image` card wants,
+     * and picking it is a check every site currently writes for itself.
+     */
+    readonly widest: string;
+    /** Alt text, from the props' title. Absent for a page that has no title. */
+    readonly alt?: string;
+}
+/**
+ * What a build generated, for the site to read back: a JSON file listing every
+ * page's images, their URLs and the dimensions they were rendered at.
+ *
+ * Without it a site reconstructs all of that in template code, globbing for
+ * `*-og.png` to find the landscape variant, or writing image paths back into
+ * each post's frontmatter. All of it is known while generating.
+ *
+ * Pages are keyed by slug, which is what a site addresses a page by: with
+ * `slugStrategy: "route"` that is the route itself.
+ */
+export interface Manifest {
+    /** Schema version, so a reader can tell what it is holding. */
+    readonly version: 1;
+    readonly pages: Readonly<Record<string, ManifestPage>>;
+}
+/**
+ * One `<meta>` tag, as the attributes it carries.
+ *
+ * Open Graph names its tags with `property` and Twitter with `name`, which is
+ * a distinction sites get wrong routinely. Keeping them apart in the type
+ * means a component can spread a tag with `<meta {...tag} />` and be right
+ * either way.
+ */
+export type MetaTag = {
+    readonly property: string;
+    readonly content: string;
+} | {
+    readonly name: string;
+    readonly content: string;
+};
+/** Options for {@link MetaTag} generation. */
+export interface MetaTagOptions {
+    /**
+     * Absolute base for a site-relative image URL, e.g. `https://example.com`.
+     *
+     * Open Graph wants an absolute URL, since a crawler has no page to resolve a
+     * relative one against. A manifest records whatever the placement's
+     * `urlBase` said, which is usually site-relative. A URL that is already
+     * absolute is left alone, so a CDN base needs nothing here.
+     */
+    readonly baseUrl?: string;
+}
+/**
+ * Reports something a template had to compromise on, so far only code
+ * truncated to stay legible. Rendering carries on regardless, since a share
+ * image is worth having even when the input did not quite fit, but the author
+ * should hear about it rather than discover it in someone else's timeline.
  */
 export type WarningHandler = (message: string) => void;
+/**
+ * How a run of text is drawn, as far as its width is concerned. Style that
+ * cannot move a glyph's advance, such as colour, is not here.
+ */
+export interface TextStyle {
+    /** CSS-style stack, matched against the configured fonts in order. */
+    readonly fontFamily: string;
+    readonly fontSize: number;
+    /** Defaults to `400`. The nearest weight in the family is measured. */
+    readonly fontWeight?: number;
+    /**
+     * Advance width to assume, as a fraction of the font size, when no
+     * configured font matches the stack and the width has to be guessed.
+     *
+     * The default suits proportional text. A caller drawing monospace passes its
+     * own, because the same guess would be far too narrow for a face whose every
+     * glyph is as wide as an `M`.
+     */
+    readonly fallbackRatio?: number;
+}
+/**
+ * The width, in pixels, that `text` occupies when drawn in `style`.
+ *
+ * Exact where the style resolves to a font the build loaded, since then the
+ * glyph advances are read from the file the rasteriser is drawing with.
+ * Estimated otherwise, which is the best there is when the text will be drawn
+ * in whichever font the machine happens to have.
+ */
+export type MeasureText = (text: string, style: TextStyle) => number;
 /**
  * Everything a template needs to produce its SVG foreground content.
  */
@@ -127,15 +433,32 @@ export interface TemplateContext {
     readonly props: MetaImageProps;
     readonly config: ResolvedConfig;
     readonly dimensions: Dimensions;
+    /**
+     * Measures text in the fonts this build is rendering with, so a template can
+     * wrap and fit its text to the space it has rather than guessing.
+     */
+    readonly measure: MeasureText;
+    /**
+     * The configured logo, loaded and ready to draw, or `undefined` where there
+     * is none. Reading the file is the renderer's job rather than the template's,
+     * so that a template stays a synchronous function over values it was handed.
+     *
+     * Present and possibly undefined, as `footer` and `badge` are on a resolved
+     * config: a context is built once and handed over whole, and a field that is
+     * sometimes absent makes every construction of one a conditional.
+     */
+    readonly logo: ImageAsset | undefined;
+    /** The same for a post's `avatar` prop. */
+    readonly avatar: ImageAsset | undefined;
 }
 /**
  * A registered template. `render` returns the SVG *foreground* content (text,
  * badges, etc.) for the given dimensions; the background and the enclosing
  * `<svg>` root are added by the renderer.
  *
- * Rendering may be asynchronous — the `code` template loads syntax grammars on
- * demand — so `render` can return a promise. Simple templates can stay
- * synchronous and just return a string.
+ * Rendering may be asynchronous, since the `code` template loads syntax
+ * grammars on demand, so `render` can return a promise. Simple templates can
+ * stay synchronous and just return a string.
  */
 export interface Template {
     readonly name: string;
@@ -149,11 +472,35 @@ export interface ColophonConfig {
     readonly colors?: BrandColors;
     /** Explicit background, overriding the gradient derived from `colors`. */
     readonly background?: Background;
+    /**
+     * Fonts to load into the rasteriser, so the output does not depend on what
+     * the build machine happens to have installed. Supplying any font turns
+     * {@link ColophonConfig.systemFonts} off by default, which is the point:
+     * a laptop, CI and a Docker image then render the same image.
+     */
+    readonly fonts?: readonly FontSource[];
+    /**
+     * Whether to also load the machine's installed fonts. Defaults to `true`
+     * when no `fonts` are configured (nothing else would render) and `false`
+     * when they are. Turn it on alongside `fonts` to fall back to system fonts
+     * for families you have not supplied, at the cost of determinism.
+     */
+    readonly systemFonts?: boolean;
+    /**
+     * Font stack for template text. Defaults to the `family` of the first
+     * configured font, or to `DEFAULT_FONT_FAMILY` when there is none.
+     */
     readonly fontFamily?: string;
     /** Footer text drawn along the bottom edge. Omit (the default) for none. */
     readonly footer?: string;
     /** Corner badge for the `banner` template. Omit (the default) for none. */
     readonly badge?: Badge;
+    /**
+     * A logo to draw in the corner, which is most of what branding an image
+     * means. Where it goes is the template's business; how big it is comes from
+     * the image's own proportions and the size being drawn.
+     */
+    readonly logo?: ImageSource;
     /** Styling for the `code` template. */
     readonly code?: CodeStyle;
     /**
@@ -168,6 +515,95 @@ export interface ColophonConfig {
     readonly sizes?: readonly OutputSize[];
     /** Extra templates, merged over (and able to override) the built-ins. */
     readonly templates?: Readonly<Record<string, Template>>;
+    /**
+     * How to read props out of the content tree. Used by `generate` and the CLI;
+     * the render core never sees it.
+     */
+    readonly content?: ContentOptions;
+    /**
+     * Where images are written and what URL they end up at. Defaults to
+     * `beside-content`, which is what Colophon did before there was a choice.
+     */
+    readonly placement?: Placement;
+    /**
+     * Where to write a {@link Manifest} of everything the build generated,
+     * relative to the working directory. Omit (the default) to write none.
+     *
+     * Somewhere the site reads data from: `data/colophon.json` for Hugo,
+     * `src/data/` for Astro, `_data/` for Eleventy and Jekyll.
+     */
+    readonly manifest?: string;
+    /**
+     * One-off images that belong to the project rather than to any post, such as
+     * a package card or a repository social preview. Rendered by the same build,
+     * and skipped or re-rendered on the same stamps.
+     */
+    readonly extra?: readonly ExtraImage[];
+}
+/**
+ * A function a config module may export instead of a config object, so that a
+ * config which has to compute something, such as brand colours read out of the
+ * site's own stylesheet, can still be a config module rather than a script.
+ *
+ * It takes no arguments. Anything it might be handed is either already on the
+ * command line or a decision the config itself is making.
+ */
+export type ColophonConfigFactory = () => ColophonConfig | Promise<ColophonConfig>;
+/** What a config module's default export may be. */
+export type ColophonConfigInput = ColophonConfig | ColophonConfigFactory;
+/**
+ * Config an {@link OutputSize} may override for itself.
+ *
+ * Some settings only make sense per size: `code.minFontScale` is the clearest
+ * case, because a 1:1 square and a 1.91:1 landscape have very different amounts
+ * of vertical room for the same snippet. Without this the only way to vary one
+ * is a `generate` pass per size, which walks and parses the whole content tree
+ * again for each.
+ *
+ * Only what a template reads while drawing is overridable. `fonts`,
+ * `systemFonts` and `templates` are shared build inputs rather than part of the
+ * picture. `onWarning` is where messages go rather than what they say, and
+ * `sizes` inside a size would be nonsense.
+ */
+export interface SizeOverrides {
+    /**
+     * Merged over the config's `colors`, so a size can change one shade on its
+     * own. `brand` is optional here precisely because the rest are kept.
+     */
+    readonly colors?: Partial<BrandColors>;
+    /** Replaces the config's background outright. See the note on merging. */
+    readonly background?: Background;
+    readonly fontFamily?: string;
+    readonly footer?: string;
+    readonly badge?: Badge;
+    /** Replaces the config's logo, for a size that wants a different mark. */
+    readonly logo?: ImageSource;
+    /** Merged over the config's `code`, so a size can change one setting. */
+    readonly code?: CodeStyle;
+}
+/**
+ * A single image that is not tied to a content file: props, somewhere to write
+ * it, and the size to draw it at.
+ *
+ * The alternative is a script that calls `renderMetaImages` and writes the
+ * bytes itself, which is a lot of machinery for one card, and which keeps
+ * neither the rebuild stamps nor the build log a content image gets.
+ */
+export interface ExtraImage {
+    readonly props: MetaImageProps;
+    /**
+     * Where to write the PNG, resolved from the current working directory when
+     * relative. This image has no post to sit beside, so there is nothing to
+     * derive a path from and `generate`'s `outputPath` is not consulted.
+     */
+    readonly output: string;
+    /**
+     * The size to render at, {@link SizeOverrides} and all. An inline size is
+     * how a one-off image gets its own footer or palette without a whole entry
+     * in `sizes`. Defaults to the first configured size, since a one-off card
+     * usually wants to match the site's primary share format.
+     */
+    readonly size?: OutputSize;
 }
 /**
  * Fully-resolved configuration with all defaults applied.
@@ -175,9 +611,13 @@ export interface ColophonConfig {
 export interface ResolvedConfig {
     readonly colors: Required<BrandColors>;
     readonly background: Background;
+    /** Configured fonts, with every `path` made absolute. */
+    readonly fonts: readonly FontSource[];
+    readonly systemFonts: boolean;
     readonly fontFamily: string;
     readonly footer: string | undefined;
     readonly badge: Badge | undefined;
+    readonly logo: ImageSource | undefined;
     readonly code: Required<CodeStyle>;
     readonly onWarning: WarningHandler;
     readonly sizes: readonly OutputSize[];

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/validate/check.d.ts

@@ -0,0 +1,13 @@
+/** Whether a value is a plain object, and so has keys worth checking. */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+/** Whether a value is a list, and so has entries worth checking. */
+export declare function isList(value: unknown): value is readonly unknown[];
+/**
+ * Report every key of one config object that is not a known option. Anything
+ * that is not an object is left alone: the shape of a value is the type
+ * checker's business, and there are no keys to judge either way.
+ */
+export declare function checkKeys(value: unknown, path: string, known: readonly string[], problems: string[]): void;
+/** Check every entry of a list, naming each by its index. */
+export declare function checkEach(values: unknown, path: string, known: readonly string[], problems: string[]): void;
+//# sourceMappingURL=check.d.ts.map

package/dist/validate/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/validate/check.ts"],"names":[],"mappings":"AAEA,yEAAyE;AACzE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,oEAAoE;AACpE,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,OAAO,EAAE,CAElE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,QAAQ,EAAE,MAAM,EAAE,GACjB,IAAI,CAYN;AAED,6DAA6D;AAC7D,wBAAgB,SAAS,CACvB,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,QAAQ,EAAE,MAAM,EAAE,GACjB,IAAI,CAQN"}

package/dist/validate/check.js

@@ -0,0 +1,34 @@
+import { describeUnknownOption } from "./suggest.js";
+/** Whether a value is a plain object, and so has keys worth checking. */
+export function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** Whether a value is a list, and so has entries worth checking. */
+export function isList(value) {
+    return Array.isArray(value);
+}
+/**
+ * Report every key of one config object that is not a known option. Anything
+ * that is not an object is left alone: the shape of a value is the type
+ * checker's business, and there are no keys to judge either way.
+ */
+export function checkKeys(value, path, known, problems) {
+    if (!isRecord(value)) {
+        return;
+    }
+    for (const key of Object.keys(value)) {
+        if (!known.includes(key)) {
+            problems.push(describeUnknownOption(path === "" ? key : `${path}.${key}`, key, known));
+        }
+    }
+}
+/** Check every entry of a list, naming each by its index. */
+export function checkEach(values, path, known, problems) {
+    if (!isList(values)) {
+        return;
+    }
+    for (const [index, value] of values.entries()) {
+        checkKeys(value, `${path}[${String(index)}]`, known, problems);
+    }
+}
+//# sourceMappingURL=check.js.map

package/dist/validate/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/validate/check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,yEAAyE;AACzE,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CACvB,KAAc,EACd,IAAY,EACZ,KAAwB,EACxB,QAAkB;IAElB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO;IACT,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,QAAQ,CAAC,IAAI,CACX,qBAAqB,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,GAAG,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,CACxE,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,SAAS,CACvB,MAAe,EACf,IAAY,EACZ,KAAwB,EACxB,QAAkB;IAElB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACpB,OAAO;IACT,CAAC;IAED,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QAC9C,SAAS,CAAC,KAAK,EAAE,GAAG,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IACjE,CAAC;AACH,CAAC"}