wand-kit 0.3.2 → 0.5.0

package/brands/interim/assets/story/index.json

@@ -0,0 +1,214 @@
+{
+  "_": "Crops of the live hero's canvas (scale-story.desktop-wheel-20261020-r4.js, captured 2026-10-21 at its 1.8x cap, 2300x1652, captions suppressed) at each story stage. `<stage>` is RGBA on the night ground, edges feathered over 140px; `<stage>-alpha` is the same frame captured without the script's ground fill, for light grounds. `body` is the art's solid extent inside the crop (luminance > 40, or alpha > 120); a layout fits that box, not the file.",
+  "ground": "0B0913",
+  "worker": {
+    "file": "worker.png",
+    "size": [
+      1126,
+      1593
+    ],
+    "body": [
+      220,
+      220,
+      906,
+      1373
+    ],
+    "ring": [
+      221,
+      221,
+      905,
+      1372
+    ]
+  },
+  "worker-alpha": {
+    "file": "worker-alpha.png",
+    "size": [
+      1125,
+      1592
+    ],
+    "body": [
+      220,
+      220,
+      905,
+      1372
+    ],
+    "ring": [
+      220,
+      221,
+      904,
+      1372
+    ]
+  },
+  "learning": {
+    "file": "learning.png",
+    "size": [
+      2206,
+      1593
+    ],
+    "body": [
+      220,
+      220,
+      2206,
+      1373
+    ],
+    "ring": [
+      828,
+      224,
+      1512,
+      1370
+    ]
+  },
+  "learning-alpha": {
+    "file": "learning-alpha.png",
+    "size": [
+      2153,
+      1592
+    ],
+    "body": [
+      220,
+      220,
+      2064,
+      1372
+    ],
+    "ring": [
+      775,
+      224,
+      1459,
+      1370
+    ]
+  },
+  "organization": {
+    "file": "organization.png",
+    "size": [
+      2147,
+      1652
+    ],
+    "body": [
+      28,
+      192,
+      1927,
+      1601
+    ],
+    "ring": [
+      789,
+      193,
+      1927,
+      1225
+    ]
+  },
+  "organization-alpha": {
+    "file": "organization-alpha.png",
+    "size": [
+      1715,
+      1652
+    ],
+    "body": [
+      220,
+      188,
+      1495,
+      1600
+    ],
+    "ring": [
+      218,
+      188,
+      1495,
+      1312
+    ]
+  },
+  "economy": {
+    "file": "economy.png",
+    "size": [
+      2037,
+      1652
+    ],
+    "body": [
+      220,
+      21,
+      1817,
+      1550
+    ],
+    "ring": [
+      325,
+      112,
+      1580,
+      1454
+    ]
+  },
+  "economy-alpha": {
+    "file": "economy-alpha.png",
+    "size": [
+      1930,
+      1652
+    ],
+    "body": [
+      220,
+      33,
+      1710,
+      1543
+    ],
+    "ring": [
+      233,
+      111,
+      1593,
+      1473
+    ]
+  },
+  "agent": {
+    "file": "agent.png",
+    "size": [
+      1190,
+      1400
+    ],
+    "body": [
+      220,
+      52,
+      970,
+      1225
+    ],
+    "ring": [
+      224,
+      53,
+      969,
+      1224
+    ]
+  },
+  "agent-alpha": {
+    "file": "agent-alpha.png",
+    "size": [
+      1190,
+      1400
+    ],
+    "body": [
+      220,
+      53,
+      970,
+      1224
+    ],
+    "ring": [
+      220,
+      53,
+      969,
+      1224
+    ]
+  },
+  "worker-light": {
+    "file": "worker-light.png",
+    "size": [
+      1125,
+      1592
+    ],
+    "body": [
+      220,
+      220,
+      905,
+      1372
+    ],
+    "ring": [
+      220,
+      221,
+      904,
+      1372
+    ],
+    "_": "worker-alpha.png with its translucent pixels tinted toward violetStrong (tools/tint-light.py), for the composition on light"
+  }
+}

