wand-kit 0.0.0-stage → 0.2.0

package/brands/current/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/current/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/current/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/current/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/current/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/current/lib/glyphs.js

@@ -0,0 +1,87 @@
+/**
+ * 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) {
+  if (!has(name)) return null;
+  const key = `${name}|${color}`;
+  if (cache.has(key)) return cache.get(key);
+  const src = svg(name).replace(/currentColor/g, "#" + String(color).replace(/^#/, ""));
+  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/current/lib/measure.js

@@ -0,0 +1,115 @@
+/**
+ * lib/measure.js — real text metrics against the actual Geist faces.
+ *
+ * Why this exists: §9 says LibreOffice ignores embedded fonts and substitutes
+ * DejaVu, so QA renders over-report overflow and lose all weight information.
+ * That makes visual QA unreliable for exactly the thing it looks like it's
+ * checking. This module measures the real font, so overflow is a build-time
+ * error rather than a judgement call about a screenshot.
+ */
+
+const path = require("path");
+const FONTS = path.join(__dirname, "..", "fonts");
+
+/* family + style -> ttf stem, mirroring embed_fonts.py */
+const FACE = {
+  "Geist":            { r: "Geist-Regular",   b: "Geist-Bold",      i: "Geist-Italic",          bi: "Geist-BoldItalic" },
+  "Geist Medium":     { r: "Geist-Medium",    b: "Geist-SemiBold",  i: "Geist-MediumItalic",    bi: "Geist-SemiBoldItalic" },
+  "Geist SemiBold":   { r: "Geist-SemiBold",  b: "Geist-ExtraBold", i: "Geist-SemiBoldItalic",  bi: "Geist-ExtraBoldItalic" },
+  "Geist ExtraBold":  { r: "Geist-ExtraBold", b: "Geist-ExtraBold", i: "Geist-ExtraBoldItalic", bi: "Geist-ExtraBoldItalic" },
+  "Geist Light":      { r: "Geist-Light",     b: "Geist-Medium",    i: "Geist-LightItalic",     bi: "Geist-MediumItalic" },
+};
+
+let FONTKIT = null;
+// Below this size, measure without kerning. PowerPoint kerns only from the
+// `kern` threshold in the deck's default text style — pptxgenjs writes 1200,
+// 12pt — so a deck kit passes 12 and its body text measures the way it is
+// drawn. 0, the default, kerns everything, as this module always has.
+let KERN_FROM = 0;
+const cache = new Map();
+function face(family = "Geist", { 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 set = FACE[family] || FACE["Geist"];
+  const stem = set[bold && italic ? "bi" : bold ? "b" : italic ? "i" : "r"];
+  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. */
+function widthIn(text, { family, fontSize, bold, italic } = {}) {
+  if (!text) return 0;
+  const f = face(family, { bold, italic });
+  const run = fontSize < KERN_FROM ? f.layout(String(text), { kern: false }) : f.layout(String(text));
+  return (run.advanceWidth / f.unitsPerEm) * (fontSize / 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? Returns a verdict object rather than a boolean 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 font size at or below `fontSize` that fits the box, stepping down in
+ * `step` pt increments but never below `min`. Use this instead of hardcoding a
+ * length threshold — it works for any string, in any language.
+ */
+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;
+
+/**
+ * This module lives in brand/, outside any kit's `node_modules`, so Node cannot
+ * resolve `fontkit` from here. The kit that loads it hands its own copy in.
+ * Explicit beats a resolution trick that works until someone moves a directory.
+ */
+module.exports = function create(fontkit, { kernFrom = 0 } = {}) {
+  FONTKIT = fontkit;
+  KERN_FROM = kernFrom;
+  return { widthIn, wrap, heightIn, fits, fitSize, lineCount, face };
+};