@safe-vanity-blockie/core 0.3.0

package/dist/scoring.js

@@ -0,0 +1,185 @@
+/**
+ * Largest-remainder apportionment: split `budget` across `rawWeights` proportionally using
+ * integers that sum to exactly `budget`.
+ *
+ * The spec's `Math.round(raw / total * budget)` does not do this — it yields 57 for a 3-stroke
+ * mouth and 62 for a 2-stroke one, silently making some expressions worth more than others.
+ */
+export function apportion(rawWeights, budget) {
+    if (rawWeights.length === 0)
+        return [];
+    const total = rawWeights.reduce((a, b) => a + b, 0);
+    if (total <= 0)
+        throw new Error('apportion: raw weights must sum to a positive number');
+    const exact = rawWeights.map((weight) => (weight * budget) / total);
+    const shares = exact.map((value) => Math.floor(value));
+    const remainder = budget - shares.reduce((a, b) => a + b, 0);
+    const order = exact
+        .map((value, index) => ({ index, fraction: value - Math.floor(value) }))
+        .sort((a, b) => b.fraction - a.fraction || a.index - b.index);
+    for (let i = 0; i < remainder; i++)
+        shares[order[i].index] += 1;
+    return shares;
+}
+export function compileFace(spec) {
+    const used = new Set();
+    const claim = (index, where) => {
+        if (!Number.isInteger(index) || index < 0 || index > 31) {
+            throw new Error(`${where}: cell index ${index} must be an integer between 0 and 31`);
+        }
+        if (used.has(index))
+            throw new Error(`${where}: cell index ${index} is used more than once`);
+        used.add(index);
+    };
+    const fixedIndex = new Uint8Array(spec.fixed.length);
+    const fixedTarget = new Uint8Array(spec.fixed.length);
+    const fixedWeight = new Int32Array(spec.fixed.length);
+    let maxScore = 0;
+    spec.fixed.forEach((cell, i) => {
+        claim(cell.index, `fixed cell ${i}`);
+        fixedIndex[i] = cell.index;
+        fixedTarget[i] = cell.value;
+        fixedWeight[i] = cell.weight;
+        maxScore += cell.weight;
+    });
+    const regionIndexStart = new Int32Array(spec.regions.length);
+    const regionLength = new Int32Array(spec.regions.length);
+    const regionAltCount = new Int32Array(spec.regions.length);
+    const regionCellStart = new Int32Array(spec.regions.length);
+    const indices = [];
+    const cells = [];
+    const weights = [];
+    const regionNames = [];
+    const regionAltNames = [];
+    spec.regions.forEach((region, r) => {
+        regionIndexStart[r] = indices.length;
+        regionCellStart[r] = cells.length;
+        regionLength[r] = region.indices.length;
+        regionAltCount[r] = region.alternatives.length;
+        regionNames.push(region.name);
+        regionAltNames.push(region.alternatives.map((alternative) => alternative.name));
+        if (region.alternatives.length === 0) {
+            throw new Error(`region "${region.name}": needs at least one alternative`);
+        }
+        for (const index of region.indices)
+            claim(index, `region "${region.name}"`);
+        indices.push(...region.indices);
+        for (const alternative of region.alternatives) {
+            if (alternative.cells.length !== region.indices.length) {
+                throw new Error(`region "${region.name}", alternative "${alternative.name}": expected ` +
+                    `${region.indices.length} cells, got ${alternative.cells.length}`);
+            }
+            const raw = alternative.cells.map((cell) => cell === 1 ? region.strokeWeight : region.bgWeight);
+            cells.push(...alternative.cells);
+            weights.push(...apportion(raw, region.budget));
+        }
+        maxScore += region.budget;
+    });
+    return {
+        name: spec.name,
+        maxScore,
+        nFixed: spec.fixed.length,
+        fixedIndex,
+        fixedTarget,
+        fixedWeight,
+        nRegions: spec.regions.length,
+        regionIndexStart,
+        regionLength,
+        regionAltCount,
+        regionCellStart,
+        regionIndex: Uint8Array.from(indices),
+        regionCells: Uint8Array.from(cells),
+        regionWeights: Int32Array.from(weights),
+        regionNames,
+        regionAltNames,
+    };
+}
+/**
+ * Builds the hot-path scorer. Everything is hoisted into locals so the returned closure is
+ * monomorphic: integer-only, no allocation, no division, no property lookups per candidate.
+ */
+export function makeScorer(face) {
+    const { nFixed, fixedIndex, fixedTarget, fixedWeight, nRegions, regionIndexStart, regionLength, regionAltCount, regionCellStart, regionIndex, regionCells, regionWeights, } = face;
+    return function score(data) {
+        let total = 0;
+        for (let i = 0; i < nFixed; i++) {
+            if (data[fixedIndex[i]] === fixedTarget[i])
+                total += fixedWeight[i];
+        }
+        for (let r = 0; r < nRegions; r++) {
+            const indexBase = regionIndexStart[r];
+            const length = regionLength[r];
+            const altCount = regionAltCount[r];
+            const cellBase = regionCellStart[r];
+            let best = 0;
+            for (let a = 0; a < altCount; a++) {
+                const offset = cellBase + a * length;
+                let got = 0;
+                for (let j = 0; j < length; j++) {
+                    if (data[regionIndex[indexBase + j]] === regionCells[offset + j]) {
+                        got += regionWeights[offset + j];
+                    }
+                }
+                if (got > best)
+                    best = got;
+            }
+            total += best;
+        }
+        return total;
+    };
+}
+/** Off the hot path: which alternative won in each region, plus the total score. */
+export function describeMatch(face, data) {
+    let total = 0;
+    for (let i = 0; i < face.nFixed; i++) {
+        if (data[face.fixedIndex[i]] === face.fixedTarget[i])
+            total += face.fixedWeight[i];
+    }
+    const regions = {};
+    for (let r = 0; r < face.nRegions; r++) {
+        const indexBase = face.regionIndexStart[r];
+        const length = face.regionLength[r];
+        const cellBase = face.regionCellStart[r];
+        let best = -1;
+        let bestAlt = 0;
+        for (let a = 0; a < face.regionAltCount[r]; a++) {
+            const offset = cellBase + a * length;
+            let got = 0;
+            for (let j = 0; j < length; j++) {
+                if (data[face.regionIndex[indexBase + j]] === face.regionCells[offset + j]) {
+                    got += face.regionWeights[offset + j];
+                }
+            }
+            if (got > best) {
+                best = got;
+                bestAlt = a;
+            }
+        }
+        total += best;
+        regions[face.regionNames[r]] = face.regionAltNames[r][bestAlt];
+    }
+    return { score: total, regions };
+}
+/** True when the grid never uses blo's spot colour, i.e. the blockie renders in two colours. */
+export function isTwoColor(data) {
+    for (let i = 0; i < data.length; i++)
+        if (data[i] === 2)
+            return false;
+    return true;
+}
+/** blo emits h 0-360, s 0-100, l 0-100. Returns r/g/b in 0-255. */
+export function hslToRgb(h, s, l) {
+    const saturation = s / 100;
+    const lightness = l / 100;
+    const k = (n) => (n + h / 30) % 12;
+    const a = saturation * Math.min(lightness, 1 - lightness);
+    const f = (n) => lightness - a * Math.max(-1, Math.min(k(n) - 3, 9 - k(n), 1));
+    return [f(0) * 255, f(8) * 255, f(4) * 255];
+}
+/** Euclidean RGB distance between two HSL colours. 0 = identical, ~441.7 = black vs white. */
+export function colorContrast(a, b) {
+    const [r1, g1, b1] = hslToRgb(a[0], a[1], a[2]);
+    const [r2, g2, b2] = hslToRgb(b[0], b[1], b[2]);
+    return Math.hypot(r1 - r2, g1 - g2, b1 - b2);
+}
+//# sourceMappingURL=scoring.js.map

