wand-kit 0.0.0-stage → 0.2.0

package/brands/next/assets/glyphs/users.svg

@@ -0,0 +1,18 @@
+<!-- @license lucide-static v0.469.0 - ISC -->
+<svg
+  class="lucide lucide-users"
+  xmlns="http://www.w3.org/2000/svg"
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <path d="M16 21v-2a4 4 0 0 0-4-4H6a4 4 0 0 0-4 4v2" />
+  <circle cx="9" cy="7" r="4" />
+  <path d="M22 21v-2a4 4 0 0 0-3-3.87" />
+  <path d="M16 3.13a4 4 0 0 1 0 7.75" />
+</svg>

package/brands/next/assets/glyphs/wallet.svg

@@ -0,0 +1,16 @@
+<!-- @license lucide-static v0.469.0 - ISC -->
+<svg
+  class="lucide lucide-wallet"
+  xmlns="http://www.w3.org/2000/svg"
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <path d="M19 7V4a1 1 0 0 0-1-1H5a2 2 0 0 0 0 4h15a1 1 0 0 1 1 1v4h-3a2 2 0 0 0 0 4h3a1 1 0 0 0 1-1v-2a1 1 0 0 0-1-1" />
+  <path d="M3 5v14a2 2 0 0 0 2 2h15a1 1 0 0 0 1-1v-4" />
+</svg>

package/brands/next/assets/glyphs/wand-sparkles.svg

@@ -0,0 +1,22 @@
+<!-- @license lucide-static v0.469.0 - ISC -->
+<svg
+  class="lucide lucide-wand-sparkles"
+  xmlns="http://www.w3.org/2000/svg"
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <path d="m21.64 3.64-1.28-1.28a1.21 1.21 0 0 0-1.72 0L2.36 18.64a1.21 1.21 0 0 0 0 1.72l1.28 1.28a1.2 1.2 0 0 0 1.72 0L21.64 5.36a1.2 1.2 0 0 0 0-1.72" />
+  <path d="m14 7 3 3" />
+  <path d="M5 6v4" />
+  <path d="M19 14v4" />
+  <path d="M10 2v2" />
+  <path d="M7 8H3" />
+  <path d="M21 16h-4" />
+  <path d="M11 3H9" />
+</svg>

package/brands/next/assets/glyphs/workflow.svg

@@ -0,0 +1,17 @@
+<!-- @license lucide-static v0.469.0 - ISC -->
+<svg
+  class="lucide lucide-workflow"
+  xmlns="http://www.w3.org/2000/svg"
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <rect width="8" height="8" x="3" y="3" rx="2" />
+  <path d="M7 11v4a2 2 0 0 0 2 2h4" />
+  <rect width="8" height="8" x="13" y="13" rx="2" />
+</svg>

package/brands/next/assets/glyphs/zap.svg

@@ -0,0 +1,15 @@
+<!-- @license lucide-static v0.469.0 - ISC -->
+<svg
+  class="lucide lucide-zap"
+  xmlns="http://www.w3.org/2000/svg"
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <path d="M4 14a1 1 0 0 1-.78-1.63l9.9-10.2a.5.5 0 0 1 .86.46l-1.92 6.02A1 1 0 0 0 13 10h7a1 1 0 0 1 .78 1.63l-9.9 10.2a.5.5 0 0 1-.86-.46l1.92-6.02A1 1 0 0 0 11 14z" />
+</svg>

package/brands/next/assets/wordmark.svg

