@ideare/kit 0.0.0-stage → 0.1.0-next.0

package/dist/fonts/catalog.js

@@ -0,0 +1,345 @@
+/** 37 OFL families from Google Fonts, each with a latin subset for pt-BR and es. */
+export const FONT_CATALOG = [
+    {
+        family: "Instrument Sans",
+        id: "instrument-sans",
+        version: "5.3.0",
+        category: "sans-serif",
+        weights: [400, 500, 600, 700],
+        roles: ["display", "text"],
+        tags: { Business: 90, Calm: 80, Competent: 85, Loud: 54, Sincere: 63, Stiff: 54 },
+    },
+    {
+        family: "Funnel Sans",
+        id: "funnel-sans",
+        version: "5.3.0",
+        category: "sans-serif",
+        weights: [300, 400, 500, 600, 700, 800],
+        roles: ["display"],
+        tags: { Competent: 68 },
+    },
+    {
+        family: "Onest",
+        id: "onest",
+        version: "5.3.1",
+        category: "sans-serif",
+        weights: [100, 200, 300, 400, 500, 600, 700, 800, 900],
+        roles: ["display", "text"],
+        tags: { Business: 55, Calm: 70, Competent: 62, Loud: 84 },
+    },
+    {
+        family: "DM Sans",
+        id: "dm-sans",
+        version: "5.3.0",
+        category: "sans-serif",
+        weights: [100, 200, 300, 400, 500, 600, 700, 800, 900],
+        roles: ["display", "text"],
+        tags: { Business: 77, Calm: 83, Loud: 81 },
+    },
+    {
+        family: "Manrope",
+        id: "manrope",
+        version: "5.3.0",
+        category: "sans-serif",
+        weights: [200, 300, 400, 500, 600, 700, 800],
+        roles: ["display", "text"],
+        tags: { Business: 55, Calm: 75, Competent: 72, Rugged: 50 },
+    },
+    {
+        family: "Plus Jakarta Sans",
+        id: "plus-jakarta-sans",
+        version: "5.3.0",
+        category: "sans-serif",
+        weights: [200, 300, 400, 500, 600, 700, 800],
+        roles: ["display", "text"],
+        tags: { Business: 60, Calm: 77, Competent: 73 },
+    },
+    {
+        family: "Outfit",
+        id: "outfit",
+        version: "5.3.0",
+        category: "sans-serif",
+        weights: [100, 200, 300, 400, 500, 600, 700, 800, 900],
+        roles: ["display", "text"],
+        tags: { Business: 59, Calm: 82, Competent: 70, Loud: 87 },
+    },
+    {
+        family: "Sora",
+        id: "sora",
+        version: "5.3.0",
+        category: "sans-serif",
+        weights: [100, 200, 300, 400, 500, 600, 700, 800],
+        roles: ["display", "text"],
+        tags: { Business: 60, Calm: 70, Competent: 74 },
+    },
+    {
+        family: "Work Sans",
+        id: "work-sans",
+        version: "5.3.0",
+        category: "sans-serif",
+        weights: [100, 200, 300, 400, 500, 600, 700, 800, 900],
+        roles: ["display", "text"],
+        tags: { Business: 70, Calm: 75, Competent: 89, Loud: 88, Vintage: 40 },
+    },
+    {
+        family: "Nunito",
+        id: "nunito",
+        version: "5.3.0",
+        category: "sans-serif",
+        weights: [200, 300, 400, 500, 600, 700, 800, 900],
+        roles: ["display", "text"],
+        tags: { Business: 70, Calm: 80, Competent: 70, Happy: 70, Loud: 84 },
+    },
+    {
+        family: "Karla",
+        id: "karla",
+        version: "5.3.0",
+        category: "sans-serif",
+        weights: [200, 300, 400, 500, 600, 700, 800],
+        roles: ["display", "text"],
+        tags: { Business: 80, Calm: 66, Competent: 69 },
+    },
+    {
+        family: "Public Sans",
+        id: "public-sans",
+        version: "5.3.0",
+        category: "sans-serif",
+        weights: [100, 200, 300, 400, 500, 600, 700, 800, 900],
+        roles: ["display", "text"],
+        tags: { Business: 85, Calm: 70, Competent: 80, Loud: 86 },
+    },
+    {
+        family: "Albert Sans",
+        id: "albert-sans",
+        version: "5.3.0",
+        category: "sans-serif",
+        weights: [100, 200, 300, 400, 500, 600, 700, 800, 900],
+        roles: ["display", "text"],
+        tags: { Business: 80, Calm: 66, Competent: 46, Loud: 85, Sincere: 50 },
+    },
+    {
+        family: "Hanken Grotesk",
+        id: "hanken-grotesk",
+        version: "5.3.0",
+        category: "sans-serif",
+        weights: [100, 200, 300, 400, 500, 600, 700, 800, 900],
+        roles: ["display", "text"],
+        tags: { Business: 68, Calm: 70, Competent: 55, Loud: 80 },
+    },
+    {
+        family: "Urbanist",
+        id: "urbanist",
+        version: "5.3.0",
+        category: "sans-serif",
+        weights: [100, 200, 300, 400, 500, 600, 700, 800, 900],
+        roles: ["display", "text"],
+        tags: { Business: 59, Calm: 70, Competent: 56, Loud: 82, Vintage: 40 },
+    },
+    {
+        family: "Be Vietnam Pro",
+        id: "be-vietnam-pro",
+        version: "5.3.0",
+        category: "sans-serif",
+        weights: [100, 200, 300, 400, 500, 600, 700, 800, 900],
+        roles: ["display", "text"],
+        tags: { Business: 55, Calm: 83, Rugged: 40 },
+    },
+    {
+        family: "Poppins",
+        id: "poppins",
+        version: "5.3.0",
+        category: "sans-serif",
+        weights: [100, 200, 300, 400, 500, 600, 700, 800, 900],
+        roles: ["display", "text"],
+        tags: { Business: 60, Calm: 85, Competent: 40, Rugged: 50, Sincere: 50 },
+    },
+    {
+        family: "Literata",
+        id: "literata",
+        version: "5.3.0",
+        category: "serif",
+        weights: [200, 300, 400, 500, 600, 700, 800, 900],
+        roles: ["display", "text"],
+        tags: { Business: 75, Competent: 70, Loud: 86, Rugged: 45, Sincere: 45 },
+    },
+    {
+        family: "Newsreader",
+        id: "newsreader",
+        version: "5.3.0",
+        category: "serif",
+        weights: [200, 300, 400, 500, 600, 700, 800],
+        roles: ["display", "text"],
+        tags: { Business: 75, Competent: 83, Fancy: 66, Sincere: 64 },
+    },
+    {
+        family: "Libre Baskerville",
+        id: "libre-baskerville",
+        version: "5.3.0",
+        category: "serif",
+        weights: [400, 500, 600, 700],
+        roles: ["display", "text"],
+        tags: { Business: 75, Calm: 60, Competent: 84, Sincere: 50, Vintage: 85 },
+    },
+    {
+        family: "Fraunces",
+        id: "fraunces",
+        version: "5.3.0",
+        category: "serif",
+        weights: [100, 200, 300, 400, 500, 600, 700, 800, 900],
+        roles: ["display"],
+        tags: { Happy: 45, Loud: 82, Vintage: 60 },
+    },
+    {
+        family: "Gloock",
+        id: "gloock",
+        version: "5.3.0",
+        category: "serif",
+        weights: [400],
+        roles: ["display"],
+        tags: { Rugged: 58, Vintage: 60 },
+    },
+    {
+        family: "Instrument Serif",
+        id: "instrument-serif",
+        version: "5.3.0",
+        category: "serif",
+        weights: [400],
+        roles: ["display"],
+        tags: { Business: 55, Sincere: 67, Vintage: 80 },
+    },
+    {
+        family: "Bodoni Moda",
+        id: "bodoni-moda",
+        version: "5.3.0",
+        category: "serif",
+        weights: [400, 500, 600, 700, 800, 900],
+        roles: ["display"],
+        tags: { Business: 60, Calm: 50, Fancy: 80, Loud: 58, Sincere: 76, Vintage: 70 },
+    },
+    {
+        family: "EB Garamond",
+        id: "eb-garamond",
+        version: "5.3.0",
+        category: "serif",
+        weights: [400, 500, 600, 700, 800],
+        roles: ["display", "text"],
+        tags: { Business: 81, Calm: 60, Competent: 79, Sincere: 80, Vintage: 84 },
+    },
+    {
+        family: "Bebas Neue",
+        id: "bebas-neue",
+        version: "5.3.0",
+        category: "sans-serif",
+        weights: [400],
+        roles: ["display"],
+        tags: { Rugged: 65, Vintage: 40 },
+    },
+    {
+        family: "Anton",
+        id: "anton",
+        version: "5.3.0",
+        category: "sans-serif",
+        weights: [400],
+        roles: ["display"],
+        tags: { Loud: 80, Rugged: 69, Vintage: 40 },
+    },
+    {
+        family: "Pacifico",
+        id: "pacifico",
+        version: "5.3.0",
+        category: "handwriting",
+        weights: [400],
+        roles: ["display"],
+        tags: { Artistic: 61, Childlike: 40, Cute: 40, Loud: 50, Playful: 50, Vintage: 64 },
+    },
+    {
+        family: "Fredoka",
+        id: "fredoka",
+        version: "5.3.0",
+        category: "sans-serif",
+        weights: [300, 400, 500, 600, 700],
+        roles: ["display", "text"],
+        tags: {
+            Active: 42,
+            Calm: 72,
+            Childlike: 50,
+            Competent: 65,
+            Cute: 52,
+            Happy: 58,
+            Loud: 78,
+            Playful: 75,
+        },
+    },
+    {
+        family: "Baloo 2",
+        id: "baloo-2",
+        version: "5.3.0",
+        category: "display",
+        weights: [400, 500, 600, 700, 800],
+        roles: ["display"],
+        tags: { Business: 60, Calm: 56, Competent: 60, Rugged: 45 },
+    },
+    {
+        family: "Syne",
+        id: "syne",
+        version: "5.3.0",
+        category: "sans-serif",
+        weights: [400, 500, 600, 700, 800],
+        roles: ["display"],
+        tags: { Awkward: 50, Business: 60, Competent: 46, Excited: 40, Rugged: 90, Stiff: 60 },
+    },
+    {
+        family: "Calistoga",
+        id: "calistoga",
+        version: "5.3.0",
+        category: "display",
+        weights: [400],
+        roles: ["display"],
+        tags: { Rugged: 70, Sincere: 78, Vintage: 40 },
+    },
+    {
+        family: "Shrikhand",
+        id: "shrikhand",
+        version: "5.3.0",
+        category: "display",
+        weights: [400],
+        roles: ["display"],
+        tags: { Active: 75, Cute: 52, Loud: 84, Rugged: 65, Vintage: 70 },
+    },
+    {
+        family: "Titan One",
+        id: "titan-one",
+        version: "5.3.0",
+        category: "display",
+        weights: [400],
+        roles: ["display"],
+        tags: { Cute: 40, Loud: 87, Rugged: 70, Vintage: 44 },
+    },
+    {
+        family: "Grandstander",
+        id: "grandstander",
+        version: "5.3.0",
+        category: "display",
+        weights: [100, 200, 300, 400, 500, 600, 700, 800, 900],
+        roles: ["display"],
+        tags: { Childlike: 80, Happy: 88, Loud: 87, Playful: 57, Sincere: 45, Vintage: 60 },
+    },
+    {
+        family: "Caprasimo",
+        id: "caprasimo",
+        version: "5.3.0",
+        category: "display",
+        weights: [400],
+        roles: ["display"],
+        tags: { Cute: 54, Loud: 79, Rugged: 58, Sincere: 76, Vintage: 62 },
+    },
+    {
+        family: "Funnel Display",
+        id: "funnel-display",
+        version: "5.3.0",
+        category: "display",
+        weights: [300, 400, 500, 600, 700, 800],
+        roles: ["display"],
+        tags: { Competent: 42, Futuristic: 45 },
+    },
+];

