@squinch/core 0.1.0

package/dist/metrics.d.ts

@@ -0,0 +1,20 @@
+/** Families the metrics table carries. `inter` is the document face; `mono`
+ *  is IBM Plex Mono, used only where digits must line up in a chip segment. */
+export type FontFamily = "inter" | "mono";
+/** Weights the table carries. Not every family has every weight — mono ships
+ *  400 alone — and asking for a missing one is a programming error, so the
+ *  lookup below throws rather than silently measuring the wrong face. */
+export type FontWeight = "400" | "500" | "600";
+/** Can the bundled subset actually draw this character? `measure` answers a
+ *  different question — it falls back to an average advance so layout never
+ *  breaks — and the gap between the two is where a glyph goes missing from a
+ *  render without anything failing. Space is drawable by definition. */
+export declare function drawable(ch: string): boolean;
+export declare function measure(text: string, sizePx: number, weight?: FontWeight, family?: FontFamily): number;
+export declare function fit(text: string, maxPx: number, sizePx: number, weight?: FontWeight, family?: FontFamily): string;
+/** Greedy word-wrap against the committed metrics tables, ellipsizing the last
+ *  line. Lived in svg.ts as `wrap()` until edge notes became layout citizens:
+ *  the layout must reserve exactly the box the renderer will draw, so the two
+ *  have to share one wrapping function or the reservation is for a different
+ *  note than the one drawn — the same single-source rule as `pillDims`. */
+export declare function wrapText(text: string, maxPx: number, sizePx: number, fam: FontFamily, maxLines: number): string[];

package/dist/metrics.generated.d.ts

@@ -0,0 +1,4 @@
+export declare const METRICS: Record<string, Record<string, {
+    advances: Record<string, number>;
+    fallback: number;
+}>>;

package/dist/metrics.generated.js