@@ -0,0 +1,7 @@
+<svg width="77" height="26" viewBox="0 0 77 26" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <path d="M3.74156 8.94922C3.85971 8.94922 3.95544 9.04735 3.95544 9.16829V18.0647C3.95544 19.7429 5.28392 21.1035 6.92226 21.1035C8.56047 21.1033 9.8882 19.7427 9.8882 18.0647V9.16829C9.8882 9.04735 9.98396 8.94922 10.1021 8.94922H13.6469C13.7556 8.94922 13.8437 9.0394 13.8437 9.15067C13.8441 9.15651 13.8454 9.1626 13.8454 9.16854V18.0647C13.8455 19.7427 15.1732 21.1033 16.8113 21.1035C18.4497 21.1035 19.7781 19.7428 19.7781 18.0647V11.3917C19.7781 11.1899 20.022 11.0954 20.1524 11.2464L20.6319 11.8044C21.228 12.4978 22.2837 12.4978 22.8799 11.8044L23.3593 11.2464C23.4898 11.0953 23.7335 11.1899 23.7335 11.3917V18.0647C23.7335 21.9802 20.6341 25.154 16.8113 25.154C14.9523 25.154 13.265 24.4028 12.0216 23.181C11.9351 23.096 11.7976 23.096 11.7111 23.181C10.4678 24.4027 8.78122 25.1549 6.92226 25.155C3.09943 25.155 0 21.9803 0 18.0647V9.16829C0 9.04735 0.0957579 8.94922 0.213881 8.94922H3.74156Z" fill="currentColor"></path>
+  <path d="M42.1885 16.9826C42.1885 17.0058 42.1903 17.029 42.1903 17.0522C42.1903 17.0753 42.1885 17.0986 42.1885 17.1217V24.9351C42.1885 25.0562 42.0925 25.1542 41.9744 25.1542H38.4467C38.3289 25.1542 38.2329 25.0562 38.2329 24.9351V24.4482C38.2329 24.2795 38.0542 24.1733 37.9077 24.2509C36.8211 24.827 35.5883 25.1542 34.2801 25.1542C29.9112 25.1542 26.3693 21.527 26.3691 17.0522C26.3692 12.5772 29.9111 8.94922 34.2801 8.94922C35.588 8.94929 36.8211 9.27577 37.9077 9.85173C38.0542 9.92927 38.2329 9.82301 38.2329 9.65432V9.16829C38.2329 9.04731 38.3289 8.94922 38.4467 8.94922H41.9744C42.0925 8.94922 42.1885 9.04731 42.1885 9.16829V16.9826ZM34.2827 13.0007C32.0983 13.0007 30.3273 14.8147 30.3273 17.0522C30.3273 19.2895 32.0983 21.1037 34.2827 21.1037C36.3988 21.1036 38.1269 19.4012 38.2329 17.2607V16.8436C38.1269 14.7031 36.3988 13.0008 34.2827 13.0007Z" fill="currentColor"></path>
+  <path d="M76.9942 16.8435C76.996 16.9129 76.9996 16.9824 76.9996 17.0522C76.9996 17.1218 76.996 17.1915 76.9942 17.2607V24.936C76.9942 25.0571 76.8986 25.1551 76.7804 25.1551H73.1815C73.0633 25.1551 72.9677 25.0571 72.9677 24.936V24.4872C72.9677 24.3196 72.7908 24.2132 72.6446 24.2888C71.5756 24.8414 70.3679 25.1542 69.0887 25.1542C64.7197 25.1542 61.1781 21.5271 61.1777 17.0522C61.1781 12.5774 64.7201 8.94921 69.0887 8.94921C70.3679 8.94928 71.5756 9.26204 72.6446 9.81469C72.7908 9.89022 72.9677 9.78389 72.9677 9.61624V3.46682C72.9677 3.34583 73.0633 3.24774 73.1815 3.24774H76.7804C76.8986 3.24774 76.9942 3.34583 76.9942 3.46682V16.8435ZM69.0862 13.1344C66.9019 13.1344 65.1309 14.9485 65.1305 17.1859C65.1309 19.4232 66.9019 21.2365 69.0862 21.2365C71.0026 21.2364 72.6002 19.8408 72.9637 17.9876C72.9663 17.9738 72.9677 17.9597 72.9677 17.9456V16.4254C72.9677 16.4112 72.9663 16.3971 72.9634 16.3833C72.5999 14.5304 71.0022 13.1345 69.0862 13.1344Z" fill="currentColor"></path>
+  <path d="M58.5402 15.9719C58.5402 12.0937 55.4706 8.95034 51.6843 8.9502C47.8977 8.9502 44.8281 12.0937 44.8281 15.9719V24.8266C44.8281 25.0081 44.9717 25.1552 45.149 25.1552H48.4235C48.6008 25.1552 48.7444 25.0081 48.7444 24.8266V16.1912C48.7447 14.5293 50.0598 13.1819 51.6826 13.1817C53.3049 13.1817 54.6204 14.5292 54.6207 16.1912V24.8266C54.6207 25.0081 54.7644 25.1552 54.9413 25.1552H58.2197C58.3966 25.1552 58.5402 25.0081 58.5402 24.8266V15.9719Z" fill="currentColor"></path>
+  <path d="M26.686 4.79448C24.2167 4.79448 22.2079 2.78565 22.2079 0.316338C22.2079 0.170667 22.0901 0.0529175 21.9445 0.0529175C21.7988 0.0529175 21.681 0.170667 21.681 0.316338C21.681 2.78565 19.6722 4.79448 17.2029 4.79448C17.0572 4.79448 16.9395 4.91224 16.9395 5.05793C16.9395 5.20358 17.0572 5.32134 17.2029 5.32134C19.6722 5.32134 21.681 7.33018 21.681 9.79952C21.681 9.94517 21.7988 10.0629 21.9445 10.0629C22.0901 10.0629 22.2079 9.94517 22.2079 9.79952C22.2079 7.33018 24.2167 5.32134 26.686 5.32134C26.8317 5.32134 26.9495 5.20358 26.9495 5.05793C26.9495 4.91224 26.8317 4.79448 26.686 4.79448Z" fill="currentColor"></path>
+</svg>