package/dist/fonts/ofl.d.ts

@@ -0,0 +1,5 @@
+/**
+ * The SIL Open Font License 1.1, as Google Fonts ships it under each family's copyright line.
+ * fonts.css and the font zip carry it, because OFL fonts must travel with their license (OFL 2).
+ */
+export declare const OFL_TEXT = "This Font Software is licensed under the SIL Open Font License, Version 1.1.\nThis license is copied below, and is also available with a FAQ at:\nhttps://scripts.sil.org/OFL\n\n\n-----------------------------------------------------------\nSIL OPEN FONT LICENSE Version 1.1 - 26 February 2007\n-----------------------------------------------------------\n\nPREAMBLE\nThe goals of the Open Font License (OFL) are to stimulate worldwide\ndevelopment of collaborative font projects, to support the font creation\nefforts of academic and linguistic communities, and to provide a free and\nopen framework in which fonts may be shared and improved in partnership\nwith others.\n\nThe OFL allows the licensed fonts to be used, studied, modified and\nredistributed freely as long as they are not sold by themselves. The\nfonts, including any derivative works, can be bundled, embedded,\nredistributed and/or sold with any software provided that any reserved\nnames are not used by derivative works. The fonts and derivatives,\nhowever, cannot be released under any other type of license. The\nrequirement for fonts to remain under this license does not apply\nto any document created using the fonts or their derivatives.\n\nDEFINITIONS\n\"Font Software\" refers to the set of files released by the Copyright\nHolder(s) under this license and clearly marked as such. This may\ninclude source files, build scripts and documentation.\n\n\"Reserved Font Name\" refers to any names specified as such after the\ncopyright statement(s).\n\n\"Original Version\" refers to the collection of Font Software components as\ndistributed by the Copyright Holder(s).\n\n\"Modified Version\" refers to any derivative made by adding to, deleting,\nor substituting -- in part or in whole -- any of the components of the\nOriginal Version, by changing formats or by porting the Font Software to a\nnew environment.\n\n\"Author\" refers to any designer, engineer, programmer, technical\nwriter or other person who contributed to the Font Software.\n\nPERMISSION & CONDITIONS\nPermission is hereby granted, free of charge, to any person obtaining\na copy of the Font Software, to use, study, copy, merge, embed, modify,\nredistribute, and sell modified and unmodified copies of the Font\nSoftware, subject to the following conditions:\n\n1) Neither the Font Software nor any of its individual components,\nin Original or Modified Versions, may be sold by itself.\n\n2) Original or Modified Versions of the Font Software may be bundled,\nredistributed and/or sold with any software, provided that each copy\ncontains the above copyright notice and this license. These can be\nincluded either as stand-alone text files, human-readable headers or\nin the appropriate machine-readable metadata fields within text or\nbinary files as long as those fields can be easily viewed by the user.\n\n3) No Modified Version of the Font Software may use the Reserved Font\nName(s) unless explicit written permission is granted by the corresponding\nCopyright Holder. This restriction only applies to the primary font name as\npresented to the users.\n\n4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font\nSoftware shall not be used to promote, endorse or advertise any\nModified Version, except to acknowledge the contribution(s) of the\nCopyright Holder(s) and the Author(s) or with their explicit written\npermission.\n\n5) The Font Software, modified or unmodified, in part or in whole,\nmust be distributed entirely under this license, and must not be\ndistributed under any other license. The requirement for fonts to\nremain under this license does not apply to any document created\nusing the Font Software.\n\nTERMINATION\nThis license becomes null and void if any of the above conditions are\nnot met.\n\nDISCLAIMER\nTHE FONT SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\nEXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF\nMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT\nOF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE\nCOPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,\nINCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL\nDAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\nFROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM\nOTHER DEALINGS IN THE FONT SOFTWARE.\n";