package/brands/interim/assets/wordmark-on-dark.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 -131 3120 999" role="img" aria-label="Wand"><path d="M0 235.79A7.79 7.79 0 0 1 7.79 228L152.47 228A7.79 7.79 0 0 1 160.25 235.79L160.25 589.17A120.25 120.25 0 0 0 400.75 589.17L400.75 235.79A7.79 7.79 0 0 1 408.53 228L553.21 228A7.79 7.79 0 0 1 561 235.79L561 589.17A120.25 120.25 0 0 0 801.49 589.17L801.49 324.02A7.79 7.79 0 0 1 809.28 316.24L810.14 316.24Q814.03 316.24 816.68 319.09L839.27 343.38A57.97 57.97 0 0 0 924.18 343.38L946.77 319.09Q949.42 316.24 953.31 316.24L953.96 316.24A7.79 7.79 0 0 1 961.75 324.02L961.75 589.17A280.5 280.5 0 0 1 487.02 791.55Q480.87 785.46 474.72 791.55A280.5 280.5 0 0 1 0 589.17ZM1068.5 548A320 320 0 1 1 1708.5 548A320 320 0 1 1 1068.5 548ZM1555 228L1703 228A6 6 0 0 1 1709 234L1709 861A6 6 0 0 1 1703 867L1555 867A6 6 0 0 1 1549 861L1549 234A6 6 0 0 1 1555 228ZM1549 547.5A160.5 160.5 0 1 0 1228 547.5A160.5 160.5 0 1 0 1549 547.5ZM1816 861L1816 505.5A277.5 277.5 0 0 1 2371 505.5L2371 861A6 6 0 0 1 2365 867L2219 867A6 6 0 0 1 2213 861L2213 515A119.5 119.5 0 0 0 1974 515L1974 861A6 6 0 0 1 1968 867L1822 867A6 6 0 0 1 1816 861ZM2478 547A319.5 319.5 0 1 1 3117 547A319.5 319.5 0 1 1 2478 547ZM2963 2L3113.5 2A6 6 0 0 1 3119.5 8L3119.5 861A6 6 0 0 1 3113.5 867L2963 867A6 6 0 0 1 2957 861L2957 8A6 6 0 0 1 2963 2ZM2957 575.43L2957 531.57A161 161 0 1 0 2957 575.43Z" fill="#ffffff"/><path d="M871.04 -125.15A7.53 7.53 0 0 1 886.41 -125.15A193.62 193.62 0 0 0 1072.35 60.79A7.53 7.53 0 0 1 1072.35 76.15A193.62 193.62 0 0 0 886.41 262.09A7.53 7.53 0 0 1 871.04 262.09A193.62 193.62 0 0 0 685.11 76.15A7.53 7.53 0 0 1 685.11 60.79A193.62 193.62 0 0 0 871.04 -125.15Z" fill="#c2a1ef"/></svg>