package/dist/scoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.js","sourceRoot":"","sources":["../src/scoring.ts"],"names":[],"mappings":"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"}

package/dist/select.d.ts

@@ -0,0 +1,47 @@
+import type { Candidate } from './miner.js';
+/**
+ * A score as a percentage of the template's maximum, rounded to the one decimal a result is
+ * displayed with. `formatScore` renders exactly this number, and `filterCandidates` compares
+ * exactly this number against the match floor, so the figure on a tile and the figure the filter
+ * judges it by are the same figure: 89.96% displays as "90.0%" and must not then be dropped by a
+ * 90% floor over a difference nothing on screen can show.
+ */
+export declare function scorePercent(score: number, maxScore: number): number;
+export declare function filterCandidates(candidates: Candidate[], filters: {
+    twoColor: boolean;
+    minContrast: number;
+    minMatch?: number;
+}): Candidate[];
+export interface SelectReportedResult {
+    reported: Candidate[];
+    /** How many candidates the filters removed. Zero when the fallback was used. */
+    droppedCount: number;
+    /** True when filtering removed everything and the unfiltered list is being shown instead. */
+    usedFallback: boolean;
+}
+/**
+ * Retention is score-ranked and blind to twoColor/minContrast/minMatch, which are applied here —
+ * so callers must retain far more candidates than they intend to display, or the filters will
+ * have nothing left to choose from.
+ *
+ * `fallbackWhenEmpty` defaults to true, which shows the unfiltered list rather than nothing when
+ * the filters match no candidate at all. That suits a caller that can say so alongside the
+ * results — the CLI prints a notice when `usedFallback` comes back true. A caller that can render
+ * an explicit "nothing matches these filters" state should pass false instead: silently showing
+ * everything makes the filter look ignored rather than unsatisfied. With it off, `droppedCount`
+ * stops being a special case and always reports what the filters actually removed.
+ */
+export declare function selectReported(candidates: Candidate[], options: {
+    twoColor: boolean;
+    minContrast: number;
+    /** Percentage floor, 0-100, judged as `scorePercent`. Omitted or 0 filters nothing. */
+    minMatch?: number;
+    keep: number;
+    fallbackWhenEmpty?: boolean;
+}): SelectReportedResult;
+/**
+ * A score as a percentage of the template's maximum. One decimal, because the interesting
+ * results sit in a narrow band near the top and whole percent would collapse distinct scores.
+ */
+export declare function formatScore(score: number, maxScore: number): string;
+//# sourceMappingURL=select.d.ts.map