package/dist/fonts/ofl.js

@@ -0,0 +1,5 @@
+/**
+ * The SIL Open Font License 1.1, as Google Fonts ships it under each family's copyright line.
+ * fonts.css and the font zip carry it, because OFL fonts must travel with their license (OFL 2).
+ */
+export const OFL_TEXT = 'This Font Software is licensed under the SIL Open Font License, Version 1.1.\nThis license is copied below, and is also available with a FAQ at:\nhttps://scripts.sil.org/OFL\n\n\n-----------------------------------------------------------\nSIL OPEN FONT LICENSE Version 1.1 - 26 February 2007\n-----------------------------------------------------------\n\nPREAMBLE\nThe goals of the Open Font License (OFL) are to stimulate worldwide\ndevelopment of collaborative font projects, to support the font creation\nefforts of academic and linguistic communities, and to provide a free and\nopen framework in which fonts may be shared and improved in partnership\nwith others.\n\nThe OFL allows the licensed fonts to be used, studied, modified and\nredistributed freely as long as they are not sold by themselves. The\nfonts, including any derivative works, can be bundled, embedded,\nredistributed and/or sold with any software provided that any reserved\nnames are not used by derivative works. The fonts and derivatives,\nhowever, cannot be released under any other type of license. The\nrequirement for fonts to remain under this license does not apply\nto any document created using the fonts or their derivatives.\n\nDEFINITIONS\n"Font Software" refers to the set of files released by the Copyright\nHolder(s) under this license and clearly marked as such. This may\ninclude source files, build scripts and documentation.\n\n"Reserved Font Name" refers to any names specified as such after the\ncopyright statement(s).\n\n"Original Version" refers to the collection of Font Software components as\ndistributed by the Copyright Holder(s).\n\n"Modified Version" refers to any derivative made by adding to, deleting,\nor substituting -- in part or in whole -- any of the components of the\nOriginal Version, by changing formats or by porting the Font Software to a\nnew environment.\n\n"Author" refers to any designer, engineer, programmer, technical\nwriter or other person who contributed to the Font Software.\n\nPERMISSION & CONDITIONS\nPermission is hereby granted, free of charge, to any person obtaining\na copy of the Font Software, to use, study, copy, merge, embed, modify,\nredistribute, and sell modified and unmodified copies of the Font\nSoftware, subject to the following conditions:\n\n1) Neither the Font Software nor any of its individual components,\nin Original or Modified Versions, may be sold by itself.\n\n2) Original or Modified Versions of the Font Software may be bundled,\nredistributed and/or sold with any software, provided that each copy\ncontains the above copyright notice and this license. These can be\nincluded either as stand-alone text files, human-readable headers or\nin the appropriate machine-readable metadata fields within text or\nbinary files as long as those fields can be easily viewed by the user.\n\n3) No Modified Version of the Font Software may use the Reserved Font\nName(s) unless explicit written permission is granted by the corresponding\nCopyright Holder. This restriction only applies to the primary font name as\npresented to the users.\n\n4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font\nSoftware shall not be used to promote, endorse or advertise any\nModified Version, except to acknowledge the contribution(s) of the\nCopyright Holder(s) and the Author(s) or with their explicit written\npermission.\n\n5) The Font Software, modified or unmodified, in part or in whole,\nmust be distributed entirely under this license, and must not be\ndistributed under any other license. The requirement for fonts to\nremain under this license does not apply to any document created\nusing the Font Software.\n\nTERMINATION\nThis license becomes null and void if any of the above conditions are\nnot met.\n\nDISCLAIMER\nTHE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,\nEXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF\nMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT\nOF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE\nCOPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,\nINCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL\nDAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\nFROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM\nOTHER DEALINGS IN THE FONT SOFTWARE.\n';