package/brands/interim/assets/wordmark-on-light.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 -131 3120 999" role="img" aria-label="Wand"><path d="M0 235.79A7.79 7.79 0 0 1 7.79 228L152.47 228A7.79 7.79 0 0 1 160.25 235.79L160.25 589.17A120.25 120.25 0 0 0 400.75 589.17L400.75 235.79A7.79 7.79 0 0 1 408.53 228L553.21 228A7.79 7.79 0 0 1 561 235.79L561 589.17A120.25 120.25 0 0 0 801.49 589.17L801.49 324.02A7.79 7.79 0 0 1 809.28 316.24L810.14 316.24Q814.03 316.24 816.68 319.09L839.27 343.38A57.97 57.97 0 0 0 924.18 343.38L946.77 319.09Q949.42 316.24 953.31 316.24L953.96 316.24A7.79 7.79 0 0 1 961.75 324.02L961.75 589.17A280.5 280.5 0 0 1 487.02 791.55Q480.87 785.46 474.72 791.55A280.5 280.5 0 0 1 0 589.17ZM1068.5 548A320 320 0 1 1 1708.5 548A320 320 0 1 1 1068.5 548ZM1555 228L1703 228A6 6 0 0 1 1709 234L1709 861A6 6 0 0 1 1703 867L1555 867A6 6 0 0 1 1549 861L1549 234A6 6 0 0 1 1555 228ZM1549 547.5A160.5 160.5 0 1 0 1228 547.5A160.5 160.5 0 1 0 1549 547.5ZM1816 861L1816 505.5A277.5 277.5 0 0 1 2371 505.5L2371 861A6 6 0 0 1 2365 867L2219 867A6 6 0 0 1 2213 861L2213 515A119.5 119.5 0 0 0 1974 515L1974 861A6 6 0 0 1 1968 867L1822 867A6 6 0 0 1 1816 861ZM2478 547A319.5 319.5 0 1 1 3117 547A319.5 319.5 0 1 1 2478 547ZM2963 2L3113.5 2A6 6 0 0 1 3119.5 8L3119.5 861A6 6 0 0 1 3113.5 867L2963 867A6 6 0 0 1 2957 861L2957 8A6 6 0 0 1 2963 2ZM2957 575.43L2957 531.57A161 161 0 1 0 2957 575.43Z" fill="#240647"/><path d="M871.04 -125.15A7.53 7.53 0 0 1 886.41 -125.15A193.62 193.62 0 0 0 1072.35 60.79A7.53 7.53 0 0 1 1072.35 76.15A193.62 193.62 0 0 0 886.41 262.09A7.53 7.53 0 0 1 871.04 262.09A193.62 193.62 0 0 0 685.11 76.15A7.53 7.53 0 0 1 685.11 60.79A193.62 193.62 0 0 0 871.04 -125.15Z" fill="#765098"/></svg>

package/brands/interim/fonts/OFL-Geist.txt