package/dist/select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../src/select.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGpE;AAED,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,SAAS,EAAE,EACvB,OAAO,EAAE;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACrE,SAAS,EAAE,CAQb;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,SAAS,EAAE,CAAA;IACrB,gFAAgF;IAChF,YAAY,EAAE,MAAM,CAAA;IACpB,6FAA6F;IAC7F,YAAY,EAAE,OAAO,CAAA;CACtB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,SAAS,EAAE,EACvB,OAAO,EAAE;IACP,QAAQ,EAAE,OAAO,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B,GACA,oBAAoB,CAWtB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnE"}

package/dist/select.js

@@ -0,0 +1,49 @@
+/**
+ * A score as a percentage of the template's maximum, rounded to the one decimal a result is
+ * displayed with. `formatScore` renders exactly this number, and `filterCandidates` compares
+ * exactly this number against the match floor, so the figure on a tile and the figure the filter
+ * judges it by are the same figure: 89.96% displays as "90.0%" and must not then be dropped by a
+ * 90% floor over a difference nothing on screen can show.
+ */
+export function scorePercent(score, maxScore) {
+    if (maxScore <= 0)
+        return 0;
+    return Number(((score / maxScore) * 100).toFixed(1));
+}
+export function filterCandidates(candidates, filters) {
+    const minMatch = filters.minMatch ?? 0;
+    return candidates.filter((candidate) => (!filters.twoColor || candidate.twoColor) &&
+        candidate.contrast >= filters.minContrast &&
+        scorePercent(candidate.score, candidate.maxScore) >= minMatch);
+}
+/**
+ * Retention is score-ranked and blind to twoColor/minContrast/minMatch, which are applied here —
+ * so callers must retain far more candidates than they intend to display, or the filters will
+ * have nothing left to choose from.
+ *
+ * `fallbackWhenEmpty` defaults to true, which shows the unfiltered list rather than nothing when
+ * the filters match no candidate at all. That suits a caller that can say so alongside the
+ * results — the CLI prints a notice when `usedFallback` comes back true. A caller that can render
+ * an explicit "nothing matches these filters" state should pass false instead: silently showing
+ * everything makes the filter look ignored rather than unsatisfied. With it off, `droppedCount`
+ * stops being a special case and always reports what the filters actually removed.
+ */
+export function selectReported(candidates, options) {
+    const filtered = filterCandidates(candidates, {
+        twoColor: options.twoColor,
+        minContrast: options.minContrast,
+        minMatch: options.minMatch,
+    });
+    const usedFallback = (options.fallbackWhenEmpty ?? true) && filtered.length === 0 && candidates.length > 0;
+    const usable = usedFallback ? candidates : filtered;
+    const droppedCount = usedFallback ? 0 : candidates.length - filtered.length;
+    return { reported: usable.slice(0, options.keep), droppedCount, usedFallback };
+}
+/**
+ * A score as a percentage of the template's maximum. One decimal, because the interesting
+ * results sit in a narrow band near the top and whole percent would collapse distinct scores.
+ */
+export function formatScore(score, maxScore) {
+    return `${scorePercent(score, maxScore).toFixed(1)}%`;
+}
+//# sourceMappingURL=select.js.map