package/dist/fonts/pick.d.ts

@@ -0,0 +1,33 @@
+import type { FontRole } from "../brand/schema.ts";
+/** google/fonts' expressive tags, scored 0 to 100 per family. */
+export declare const FONT_TAGS: readonly ["Active", "Artistic", "Awkward", "Business", "Calm", "Childlike", "Competent", "Cute", "Excited", "Fancy", "Futuristic", "Happy", "Innovative", "Loud", "Playful", "Rugged", "Sincere", "Sophisticated", "Stiff", "Vintage"];
+export type FontTag = (typeof FONT_TAGS)[number];
+export type CatalogFont = {
+    family: string;
+    /** The Fontsource id. */
+    id: string;
+    /** The Fontsource release the kit pins, so a brand always draws with the same bytes. */
+    version: string;
+    category: string;
+    /** Static weights Fontsource serves as TTF. */
+    weights: number[];
+    roles: FontRole[];
+    tags: Partial<Record<FontTag, number>>;
+};
+/** Fontsource versions for every catalog family, for fetchFontResolver's `versions`. */
+export declare function catalogVersions(): Record<string, string>;
+export declare function catalogFont(id: string): CatalogFont | undefined;
+/** The nearest available static weight, for a role that asks for, say, 800 on a 700 family. */
+export declare function nearestWeight(font: {
+    weights: number[];
+}, wanted: number): number;
+/**
+ * A display and a text family for a voice, as tags (the AI text step suggests them, or the
+ * studio maps the owner's words). `variant` walks down the ranking for "Try another", and the
+ * text face is chosen to read well (Business, Competent, Calm) and to differ from the display
+ * face in category, which is how pairs stay clear apart.
+ */
+export declare function pickFonts(tags: readonly FontTag[], variant?: number): {
+    display: CatalogFont;
+    text: CatalogFont;
+};