@@ -0,0 +1,4 @@
+// GENERATED by scripts/gen-metrics-module.ts — do not edit.
+// Precomputed advance widths (em units) per family/weight. Layout measures
+// text against this table and never asks the environment.
+export const METRICS = { "inter": { "400": { "advances": { "0": 0.630859, "1": 0.406738, "2": 0.609863, "3": 0.617676, "4": 0.645996, "5": 0.593262, "6": 0.620117, "7": 0.565918, "8": 0.618652, "9": 0.620117, " ": 0.28125, "!": 0.287598, "\"": 0.46582, "#": 0.633301, "$": 0.641602, "%": 0.981934, "&": 0.644043, "'": 0.299805, "(": 0.364746, ")": 0.364746, "*": 0.500977, "+": 0.661621, ",": 0.288086, "-": 0.459961, ".": 0.288086, "/": 0.360352, ":": 0.288086, ";": 0.301758, "<": 0.661621, "=": 0.661621, ">": 0.661621, "?": 0.51123, "@": 0.96582, "A": 0.689941, "B": 0.654297, "C": 0.730469, "D": 0.72168, "E": 0.601074, "F": 0.590332, "G": 0.746094, "H": 0.743164, "I": 0.268555, "J": 0.570801, "K": 0.671875, "L": 0.56543, "M": 0.90332, "N": 0.753418, "O": 0.764648, "P": 0.638672, "Q": 0.764648, "R": 0.643555, "S": 0.641602, "T": 0.645508, "U": 0.744141, "V": 0.689941, "W": 0.985352, "X": 0.682129, "Y": 0.678711, "Z": 0.628906, "[": 0.364746, "\\": 0.360352, "]": 0.364746, "^": 0.471191, "_": 0.456055, "`": 0.322754, "a": 0.561523, "b": 0.612305, "c": 0.571289, "d": 0.612305, "e": 0.583008, "f": 0.370117, "g": 0.613281, "h": 0.591309, "i": 0.242188, "j": 0.242188, "k": 0.548828, "l": 0.242188, "m": 0.875977, "n": 0.59082, "o": 0.599609, "p": 0.612305, "q": 0.612305, "r": 0.376465, "s": 0.527832, "t": 0.327148, "u": 0.591309, "v": 0.562012, "w": 0.818359, "x": 0.545898, "y": 0.562012, "z": 0.552246, "{": 0.42627, "|": 0.33252, "}": 0.42627, "~": 0.661621, "·": 0.288086, "×": 0.661621, "…": 0.864258, "—": 1, "–": 0.5, "‘": 0.260742, "’": 0.260742, "“": 0.44043, "”": 0.44043, "→": 0.65625, "←": 0.65625, "↔": 0.65625, "•": 0.5625, "§": 0.568359, "©": 0.914063, "®": 0.666016, "™": 0.61084, "°": 0.455566, "±": 0.661621, "≈": 0.65625, "≥": 0.65625, "≤": 0.65625, "‹": 0.384277, "›": 0.384277, "«": 0.58252, "»": 0.58252 }, "fallback": 0.565131 }, "500": { "advances": { "0": 0.645508, "1": 0.415039, "2": 0.616211, "3": 0.626953, "4": 0.65625, "5": 0.603027, "6": 0.629883, "7": 0.571289, "8": 0.629395, "9": 0.629883, " ": 0.266602, "!": 0.304199, "\"": 0.494141, "#": 0.638672, "$": 0.645996, "%": 0.993164, "&": 0.65332, "'": 0.312988, "(": 0.368652, ")": 0.368652, "*": 0.520508, "+": 0.66748, ",": 0.303223, "-": 0.462402, ".": 0.303223, "/": 0.369629, ":": 0.303223, ";": 0.31543, "<": 0.66748, "=": 0.66748, ">": 0.66748, "?": 0.527344, "@": 0.982422, "A": 0.708984, "B": 0.656738, "C": 0.733398, "D": 0.72168, "E": 0.603027, "F": 0.589355, "G": 0.747559, "H": 0.744629, "I": 0.272461, "J": 0.575195, "K": 0.6875, "L": 0.56543, "M": 0.912598, "N": 0.756348, "O": 0.766602, "P": 0.641602, "Q": 0.768555, "R": 0.647949, "S": 0.645996, "T": 0.652832, "U": 0.740234, "V": 0.708984, "W": 1.00293, "X": 0.700684, "Y": 0.696289, "Z": 0.640625, "[": 0.368652, "\\": 0.369629, "]": 0.368652, "^": 0.476563, "_": 0.462891, "`": 0.336914, "a": 0.567871, "b": 0.618164, "c": 0.577148, "d": 0.618164, "e": 0.587402, "f": 0.379395, "g": 0.619629, "h": 0.601563, "i": 0.251953, "j": 0.251953, "k": 0.559082, "l": 0.251953, "m": 0.888184, "n": 0.601563, "o": 0.604004, "p": 0.618164, "q": 0.618164, "r": 0.386719, "s": 0.538574, "t": 0.340332, "u": 0.601563, "v": 0.574707, "w": 0.829102, "x": 0.557129, "y": 0.575195, "z": 0.559082, "{": 0.44043, "|": 0.345703, "}": 0.44043, "~": 0.66748, "·": 0.303223, "×": 0.66748, "…": 0.910156, "—": 1, "–": 0.5, "‘": 0.277344, "’": 0.277344, "“": 0.473633, "”": 0.470703, "→": 0.65625, "←": 0.65625, "↔": 0.65625, "•": 0.533203, "§": 0.568359, "©": 0.914063, "®": 0.664551, "™": 0.620605, "°": 0.457031, "±": 0.66748, "≈": 0.65625, "≥": 0.65625, "≤": 0.65625, "‹": 0.399902, "›": 0.399902, "«": 0.608398, "»": 0.608398 }, "fallback": 0.573791 }, "600": { "advances": { "0": 0.659668, "1": 0.422852, "2": 0.623047, "3": 0.63623, "4": 0.666016, "5": 0.612305, "6": 0.639648, "7": 0.576172, "8": 0.640137, "9": 0.639648, " ": 0.251953, "!": 0.321289, "\"": 0.522949, "#": 0.643555, "$": 0.650391, "%": 1.004395, "&": 0.662598, "'": 0.325684, "(": 0.373047, ")": 0.373047, "*": 0.539551, "+": 0.672852, ",": 0.318848, "-": 0.465332, ".": 0.318848, "/": 0.378906, ":": 0.318848, ";": 0.329102, "<": 0.672852, "=": 0.672852, ">": 0.672852, "?": 0.543457, "@": 0.999023, "A": 0.727539, "B": 0.65918, "C": 0.736816, "D": 0.722168, "E": 0.605469, "F": 0.587891, "G": 0.749023, "H": 0.745605, "I": 0.276855, "J": 0.57959, "K": 0.703125, "L": 0.56543, "M": 0.922363, "N": 0.759277, "O": 0.768555, "P": 0.64502, "Q": 0.772949, "R": 0.652344, "S": 0.650391, "T": 0.660156, "U": 0.73584, "V": 0.727539, "W": 1.02002, "X": 0.719727, "Y": 0.713379, "Z": 0.652344, "[": 0.373047, "\\": 0.378906, "]": 0.373047, "^": 0.481445, "_": 0.469238, "`": 0.351074, "a": 0.574219, "b": 0.624023, "c": 0.58252, "d": 0.624023, "e": 0.591309, "f": 0.388672, "g": 0.625488, "h": 0.612305, "i": 0.261719, "j": 0.261719, "k": 0.569336, "l": 0.261719, "m": 0.900391, "n": 0.611816, "o": 0.608887, "p": 0.624023, "q": 0.624023, "r": 0.396973, "s": 0.549316, "t": 0.353027, "u": 0.612305, "v": 0.586914, "w": 0.839355, "x": 0.568848, "y": 0.588379, "z": 0.565918, "{": 0.45459, "|": 0.358887, "}": 0.45459, "~": 0.672852, "·": 0.318848, "×": 0.672852, "…": 0.956055, "—": 1, "–": 0.5, "‘": 0.293945, "’": 0.293945, "“": 0.506836, "”": 0.501465, "→": 0.65625, "←": 0.65625, "↔": 0.65625, "•": 0.503418, "§": 0.568359, "©": 0.914063, "®": 0.663574, "™": 0.630371, "°": 0.458008, "±": 0.672852, "≈": 0.65625, "≥": 0.65625, "≤": 0.65625, "‹": 0.415527, "›": 0.415527, "«": 0.634277, "»": 0.634277 }, "fallback": 0.582423 } }, "mono": { "400": { "advances": { "0": 0.6, "1": 0.6, "2": 0.6, "3": 0.6, "4": 0.6, "5": 0.6, "6": 0.6, "7": 0.6, "8": 0.6, "9": 0.6, " ": 0.6, "!": 0.6, "\"": 0.6, "#": 0.6, "$": 0.6, "%": 0.6, "&": 0.6, "'": 0.6, "(": 0.6, ")": 0.6, "*": 0.6, "+": 0.6, ",": 0.6, "-": 0.6, ".": 0.6, "/": 0.6, ":": 0.6, ";": 0.6, "<": 0.6, "=": 0.6, ">": 0.6, "?": 0.6, "@": 0.6, "A": 0.6, "B": 0.6, "C": 0.6, "D": 0.6, "E": 0.6, "F": 0.6, "G": 0.6, "H": 0.6, "I": 0.6, "J": 0.6, "K": 0.6, "L": 0.6, "M": 0.6, "N": 0.6, "O": 0.6, "P": 0.6, "Q": 0.6, "R": 0.6, "S": 0.6, "T": 0.6, "U": 0.6, "V": 0.6, "W": 0.6, "X": 0.6, "Y": 0.6, "Z": 0.6, "[": 0.6, "\\": 0.6, "]": 0.6, "^": 0.6, "_": 0.6, "`": 0.6, "a": 0.6, "b": 0.6, "c": 0.6, "d": 0.6, "e": 0.6, "f": 0.6, "g": 0.6, "h": 0.6, "i": 0.6, "j": 0.6, "k": 0.6, "l": 0.6, "m": 0.6, "n": 0.6, "o": 0.6, "p": 0.6, "q": 0.6, "r": 0.6, "s": 0.6, "t": 0.6, "u": 0.6, "v": 0.6, "w": 0.6, "x": 0.6, "y": 0.6, "z": 0.6, "{": 0.6, "|": 0.6, "}": 0.6, "~": 0.6, "·": 0.6, "×": 0.6, "…": 0.6, "—": 0.6, "–": 0.6, "‘": 0.6, "’": 0.6, "“": 0.6, "”": 0.6, "→": 0.6, "←": 0.6, "↔": 0.6, "•": 0.6, "§": 0.6, "©": 0.6, "®": 0.6, "™": 0.6, "°": 0.6, "±": 0.6, "≈": 0.6, "≥": 0.6, "≤": 0.6, "‹": 0.6, "›": 0.6, "«": 0.6, "»": 0.6 }, "fallback": 0.6 } } };