package/dist/select.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.js","sourceRoot":"","sources":["../src/select.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,QAAgB;IAC1D,IAAI,QAAQ,IAAI,CAAC;QAAE,OAAO,CAAC,CAAA;IAC3B,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,QAAQ,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;AACtD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,UAAuB,EACvB,OAAsE;IAEtE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAA;IACtC,OAAO,UAAU,CAAC,MAAM,CACtB,CAAC,SAAS,EAAE,EAAE,CACZ,CAAC,CAAC,OAAO,CAAC,QAAQ,IAAI,SAAS,CAAC,QAAQ,CAAC;QACzC,SAAS,CAAC,QAAQ,IAAI,OAAO,CAAC,WAAW;QACzC,YAAY,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAChE,CAAA;AACH,CAAC;AAUD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAC5B,UAAuB,EACvB,OAOC;IAED,MAAM,QAAQ,GAAG,gBAAgB,CAAC,UAAU,EAAE;QAC5C,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAC,CAAA;IACF,MAAM,YAAY,GAChB,CAAC,OAAO,CAAC,iBAAiB,IAAI,IAAI,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,CAAA;IACvF,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAA;IACnD,MAAM,YAAY,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAA;IAC3E,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,YAAY,EAAE,CAAA;AAChF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,QAAgB;IACzD,OAAO,GAAG,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAA;AACvD,CAAC"}

package/dist/templates.d.ts

@@ -0,0 +1,18 @@
+import type { FaceSpec, RegionAlternative } from './types.js';
+export declare const MOUTH_BUDGET = 60;
+export declare const MOUTH_STROKE_WEIGHT = 3;
+export declare const MOUTH_BG_WEIGHT = 1;
+/** Rows 0-4, index = row * 4 + col. 1 = the eye pixel (mirrored to column 5), 0 = background. */
+export declare const BASE_TARGET: readonly (0 | 1)[];
+/** 8 = the eye, 5 = cells hugging it (isolation, incl. col 3 to keep the two eyes apart), 3 = plain background. */
+export declare const BASE_WEIGHTS: readonly number[];
+/** Rows 5-7 of the left half: r5c0..r5c3, r6c0..r6c3, r7c0..r7c3. */
+export declare const MOUTH_INDICES: readonly number[];
+export declare const MOUTHS: readonly RegionAlternative[];
+/** Builds a face with fixed eyes and the named subset of expressions accepted for the mouth. */
+export declare function faceWithMouths(name: string, mouthNames: string[]): FaceSpec;
+export declare const TEMPLATES: Record<string, FaceSpec>;
+export declare function getTemplate(name: string): FaceSpec;
+/** Validates untrusted JSON (a `--target file.json`, or a future web designer export). */
+export declare function parseFaceSpec(input: unknown): FaceSpec;
+//# sourceMappingURL=templates.d.ts.map