package/dist/fonts/pick.js

@@ -0,0 +1,73 @@
+import { FONT_CATALOG } from "./catalog.js";
+/** google/fonts' expressive tags, scored 0 to 100 per family. */
+export const FONT_TAGS = [
+    "Active",
+    "Artistic",
+    "Awkward",
+    "Business",
+    "Calm",
+    "Childlike",
+    "Competent",
+    "Cute",
+    "Excited",
+    "Fancy",
+    "Futuristic",
+    "Happy",
+    "Innovative",
+    "Loud",
+    "Playful",
+    "Rugged",
+    "Sincere",
+    "Sophisticated",
+    "Stiff",
+    "Vintage",
+];
+/** Fontsource versions for every catalog family, for fetchFontResolver's `versions`. */
+export function catalogVersions() {
+    return Object.fromEntries(FONT_CATALOG.map((font) => [font.id, font.version]));
+}
+export function catalogFont(id) {
+    return FONT_CATALOG.find((font) => font.id === id);
+}
+function score(font, tags) {
+    if (tags.length === 0)
+        return 0;
+    return tags.reduce((sum, tag) => sum + (font.tags[tag] ?? 0), 0) / tags.length;
+}
+/** The nearest available static weight, for a role that asks for, say, 800 on a 700 family. */
+export function nearestWeight(font, wanted) {
+    return ([...font.weights].sort((a, b) => Math.abs(a - wanted) - Math.abs(b - wanted) || b - a)[0] ??
+        400);
+}
+/**
+ * A display and a text family for a voice, as tags (the AI text step suggests them, or the
+ * studio maps the owner's words). `variant` walks down the ranking for "Try another", and the
+ * text face is chosen to read well (Business, Competent, Calm) and to differ from the display
+ * face in category, which is how pairs stay clear apart.
+ */
+export function pickFonts(tags, variant = 0) {
+    const displays = FONT_CATALOG.filter((font) => font.roles.includes("display"))
+        .map((font) => ({ font, rank: score(font, tags) }))
+        .sort((a, b) => b.rank - a.rank || a.font.id.localeCompare(b.font.id));
+    const display = displays[variant % displays.length]?.font ?? FONT_CATALOG[0];
+    if (!display)
+        throw new Error("The font catalog is empty");
+    const reading = ["Business", "Competent", "Calm"];
+    const texts = FONT_CATALOG.filter((font) => font.roles.includes("text"))
+        .map((font) => {
+        const sameFamily = font.id === display.id;
+        const sameCategory = font.category === display.category;
+        // One family can do both jobs when it is a reading face; otherwise contrast them.
+        const pairing = sameFamily
+            ? display.roles.includes("text")
+                ? 5
+                : -100
+            : sameCategory
+                ? -10
+                : 10;
+        return { font, rank: score(font, reading) + score(font, tags) / 2 + pairing };
+    })
+        .sort((a, b) => b.rank - a.rank || a.font.id.localeCompare(b.font.id));
+    const text = texts[Math.floor(variant / displays.length) % texts.length]?.font ?? display;
+    return { display, text };
+}