package/dist/metrics.js

@@ -0,0 +1,57 @@
+// Text measurement from the committed metrics table ONLY (non-negotiable:
+// layout never asks the environment how wide text is). Browser-safe.
+import { METRICS } from "./metrics.generated.js";
+/** Can the bundled subset actually draw this character? `measure` answers a
+ *  different question — it falls back to an average advance so layout never
+ *  breaks — and the gap between the two is where a glyph goes missing from a
+ *  render without anything failing. Space is drawable by definition. */
+export function drawable(ch) {
+    return ch === " " || ch in METRICS.inter["400"].advances;
+}
+export function measure(text, sizePx, weight = "500", family = "inter") {
+    const m = METRICS[family]?.[weight];
+    if (!m)
+        throw new Error(`no metrics for ${family} ${weight} — regenerate with gen-metrics`);
+    let em = 0;
+    for (const ch of text)
+        em += m.advances[ch] ?? m.fallback;
+    return em * sizePx;
+}
+export function fit(text, maxPx, sizePx, weight = "500", family = "inter") {
+    if (measure(text, sizePx, weight, family) <= maxPx)
+        return text;
+    let s = text;
+    while (s.length > 1 && measure(s + "…", sizePx, weight, family) > maxPx)
+        s = s.slice(0, -1);
+    return s.trimEnd() + "…";
+}
+/** Greedy word-wrap against the committed metrics tables, ellipsizing the last
+ *  line. Lived in svg.ts as `wrap()` until edge notes became layout citizens:
+ *  the layout must reserve exactly the box the renderer will draw, so the two
+ *  have to share one wrapping function or the reservation is for a different
+ *  note than the one drawn — the same single-source rule as `pillDims`. */
+export function wrapText(text, maxPx, sizePx, fam, maxLines) {
+    const words = text.split(" ");
+    const lines = [];
+    let cur = "";
+    for (const w of words) {
+        const attempt = cur ? `${cur} ${w}` : w;
+        if (measure(attempt, sizePx, "400", fam) <= maxPx)
+            cur = attempt;
+        else {
+            if (cur)
+                lines.push(cur);
+            cur = w;
+            if (lines.length === maxLines - 1)
+                break;
+        }
+    }
+    if (lines.length < maxLines)
+        lines.push(cur);
+    const consumed = lines.join(" ").length;
+    if (consumed < text.length) {
+        const last = lines[lines.length - 1];
+        lines[lines.length - 1] = fit(`${last}${text.slice(consumed)}`, maxPx, sizePx, "400", fam);
+    }
+    return lines;
+}

package/dist/model/build.d.ts

@@ -0,0 +1,8 @@
+import type { BuildResult, Diagnostic } from "./types.js";
+export interface ProjectFile {
+    name: string;
+    src: string;
+}
+export declare function buildModel(src: string): BuildResult;
+export declare function buildProject(input: ProjectFile[]): BuildResult;
+export declare function formatDiagnostics(diags: Diagnostic[], file?: string): string;