@@ -0,0 +1,93 @@
+Copyright 2024 The Geist Project Authors (https://github.com/vercel/geist-font.git)
+
+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:
+https://openfontlicense.org
+
+
+-----------------------------------------------------------
+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/interim/fonts/OFL-Newsreader.txt

@@ -0,0 +1,93 @@
+Copyright 2020 The Newsreader Project Authors (http://github.com/productiontype/Newsreader)
+
+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/interim/fonts/faces.json

@@ -0,0 +1,12 @@
+{
+  "_": "The one table that maps a PowerPoint family name to the files that draw it; measure.js, pdf.js, embed_fonts.py and brandlint read it. Weight rides on the family name (\"Geist Medium\" is the display's 500 since the approved design of 2026-10-22), so a renderer that matches by name has one face per name. `tracking` is letter-spacing in em: the display and phrase untracked, as approved; the label's caps add their own 0.11em where they are set.",
+  "default": "Geist",
+  "families": {
+    "Geist": { "role": "body", "r": "Geist-Regular", "b": "Geist-SemiBold", "i": "Geist-Regular", "bi": "Geist-SemiBold", "tracking": 0, "license": "SIL OFL 1.1, see OFL-Geist.txt" },
+    "Geist Book": { "role": "site display (450)", "r": "Geist-Book", "b": "Geist-SemiBold", "i": "Geist-Book", "bi": "Geist-SemiBold", "tracking": -0.063, "license": "SIL OFL 1.1, see OFL-Geist.txt" },
+    "Geist Medium": { "role": "display, label", "r": "Geist-Medium", "b": "Geist-SemiBold", "i": "Geist-Medium", "bi": "Geist-SemiBold", "tracking": 0, "license": "SIL OFL 1.1, see OFL-Geist.txt" },
+    "Geist SemiBold": { "role": "bold", "r": "Geist-SemiBold", "b": "Geist-SemiBold", "i": "Geist-SemiBold", "bi": "Geist-SemiBold", "tracking": 0, "license": "SIL OFL 1.1, see OFL-Geist.txt" },
+    "Newsreader": { "role": "site phrase (400)", "r": "Newsreader-Regular", "b": "Newsreader-Regular", "i": "Newsreader-Italic", "bi": "Newsreader-Italic", "tracking": -0.049, "license": "SIL OFL 1.1, see OFL-Newsreader.txt" },
+    "Newsreader Medium": { "role": "phrase", "r": "Newsreader-Medium", "b": "Newsreader-Medium", "i": "Newsreader-MediumItalic", "bi": "Newsreader-MediumItalic", "tracking": 0, "license": "SIL OFL 1.1, see OFL-Newsreader.txt" }
+  }
+}

package/brands/interim/lib/composition.js

@@ -0,0 +1,169 @@
+/**
+ * lib/composition.js — draws one window of the approved social composition onto a canvas.
+ *
+ * A browser script. The page that loads it sets `window.CARD` (lib/composition.mjs
+ * writes such pages): the composition from assets/social/composition.json, the
+ * palette resolved to hex for one ground, the wordmark's paths, the ring's file,
+ * and the window, a scale `s` (px per master unit) with the master point at the
+ * card's top-left (`x0`, `y0`). Everything is drawn in master units, so the art,
+ * the lockup and the stroke widths scale together and no part is re-proportioned
+ * per format. `lockup: false` draws the art alone, for a page that sets its own
+ * title over it. A fit gate is written as JSON into <script id="gate">.
+ */
+(async function () {
+  const C = window.CARD, D = C.composition, P = C.palette;
+  const dpr = window.devicePixelRatio || 1;
+  const cv = document.getElementById("card");
+  cv.width = Math.round(C.w * dpr); cv.height = Math.round(C.h * dpr);
+  cv.style.width = C.w + "px"; cv.style.height = C.h + "px";
+  const ctx = cv.getContext("2d");
+
+  await Promise.all((C.fonts || []).map((f) => document.fonts.load(f)));
+  const ring = await new Promise((ok, no) => { const i = new Image(); i.onload = () => ok(i); i.onerror = () => no(new Error("ring image did not load: " + C.ringSrc)); i.src = C.ringSrc; });
+
+  const hex = (h) => [0, 2, 4].map((i) => parseInt(h.slice(i, i + 2), 16));
+  const rgba = (c, a) => `rgba(${c.map((v) => Math.round(Math.max(0, Math.min(255, v)))).join(",")},${Math.max(0, Math.min(1, a)).toFixed(4)})`;
+  const mix = (a, b, t) => a.map((v, i) => v + (b[i] - v) * t);
+
+  // master -> device pixels
+  const k = C.s * dpr;
+  ctx.setTransform(1, 0, 0, 1, 0, 0);
+  ctx.fillStyle = "#" + P.ground; ctx.fillRect(0, 0, cv.width, cv.height);
+  ctx.setTransform(k, 0, 0, k, -C.x0 * k, -C.y0 * k);
+  const toPx = (x, y) => [(x - C.x0) * C.s, (y - C.y0) * C.s];
+  const left = C.x0, top = C.y0, right = C.x0 + C.w / C.s, bottom = C.y0 + C.h / C.s;
+
+  // ---- the planet: a disc of ground over a light that falls off outside its edge
+  const pl = D.planet, glowEnd = pl.glow[pl.glow.length - 1][0], light = hex(P.light);
+  const g = ctx.createRadialGradient(pl.c[0], pl.c[1], pl.r, pl.c[0], pl.c[1], pl.r + glowEnd);
+  for (const [t, a] of pl.glow) g.addColorStop(t / glowEnd, rgba(light, a * P.glowGain));
+  ctx.fillStyle = g; ctx.fillRect(left, top, right - left, bottom - top);
+  ctx.beginPath(); ctx.arc(pl.c[0], pl.c[1], pl.r, 0, Math.PI * 2);
+  ctx.fillStyle = "#" + P.planet; ctx.fill();
+
+  // ---- trails: y(x) polylines, tinted and faded along x by the measured stops
+  const tr = D.trails, head = hex(P.trailHead), tail = hex(P.trailTail);
+  for (const t of tr.list) {
+    const x0 = t.points[0][0], x1 = t.points[t.points.length - 1][0];
+    const grad = ctx.createLinearGradient(x0, 0, x1, 0);
+    for (const [x, kk, tt] of t.stops) {
+      if (x < x0 || x > x1) continue;
+      grad.addColorStop((x - x0) / (x1 - x0), rgba(mix(head, tail, Math.max(0, tt)), Math.min(1, kk / tr.width) * P.trailGain));
+    }
+    ctx.beginPath();
+    t.points.forEach(([x, y], i) => (i ? ctx.lineTo(x, y) : ctx.moveTo(x, y)));
+    ctx.lineWidth = tr.width; ctx.lineCap = "round"; ctx.lineJoin = "round";
+    ctx.strokeStyle = grad; ctx.stroke();
+  }
+
+  // ---- dots: a core in a gaussian glow
+  const dt = D.dots, R = dt.glowSigma * 3;
+  for (const d of dt.list) {
+    const gg = ctx.createRadialGradient(d.x, d.y, 0, d.x, d.y, R);
+    for (let i = 0; i <= 12; i++) { const r = (i / 12) * R; gg.addColorStop(i / 12, rgba(hex(P.dotGlow), dt.glowAlpha * P.dotGain * Math.exp(-(r * r) / (2 * dt.glowSigma * dt.glowSigma)) * (i === 12 ? 0 : 1))); }
+    ctx.fillStyle = gg; ctx.beginPath(); ctx.arc(d.x, d.y, R, 0, Math.PI * 2); ctx.fill();
+    ctx.fillStyle = "#" + P.dot; ctx.beginPath(); ctx.arc(d.x, d.y, dt.core, 0, Math.PI * 2); ctx.fill();
+  }
+
+  // ---- the ring, over the trails: they show through its opening
+  const rg = D.ring, [lx0, ly0, lx1, ly1] = rg.lumBox, [bx0, by0, bx1, by1] = rg.box, rdx = (C.ring && C.ring.dx) || 0, rdy = (C.ring && C.ring.dy) || 0;
+  const sc = ((bx1 - bx0) / (lx1 - lx0) + (by1 - by0) / (ly1 - ly0)) / 2;
+  ctx.imageSmoothingEnabled = true; ctx.imageSmoothingQuality = "high";
+  ctx.drawImage(ring, bx0 + rdx - lx0 * sc, by0 + rdy - ly0 * sc, ring.naturalWidth * sc, ring.naturalHeight * sc);
+  const ringBox = [bx0 + rdx, by0 + rdy, bx1 + rdx, by1 + rdy];
+
+  // ---- a photograph over the art (`C.photo`: a cut-out with its own transparency, filling the card): the brand's one
+  // grade, as the kit's photo() lays it (blacks lift toward gradeLow at 42%, highlights settle toward gradeHigh at 55%),
+  // so a person cut from daylight sits in the scene. A profile photo that continues the banner is this over the banner's art.
+  if (C.photo) {
+    const im = await new Promise((ok, no) => { const i = new Image(); i.onload = () => ok(i); i.onerror = () => no(new Error("photo did not load: " + C.photo.src)); i.src = C.photo.src; });
+    const layer = () => { const c = document.createElement("canvas"); c.width = cv.width; c.height = cv.height; return [c, c.getContext("2d")]; };
+    const [cut, c0] = layer(), sc2 = Math.max(cut.width / im.naturalWidth, cut.height / im.naturalHeight);
+    c0.imageSmoothingQuality = "high";
+    c0.drawImage(im, (cut.width - im.naturalWidth * sc2) / 2, (cut.height - im.naturalHeight * sc2) / 2, im.naturalWidth * sc2, im.naturalHeight * sc2);
+    // the grade by blending, not by reading pixels back (a file:// image taints the canvas): lighten toward the low
+    // colour, darken toward the high, each clipped to the cut-out's own shape
+    const [g, g0] = layer();
+    g0.drawImage(cut, 0, 0);
+    for (const [op, colour, a] of [["lighten", C.photo.low, 0.42], ["darken", C.photo.high, 0.55]]) {
+      g0.globalCompositeOperation = op; g0.fillStyle = rgba(hex(colour), a); g0.fillRect(0, 0, g.width, g.height);
+      g0.globalCompositeOperation = "destination-in"; g0.drawImage(cut, 0, 0);
+    }
+    ctx.save(); ctx.setTransform(1, 0, 0, 1, 0, 0); ctx.drawImage(g, 0, 0); ctx.restore();
+  }
+
+  // ---- the lockup, over everything: the wordmark (letters and its approved spark, as the SVG draws them) and two lines.
+  // In place, it sits where the approved exports set it, at the art's scale. `C.set` sets it on its own instead, for a
+  // card that must survive a crop or a thumbnail: { size (the lead's px) or fit: { width, max } (the largest size whose
+  // block fits `width`, up to `max`), x (the lead's ink left; the centre axis when centred; omitted, the block is centred
+  // on the card), top (the spark's tip) or middle (the block's centre), align "left" | "centre", indent (em, the phrase's
+  // step; the approved 2.49 by default), wordmark (its scale alone, 1 by default) }.
+  const boxes = {};
+  let lockPx = null, typePx = +(D.lockup.lead.size * C.s).toFixed(1);
+  if (C.lockup !== false) {
+    const L = D.lockup, W = C.paths, S = C.set || null, wk = L.wordmark.height / W.lettersH;
+    const ox = S ? 0 : (C.lockup && C.lockup.dx) || 0, oy = S ? 0 : (C.lockup && C.lockup.dy) || 0;
+    const align = (S && S.align) || "left", centre = S && align === "centre" ? L.lead.inkLeft : null;
+    const indent = S && S.indent != null ? S.indent : (L.phrase.inkLeft - L.lead.inkLeft) / L.lead.size;
+    // the wordmark, scaled alone if asked, its baseline and left edge held
+    const wmS = (S && S.wordmark) || 1, wkS = wk * wmS, wW = W.lettersW * wkS, wH = L.wordmark.height * wmS;
+    const wl = centre != null ? centre - wW / 2 : L.wordmark.centerX + ox - (W.lettersW * wk) / 2, wt = L.wordmark.top + oy + L.wordmark.height - wH;
+    boxes.wordmark = [wl, wt + (W.sparkTop - W.lettersTop) * wkS, wl + wW, wt + wH];
+    // the two lines, measured before anything is drawn (metrics are in the font's own px, whatever the transform)
+    const lines = [["lead", { ...L.lead, ...(C.text && C.text.lead ? { text: C.text.lead } : {}) }, P.ink, L.lead.inkLeft + ox],
+                   ["phrase", { ...L.phrase, ...(C.text && C.text.phrase ? { text: C.text.phrase } : {}) }, P.phrase, S ? L.lead.inkLeft + indent * L.lead.size : L.phrase.inkLeft + ox]];
+    const font = (spec) => { ctx.font = `${spec.italic ? "italic " : ""}${spec.weight} ${spec.size}px "${spec.family}"`; ctx.letterSpacing = (spec.tracking || 0) * spec.size + "px"; };
+    const set = lines.map(([key, spec, colour, left]) => {
+      font(spec);
+      const m = ctx.measureText(spec.text), w = m.actualBoundingBoxLeft + m.actualBoundingBoxRight;
+      const inkLeft = centre != null ? centre - w / 2 : left, y = spec.baseline + oy;
+      boxes[key] = [inkLeft, y - m.actualBoundingBoxAscent, inkLeft + w, y + m.actualBoundingBoxDescent];
+      return { key, spec, colour, x: inkLeft + m.actualBoundingBoxLeft, y };
+    });
+    const all = Object.values(boxes);
+    const blk = [Math.min(...all.map((b) => b[0])), boxes.wordmark[1], Math.max(...all.map((b) => b[2])), Math.max(boxes.lead[3], boxes.phrase[3])];
+    // where the block lands: in place, the art's own transform; set, a transform of its own
+    let toCard;
+    if (S) {
+      const u = S.fit ? Math.min(S.fit.max / L.lead.size, S.fit.width / (blk[2] - blk[0])) : S.size / L.lead.size;
+      const X0 = S.x == null ? C.w / 2 - ((blk[2] - blk[0]) * u) / 2 : S.x - ((centre != null ? centre : L.lead.inkLeft) - blk[0]) * u;
+      const Y0 = S.middle != null ? S.middle - ((blk[3] - blk[1]) * u) / 2 : S.top;
+      ctx.setTransform(dpr * u, 0, 0, dpr * u, dpr * (X0 - blk[0] * u), dpr * (Y0 - blk[1] * u));
+      toCard = (b) => [X0 + (b[0] - blk[0]) * u, Y0 + (b[1] - blk[1]) * u, X0 + (b[2] - blk[0]) * u, Y0 + (b[3] - blk[1]) * u];
+      typePx = +(L.lead.size * u).toFixed(1);
+    } else {
+      toCard = (b) => { const [a, c] = toPx(b[0], b[1]), [e, f] = toPx(b[2], b[3]); return [a, c, e, f]; };
+    }
+    ctx.save();
+    ctx.translate(wl, wt - W.lettersTop * wkS); ctx.scale(wkS, wkS);
+    ctx.fillStyle = "#" + P.wordmark; ctx.fill(new Path2D(W.letters));
+    ctx.fillStyle = "#" + P.spark; ctx.fill(new Path2D(W.spark));
+    ctx.restore();
+    for (const l of set) { font(l.spec); ctx.fillStyle = "#" + l.colour; ctx.fillText(l.spec.text, l.x, l.y); }
+    for (const k2 of Object.keys(boxes)) boxes[k2] = toCard(boxes[k2]).map((v) => Math.round(v * 10) / 10);
+    lockPx = toCard(blk).map((v) => Math.round(v * 10) / 10);
+    ctx.setTransform(k, 0, 0, k, -C.x0 * k, -C.y0 * k);
+  }
+
+  // ---- gate: the rules every card keeps (px, at 1x)
+  const px = (b) => { const [a, c] = toPx(b[0], b[1]), [e, f] = toPx(b[2], b[3]); return [a, c, e, f].map((v) => Math.round(v * 10) / 10); };
+  const r = C.rules || {}, reasons = [];
+  const inside = (b, m) => b[0] >= m - 0.5 && b[1] >= m - 0.5 && b[2] <= C.w - m + 0.5 && b[3] <= C.h - m + 0.5;
+  const pRing = px(ringBox);
+  if (lockPx) {
+    if (r.margin != null && !inside(lockPx, r.margin)) reasons.push(`the lockup comes within ${r.margin}px of an edge`);
+    if (pRing[0] < lockPx[2] + (r.gap || 0) && pRing[2] > lockPx[0] && pRing[1] < lockPx[3] && pRing[3] > lockPx[1]) reasons.push("the ring crowds the lockup");
+    if (r.minType && typePx < r.minType) reasons.push(`type at ${typePx}px is under the ${r.minType}px floor`);
+    // a square crop from the centre (Slack's and WhatsApp's thumbnails) must keep the whole lockup
+    if (r.squareSafe != null && C.w > C.h) {
+      const sx0 = (C.w - C.h) / 2 + r.squareSafe, sx1 = (C.w + C.h) / 2 - r.squareSafe;
+      if (lockPx[0] < sx0 - 0.5 || lockPx[2] > sx1 + 0.5) reasons.push(`the lockup leaves the centre square (x ${sx0} to ${sx1})`);
+    }
+  }
+  if (r.ringWhole && !inside(pRing, r.ringMargin || 0)) reasons.push("the ring is cut by an edge");
+  const gate = { ok: !reasons.length, reasons, s: C.s, typePx, lockup: lockPx, ring: pRing,
+    dots: dt.list.map((d) => toPx(d.x, d.y).map(Math.round)), boxes };
+  const s = document.createElement("script"); s.type = "application/json"; s.id = "gate"; s.textContent = JSON.stringify(gate);
+  document.body.appendChild(s);
+  document.body.dataset.done = "1";
+})().catch((e) => { const s = document.createElement("script"); s.type = "application/json"; s.id = "gate"; s.textContent = JSON.stringify({ ok: false, reasons: ["compose failed: " + e] }); document.body.appendChild(s); });