package/dist/imports/folder.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Which files of a brand folder or zip ideare reads. The studio and the CLI ask the same
+ * question before anything is sent, so both send the same files and skip the same ones, each
+ * with its reason: files the computer made (`__MACOSX`, `.DS_Store`, `Thumbs.db`), hidden files,
+ * types ideare can't read, empty files, and anything past the limits.
+ */
+export declare const IMPORT_LIMITS: {
+    /** Files sent from one folder or zip. */
+    readonly files: 200;
+    /** Bytes of all of them together. */
+    readonly totalBytes: number;
+    /** Bytes of one file. */
+    readonly fileBytes: number;
+};
+/** What each file ending is sent as. The type is what the upload signs; the server still reads
+ *  the bytes to know what a file really is. */
+declare const TYPES: {
+    readonly png: "image/png";
+    readonly jpg: "image/jpeg";
+    readonly jpeg: "image/jpeg";
+    readonly webp: "image/webp";
+    readonly svg: "image/svg+xml";
+    readonly heic: "image/heic";
+    readonly heif: "image/heif";
+    readonly ttf: "font/ttf";
+    readonly otf: "font/otf";
+    readonly woff: "font/woff";
+    readonly woff2: "font/woff2";
+    readonly pdf: "application/pdf";
+};
+export type ImportMime = (typeof TYPES)[keyof typeof TYPES];
+/** Every type a folder import sends. */
+export declare const IMPORT_MIMES: readonly ImportMime[];
+export type ImportSkipReason = 
+/** Made by the computer, not the owner. */
+"system"
+/** A hidden file or folder (its name starts with a dot). */
+ | "hidden"
+/** A type ideare can't read, like .ai, .psd or .mp4. `ext` says which. */
+ | "type" | "empty"
+/** Over IMPORT_LIMITS.fileBytes. */
+ | "tooBig"
+/** Past IMPORT_LIMITS.files. */
+ | "tooMany"
+/** Past IMPORT_LIMITS.totalBytes. */
+ | "tooMuch"
+/** A damaged or password-locked file inside a zip. */
+ | "unreadable";
+export type ImportEntry = {
+    path: string;
+    size: number;
+};
+export type ImportCheck = {
+    ok: true;
+    mime: ImportMime;
+} | {
+    ok: false;
+    reason: ImportSkipReason;
+    ext?: string;
+};
+export type ImportPlan<T extends ImportEntry> = {
+    send: (T & {
+        mime: ImportMime;
+    })[];
+    skipped: (T & {
+        reason: ImportSkipReason;
+        ext?: string;
+    })[];
+};
+/** A path as a zip or a folder gives it, with forward slashes and no leading `./` or `/`. */
+export declare function importPath(raw: string): string;
+/** One file on its own: read it, or why not. The count and total limits are planImport's. */
+export declare function checkImportEntry(path: string, size: number): ImportCheck;
+/**
+ * Every file of a folder sorted into what to send and what to skip, with the limits held: at most
+ * IMPORT_LIMITS.files files and IMPORT_LIMITS.totalBytes in all. The same files always give the
+ * same plan, whatever order the folder listed them in.
+ */
+export declare function planImport<T extends ImportEntry>(entries: readonly T[]): ImportPlan<T>;
+export {};