package/dist/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,QAAQ,EAAa,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAEpF,eAAO,MAAM,YAAY,KAAK,CAAA;AAC9B,eAAO,MAAM,mBAAmB,IAAI,CAAA;AACpC,eAAO,MAAM,eAAe,IAAI,CAAA;AAEhC,iGAAiG;AACjG,eAAO,MAAM,WAAW,EAAE,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,EAEzC,CAAA;AAED,mHAAmH;AACnH,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAEzC,CAAA;AAED,qEAAqE;AACrE,eAAO,MAAM,aAAa,EAAE,SAAS,MAAM,EAAqD,CAAA;AAEhG,eAAO,MAAM,MAAM,EAAE,SAAS,iBAAiB,EAO9C,CAAA;AAiBD,gGAAgG;AAChG,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,QAAQ,CAW3E;AAKD,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAQ7C,CAAA;AAEF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAKlD;AAkBD,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAoEtD"}

package/dist/templates.js

@@ -0,0 +1,140 @@
+export const MOUTH_BUDGET = 60;
+export const MOUTH_STROKE_WEIGHT = 3;
+export const MOUTH_BG_WEIGHT = 1;
+/** Rows 0-4, index = row * 4 + col. 1 = the eye pixel (mirrored to column 5), 0 = background. */
+export const BASE_TARGET = [
+    0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0,
+];
+/** 8 = the eye, 5 = cells hugging it (isolation, incl. col 3 to keep the two eyes apart), 3 = plain background. */
+export const BASE_WEIGHTS = [
+    3, 3, 3, 3, 3, 3, 5, 3, 3, 5, 8, 5, 3, 3, 5, 3, 3, 3, 3, 3,
+];
+/** Rows 5-7 of the left half: r5c0..r5c3, r6c0..r6c3, r7c0..r7c3. */
+export const MOUTH_INDICES = [20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31];
+export const MOUTHS = [
+    // r5: c0 c1 c2 c3   r6: c0 c1 c2 c3   r7: c0 c1 c2 c3
+    { name: 'smile', cells: [0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1] }, // corners up, dips centre
+    { name: 'frown', cells: [0, 0, 0, 1, 0, 0, 1, 0, 0, 1, 0, 0] }, // corners down
+    { name: 'neutral', cells: [0, 0, 0, 0, 0, 1, 1, 1, 0, 0, 0, 0] }, // straight line
+    { name: 'open', cells: [0, 0, 1, 1, 0, 0, 1, 0, 0, 0, 1, 1] }, // rounded "o" / surprised
+    { name: 'small', cells: [0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0] }, // little mouth
+];
+function baseFixedCells() {
+    return BASE_TARGET.map((value, index) => ({ index, value, weight: BASE_WEIGHTS[index] }));
+}
+function mouthRegion(alternatives) {
+    return {
+        name: 'mouth',
+        indices: [...MOUTH_INDICES],
+        budget: MOUTH_BUDGET,
+        strokeWeight: MOUTH_STROKE_WEIGHT,
+        bgWeight: MOUTH_BG_WEIGHT,
+        alternatives,
+    };
+}
+/** Builds a face with fixed eyes and the named subset of expressions accepted for the mouth. */
+export function faceWithMouths(name, mouthNames) {
+    const alternatives = mouthNames.map((mouthName) => {
+        const mouth = MOUTHS.find((candidate) => candidate.name === mouthName);
+        if (!mouth) {
+            throw new Error(`unknown mouth "${mouthName}"; available: ${MOUTHS.map((m) => m.name).join(', ')}`);
+        }
+        return { name: mouth.name, cells: [...mouth.cells] };
+    });
+    return { name, fixed: baseFixedCells(), regions: [mouthRegion(alternatives)] };
+}
+// Built on a null prototype so a lookup by an attacker- or URL-controlled name can never resolve
+// an inherited Object.prototype key (e.g. "constructor", "toString", "__proto__") instead of
+// throwing the intended "unknown template" error.
+export const TEMPLATES = Object.assign(Object.create(null), {
+    faces: faceWithMouths('faces', MOUTHS.map((mouth) => mouth.name)),
+    ...Object.fromEntries(MOUTHS.map((mouth) => [mouth.name, faceWithMouths(mouth.name, [mouth.name])])),
+});
+export function getTemplate(name) {
+    if (!Object.hasOwn(TEMPLATES, name)) {
+        throw new Error(`unknown template "${name}"; available: ${Object.keys(TEMPLATES).join(', ')}`);
+    }
+    return TEMPLATES[name];
+}
+/** Guards the `entry as Record<string, unknown>` casts below: a null or primitive entry would
+ *  otherwise surface as a raw TypeError from the first property read. */
+function requireObject(value, label) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        throw new Error(`${label} must be an object, got ${JSON.stringify(value)}`);
+    }
+    return value;
+}
+function requirePositiveInteger(value, label) {
+    if (!Number.isInteger(value) || value <= 0) {
+        throw new Error(`${label} must be a positive integer, got ${JSON.stringify(value)}`);
+    }
+    return value;
+}
+/** Validates untrusted JSON (a `--target file.json`, or a future web designer export). */
+export function parseFaceSpec(input) {
+    if (typeof input !== 'object' || input === null || Array.isArray(input)) {
+        throw new Error('FaceSpec must be an object');
+    }
+    const raw = input;
+    const name = typeof raw.name === 'string' && raw.name ? raw.name : 'custom';
+    const fixedInput = Array.isArray(raw.fixed) ? raw.fixed : [];
+    const fixed = fixedInput.map((entry, i) => {
+        const cell = requireObject(entry, `fixed[${i}]`);
+        const index = cell.index;
+        if (!Number.isInteger(index) || index < 0 || index > 31) {
+            throw new Error(`fixed[${i}].index must be an integer between 0 and 31`);
+        }
+        if (cell.value !== 0 && cell.value !== 1) {
+            throw new Error(`fixed[${i}].value must be 0 or 1`);
+        }
+        return {
+            index: index,
+            value: cell.value,
+            weight: requirePositiveInteger(cell.weight, `fixed[${i}].weight`),
+        };
+    });
+    const regionsInput = Array.isArray(raw.regions) ? raw.regions : [];
+    const regions = regionsInput.map((entry, r) => {
+        const label = `regions[${r}]`;
+        const region = requireObject(entry, label);
+        if (!Array.isArray(region.indices) || region.indices.length === 0) {
+            throw new Error(`${label}.indices must be a non-empty array`);
+        }
+        for (const index of region.indices) {
+            if (!Number.isInteger(index) || index < 0 || index > 31) {
+                throw new Error(`${label}.indices must all be integers between 0 and 31`);
+            }
+        }
+        if (!Array.isArray(region.alternatives) || region.alternatives.length === 0) {
+            throw new Error(`${label}.alternatives must contain at least one alternative`);
+        }
+        const alternatives = region.alternatives.map((altEntry, a) => {
+            const alternative = requireObject(altEntry, `${label}.alternatives[${a}]`);
+            if (!Array.isArray(alternative.cells)) {
+                throw new Error(`${label}.alternatives[${a}].cells must be an array`);
+            }
+            for (const cell of alternative.cells) {
+                if (cell !== 0 && cell !== 1) {
+                    throw new Error(`${label}.alternatives[${a}].cells value must be 0 or 1`);
+                }
+            }
+            return {
+                name: typeof alternative.name === 'string' ? alternative.name : `alt${a}`,
+                cells: alternative.cells,
+            };
+        });
+        return {
+            name: typeof region.name === 'string' ? region.name : `region${r}`,
+            indices: region.indices,
+            budget: requirePositiveInteger(region.budget, `${label}.budget`),
+            strokeWeight: requirePositiveInteger(region.strokeWeight, `${label}.strokeWeight`),
+            bgWeight: requirePositiveInteger(region.bgWeight, `${label}.bgWeight`),
+            alternatives,
+        };
+    });
+    if (fixed.length === 0 && regions.length === 0) {
+        throw new Error('FaceSpec must define at least one fixed cell or region');
+    }
+    return { name, fixed, regions };
+}
+//# sourceMappingURL=templates.js.map