package/brands/next/fonts/OFL-OverusedGrotesk.txt

@@ -0,0 +1,93 @@
+Copyright (c) 2023-2025, Bao Nguyen/RandomMaerks (rmforbusiness@gmail.com).
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/brands/next/fonts/faces.json

@@ -0,0 +1,27 @@
+{
+  "_": "The one table that maps a PowerPoint family name to the files that draw it. measure.js, the PDF renderer, the preview, embed_fonts.py and brandlint.py all read this file, so a face is added once. `tracking` is letter-spacing in em, measured from the website's CSS (headings -0.07em, body -0.02em): the kit writes it into every run and measures with it, so fit is judged on the spacing that is actually drawn.",
+  "default": "Overused Grotesk",
+  "families": {
+    "FK Roman Standard Light": {
+      "role": "display",
+      "r": "FKRomanStandard-Light", "b": "FKRomanStandard-Light",
+      "i": "FKRomanStandard-Light", "bi": "FKRomanStandard-Light",
+      "tracking": -0.07,
+      "license": "commercial - Florian Karsten Typefaces EULA, see LICENSE-FONTS.md"
+    },
+    "Overused Grotesk": {
+      "role": "body",
+      "r": "OverusedGrotesk-Roman", "b": "OverusedGrotesk-SemiBold",
+      "i": "OverusedGrotesk-Italic", "bi": "OverusedGrotesk-SemiBoldItalic",
+      "tracking": -0.02,
+      "license": "SIL OFL 1.1, see OFL-OverusedGrotesk.txt"
+    },
+    "Overused Grotesk Medium": {
+      "role": "label",
+      "r": "OverusedGrotesk-Medium", "b": "OverusedGrotesk-SemiBold",
+      "i": "OverusedGrotesk-MediumItalic", "bi": "OverusedGrotesk-SemiBoldItalic",
+      "tracking": -0.01,
+      "license": "SIL OFL 1.1, see OFL-OverusedGrotesk.txt"
+    }
+  }
+}

package/brands/next/lib/glyphs.js