package/dist/imports/folder.js

@@ -0,0 +1,124 @@
+/**
+ * Which files of a brand folder or zip ideare reads. The studio and the CLI ask the same
+ * question before anything is sent, so both send the same files and skip the same ones, each
+ * with its reason: files the computer made (`__MACOSX`, `.DS_Store`, `Thumbs.db`), hidden files,
+ * types ideare can't read, empty files, and anything past the limits.
+ */
+export const IMPORT_LIMITS = {
+    /** Files sent from one folder or zip. */
+    files: 200,
+    /** Bytes of all of them together. */
+    totalBytes: 200 * 1024 * 1024,
+    /** Bytes of one file. */
+    fileBytes: 25 * 1024 * 1024,
+};
+/** What each file ending is sent as. The type is what the upload signs; the server still reads
+ *  the bytes to know what a file really is. */
+const TYPES = {
+    png: "image/png",
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    webp: "image/webp",
+    svg: "image/svg+xml",
+    heic: "image/heic",
+    heif: "image/heif",
+    ttf: "font/ttf",
+    otf: "font/otf",
+    woff: "font/woff",
+    woff2: "font/woff2",
+    pdf: "application/pdf",
+};
+/** Every type a folder import sends. */
+export const IMPORT_MIMES = [...new Set(Object.values(TYPES))];
+/** Files a computer makes on its own, never the owner's: macOS resource forks, folder settings
+ *  and indexes, Windows thumbnails. */
+const SYSTEM_PARTS = new Set([
+    "__macosx",
+    ".ds_store",
+    "thumbs.db",
+    "ehthumbs.db",
+    "desktop.ini",
+    "icon\r",
+    ".spotlight-v100",
+    ".trashes",
+    ".fseventsd",
+    ".localized",
+]);
+/** A path as a zip or a folder gives it, with forward slashes and no leading `./` or `/`. */
+export function importPath(raw) {
+    return raw
+        .replace(/\\/g, "/")
+        .replace(/^(?:\.\/|\/)+/, "")
+        .replace(/\/{2,}/g, "/");
+}
+/** The ending after the last dot of the file's own name, lowercase, or "" when it has none. */
+function extension(path) {
+    const name = path.slice(path.lastIndexOf("/") + 1);
+    const dot = name.lastIndexOf(".");
+    return dot > 0 ? name.slice(dot + 1).toLowerCase() : "";
+}
+function isType(ext) {
+    return Object.hasOwn(TYPES, ext);
+}
+/** One file on its own: read it, or why not. The count and total limits are planImport's. */
+export function checkImportEntry(path, size) {
+    const parts = importPath(path).split("/").filter(Boolean);
+    if (parts.some((part) => SYSTEM_PARTS.has(part.toLowerCase())))
+        return { ok: false, reason: "system" };
+    // macOS writes "._name" beside every file it copies to a disk that can't hold its extras.
+    if (parts.some((part) => part.startsWith(".")))
+        return { ok: false, reason: "hidden" };
+    const ext = extension(path);
+    if (!isType(ext))
+        return { ok: false, reason: "type", ...(ext ? { ext } : {}) };
+    if (size <= 0)
+        return { ok: false, reason: "empty" };
+    if (size > IMPORT_LIMITS.fileBytes)
+        return { ok: false, reason: "tooBig" };
+    return { ok: true, mime: TYPES[ext] };
+}
+/** The guide and the fonts first, then vectors, then pictures: when a folder holds more than the
+ *  limits, what tells the most about the brand is what gets sent. */
+function priority(mime) {
+    if (mime === "application/pdf")
+        return 0;
+    if (mime.startsWith("font/"))
+        return 1;
+    if (mime === "image/svg+xml")
+        return 2;
+    return 3;
+}
+/**
+ * Every file of a folder sorted into what to send and what to skip, with the limits held: at most
+ * IMPORT_LIMITS.files files and IMPORT_LIMITS.totalBytes in all. The same files always give the
+ * same plan, whatever order the folder listed them in.
+ */
+export function planImport(entries) {
+    const plan = { send: [], skipped: [] };
+    const readable = [];
+    for (const entry of entries) {
+        const check = checkImportEntry(entry.path, entry.size);
+        if (check.ok)
+            readable.push({ ...entry, mime: check.mime });
+        else
+            plan.skipped.push({
+                ...entry,
+                reason: check.reason,
+                ...(check.ext ? { ext: check.ext } : {}),
+            });
+    }
+    readable.sort((a, b) => priority(a.mime) - priority(b.mime) ||
+        importPath(a.path).localeCompare(importPath(b.path)));
+    let total = 0;
+    for (const entry of readable) {
+        if (plan.send.length >= IMPORT_LIMITS.files)
+            plan.skipped.push({ ...entry, reason: "tooMany" });
+        else if (total + entry.size > IMPORT_LIMITS.totalBytes)
+            plan.skipped.push({ ...entry, reason: "tooMuch" });
+        else {
+            total += entry.size;
+            plan.send.push(entry);
+        }
+    }
+    return plan;
+}