package/dist/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,60 @@
+/** Hue 0-360, saturation 0-100, lightness 0-100 — the ranges blo emits. */
+export type Hsl = readonly [number, number, number];
+/** blo's palette, in the order blo returns it: background, color, spot. */
+export type Palette = readonly [Hsl, Hsl, Hsl];
+export interface BloImage {
+    /** 32 values in {0,1,2} for the left half of the 8x8 grid; column c mirrors to 7-c. */
+    readonly data: Uint8Array;
+    readonly colors: Palette;
+}
+/** A cell whose target value is pinned. `index` is 0..31 in the left half of the grid. */
+export interface FixedCell {
+    index: number;
+    value: 0 | 1;
+    weight: number;
+}
+/** One accepted shape for a region, e.g. a single mouth expression. */
+export interface RegionAlternative {
+    name: string;
+    /** Aligned 1:1 with the region's `indices`. */
+    cells: (0 | 1)[];
+}
+/**
+ * A group of cells scored as `max` over a list of alternatives. Every alternative is normalised
+ * to the same `budget`, so no shape wins just for having more stroke pixels.
+ */
+export interface FaceRegion {
+    name: string;
+    indices: number[];
+    budget: number;
+    /** Relative weight of a cell that should be foreground. */
+    strokeWeight: number;
+    /** Relative weight of a cell that should stay background. */
+    bgWeight: number;
+    alternatives: RegionAlternative[];
+}
+export interface FaceSpec {
+    name: string;
+    fixed: FixedCell[];
+    regions: FaceRegion[];
+}
+/** Flattened, integer-only form of a FaceSpec. Built once; read millions of times. */
+export interface CompiledFace {
+    readonly name: string;
+    readonly maxScore: number;
+    readonly nFixed: number;
+    readonly fixedIndex: Uint8Array;
+    readonly fixedTarget: Uint8Array;
+    readonly fixedWeight: Int32Array;
+    readonly nRegions: number;
+    readonly regionIndexStart: Int32Array;
+    readonly regionLength: Int32Array;
+    readonly regionAltCount: Int32Array;
+    readonly regionCellStart: Int32Array;
+    readonly regionIndex: Uint8Array;
+    readonly regionCells: Uint8Array;
+    readonly regionWeights: Int32Array;
+    readonly regionNames: readonly string[];
+    readonly regionAltNames: readonly (readonly string[])[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAEnD,2EAA2E;AAC3E,MAAM,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;AAE9C,MAAM,WAAW,QAAQ;IACvB,uFAAuF;IACvF,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CACzB;AAED,0FAA0F;AAC1F,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,CAAC,GAAG,CAAC,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;CACf;AAED,uEAAuE;AACvE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,+CAA+C;IAC/C,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAA;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAA;IACpB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,iBAAiB,EAAE,CAAA;CAClC;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,SAAS,EAAE,CAAA;IAClB,OAAO,EAAE,UAAU,EAAE,CAAA;CACtB;AAED,sFAAsF;AACtF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;IAC/B,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAA;IAChC,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAA;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,gBAAgB,EAAE,UAAU,CAAA;IACrC,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAA;IACjC,QAAQ,CAAC,cAAc,EAAE,UAAU,CAAA;IACnC,QAAQ,CAAC,eAAe,EAAE,UAAU,CAAA;IACpC,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAA;IAChC,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAA;IAChC,QAAQ,CAAC,aAAa,EAAE,UAAU,CAAA;IAClC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC,QAAQ,CAAC,cAAc,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAA;CACxD"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@safe-vanity-blockie/core",
+  "version": "0.3.0",
+  "description": "Isomorphic blo identicon, CREATE2 address derivation and mining primitives for Safe vanity blockies",
+  "engines": {
+    "node": ">=22"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tmjssz/safe-vanity-blockie.git",
+    "directory": "packages/core"
+  },
+  "type": "module",
+  "license": "MIT",
+  "keywords": [
+    "safe",
+    "safe-global",
+    "blockie",
+    "blo",
+    "identicon",
+    "vanity-address",
+    "create2",
+    "ethereum"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "hash-wasm": "^4.12.0"
+  },
+  "devDependencies": {
+    "@noble/hashes": "^2.3.0",
+    "blo": "2.0.0",
+    "viem": "^2.55.11"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}