@idelio/contracts 0.1.0-beta.0

package/dist/creative-direction.js

@@ -0,0 +1,681 @@
+import { z } from "zod";
+export const brandStyles = [
+    "modern",
+    "minimal",
+    "bold",
+    "playful",
+    "elegant",
+    "corporate",
+    "luxury",
+    "organic",
+    "geometric",
+    "handcrafted",
+    "brutalist",
+    "editorial",
+    "retro",
+    "vintage",
+    "futuristic",
+    "timeless",
+    "art_deco",
+    "y2k",
+    "calm",
+    "energetic",
+    "warm",
+    "technical",
+    "rebellious",
+    "premium",
+];
+export const MAX_BRAND_STYLES = 5;
+export const BRAND_STYLES = {
+    modern: { label: "Modern", hint: "contemporary and clean, of this decade" },
+    minimal: { label: "Minimal", hint: "stripped back, generous space, few elements" },
+    bold: { label: "Bold", hint: "high contrast, confident, impossible to miss" },
+    playful: { label: "Playful", hint: "friendly and light, with a sense of humour" },
+    elegant: { label: "Elegant", hint: "refined and restrained, quietly expensive" },
+    corporate: { label: "Corporate", hint: "credible and institutional, trust first" },
+    luxury: { label: "Luxury", hint: "premium materials, deep tones, unhurried" },
+    organic: { label: "Organic", hint: "natural forms, soft edges, earthy" },
+    geometric: { label: "Geometric", hint: "built from circles, squares and precise angles" },
+    handcrafted: { label: "Handcrafted", hint: "made by a person, slight imperfection welcome" },
+    brutalist: { label: "Brutalist", hint: "raw, structural, unapologetically plain" },
+    editorial: { label: "Editorial", hint: "magazine typography, strong hierarchy" },
+    retro: { label: "Retro", hint: "knowingly borrowed from the 70s and 80s" },
+    vintage: { label: "Vintage", hint: "aged and heritage, as if it has always existed" },
+    futuristic: { label: "Futuristic", hint: "forward looking, technical, slightly synthetic" },
+    timeless: { label: "Timeless", hint: "classical proportions that will not date" },
+    art_deco: { label: "Art deco", hint: "symmetry, gold, stepped geometry" },
+    y2k: { label: "Y2K", hint: "early web optimism, chrome and gradients" },
+    calm: { label: "Calm", hint: "low contrast, quiet, reassuring" },
+    energetic: { label: "Energetic", hint: "saturated, kinetic, forward leaning" },
+    warm: { label: "Warm", hint: "human and inviting, warm hues" },
+    technical: { label: "Technical", hint: "precise, systematic, engineered" },
+    rebellious: { label: "Rebellious", hint: "breaks the category's rules on purpose" },
+    premium: { label: "Premium", hint: "considered detail, restraint over decoration" },
+};
+export const brandStyleGroupIds = ["character", "aesthetic", "era", "energy"];
+export const DEFAULT_STYLE_GROUP_ID = "character";
+export const brandStyleGroups = [
+    {
+        id: "character",
+        label: "Character",
+        styles: ["modern", "minimal", "bold", "playful", "elegant", "corporate"],
+    },
+    {
+        id: "aesthetic",
+        label: "Aesthetic",
+        styles: ["luxury", "organic", "geometric", "handcrafted", "brutalist", "editorial"],
+    },
+    {
+        id: "era",
+        label: "Era",
+        styles: ["retro", "vintage", "futuristic", "timeless", "art_deco", "y2k"],
+    },
+    {
+        id: "energy",
+        label: "Energy",
+        styles: ["calm", "energetic", "warm", "technical", "rebellious", "premium"],
+    },
+];
+export const paletteIds = [
+    "indigo",
+    "teal",
+    "amber",
+    "forest",
+    "rose",
+    "slate",
+    "midnight",
+    "coral",
+    "sand",
+    "plum",
+    "ocean",
+    "citrus",
+    "mono_warm",
+    "berry",
+];
+export const paletteDirections = [
+    {
+        id: "indigo",
+        name: "Indigo focus",
+        desc: "Confident and modern - great for tech and SaaS.",
+        colors: ["#4744C9", "#6D6EF0", "#14162E", "#EEEEFC", "#A5A3F0"],
+        mood: ["technical", "modern", "trustworthy"],
+    },
+    {
+        id: "teal",
+        name: "Calm teal",
+        desc: "Fresh and trustworthy - health and wellness.",
+        colors: ["#0EA5A4", "#134E4A", "#99F6E4", "#F0FDFA", "#5EEAD4"],
+        mood: ["calm", "clean", "health"],
+    },
+    {
+        id: "amber",
+        name: "Warm amber",
+        desc: "Inviting and artisanal - food, craft and retail.",
+        colors: ["#B45309", "#C9884F", "#EADBC8", "#2A1B12", "#F59E0B"],
+        mood: ["warm", "handcrafted", "food"],
+    },
+    {
+        id: "forest",
+        name: "Deep forest",
+        desc: "Grounded and premium - sustainable brands.",
+        colors: ["#16A34A", "#065F46", "#BBF7D0", "#052E16", "#22C55E"],
+        mood: ["organic", "sustainable", "grounded"],
+    },
+    {
+        id: "rose",
+        name: "Rose bloom",
+        desc: "Elegant and editorial - beauty and lifestyle.",
+        colors: ["#E11D48", "#5B1E3F", "#FBCFE1", "#FFF1F5", "#F472A0"],
+        mood: ["elegant", "beauty", "editorial"],
+    },
+    {
+        id: "slate",
+        name: "Slate mono",
+        desc: "Minimal and precise - premium and pro tools.",
+        colors: ["#111827", "#374151", "#9CA3AF", "#F3F4F6", "#6B7280"],
+        mood: ["minimal", "technical", "premium"],
+    },
+    {
+        id: "midnight",
+        name: "Midnight blue",
+        desc: "Serious and nocturnal - fintech and security.",
+        colors: ["#1E3A8A", "#0B1220", "#93C5FD", "#F8FAFC", "#3B82F6"],
+        mood: ["corporate", "secure", "night"],
+    },
+    {
+        id: "coral",
+        name: "Coral pop",
+        desc: "Energetic and social - consumer apps.",
+        colors: ["#FF6B5B", "#7C2D12", "#FFD9D2", "#FFF7F5", "#FB923C"],
+        mood: ["energetic", "playful", "consumer"],
+    },
+    {
+        id: "sand",
+        name: "Sand and ink",
+        desc: "Quiet and editorial - studios and publishing.",
+        colors: ["#C4A484", "#2B2622", "#EFE6DA", "#FBF8F4", "#8A7A66"],
+        mood: ["timeless", "editorial", "calm"],
+    },
+    {
+        id: "plum",
+        name: "Deep plum",
+        desc: "Rich and expressive - culture and events.",
+        colors: ["#6D28D9", "#2E1065", "#DDD6FE", "#FAF5FF", "#A78BFA"],
+        mood: ["luxury", "expressive", "culture"],
+    },
+    {
+        id: "ocean",
+        name: "Ocean depth",
+        desc: "Wide and dependable - logistics and travel.",
+        colors: ["#0369A1", "#082F49", "#BAE6FD", "#F0F9FF", "#38BDF8"],
+        mood: ["dependable", "travel", "open"],
+    },
+    {
+        id: "citrus",
+        name: "Citrus bright",
+        desc: "Optimistic and loud - sport and food delivery.",
+        colors: ["#CA8A04", "#422006", "#FEF08A", "#FEFCE8", "#FACC15"],
+        mood: ["energetic", "optimistic", "sport"],
+    },
+    {
+        id: "mono_warm",
+        name: "Warm mono",
+        desc: "One hue, many steps - restrained and premium.",
+        colors: ["#3F3A34", "#1C1917", "#D6D3D1", "#FAFAF9", "#78716C"],
+        mood: ["minimal", "premium", "warm"],
+    },
+    {
+        id: "berry",
+        name: "Berry contrast",
+        desc: "Bold and modern - fashion and media.",
+        colors: ["#BE123C", "#4C0519", "#FECDD3", "#FFF1F2", "#F43F5E"],
+        mood: ["bold", "fashion", "modern"],
+    },
+];
+export const CUSTOM_PALETTE_DEFAULT = [
+    "#4744C9",
+    "#14162E",
+    "#F59E0B",
+    "#E5E7EB",
+    "#F8FAFC",
+];
+export const fontPairIds = [
+    "sora_inter",
+    "fraunces_inter",
+    "space_inter",
+    "playfair_source",
+    "dmserif_dmsans",
+    "outfit_inter",
+    "manrope_manrope",
+    "bricolage_inter",
+    "instrument_inter",
+    "archivo_archivo",
+    "lora_lato",
+    "syne_inter",
+    "epilogue_inter",
+    "ibmplex_ibmplex",
+    "jost_inter",
+    "newsreader_inter",
+    "chivo_chivo",
+    "unbounded_inter",
+    "figtree_figtree",
+    "spectral_inter",
+];
+export const fontPairCategories = [
+    "geometric",
+    "editorial",
+    "technical",
+    "humanist",
+    "display",
+];
+const INTER = {
+    family: "Inter Variable",
+    fontsourcePackage: "@fontsource-variable/inter",
+    weights: "100 900",
+    license: "OFL",
+};
+export const fontPairs = [
+    {
+        id: "sora_inter",
+        name: "Sora + Inter",
+        desc: "Geometric, modern, versatile.",
+        category: "geometric",
+        heading: {
+            family: "Sora Variable",
+            fontsourcePackage: "@fontsource-variable/sora",
+            weights: "100 800",
+            license: "OFL",
+        },
+        body: INTER,
+    },
+    {
+        id: "fraunces_inter",
+        name: "Fraunces + Inter",
+        desc: "Editorial with a warm, wobbly contrast.",
+        category: "editorial",
+        heading: {
+            family: "Fraunces Variable",
+            fontsourcePackage: "@fontsource-variable/fraunces",
+            weights: "100 900",
+            license: "OFL",
+        },
+        body: INTER,
+    },
+    {
+        id: "space_inter",
+        name: "Space Grotesk + Inter",
+        desc: "Technical and precise, with character.",
+        category: "technical",
+        heading: {
+            family: "Space Grotesk Variable",
+            fontsourcePackage: "@fontsource-variable/space-grotesk",
+            weights: "300 700",
+            license: "OFL",
+        },
+        body: INTER,
+    },
+    {
+        id: "playfair_source",
+        name: "Playfair Display + Source Sans 3",
+        desc: "High contrast serif over a calm sans.",
+        category: "editorial",
+        heading: {
+            family: "Playfair Display Variable",
+            fontsourcePackage: "@fontsource-variable/playfair-display",
+            weights: "400 900",
+            license: "OFL",
+        },
+        body: {
+            family: "Source Sans 3 Variable",
+            fontsourcePackage: "@fontsource-variable/source-sans-3",
+            weights: "200 900",
+            license: "OFL",
+        },
+    },
+    {
+        id: "dmserif_dmsans",
+        name: "DM Serif Display + DM Sans",
+        desc: "One family's serif and sans, made to pair.",
+        category: "editorial",
+        heading: {
+            family: "DM Serif Display",
+            fontsourcePackage: "@fontsource/dm-serif-display",
+            weights: "400",
+            license: "OFL",
+        },
+        body: {
+            family: "DM Sans Variable",
+            fontsourcePackage: "@fontsource-variable/dm-sans",
+            weights: "100 1000",
+            license: "OFL",
+        },
+    },
+    {
+        id: "outfit_inter",
+        name: "Outfit + Inter",
+        desc: "Wide geometric caps, friendly and current.",
+        category: "geometric",
+        heading: {
+            family: "Outfit Variable",
+            fontsourcePackage: "@fontsource-variable/outfit",
+            weights: "100 900",
+            license: "OFL",
+        },
+        body: INTER,
+    },
+    {
+        id: "manrope_manrope",
+        name: "Manrope",
+        desc: "One humanist sans doing both jobs.",
+        category: "humanist",
+        heading: {
+            family: "Manrope Variable",
+            fontsourcePackage: "@fontsource-variable/manrope",
+            weights: "200 800",
+            license: "OFL",
+        },
+        body: {
+            family: "Manrope Variable",
+            fontsourcePackage: "@fontsource-variable/manrope",
+            weights: "200 800",
+            license: "OFL",
+        },
+    },
+    {
+        id: "bricolage_inter",
+        name: "Bricolage Grotesque + Inter",
+        desc: "Deliberately irregular, memorable headlines.",
+        category: "display",
+        heading: {
+            family: "Bricolage Grotesque Variable",
+            fontsourcePackage: "@fontsource-variable/bricolage-grotesque",
+            weights: "200 800",
+            license: "OFL",
+        },
+        body: INTER,
+    },
+    {
+        id: "instrument_inter",
+        name: "Instrument Serif + Inter",
+        desc: "Tall, quiet serif for a restrained brand.",
+        category: "editorial",
+        heading: {
+            family: "Instrument Serif",
+            fontsourcePackage: "@fontsource/instrument-serif",
+            weights: "400",
+            license: "OFL",
+        },
+        body: INTER,
+    },
+    {
+        id: "archivo_archivo",
+        name: "Archivo Black + Archivo",
+        desc: "Heavy grotesque headlines over its own text face.",
+        category: "display",
+        heading: {
+            family: "Archivo Black",
+            fontsourcePackage: "@fontsource/archivo-black",
+            weights: "400",
+            license: "OFL",
+        },
+        body: {
+            family: "Archivo Variable",
+            fontsourcePackage: "@fontsource-variable/archivo",
+            weights: "100 900",
+            license: "OFL",
+        },
+    },
+    {
+        id: "lora_lato",
+        name: "Lora + Lato",
+        desc: "Warm bookish serif with a neutral sans.",
+        category: "humanist",
+        heading: {
+            family: "Lora Variable",
+            fontsourcePackage: "@fontsource-variable/lora",
+            weights: "400 700",
+            license: "OFL",
+        },
+        body: {
+            family: "Lato",
+            fontsourcePackage: "@fontsource/lato",
+            weights: "400;700",
+            license: "OFL",
+        },
+    },
+    {
+        id: "syne_inter",
+        name: "Syne + Inter",
+        desc: "Art-scene display face, unmistakably contemporary.",
+        category: "display",
+        heading: {
+            family: "Syne Variable",
+            fontsourcePackage: "@fontsource-variable/syne",
+            weights: "400 800",
+            license: "OFL",
+        },
+        body: INTER,
+    },
+    {
+        id: "epilogue_inter",
+        name: "Epilogue + Inter",
+        desc: "Crisp geometric sans with a sharp italic.",
+        category: "geometric",
+        heading: {
+            family: "Epilogue Variable",
+            fontsourcePackage: "@fontsource-variable/epilogue",
+            weights: "100 900",
+            license: "OFL",
+        },
+        body: INTER,
+    },
+    {
+        id: "ibmplex_ibmplex",
+        name: "IBM Plex Sans",
+        desc: "Engineered and systematic, one family throughout.",
+        category: "technical",
+        heading: {
+            family: "IBM Plex Sans Variable",
+            fontsourcePackage: "@fontsource-variable/ibm-plex-sans",
+            weights: "100 700",
+            license: "OFL",
+        },
+        body: {
+            family: "IBM Plex Sans Variable",
+            fontsourcePackage: "@fontsource-variable/ibm-plex-sans",
+            weights: "100 700",
+            license: "OFL",
+        },
+    },
+    {
+        id: "jost_inter",
+        name: "Jost + Inter",
+        desc: "Futura-adjacent geometry, clean and timeless.",
+        category: "geometric",
+        heading: {
+            family: "Jost Variable",
+            fontsourcePackage: "@fontsource-variable/jost",
+            weights: "100 900",
+            license: "OFL",
+        },
+        body: INTER,
+    },
+    {
+        id: "newsreader_inter",
+        name: "Newsreader + Inter",
+        desc: "Made for long reads, comfortable at any size.",
+        category: "editorial",
+        heading: {
+            family: "Newsreader Variable",
+            fontsourcePackage: "@fontsource-variable/newsreader",
+            weights: "200 800",
+            license: "OFL",
+        },
+        body: INTER,
+    },
+    {
+        id: "chivo_chivo",
+        name: "Chivo",
+        desc: "Sturdy grotesque, plain-spoken and legible.",
+        category: "humanist",
+        heading: {
+            family: "Chivo Variable",
+            fontsourcePackage: "@fontsource-variable/chivo",
+            weights: "100 900",
+            license: "OFL",
+        },
+        body: {
+            family: "Chivo Variable",
+            fontsourcePackage: "@fontsource-variable/chivo",
+            weights: "100 900",
+            license: "OFL",
+        },
+    },
+    {
+        id: "unbounded_inter",
+        name: "Unbounded + Inter",
+        desc: "Loud display face for a brand that wants noticing.",
+        category: "display",
+        heading: {
+            family: "Unbounded Variable",
+            fontsourcePackage: "@fontsource-variable/unbounded",
+            weights: "200 900",
+            license: "OFL",
+        },
+        body: INTER,
+    },
+    {
+        id: "figtree_figtree",
+        name: "Figtree",
+        desc: "Soft, approachable sans across the whole system.",
+        category: "humanist",
+        heading: {
+            family: "Figtree Variable",
+            fontsourcePackage: "@fontsource-variable/figtree",
+            weights: "300 900",
+            license: "OFL",
+        },
+        body: {
+            family: "Figtree Variable",
+            fontsourcePackage: "@fontsource-variable/figtree",
+            weights: "300 900",
+            license: "OFL",
+        },
+    },
+    {
+        id: "spectral_inter",
+        name: "Spectral + Inter",
+        desc: "Screen-first serif, quietly authoritative.",
+        category: "editorial",
+        heading: {
+            family: "Spectral",
+            fontsourcePackage: "@fontsource/spectral",
+            weights: "400;600;700",
+            license: "OFL",
+        },
+        body: INTER,
+    },
+];
+export const logoMarkStyles = [
+    "geometric",
+    "rounded",
+    "circular",
+    "sharp",
+    "monogram",
+    "lettermark",
+    "abstract",
+    "emblem",
+    "organic",
+    "line",
+    "gradient",
+    "wordmark_only",
+];
+export const LOGO_MARK_STYLES = {
+    geometric: {
+        label: "Geometric",
+        desc: "Built from precise circles, squares and angles.",
+        category: "geometric",
+        previewPath: "M4 6h14v14H4Z M22 6h14v14H22Z M4 24h32v10H4Z",
+    },
+    rounded: {
+        label: "Rounded",
+        desc: "Soft forms with generous corner radii.",
+        category: "humanist",
+        previewPath: "M11 6h18a7 7 0 0 1 7 7v14a7 7 0 0 1-7 7H11a7 7 0 0 1-7-7V13a7 7 0 0 1 7-7Z",
+    },
+    circular: {
+        label: "Circular",
+        desc: "A balanced badge, contained in a circle.",
+        category: "editorial",
+        previewPath: "M20 4a16 16 0 1 1 0 32 16 16 0 0 1 0-32Z",
+    },
+    sharp: {
+        label: "Sharp",
+        desc: "Crisp angular geometry, confident corners.",
+        category: "geometric",
+        previewPath: "M20 2 38 20 20 38 2 20Z",
+    },
+    monogram: {
+        label: "Monogram",
+        desc: "Built from the brand's initials.",
+        previewPath: "M6 6h6l8 12 8-12h6v28h-7V19l-7 10-7-10v15H6Z",
+    },
+    lettermark: {
+        label: "Lettermark",
+        desc: "A single stylised letterform.",
+        previewPath: "M20 5 34 35h-7L20 19 13 35H6Z",
+    },
+    abstract: {
+        label: "Abstract",
+        desc: "Non-representational, meaning through form.",
+        category: "display",
+        previewPath: "M13 5a10 10 0 1 1 0 20 10 10 0 0 1 0-20Z M27 15a10 10 0 1 1 0 20 10 10 0 0 1 0-20Z",
+    },
+    emblem: {
+        label: "Emblem",
+        desc: "A pictorial motif enclosed inside a shape.",
+        previewPath: "M20 3 35 9v12c0 8-6 14-15 17-9-3-15-9-15-17V9Z",
+    },
+    organic: {
+        label: "Organic",
+        desc: "Natural forms with flowing edges.",
+        category: "humanist",
+        previewPath: "M35 5c0 15-9 27-24 30C11 20 20 8 35 5Z",
+    },
+    line: {
+        label: "Line",
+        desc: "Single-weight line art, no heavy fills.",
+        category: "technical",
+        previewPath: "M6 34 20 6l14 28h-4.5L20 15 10.5 34Z",
+    },
+    gradient: {
+        label: "Gradient",
+        desc: "A smooth two-tone fade across the mark.",
+        category: "display",
+        previewPath: "M20 4a16 16 0 1 1 0 32Z M20 4a16 16 0 0 0-13 25h13Z",
+    },
+    wordmark_only: {
+        label: "Wordmark only",
+        desc: "Typographic name, with no separate icon.",
+        previewPath: "M4 13h32v6H4Z M4 23h22v6H4Z",
+    },
+};
+export const logoLockups = ["horizontal", "stacked", "icon_only"];
+export const LOGO_LOCKUPS = {
+    horizontal: { label: "Horizontal", desc: "Mark on the left, name on the right." },
+    stacked: { label: "Stacked", desc: "Mark above, name centred below." },
+    icon_only: { label: "Icon only", desc: "The mark alone, with no name." },
+};
+export const AI_CHOICE = "ai";
+export const hexColorSchema = z
+    .string()
+    .regex(/^#[0-9a-fA-F]{6}$/, "must be a six-digit hex color, e.g. #4744C9");
+export const colorDirectionSchema = z.discriminatedUnion("mode", [
+    z.object({ mode: z.literal(AI_CHOICE) }).strict(),
+    z.object({ mode: z.literal("preset"), preset_id: z.enum(paletteIds) }).strict(),
+    z.object({ mode: z.literal("custom"), colors: z.array(hexColorSchema).min(3).max(6) }).strict(),
+]);
+export const typographyDirectionSchema = z.discriminatedUnion("mode", [
+    z.object({ mode: z.literal(AI_CHOICE) }).strict(),
+    z.object({ mode: z.literal("preset"), preset_id: z.enum(fontPairIds) }).strict(),
+]);
+export const logoDirectionSchema = z
+    .object({
+    style: z.union([z.literal(AI_CHOICE), z.enum(logoMarkStyles)]).default(AI_CHOICE),
+    lockup: z.union([z.literal(AI_CHOICE), z.enum(logoLockups)]).default(AI_CHOICE),
+    include_tagline: z.boolean().default(false),
+})
+    .strict()
+    .refine((v) => !(v.style === "wordmark_only" && v.lockup === "icon_only"), {
+    path: ["lockup"],
+    message: 'a "wordmark only" mark cannot use the "icon only" lockup - there is no icon',
+});
+export const creativeDirectionSchema = z
+    .object({
+    styles: z.array(z.enum(brandStyles)).max(MAX_BRAND_STYLES).optional(),
+    color: colorDirectionSchema.optional(),
+    typography: typographyDirectionSchema.optional(),
+    logo: logoDirectionSchema.optional(),
+})
+    .strict();
+export const DEFAULT_CREATIVE_DIRECTION = {
+    styles: [],
+    color: { mode: AI_CHOICE },
+    typography: { mode: AI_CHOICE },
+    logo: { style: AI_CHOICE, lockup: AI_CHOICE, include_tagline: false },
+};
+export const SHORTLIST_SIZES = { palettes: 12, font_pairs: 8, logo_styles: 6 };
+export const creativeDirectionsRequestSchema = z
+    .object({
+    prompt: z.string().min(8).max(500),
+    styles: z.array(z.enum(brandStyles)).max(MAX_BRAND_STYLES).optional(),
+})
+    .strict();
+export const creativeDirectionsResponseSchema = z
+    .object({
+    palettes: z.array(z.enum(paletteIds)),
+    font_pairs: z.array(z.enum(fontPairIds)),
+    logo_styles: z.array(z.enum(logoMarkStyles)),
+    rationale: z.string().max(200).optional(),
+})
+    .strict();