@clipwright/core 0.39.0 → 0.40.0

package/dist/design.d.ts

@@ -0,0 +1,921 @@
+import { z } from "zod";
+/** The least contrast of text against the fill it sits on. */
+export declare const DESIGN_MIN_CONTRAST = 4.5;
+/** The ground caption words are drawn against: their black stroke or box. */
+export declare const CAPTION_ACCENT_GROUND = "#000000";
+export declare const DESIGN_MOTIONS: readonly ["calm", "playful", "premium", "punchy"];
+export type DesignMotion = (typeof DESIGN_MOTIONS)[number];
+export declare const DESIGN_RADII: readonly ["square", "soft", "round", "pill"];
+export type DesignRadius = (typeof DESIGN_RADII)[number];
+/** Each radius as a factor on the corners every template draws at `round`. */
+export declare const DESIGN_RADIUS_SCALE: Readonly<Record<DesignRadius, number>>;
+/** Faces the composition bundles, each under an open font licence, at a weight a caption preset already ships (a test keeps both). */
+export declare const DESIGN_FONTS: {
+    readonly "Plus Jakarta Sans": {
+        readonly weight: 800;
+        readonly category: "sans";
+        readonly license: "OFL-1.1";
+    };
+    readonly Inter: {
+        readonly weight: 700;
+        readonly category: "sans";
+        readonly license: "OFL-1.1";
+    };
+    readonly Montserrat: {
+        readonly weight: 800;
+        readonly category: "sans";
+        readonly license: "OFL-1.1";
+    };
+    readonly Roboto: {
+        readonly weight: 700;
+        readonly category: "sans";
+        readonly license: "OFL-1.1";
+    };
+    readonly "PT Sans": {
+        readonly weight: 700;
+        readonly category: "sans";
+        readonly license: "OFL-1.1";
+    };
+    readonly Oswald: {
+        readonly weight: 700;
+        readonly category: "condensed";
+        readonly license: "OFL-1.1";
+    };
+    readonly "Bebas Neue": {
+        readonly weight: 400;
+        readonly category: "condensed";
+        readonly license: "OFL-1.1";
+    };
+    readonly "Titan One": {
+        readonly weight: 400;
+        readonly category: "display";
+        readonly license: "OFL-1.1";
+    };
+    readonly Bungee: {
+        readonly weight: 400;
+        readonly category: "display";
+        readonly license: "OFL-1.1";
+    };
+    readonly Bangers: {
+        readonly weight: 400;
+        readonly category: "display";
+        readonly license: "OFL-1.1";
+    };
+    readonly Caveat: {
+        readonly weight: 700;
+        readonly category: "hand";
+        readonly license: "OFL-1.1";
+    };
+    readonly "Permanent Marker": {
+        readonly weight: 400;
+        readonly category: "hand";
+        readonly license: "Apache-2.0";
+    };
+};
+export type DesignFont = keyof typeof DESIGN_FONTS;
+export declare const DESIGN_FONT_FAMILIES: [DesignFont, ...DesignFont[]];
+export declare const DESIGN_PALETTE_ROLES: readonly ["background", "surface", "ink", "accent", "accent_ink"];
+export type DesignPaletteRole = (typeof DESIGN_PALETTE_ROLES)[number];
+export type DesignPalette = Record<DesignPaletteRole, string>;
+export interface DesignLook {
+    palette: DesignPalette;
+    fonts: {
+        display: DesignFont;
+        body: DesignFont;
+    };
+    radius: DesignRadius;
+    motion: DesignMotion;
+    /** Topics the look suits; the agent picks by them when the customer leaves the look to us. */
+    fits: string;
+}
+/** Our own looks: none is a house default, and none sits in hues 230–335 (a test keeps both). */
+export declare const DESIGN_LOOKS: {
+    readonly fresh_mint: {
+        readonly palette: {
+            readonly background: "#E9F7F1";
+            readonly surface: "#FFFFFF";
+            readonly ink: "#0F2A23";
+            readonly accent: "#12B886";
+            readonly accent_ink: "#062A1F";
+        };
+        readonly fonts: {
+            readonly display: "Plus Jakarta Sans";
+            readonly body: "Inter";
+        };
+        readonly radius: "round";
+        readonly motion: "playful";
+        readonly fits: "health, wellness, apps";
+    };
+    readonly sunset_coral: {
+        readonly palette: {
+            readonly background: "#FFF0E8";
+            readonly surface: "#FFFFFF";
+            readonly ink: "#2B1A14";
+            readonly accent: "#FF6B4A";
+            readonly accent_ink: "#2B1A14";
+        };
+        readonly fonts: {
+            readonly display: "Montserrat";
+            readonly body: "Inter";
+        };
+        readonly radius: "pill";
+        readonly motion: "punchy";
+        readonly fits: "food, lifestyle, retail";
+    };
+    readonly midnight_gold: {
+        readonly palette: {
+            readonly background: "#0E0F12";
+            readonly surface: "#1A1C21";
+            readonly ink: "#F5F1E8";
+            readonly accent: "#D4A64A";
+            readonly accent_ink: "#14110A";
+        };
+        readonly fonts: {
+            readonly display: "Montserrat";
+            readonly body: "Inter";
+        };
+        readonly radius: "soft";
+        readonly motion: "premium";
+        readonly fits: "luxury, finance, real estate";
+    };
+    readonly forest_paper: {
+        readonly palette: {
+            readonly background: "#F3EFE4";
+            readonly surface: "#FBF8F1";
+            readonly ink: "#1F2A1F";
+            readonly accent: "#2F6B3A";
+            readonly accent_ink: "#FFFFFF";
+        };
+        readonly fonts: {
+            readonly display: "PT Sans";
+            readonly body: "PT Sans";
+        };
+        readonly radius: "soft";
+        readonly motion: "calm";
+        readonly fits: "education, outdoors, sustainability";
+    };
+    readonly electric_lime: {
+        readonly palette: {
+            readonly background: "#0B0D0A";
+            readonly surface: "#161A14";
+            readonly ink: "#F2F7EC";
+            readonly accent: "#B8F23A";
+            readonly accent_ink: "#0B0D0A";
+        };
+        readonly fonts: {
+            readonly display: "Oswald";
+            readonly body: "Inter";
+        };
+        readonly radius: "square";
+        readonly motion: "punchy";
+        readonly fits: "fitness, sport, gaming";
+    };
+    readonly ocean_teal: {
+        readonly palette: {
+            readonly background: "#E6F3F7";
+            readonly surface: "#FFFFFF";
+            readonly ink: "#0B2530";
+            readonly accent: "#0B6E8A";
+            readonly accent_ink: "#FFFFFF";
+        };
+        readonly fonts: {
+            readonly display: "Inter";
+            readonly body: "Inter";
+        };
+        readonly radius: "round";
+        readonly motion: "calm";
+        readonly fits: "software, healthcare, services";
+    };
+    readonly sunny_pop: {
+        readonly palette: {
+            readonly background: "#FFF6D6";
+            readonly surface: "#FFFFFF";
+            readonly ink: "#1E1A10";
+            readonly accent: "#FFC21A";
+            readonly accent_ink: "#1E1A10";
+        };
+        readonly fonts: {
+            readonly display: "Titan One";
+            readonly body: "Inter";
+        };
+        readonly radius: "pill";
+        readonly motion: "playful";
+        readonly fits: "kids, entertainment, events";
+    };
+    readonly graphite_red: {
+        readonly palette: {
+            readonly background: "#F2F2F0";
+            readonly surface: "#FFFFFF";
+            readonly ink: "#111111";
+            readonly accent: "#C62D23";
+            readonly accent_ink: "#FFFFFF";
+        };
+        readonly fonts: {
+            readonly display: "Inter";
+            readonly body: "Roboto";
+        };
+        readonly radius: "square";
+        readonly motion: "punchy";
+        readonly fits: "news, media, marketing";
+    };
+};
+export type DesignLookId = keyof typeof DESIGN_LOOKS;
+export declare const DESIGN_LOOK_IDS: [DesignLookId, ...DesignLookId[]];
+export declare const designPalette: z.ZodObject<{
+    accent: z.ZodString;
+    accent_ink: z.ZodString;
+    background: z.ZodString;
+    ink: z.ZodString;
+    surface: z.ZodString;
+}, z.core.$strict>;
+/** Each text role against each fill it is drawn on; a pair under 4.5:1 is refused with the nearest readable shade, never shifted (D2). */
+export declare function designPaletteRefusals(palette: DesignPalette): {
+    path: string[];
+    message: string;
+}[];
+export declare const design: z.ZodObject<{
+    look: z.ZodOptional<z.ZodEnum<{
+        electric_lime: "electric_lime";
+        forest_paper: "forest_paper";
+        fresh_mint: "fresh_mint";
+        graphite_red: "graphite_red";
+        midnight_gold: "midnight_gold";
+        ocean_teal: "ocean_teal";
+        sunny_pop: "sunny_pop";
+        sunset_coral: "sunset_coral";
+    }>>;
+    palette: z.ZodOptional<z.ZodObject<{
+        accent: z.ZodString;
+        accent_ink: z.ZodString;
+        background: z.ZodString;
+        ink: z.ZodString;
+        surface: z.ZodString;
+    }, z.core.$strict>>;
+    fonts: z.ZodOptional<z.ZodObject<{
+        display: z.ZodOptional<z.ZodEnum<{
+            Bangers: "Bangers";
+            "Bebas Neue": "Bebas Neue";
+            Bungee: "Bungee";
+            Caveat: "Caveat";
+            Inter: "Inter";
+            Montserrat: "Montserrat";
+            Oswald: "Oswald";
+            "PT Sans": "PT Sans";
+            "Permanent Marker": "Permanent Marker";
+            "Plus Jakarta Sans": "Plus Jakarta Sans";
+            Roboto: "Roboto";
+            "Titan One": "Titan One";
+        }>>;
+        body: z.ZodOptional<z.ZodEnum<{
+            Bangers: "Bangers";
+            "Bebas Neue": "Bebas Neue";
+            Bungee: "Bungee";
+            Caveat: "Caveat";
+            Inter: "Inter";
+            Montserrat: "Montserrat";
+            Oswald: "Oswald";
+            "PT Sans": "PT Sans";
+            "Permanent Marker": "Permanent Marker";
+            "Plus Jakarta Sans": "Plus Jakarta Sans";
+            Roboto: "Roboto";
+            "Titan One": "Titan One";
+        }>>;
+    }, z.core.$strict>>;
+    logo_asset_id: z.ZodOptional<z.ZodString>;
+    radius: z.ZodOptional<z.ZodEnum<{
+        pill: "pill";
+        round: "round";
+        soft: "soft";
+        square: "square";
+    }>>;
+    motion: z.ZodOptional<z.ZodEnum<{
+        calm: "calm";
+        playful: "playful";
+        premium: "premium";
+        punchy: "punchy";
+    }>>;
+    style: z.ZodOptional<z.ZodEnum<{
+        clay: "clay";
+        comic: "comic";
+        engraving: "engraving";
+        fabric: "fabric";
+        film: "film";
+        glass: "glass";
+        line_boil: "line_boil";
+        paper_cutout: "paper_cutout";
+        pixel: "pixel";
+        sketchbook: "sketchbook";
+        zine: "zine";
+    }>>;
+}, z.core.$strict>;
+export type DesignInput = z.infer<typeof design>;
+/** The DNA every drawer reads: the palette with its derived roles, both fonts, radius, motion and logo. */
+export declare const resolvedDesign: z.ZodObject<{
+    look: z.ZodOptional<z.ZodEnum<{
+        electric_lime: "electric_lime";
+        forest_paper: "forest_paper";
+        fresh_mint: "fresh_mint";
+        graphite_red: "graphite_red";
+        midnight_gold: "midnight_gold";
+        ocean_teal: "ocean_teal";
+        sunny_pop: "sunny_pop";
+        sunset_coral: "sunset_coral";
+    }>>;
+    palette: z.ZodObject<{
+        accent_text: z.ZodString;
+        caption_accent: z.ZodString;
+        accent: z.ZodString;
+        accent_ink: z.ZodString;
+        background: z.ZodString;
+        ink: z.ZodString;
+        surface: z.ZodString;
+    }, z.core.$strict>;
+    fonts: z.ZodObject<{
+        display: z.ZodEnum<{
+            Bangers: "Bangers";
+            "Bebas Neue": "Bebas Neue";
+            Bungee: "Bungee";
+            Caveat: "Caveat";
+            Inter: "Inter";
+            Montserrat: "Montserrat";
+            Oswald: "Oswald";
+            "PT Sans": "PT Sans";
+            "Permanent Marker": "Permanent Marker";
+            "Plus Jakarta Sans": "Plus Jakarta Sans";
+            Roboto: "Roboto";
+            "Titan One": "Titan One";
+        }>;
+        body: z.ZodEnum<{
+            Bangers: "Bangers";
+            "Bebas Neue": "Bebas Neue";
+            Bungee: "Bungee";
+            Caveat: "Caveat";
+            Inter: "Inter";
+            Montserrat: "Montserrat";
+            Oswald: "Oswald";
+            "PT Sans": "PT Sans";
+            "Permanent Marker": "Permanent Marker";
+            "Plus Jakarta Sans": "Plus Jakarta Sans";
+            Roboto: "Roboto";
+            "Titan One": "Titan One";
+        }>;
+    }, z.core.$strip>;
+    radius: z.ZodEnum<{
+        pill: "pill";
+        round: "round";
+        soft: "soft";
+        square: "square";
+    }>;
+    motion: z.ZodEnum<{
+        calm: "calm";
+        playful: "playful";
+        premium: "premium";
+        punchy: "punchy";
+    }>;
+    style: z.ZodOptional<z.ZodEnum<{
+        clay: "clay";
+        comic: "comic";
+        engraving: "engraving";
+        fabric: "fabric";
+        film: "film";
+        glass: "glass";
+        line_boil: "line_boil";
+        paper_cutout: "paper_cutout";
+        pixel: "pixel";
+        sketchbook: "sketchbook";
+        zine: "zine";
+    }>>;
+    logo_asset_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ResolvedDesign = z.infer<typeof resolvedDesign>;
+/** A look's own values under the customer's; a palette without a look takes the plain defaults below. */
+export declare function resolveDesign(input: DesignInput): ResolvedDesign;
+/** The same object for tools/list, where every byte counts: no patterns or catalogues, which brand_kit lists; the API checks the full `design`. */
+export declare const mcpDesign: z.ZodObject<{
+    look: z.ZodOptional<z.ZodString>;
+    palette: z.ZodOptional<z.ZodObject<{
+        accent: z.ZodOptional<z.ZodString>;
+        accent_ink: z.ZodOptional<z.ZodString>;
+        background: z.ZodOptional<z.ZodString>;
+        ink: z.ZodOptional<z.ZodString>;
+        surface: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    fonts: z.ZodOptional<z.ZodObject<{
+        display: z.ZodOptional<z.ZodString>;
+        body: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    logo_asset_id: z.ZodOptional<z.ZodString>;
+    radius: z.ZodOptional<z.ZodEnum<{
+        pill: "pill";
+        round: "round";
+        soft: "soft";
+        square: "square";
+    }>>;
+    motion: z.ZodOptional<z.ZodEnum<{
+        calm: "calm";
+        playful: "playful";
+        premium: "premium";
+        punchy: "punchy";
+    }>>;
+    style: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/** Our looks and the bundled faces, listed with the kit so an agent picks from them without a catalogue in every tool. */
+export declare const designLookEntry: z.ZodObject<{
+    id: z.ZodEnum<{
+        electric_lime: "electric_lime";
+        forest_paper: "forest_paper";
+        fresh_mint: "fresh_mint";
+        graphite_red: "graphite_red";
+        midnight_gold: "midnight_gold";
+        ocean_teal: "ocean_teal";
+        sunny_pop: "sunny_pop";
+        sunset_coral: "sunset_coral";
+    }>;
+    fits: z.ZodString;
+    palette: z.ZodObject<{
+        accent: z.ZodString;
+        accent_ink: z.ZodString;
+        background: z.ZodString;
+        ink: z.ZodString;
+        surface: z.ZodString;
+    }, z.core.$strict>;
+    fonts: z.ZodObject<{
+        display: z.ZodEnum<{
+            Bangers: "Bangers";
+            "Bebas Neue": "Bebas Neue";
+            Bungee: "Bungee";
+            Caveat: "Caveat";
+            Inter: "Inter";
+            Montserrat: "Montserrat";
+            Oswald: "Oswald";
+            "PT Sans": "PT Sans";
+            "Permanent Marker": "Permanent Marker";
+            "Plus Jakarta Sans": "Plus Jakarta Sans";
+            Roboto: "Roboto";
+            "Titan One": "Titan One";
+        }>;
+        body: z.ZodEnum<{
+            Bangers: "Bangers";
+            "Bebas Neue": "Bebas Neue";
+            Bungee: "Bungee";
+            Caveat: "Caveat";
+            Inter: "Inter";
+            Montserrat: "Montserrat";
+            Oswald: "Oswald";
+            "PT Sans": "PT Sans";
+            "Permanent Marker": "Permanent Marker";
+            "Plus Jakarta Sans": "Plus Jakarta Sans";
+            Roboto: "Roboto";
+            "Titan One": "Titan One";
+        }>;
+    }, z.core.$strip>;
+    radius: z.ZodEnum<{
+        pill: "pill";
+        round: "round";
+        soft: "soft";
+        square: "square";
+    }>;
+    motion: z.ZodEnum<{
+        calm: "calm";
+        playful: "playful";
+        premium: "premium";
+        punchy: "punchy";
+    }>;
+}, z.core.$strip>;
+export declare function designCatalog(): {
+    looks: z.infer<typeof designLookEntry>[];
+    fonts: DesignFont[];
+};
+/** The account's saved DNA (#1122): a run naming neither design nor template_theme draws in it, so a series stays consistent. */
+export declare const BRAND_KIT_PATH = "/v1/brand-kit";
+export declare const brandKitInput: z.ZodObject<{
+    design: z.ZodNullable<z.ZodObject<{
+        look: z.ZodOptional<z.ZodEnum<{
+            electric_lime: "electric_lime";
+            forest_paper: "forest_paper";
+            fresh_mint: "fresh_mint";
+            graphite_red: "graphite_red";
+            midnight_gold: "midnight_gold";
+            ocean_teal: "ocean_teal";
+            sunny_pop: "sunny_pop";
+            sunset_coral: "sunset_coral";
+        }>>;
+        palette: z.ZodOptional<z.ZodObject<{
+            accent: z.ZodString;
+            accent_ink: z.ZodString;
+            background: z.ZodString;
+            ink: z.ZodString;
+            surface: z.ZodString;
+        }, z.core.$strict>>;
+        fonts: z.ZodOptional<z.ZodObject<{
+            display: z.ZodOptional<z.ZodEnum<{
+                Bangers: "Bangers";
+                "Bebas Neue": "Bebas Neue";
+                Bungee: "Bungee";
+                Caveat: "Caveat";
+                Inter: "Inter";
+                Montserrat: "Montserrat";
+                Oswald: "Oswald";
+                "PT Sans": "PT Sans";
+                "Permanent Marker": "Permanent Marker";
+                "Plus Jakarta Sans": "Plus Jakarta Sans";
+                Roboto: "Roboto";
+                "Titan One": "Titan One";
+            }>>;
+            body: z.ZodOptional<z.ZodEnum<{
+                Bangers: "Bangers";
+                "Bebas Neue": "Bebas Neue";
+                Bungee: "Bungee";
+                Caveat: "Caveat";
+                Inter: "Inter";
+                Montserrat: "Montserrat";
+                Oswald: "Oswald";
+                "PT Sans": "PT Sans";
+                "Permanent Marker": "Permanent Marker";
+                "Plus Jakarta Sans": "Plus Jakarta Sans";
+                Roboto: "Roboto";
+                "Titan One": "Titan One";
+            }>>;
+        }, z.core.$strict>>;
+        logo_asset_id: z.ZodOptional<z.ZodString>;
+        radius: z.ZodOptional<z.ZodEnum<{
+            pill: "pill";
+            round: "round";
+            soft: "soft";
+            square: "square";
+        }>>;
+        motion: z.ZodOptional<z.ZodEnum<{
+            calm: "calm";
+            playful: "playful";
+            premium: "premium";
+            punchy: "punchy";
+        }>>;
+        style: z.ZodOptional<z.ZodEnum<{
+            clay: "clay";
+            comic: "comic";
+            engraving: "engraving";
+            fabric: "fabric";
+            film: "film";
+            glass: "glass";
+            line_boil: "line_boil";
+            paper_cutout: "paper_cutout";
+            pixel: "pixel";
+            sketchbook: "sketchbook";
+            zine: "zine";
+        }>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const brandKit: z.ZodObject<{
+    design: z.ZodNullable<z.ZodObject<{
+        look: z.ZodOptional<z.ZodEnum<{
+            electric_lime: "electric_lime";
+            forest_paper: "forest_paper";
+            fresh_mint: "fresh_mint";
+            graphite_red: "graphite_red";
+            midnight_gold: "midnight_gold";
+            ocean_teal: "ocean_teal";
+            sunny_pop: "sunny_pop";
+            sunset_coral: "sunset_coral";
+        }>>;
+        palette: z.ZodOptional<z.ZodObject<{
+            accent: z.ZodString;
+            accent_ink: z.ZodString;
+            background: z.ZodString;
+            ink: z.ZodString;
+            surface: z.ZodString;
+        }, z.core.$strict>>;
+        fonts: z.ZodOptional<z.ZodObject<{
+            display: z.ZodOptional<z.ZodEnum<{
+                Bangers: "Bangers";
+                "Bebas Neue": "Bebas Neue";
+                Bungee: "Bungee";
+                Caveat: "Caveat";
+                Inter: "Inter";
+                Montserrat: "Montserrat";
+                Oswald: "Oswald";
+                "PT Sans": "PT Sans";
+                "Permanent Marker": "Permanent Marker";
+                "Plus Jakarta Sans": "Plus Jakarta Sans";
+                Roboto: "Roboto";
+                "Titan One": "Titan One";
+            }>>;
+            body: z.ZodOptional<z.ZodEnum<{
+                Bangers: "Bangers";
+                "Bebas Neue": "Bebas Neue";
+                Bungee: "Bungee";
+                Caveat: "Caveat";
+                Inter: "Inter";
+                Montserrat: "Montserrat";
+                Oswald: "Oswald";
+                "PT Sans": "PT Sans";
+                "Permanent Marker": "Permanent Marker";
+                "Plus Jakarta Sans": "Plus Jakarta Sans";
+                Roboto: "Roboto";
+                "Titan One": "Titan One";
+            }>>;
+        }, z.core.$strict>>;
+        logo_asset_id: z.ZodOptional<z.ZodString>;
+        radius: z.ZodOptional<z.ZodEnum<{
+            pill: "pill";
+            round: "round";
+            soft: "soft";
+            square: "square";
+        }>>;
+        motion: z.ZodOptional<z.ZodEnum<{
+            calm: "calm";
+            playful: "playful";
+            premium: "premium";
+            punchy: "punchy";
+        }>>;
+        style: z.ZodOptional<z.ZodEnum<{
+            clay: "clay";
+            comic: "comic";
+            engraving: "engraving";
+            fabric: "fabric";
+            film: "film";
+            glass: "glass";
+            line_boil: "line_boil";
+            paper_cutout: "paper_cutout";
+            pixel: "pixel";
+            sketchbook: "sketchbook";
+            zine: "zine";
+        }>>;
+    }, z.core.$strict>>;
+    updated_at: z.ZodNullable<z.ZodString>;
+    looks: z.ZodArray<z.ZodObject<{
+        id: z.ZodEnum<{
+            electric_lime: "electric_lime";
+            forest_paper: "forest_paper";
+            fresh_mint: "fresh_mint";
+            graphite_red: "graphite_red";
+            midnight_gold: "midnight_gold";
+            ocean_teal: "ocean_teal";
+            sunny_pop: "sunny_pop";
+            sunset_coral: "sunset_coral";
+        }>;
+        fits: z.ZodString;
+        palette: z.ZodObject<{
+            accent: z.ZodString;
+            accent_ink: z.ZodString;
+            background: z.ZodString;
+            ink: z.ZodString;
+            surface: z.ZodString;
+        }, z.core.$strict>;
+        fonts: z.ZodObject<{
+            display: z.ZodEnum<{
+                Bangers: "Bangers";
+                "Bebas Neue": "Bebas Neue";
+                Bungee: "Bungee";
+                Caveat: "Caveat";
+                Inter: "Inter";
+                Montserrat: "Montserrat";
+                Oswald: "Oswald";
+                "PT Sans": "PT Sans";
+                "Permanent Marker": "Permanent Marker";
+                "Plus Jakarta Sans": "Plus Jakarta Sans";
+                Roboto: "Roboto";
+                "Titan One": "Titan One";
+            }>;
+            body: z.ZodEnum<{
+                Bangers: "Bangers";
+                "Bebas Neue": "Bebas Neue";
+                Bungee: "Bungee";
+                Caveat: "Caveat";
+                Inter: "Inter";
+                Montserrat: "Montserrat";
+                Oswald: "Oswald";
+                "PT Sans": "PT Sans";
+                "Permanent Marker": "Permanent Marker";
+                "Plus Jakarta Sans": "Plus Jakarta Sans";
+                Roboto: "Roboto";
+                "Titan One": "Titan One";
+            }>;
+        }, z.core.$strip>;
+        radius: z.ZodEnum<{
+            pill: "pill";
+            round: "round";
+            soft: "soft";
+            square: "square";
+        }>;
+        motion: z.ZodEnum<{
+            calm: "calm";
+            playful: "playful";
+            premium: "premium";
+            punchy: "punchy";
+        }>;
+    }, z.core.$strip>>;
+    fonts: z.ZodArray<z.ZodEnum<{
+        Bangers: "Bangers";
+        "Bebas Neue": "Bebas Neue";
+        Bungee: "Bungee";
+        Caveat: "Caveat";
+        Inter: "Inter";
+        Montserrat: "Montserrat";
+        Oswald: "Oswald";
+        "PT Sans": "PT Sans";
+        "Permanent Marker": "Permanent Marker";
+        "Plus Jakarta Sans": "Plus Jakarta Sans";
+        Roboto: "Roboto";
+        "Titan One": "Titan One";
+    }>>;
+}, z.core.$strip>;
+export type BrandKit = z.infer<typeof brandKit>;
+/** A proposed DNA read from a public site's page and stylesheets, for the customer to confirm (#1122). */
+export declare const BRAND_EXTRACT_PATH = "/v1/brand/extract";
+export declare const extractBrandInput: z.ZodObject<{
+    url: z.ZodString;
+}, z.core.$strict>;
+export declare const extractBrandResponse: z.ZodObject<{
+    url: z.ZodString;
+    design: z.ZodObject<{
+        look: z.ZodOptional<z.ZodEnum<{
+            electric_lime: "electric_lime";
+            forest_paper: "forest_paper";
+            fresh_mint: "fresh_mint";
+            graphite_red: "graphite_red";
+            midnight_gold: "midnight_gold";
+            ocean_teal: "ocean_teal";
+            sunny_pop: "sunny_pop";
+            sunset_coral: "sunset_coral";
+        }>>;
+        palette: z.ZodOptional<z.ZodObject<{
+            accent: z.ZodString;
+            accent_ink: z.ZodString;
+            background: z.ZodString;
+            ink: z.ZodString;
+            surface: z.ZodString;
+        }, z.core.$strict>>;
+        fonts: z.ZodOptional<z.ZodObject<{
+            display: z.ZodOptional<z.ZodEnum<{
+                Bangers: "Bangers";
+                "Bebas Neue": "Bebas Neue";
+                Bungee: "Bungee";
+                Caveat: "Caveat";
+                Inter: "Inter";
+                Montserrat: "Montserrat";
+                Oswald: "Oswald";
+                "PT Sans": "PT Sans";
+                "Permanent Marker": "Permanent Marker";
+                "Plus Jakarta Sans": "Plus Jakarta Sans";
+                Roboto: "Roboto";
+                "Titan One": "Titan One";
+            }>>;
+            body: z.ZodOptional<z.ZodEnum<{
+                Bangers: "Bangers";
+                "Bebas Neue": "Bebas Neue";
+                Bungee: "Bungee";
+                Caveat: "Caveat";
+                Inter: "Inter";
+                Montserrat: "Montserrat";
+                Oswald: "Oswald";
+                "PT Sans": "PT Sans";
+                "Permanent Marker": "Permanent Marker";
+                "Plus Jakarta Sans": "Plus Jakarta Sans";
+                Roboto: "Roboto";
+                "Titan One": "Titan One";
+            }>>;
+        }, z.core.$strict>>;
+        logo_asset_id: z.ZodOptional<z.ZodString>;
+        radius: z.ZodOptional<z.ZodEnum<{
+            pill: "pill";
+            round: "round";
+            soft: "soft";
+            square: "square";
+        }>>;
+        motion: z.ZodOptional<z.ZodEnum<{
+            calm: "calm";
+            playful: "playful";
+            premium: "premium";
+            punchy: "punchy";
+        }>>;
+        style: z.ZodOptional<z.ZodEnum<{
+            clay: "clay";
+            comic: "comic";
+            engraving: "engraving";
+            fabric: "fabric";
+            film: "film";
+            glass: "glass";
+            line_boil: "line_boil";
+            paper_cutout: "paper_cutout";
+            pixel: "pixel";
+            sketchbook: "sketchbook";
+            zine: "zine";
+        }>>;
+    }, z.core.$strict>;
+    resolved: z.ZodObject<{
+        look: z.ZodOptional<z.ZodEnum<{
+            electric_lime: "electric_lime";
+            forest_paper: "forest_paper";
+            fresh_mint: "fresh_mint";
+            graphite_red: "graphite_red";
+            midnight_gold: "midnight_gold";
+            ocean_teal: "ocean_teal";
+            sunny_pop: "sunny_pop";
+            sunset_coral: "sunset_coral";
+        }>>;
+        palette: z.ZodObject<{
+            accent_text: z.ZodString;
+            caption_accent: z.ZodString;
+            accent: z.ZodString;
+            accent_ink: z.ZodString;
+            background: z.ZodString;
+            ink: z.ZodString;
+            surface: z.ZodString;
+        }, z.core.$strict>;
+        fonts: z.ZodObject<{
+            display: z.ZodEnum<{
+                Bangers: "Bangers";
+                "Bebas Neue": "Bebas Neue";
+                Bungee: "Bungee";
+                Caveat: "Caveat";
+                Inter: "Inter";
+                Montserrat: "Montserrat";
+                Oswald: "Oswald";
+                "PT Sans": "PT Sans";
+                "Permanent Marker": "Permanent Marker";
+                "Plus Jakarta Sans": "Plus Jakarta Sans";
+                Roboto: "Roboto";
+                "Titan One": "Titan One";
+            }>;
+            body: z.ZodEnum<{
+                Bangers: "Bangers";
+                "Bebas Neue": "Bebas Neue";
+                Bungee: "Bungee";
+                Caveat: "Caveat";
+                Inter: "Inter";
+                Montserrat: "Montserrat";
+                Oswald: "Oswald";
+                "PT Sans": "PT Sans";
+                "Permanent Marker": "Permanent Marker";
+                "Plus Jakarta Sans": "Plus Jakarta Sans";
+                Roboto: "Roboto";
+                "Titan One": "Titan One";
+            }>;
+        }, z.core.$strip>;
+        radius: z.ZodEnum<{
+            pill: "pill";
+            round: "round";
+            soft: "soft";
+            square: "square";
+        }>;
+        motion: z.ZodEnum<{
+            calm: "calm";
+            playful: "playful";
+            premium: "premium";
+            punchy: "punchy";
+        }>;
+        style: z.ZodOptional<z.ZodEnum<{
+            clay: "clay";
+            comic: "comic";
+            engraving: "engraving";
+            fabric: "fabric";
+            film: "film";
+            glass: "glass";
+            line_boil: "line_boil";
+            paper_cutout: "paper_cutout";
+            pixel: "pixel";
+            sketchbook: "sketchbook";
+            zine: "zine";
+        }>>;
+        logo_asset_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    evidence: z.ZodObject<{
+        colors: z.ZodArray<z.ZodObject<{
+            hex: z.ZodString;
+            count: z.ZodNumber;
+        }, z.core.$strip>>;
+        fonts: z.ZodArray<z.ZodString>;
+        logo_url: z.ZodNullable<z.ZodString>;
+        radius_px: z.ZodNullable<z.ZodNumber>;
+        stylesheets: z.ZodNumber;
+    }, z.core.$strip>;
+    warnings: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type ExtractBrandResponse = z.infer<typeof extractBrandResponse>;
+/** The DNA as the composition draws a template: camel-cased roles, the corner factor and the display face at its weight. */
+export declare function templateDesignOf(resolved: ResolvedDesign): {
+    background: string;
+    surface: string;
+    ink: string;
+    accent: string;
+    accentInk: string;
+    accentText: string;
+    radius: number;
+    font: {
+        family: string;
+        weight: number;
+    };
+};
+export declare function hexToHsl(color: string): {
+    h: number;
+    s: number;
+    l: number;
+};
+export declare function hslToHex({ h, s, l }: {
+    h: number;
+    s: number;
+    l: number;
+}): string;
+/** The colour itself when it reads on every ground, else the nearest lightness of its hue that does; failing that, white or black, whichever
+ * reads better on the worst ground, which a caller must check when grounds sit on both sides of it. */
+export declare function readableShade(color: string, ground: string | readonly string[], min?: number): string;