@@ -0,0 +1,89 @@
+/**
+ * lib/glyphs.js — the named icon set.
+ *
+ * The old library was 36 PNGs named after their extraction order, half baked
+ * white and half baked accent. That produced two standing bugs: a white glyph on
+ * a light tile is invisible, and nobody could pick an icon by meaning because
+ * the names carried none.
+ *
+ * These are Lucide's single-colour stroke SVGs. `stroke="currentColor"` means
+ * the kit substitutes the theme's colour at build time, so polarity cannot be
+ * wrong. They go into the deck as vector — pptxgenjs writes the OOXML
+ * `asvg:svgBlip` extension with a raster fallback — so nothing is rasterised
+ * and the kit keeps needing no native dependency.
+ */
+
+const fs = require("fs");
+const path = require("path");
+
+const DIR = path.join(__dirname, "..", "assets", "glyphs");
+let INDEX = null, BUNDLE = null;
+
+function index() {
+  if (!INDEX) INDEX = JSON.parse(fs.readFileSync(path.join(DIR, "index.json"), "utf8"));
+  return INDEX;
+}
+
+/**
+ * 75 SVGs is 75 files, and a packaged skill is capped at 200 of them. The
+ * packager collapses them into one `glyphs.json`; loose files still win when
+ * they are there, so the repo keeps its readable one-file-per-icon layout.
+ */
+function bundle() {
+  if (BUNDLE === null) {
+    const f = path.join(DIR, "glyphs.json");
+    BUNDLE = fs.existsSync(f) ? JSON.parse(fs.readFileSync(f, "utf8")) : false;
+  }
+  return BUNDLE;
+}
+
+/** The raw SVG source for a glyph. */
+function svg(name) {
+  const b = bundle();
+  if (b && b[name]) return b[name];
+  return fs.readFileSync(path.join(DIR, name + ".svg"), "utf8");
+}
+
+/** Every glyph name, for validation and for `wand.js glyphs`. */
+const names = () => index().icons;
+const has = (name) => typeof name === "string" && index().icons.includes(name);
+
+const cache = new Map();
+
+/**
+ * A recoloured glyph as a data URI, ready for `addImage({ data })`.
+ * Returns null for anything that isn't a known glyph name, so callers can fall
+ * back to the legacy PNG path.
+ */
+function dataUri(name, color, { strokeWidth } = {}) {
+  if (!has(name)) return null;
+  const key = `${name}|${color}|${strokeWidth || ""}`;
+  if (cache.has(key)) return cache.get(key);
+  let src = svg(name).replace(/currentColor/g, "#" + String(color).replace(/^#/, ""));
+  // the site draws its line art at a hairline; Lucide's 2px reads heavy beside it
+  if (strokeWidth) src = src.replace(/stroke-width="[\d.]+"/g, `stroke-width="${strokeWidth}"`);
+  const uri = "image/svg+xml;base64," + Buffer.from(src, "utf8").toString("base64");
+  cache.set(key, uri);
+  return uri;
+}
+
+/** Nearest names, for a useful error when someone mistypes one. */
+function suggest(name, n = 4) {
+  const q = String(name || "").toLowerCase();
+  return index().icons
+    .map((g) => [g, g.includes(q) || q.includes(g) ? 0 : distance(q, g)])
+    .sort((a, b) => a[1] - b[1]).slice(0, n).map((r) => r[0]);
+}
+
+function distance(a, b) {
+  const d = Array.from({ length: a.length + 1 }, (_, i) => [i, ...Array(b.length).fill(0)]);
+  for (let j = 0; j <= b.length; j++) d[0][j] = j;
+  for (let i = 1; i <= a.length; i++) {
+    for (let j = 1; j <= b.length; j++) {
+      d[i][j] = Math.min(d[i - 1][j] + 1, d[i][j - 1] + 1, d[i - 1][j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1));
+    }
+  }
+  return d[a.length][b.length];
+}
+
+module.exports = { names, has, svg, dataUri, suggest, index, DIR };

package/brands/next/lib/measure.js

@@ -0,0 +1,121 @@
+/**
+ * lib/measure.js — real text metrics against the brand's actual faces.
+ *
+ * Why this exists: LibreOffice ignores embedded fonts and substitutes DejaVu,
+ * so QA renders over-report overflow and lose all weight information. This
+ * module measures the real font, so overflow is a build-time error rather than
+ * a judgement call about a screenshot.
+ *
+ * What differs from the Geist-era copy in brand/lib: the face table is data
+ * (`fonts/faces.json`), not code, and every family carries its letter-spacing.
+ * The website sets headings at -0.07em and body at -0.02em, the kit writes the
+ * same spacing into every run, and this module measures with it — so a title
+ * is judged at the width it is actually drawn, not at the font's default.
+ */
+
+const fs = require("fs");
+const path = require("path");
+const FONTS = path.join(__dirname, "..", "fonts");
+const TABLE = JSON.parse(fs.readFileSync(path.join(FONTS, "faces.json"), "utf8"));
+
+let FONTKIT = null;
+const cache = new Map();
+
+/** The faces.json entry for a family, falling back to the default body face. */
+function familyOf(family) {
+  return TABLE.families[family] || TABLE.families[TABLE.default];
+}
+
+/** The TTF stem that draws a family in a given style. */
+function stemOf(family, bold = false, italic = false) {
+  const set = familyOf(family);
+  return set[bold && italic ? "bi" : bold ? "b" : italic ? "i" : "r"];
+}
+
+/** Letter-spacing for a family, in em. */
+const trackingEm = (family) => familyOf(family).tracking || 0;
+
+/** Letter-spacing in points at a size — the unit PowerPoint's `spc` and PDF's `Tc` take. */
+const trackingPt = (family, fontSize) => +(trackingEm(family) * fontSize).toFixed(2);
+
+function face(family, { bold = false, italic = false } = {}) {
+  if (!FONTKIT) throw new Error("measure.js was loaded without fontkit — require it through the kit's lib/shared.js");
+  const stem = stemOf(family, bold, italic);
+  if (!cache.has(stem)) cache.set(stem, FONTKIT.openSync(path.join(FONTS, stem + ".ttf")));
+  return cache.get(stem);
+}
+
+/** Width of a single line, in inches, tracking included. */
+function widthIn(text, { family, fontSize, bold, italic } = {}) {
+  if (!text) return 0;
+  const f = face(family, { bold, italic });
+  const run = f.layout(String(text));
+  const glyphs = run.glyphs.length;
+  return (run.advanceWidth / f.unitsPerEm) * (fontSize / 72) + (trackingPt(family, fontSize) * glyphs) / 72;
+}
+
+/**
+ * Greedy word wrap at a given box width. Returns the lines it would occupy.
+ * Honours explicit \n. Matches how PowerPoint breaks closely enough to catch
+ * the failures that matter (a line too many, a word that can't fit at all).
+ */
+function wrap(text, boxWidthIn, opts = {}) {
+  const out = [];
+  for (const para of String(text).split("\n")) {
+    const words = para.split(/\s+/).filter(Boolean);
+    if (!words.length) { out.push(""); continue; }
+    let line = words[0];
+    for (let i = 1; i < words.length; i++) {
+      const test = line + " " + words[i];
+      if (widthIn(test, opts) <= boxWidthIn) line = test;
+      else { out.push(line); line = words[i]; }
+    }
+    out.push(line);
+  }
+  return out;
+}
+
+/** Rendered height in inches for text wrapped into a box. */
+function heightIn(text, boxWidthIn, opts = {}) {
+  const leading = opts.lineSpacingMultiple || 1.2;
+  return wrap(text, boxWidthIn, opts).length * (opts.fontSize / 72) * leading;
+}
+
+/** Does this text fit the box? A verdict object, so callers can report why. */
+function fits(text, boxWidthIn, boxHeightIn, opts = {}) {
+  const lines = wrap(text, boxWidthIn, opts);
+  const h = heightIn(text, boxWidthIn, opts);
+  const widest = Math.max(...lines.map((l) => widthIn(l, opts)));
+  return {
+    ok: h <= boxHeightIn + 1e-6 && widest <= boxWidthIn + 1e-6,
+    lines: lines.length,
+    heightIn: +h.toFixed(3),
+    widestIn: +widest.toFixed(3),
+    overflowIn: +Math.max(0, h - boxHeightIn).toFixed(3),
+  };
+}
+
+/** Largest size at or below `fontSize` that fits, stepping by `step`, never below `min`. */
+function fitSize(text, boxWidthIn, boxHeightIn, opts = {}) {
+  const { fontSize, min = 7, step = 0.5 } = opts;
+  for (let s = fontSize; s >= min; s -= step) {
+    if (fits(text, boxWidthIn, boxHeightIn, { ...opts, fontSize: s }).ok) return s;
+  }
+  return min;
+}
+
+/** Line count only — the common case for "will this title be 2 lines or 3?". */
+const lineCount = (text, boxWidthIn, opts = {}) => wrap(text, boxWidthIn, opts).length;
+
+/** Every family the brand knows, for the gates that check a deck stays inside them. */
+const families = () => Object.keys(TABLE.families);
+
+/**
+ * This module lives in the brand payload, outside any kit's node_modules, so
+ * Node cannot resolve `fontkit` from here. The kit that loads it hands its own
+ * copy in.
+ */
+module.exports = function create(fontkit) {
+  FONTKIT = fontkit;
+  return { widthIn, wrap, heightIn, fits, fitSize, lineCount, face, stemOf, trackingEm, trackingPt, families, TABLE };
+};