@visant/logo-trace 0.1.0

package/README.md

@@ -0,0 +1,87 @@
+# @visant/logo-trace
+
+Raster → **SVG** vectorization tuned for logos. [Potrace](https://www.npmjs.com/package/potrace) under the hood, wrapped with the bits that make a logo trace cleanly:
+
+- **Otsu auto-threshold** — picks the black/white cutoff per image instead of a fixed 128.
+- **Auto-invert** — light-on-light art (e.g. a gray wordmark on white) is inverted automatically before tracing, then inverted-retried if the first pass comes back empty.
+- **Calibrated presets** — `logo`, `lettering`, `lineArt`, `stamp`.
+- **Sanitize + optimize** — output is run through DOMPurify and a numeric/editor-cruft minifier, so you get a small, safe SVG string.
+
+It powers the Visant Labs PNG→SVG trace endpoint and the Studio 3D GLB export (image → traced SVG → extruded mesh).
+
+## Install
+
+```bash
+npm i @visant/logo-trace
+# node-first peers (the server already has these):
+npm i sharp jsdom dompurify
+```
+
+`potrace` is a direct dependency. `sharp` (Otsu grayscale + invert), `jsdom` and `dompurify` (the sanitize/optimize pass) are **optional peer dependencies**, imported lazily. Without `sharp`, `threshold: 'auto'` degrades to a fixed 128; the sanitize pass requires `jsdom` + `dompurify`.
+
+## Usage
+
+```ts
+import { trace } from '@visant/logo-trace';
+import { readFile } from 'node:fs/promises';
+
+const png = await readFile('logo.png');
+
+// Named preset:
+const svg = await trace(png, { preset: 'logo' });
+// → '<svg ...><path d="..."/></svg>'
+
+// Or explicit options (override any preset value):
+const svg2 = await trace(png, {
+  preset: 'lettering',
+  threshold: 'auto',   // Otsu + auto-invert
+  turdSize: 2,         // drop speckles < 2px²
+  optTolerance: 0.2,   // curve smoothing
+  alphaMax: 0.8,       // corner roundness
+  color: '#111111',
+});
+```
+
+`trace` is an alias of `tracePipeline` (trace → sanitize → optimize). Use `traceImage` if you want the raw potrace output without the cleanup pass.
+
+## Exports
+
+| Entry | Purpose |
+| --- | --- |
+| `.` | everything below, flat |
+| `./presets` | `TRACE_PRESETS`, `resolveTraceOptions` |
+| `./sanitize` | `parseBase64Image`, `sanitizeSvg`, `optimizeSvg`, `cleanSvg` |
+
+### API
+
+| Export | Signature |
+| --- | --- |
+| `trace` / `tracePipeline` | `(buffer, opts?) => Promise<string>` — full pipeline |
+| `traceImage` | `(buffer, opts?) => Promise<string>` — raw potrace SVG, no cleanup |
+| `cleanSvgPipeline` / `cleanSvg` | `(rawSvg) => Promise<string>` — sanitize + optimize an existing SVG |
+| `parseBase64Image` | `(dataUri) => Buffer \| null` — parse a `data:image/...;base64,...` URI |
+| `TRACE_PRESETS` | calibrated parameter sets per preset |
+| `resolveTraceOptions` | `(opts) => TraceOptions` — merge a preset under explicit options |
+
+## Presets
+
+| Preset | turdSize | optTolerance | threshold | alphaMax |
+| --- | --- | --- | --- | --- |
+| `logo` | 3 | 0.3 | auto | 0.8 |
+| `lettering` | 1 | 0.15 | auto | 0.5 |
+| `lineArt` | 0 | 0.1 | 128 | 1.0 |
+| `stamp` | 5 | 0.5 | auto | 0.8 |
+
+## From a base64 data URI
+
+```ts
+import { parseBase64Image, trace } from '@visant/logo-trace';
+
+const buffer = parseBase64Image(dataUri); // null on a non-image / prefix-less string
+if (!buffer) throw new Error('Invalid base64 image format');
+const svg = await trace(buffer, { preset: 'logo' });
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { trace, tracePipeline, traceImage, cleanSvgPipeline } from './trace.js';
+export { TRACE_PRESETS, resolveTraceOptions } from './presets.js';
+export { parseBase64Image, sanitizeSvg, optimizeSvg, cleanSvg } from './sanitize.js';
+export type { TracePreset, TraceOptions, SvgOptimizeOptions } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGhF,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGlE,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGrF,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+// @visant/logo-trace — public surface.
+// Raster → SVG vectorization tuned for logos: potrace + Otsu auto-threshold
+// (with auto-invert for light-on-light art) + calibrated presets + a
+// sanitize/optimize pass that returns a clean, minified SVG string.
+// ── Core ──
+export { trace, tracePipeline, traceImage, cleanSvgPipeline } from './trace.js';
+// ── Presets ──
+export { TRACE_PRESETS, resolveTraceOptions } from './presets.js';
+// ── SVG sanitize / optimize / data-URI parsing ──
+export { parseBase64Image, sanitizeSvg, optimizeSvg, cleanSvg } from './sanitize.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,4EAA4E;AAC5E,qEAAqE;AACrE,oEAAoE;AAEpE,aAAa;AACb,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEhF,gBAAgB;AAChB,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAElE,mDAAmD;AACnD,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/presets.d.ts

@@ -0,0 +1,13 @@
+import type { TracePreset, TraceOptions } from './types.js';
+/**
+ * Calibrated potrace parameter sets per use-case. Values are tuned for clean
+ * logo/lettering vectorization and must not drift — they are the same numbers
+ * the Visant trace endpoint has shipped.
+ */
+export declare const TRACE_PRESETS: Record<Exclude<TracePreset, 'custom'>, Required<Omit<TraceOptions, 'color' | 'preset'>>>;
+/**
+ * Resolve a preset into concrete options. Explicit options always win over the
+ * preset's base values. Non-preset (or 'custom') input is returned untouched.
+ */
+export declare function resolveTraceOptions(opts: TraceOptions): TraceOptions;
+//# sourceMappingURL=presets.d.ts.map

package/dist/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../src/presets.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE5D;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAChC,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,EAC9B,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,GAAG,QAAQ,CAAC,CAAC,CAMjD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,CAapE"}

package/dist/presets.js

@@ -0,0 +1,31 @@
+// @visant/logo-trace — calibrated trace presets (single source of truth).
+/**
+ * Calibrated potrace parameter sets per use-case. Values are tuned for clean
+ * logo/lettering vectorization and must not drift — they are the same numbers
+ * the Visant trace endpoint has shipped.
+ */
+export const TRACE_PRESETS = {
+    logo: { turdSize: 3, optTolerance: 0.3, threshold: 'auto', alphaMax: 0.8 },
+    lettering: { turdSize: 1, optTolerance: 0.15, threshold: 'auto', alphaMax: 0.5 },
+    lineArt: { turdSize: 0, optTolerance: 0.1, threshold: 128, alphaMax: 1.0 },
+    stamp: { turdSize: 5, optTolerance: 0.5, threshold: 'auto', alphaMax: 0.8 },
+};
+/**
+ * Resolve a preset into concrete options. Explicit options always win over the
+ * preset's base values. Non-preset (or 'custom') input is returned untouched.
+ */
+export function resolveTraceOptions(opts) {
+    if (opts.preset && opts.preset !== 'custom' && TRACE_PRESETS[opts.preset]) {
+        const base = TRACE_PRESETS[opts.preset];
+        return {
+            turdSize: opts.turdSize ?? base.turdSize,
+            optTolerance: opts.optTolerance ?? base.optTolerance,
+            threshold: opts.threshold ?? base.threshold,
+            alphaMax: opts.alphaMax ?? base.alphaMax,
+            color: opts.color,
+            preset: opts.preset,
+        };
+    }
+    return opts;
+}
+//# sourceMappingURL=presets.js.map

package/dist/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../src/presets.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAI1E;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAGtB;IACF,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE;IAC1E,SAAS,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE;IAChF,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE;IAC1E,KAAK,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE;CAC5E,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAkB;IACpD,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1E,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxC,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ;YACxC,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY;YACpD,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS;YAC3C,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ;YACxC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/sanitize.d.ts

@@ -0,0 +1,20 @@
+import type { SvgOptimizeOptions } from './types.js';
+/**
+ * Parse a `data:image/<mime>;base64,<payload>` string into a Buffer.
+ * Returns `null` when the string is not a base64 image data-URI — callers use
+ * that to reject bad input (e.g. respond 400). It validates the prefix rather
+ * than stripping it, so a raw (prefix-less) base64 blob is intentionally
+ * rejected. The MIME pattern is wide enough to match e.g. `image/svg+xml`.
+ */
+export declare function parseBase64Image(image: string): Buffer | null;
+/** Strip scripts / unsafe content from an SVG string, keeping SVG + filters + <use>. */
+export declare function sanitizeSvg(svg: string): Promise<string>;
+/**
+ * Strip editor cruft, comments, metadata, hidden/empty nodes and minify numeric
+ * literals from an SVG string. Pure string transforms except the optional
+ * `removeHiddenElements` pass, which needs jsdom.
+ */
+export declare function optimizeSvg(svgString: string, options?: Partial<SvgOptimizeOptions>): Promise<string>;
+/** sanitize → optimize. Used to clean SVG pasted from Figma/Illustrator/etc. */
+export declare function cleanSvg(raw: string): Promise<string>;
+//# sourceMappingURL=sanitize.d.ts.map

package/dist/sanitize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../src/sanitize.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAIrD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI7D;AAsBD,wFAAwF;AACxF,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM9D;AAmBD;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACpC,OAAO,CAAC,MAAM,CAAC,CA2EjB;AAED,gFAAgF;AAChF,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG3D"}

package/dist/sanitize.js

@@ -0,0 +1,135 @@
+// @visant/logo-trace — SVG sanitization + optimization + data-URI parsing.
+//
+// `jsdom` and `dompurify` are optional peers, imported lazily. They are only
+// needed for the sanitize/optimize pass (the server always has them); the trace
+// core can run without them if you skip cleanup.
+// ── data-URI parsing ────────────────────────────────────────────────────────
+/**
+ * Parse a `data:image/<mime>;base64,<payload>` string into a Buffer.
+ * Returns `null` when the string is not a base64 image data-URI — callers use
+ * that to reject bad input (e.g. respond 400). It validates the prefix rather
+ * than stripping it, so a raw (prefix-less) base64 blob is intentionally
+ * rejected. The MIME pattern is wide enough to match e.g. `image/svg+xml`.
+ */
+export function parseBase64Image(image) {
+    const match = image.match(/^data:image\/[^;]+;base64,(.+)$/i);
+    if (!match)
+        return null;
+    return Buffer.from(match[1], 'base64');
+}
+// ── SVG sanitization (DOMPurify) ─────────────────────────────────────────────
+let _purify = null;
+async function getPurify() {
+    if (_purify)
+        return _purify;
+    let JSDOM;
+    let createDOMPurify;
+    try {
+        JSDOM = (await import('jsdom')).JSDOM;
+        createDOMPurify = (await import('dompurify')).default;
+    }
+    catch {
+        throw new Error('@visant/logo-trace sanitize requires the optional peer dependencies ' +
+            '"jsdom" and "dompurify". Install them with `npm i jsdom dompurify`.');
+    }
+    _purify = createDOMPurify(new JSDOM('').window);
+    return _purify;
+}
+/** Strip scripts / unsafe content from an SVG string, keeping SVG + filters + <use>. */
+export async function sanitizeSvg(svg) {
+    const purify = await getPurify();
+    return purify.sanitize(svg, {
+        USE_PROFILES: { svg: true, svgFilters: true },
+        ADD_TAGS: ['use'],
+    });
+}
+// ── SVG optimization ─────────────────────────────────────────────────────────
+function escapeRegexSpecial(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+const EDITOR_XMLNS = [
+    'xmlns:inkscape',
+    'xmlns:sodipodi',
+    'xmlns:sketch',
+    'xmlns:dc',
+    'xmlns:cc',
+    'xmlns:rdf',
+];
+const EDITOR_ATTR_PREFIXES = ['inkscape:', 'sodipodi:', 'sketch:', 'data-name'];
+/**
+ * Strip editor cruft, comments, metadata, hidden/empty nodes and minify numeric
+ * literals from an SVG string. Pure string transforms except the optional
+ * `removeHiddenElements` pass, which needs jsdom.
+ */
+export async function optimizeSvg(svgString, options) {
+    const opts = {
+        removeComments: true,
+        removeMetadata: true,
+        removeEditorData: true,
+        removeEmptyGroups: true,
+        minifyPaths: true,
+        removeHiddenElements: true,
+        ...options,
+    };
+    let svg = svgString;
+    svg = svg.replace(/<\?xml[^?]*\?>\s*/gi, '');
+    svg = svg.replace(/<!DOCTYPE[^>]*>\s*/gi, '');
+    if (opts.removeComments) {
+        let prev = '';
+        while (prev !== svg) {
+            prev = svg;
+            svg = svg.replace(/<!--[\s\S]*?-->/g, '');
+        }
+    }
+    if (opts.removeMetadata) {
+        svg = svg.replace(/<metadata[\s\S]*?<\/metadata>\s*/gi, '');
+    }
+    if (opts.removeEditorData) {
+        for (const ns of EDITOR_XMLNS) {
+            const escaped = escapeRegexSpecial(ns);
+            svg = svg.replace(new RegExp(`\\s+${escaped}="[^"]*"`, 'gi'), '');
+        }
+        for (const prefix of EDITOR_ATTR_PREFIXES) {
+            const escaped = escapeRegexSpecial(prefix);
+            svg = svg.replace(new RegExp(`\\s+${escaped}[a-z-]*="[^"]*"`, 'gi'), '');
+        }
+        const withoutXlinkDecl = svg.replace(/\s+xmlns:xlink="[^"]*"/gi, '');
+        if (!/xlink:/i.test(withoutXlinkDecl)) {
+            svg = withoutXlinkDecl;
+        }
+        svg = svg.replace(/<sodipodi:[^>]*\/>\s*/gi, '');
+        svg = svg.replace(/<sodipodi:[^>]*>[\s\S]*?<\/sodipodi:[^>]*>\s*/gi, '');
+        svg = svg.replace(/<inkscape:[^>]*\/>\s*/gi, '');
+        svg = svg.replace(/<inkscape:[^>]*>[\s\S]*?<\/inkscape:[^>]*>\s*/gi, '');
+    }
+    if (opts.removeEmptyGroups) {
+        let prev = '';
+        while (prev !== svg) {
+            prev = svg;
+            svg = svg.replace(/<g[^>]*>\s*<\/g>\s*/gi, '');
+        }
+    }
+    if (opts.removeHiddenElements) {
+        const { JSDOM } = await import('jsdom');
+        const dom = new JSDOM(svg, { contentType: 'image/svg+xml' });
+        const doc = dom.window.document;
+        doc.querySelectorAll('[display="none"], [visibility="hidden"]').forEach((el) => el.remove());
+        svg = doc.documentElement.outerHTML;
+    }
+    if (opts.minifyPaths) {
+        svg = svg.replace(/\b(\d+)\.0+\b/g, '$1');
+        svg = svg.replace(/\b0+(\.\d*[1-9])0+\b/g, '$1');
+        svg = svg.replace(/\b0+(\.\d+)\b/g, '$1');
+        svg = svg.replace(/(?<=[\s,(":]|^)0+(\.\d+)/g, '$1');
+    }
+    svg = svg.replace(/\s{2,}/g, ' ');
+    svg = svg.replace(/>\s+</g, '><');
+    svg = svg.trim();
+    return svg;
+}
+/** sanitize → optimize. Used to clean SVG pasted from Figma/Illustrator/etc. */
+export async function cleanSvg(raw) {
+    const sanitized = await sanitizeSvg(raw);
+    return optimizeSvg(sanitized);
+}
+//# sourceMappingURL=sanitize.js.map

package/dist/sanitize.js.map

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

package/dist/trace.d.ts

@@ -0,0 +1,17 @@
+import type { TraceOptions } from './types.js';
+/**
+ * Vectorize a raster image buffer to an SVG string. Honors a named `preset`
+ * and/or explicit options. Does NOT sanitize/optimize — call `tracePipeline`
+ * for the full cleaned result.
+ */
+export declare function traceImage(buffer: Buffer, opts?: TraceOptions): Promise<string>;
+/**
+ * Full pipeline: trace → sanitize → optimize → clean SVG string.
+ * The primary entry point for raster → SVG logo vectorization.
+ */
+export declare function tracePipeline(buffer: Buffer, opts?: TraceOptions): Promise<string>;
+/** Alias for `tracePipeline` — the package's headline `trace(buffer, preset|opts)`. */
+export declare const trace: typeof tracePipeline;
+/** sanitize → optimize a raw SVG string (no tracing). */
+export declare function cleanSvgPipeline(raw: string): Promise<string>;
+//# sourceMappingURL=trace.d.ts.map

package/dist/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA2F/C;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CA6CzF;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAI5F;AAED,uFAAuF;AACvF,eAAO,MAAM,KAAK,sBAAgB,CAAC;AAEnC,yDAAyD;AACzD,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGnE"}

package/dist/trace.js

@@ -0,0 +1,152 @@
+// @visant/logo-trace — raster → SVG core.
+//
+// Pipeline: Otsu auto-threshold (+ auto-invert for light-on-light art) →
+// potrace vectorization (with an invert-retry fallback) → sanitize → optimize.
+//
+// `sharp` is an optional peer used only for the grayscale histogram / invert;
+// without it, 'auto' threshold gracefully degrades to a fixed 128.
+import { resolveTraceOptions } from './presets.js';
+import { sanitizeSvg, optimizeSvg } from './sanitize.js';
+function clamp(value, min, max, fallback) {
+    const n = Number(value);
+    if (isNaN(n))
+        return fallback;
+    return Math.max(min, Math.min(max, n));
+}
+// ── Otsu auto-threshold ──────────────────────────────────────────────────────
+function computeOtsuFromGrayscale(pixels) {
+    const histogram = new Array(256).fill(0);
+    let totalPixels = 0;
+    for (let i = 0; i < pixels.length; i++) {
+        histogram[pixels[i]]++;
+        totalPixels++;
+    }
+    if (totalPixels === 0)
+        return 128;
+    let sum = 0;
+    for (let i = 0; i < 256; i++)
+        sum += i * histogram[i];
+    let sumB = 0;
+    let wB = 0;
+    let maxVariance = 0;
+    let bestThreshold = 128;
+    for (let t = 0; t < 256; t++) {
+        wB += histogram[t];
+        if (wB === 0)
+            continue;
+        const wF = totalPixels - wB;
+        if (wF === 0)
+            break;
+        sumB += t * histogram[t];
+        const meanB = sumB / wB;
+        const meanF = (sum - sumB) / wF;
+        const variance = wB * wF * (meanB - meanF) * (meanB - meanF);
+        if (variance > maxVariance) {
+            maxVariance = variance;
+            bestThreshold = t;
+        }
+    }
+    return bestThreshold;
+}
+async function loadSharp() {
+    return (await import('sharp')).default;
+}
+async function computeOtsuFromImage(buffer) {
+    try {
+        const sharp = await loadSharp();
+        const grayscale = await sharp(buffer).grayscale().raw().toBuffer();
+        const threshold = computeOtsuFromGrayscale(grayscale);
+        // If threshold > 230, the image is light-on-light (e.g. gray logo on white).
+        // A designer would invert it first — we do the same automatically.
+        return { threshold, needsInvert: threshold > 230 };
+    }
+    catch {
+        return { threshold: 128, needsInvert: false };
+    }
+}
+async function invertImage(buffer) {
+    const sharp = await loadSharp();
+    return sharp(buffer).negate({ alpha: false }).toBuffer();
+}
+function svgHasContent(svg) {
+    const match = svg.match(/\bd="([^"]*)"/);
+    return !!match && match[1].trim().length > 5;
+}
+// ── Potrace ──────────────────────────────────────────────────────────────────
+async function potraceTrace(buffer, potraceOpts) {
+    const potrace = await import('potrace');
+    return new Promise((resolve, reject) => {
+        potrace.trace(buffer, potraceOpts, (err, svg) => {
+            if (err)
+                reject(err);
+            else
+                resolve(svg);
+        });
+    });
+}
+/**
+ * Vectorize a raster image buffer to an SVG string. Honors a named `preset`
+ * and/or explicit options. Does NOT sanitize/optimize — call `tracePipeline`
+ * for the full cleaned result.
+ */
+export async function traceImage(buffer, opts = {}) {
+    const resolved = resolveTraceOptions(opts);
+    let threshold;
+    let imageBuffer = buffer;
+    if (resolved.threshold === 'auto') {
+        const otsu = await computeOtsuFromImage(buffer);
+        if (otsu.needsInvert) {
+            // Light-on-light image (like gray logo on white bg) — invert first
+            imageBuffer = await invertImage(buffer);
+            // After inversion, re-compute Otsu on the inverted image
+            const otsu2 = await computeOtsuFromImage(imageBuffer);
+            threshold = otsu2.threshold;
+        }
+        else {
+            threshold = otsu.threshold;
+        }
+    }
+    else {
+        threshold = clamp(Number(resolved.threshold) || 128, 0, 255, 128);
+    }
+    const potraceOpts = {
+        turdSize: clamp(resolved.turdSize, 0, 20, 2),
+        alphaMax: clamp(resolved.alphaMax, 0, 1.334, 1),
+        optCurve: true,
+        optTolerance: clamp(resolved.optTolerance, 0, 2, 0.2),
+        color: resolved.color || '#000000',
+        threshold,
+    };
+    const svg = await potraceTrace(imageBuffer, potraceOpts);
+    // Fallback: if trace produced empty paths and we didn't already invert, try inverting
+    if (!svgHasContent(svg) && imageBuffer === buffer) {
+        try {
+            const inverted = await invertImage(buffer);
+            const otsu = await computeOtsuFromImage(inverted);
+            const retrySvg = await potraceTrace(inverted, { ...potraceOpts, threshold: otsu.threshold });
+            if (svgHasContent(retrySvg))
+                return retrySvg;
+        }
+        catch {
+            /* fall through to original empty result */
+        }
+    }
+    return svg;
+}
+/**
+ * Full pipeline: trace → sanitize → optimize → clean SVG string.
+ * The primary entry point for raster → SVG logo vectorization.
+ */
+export async function tracePipeline(buffer, opts = {}) {
+    const raw = await traceImage(buffer, opts);
+    const sanitized = await sanitizeSvg(raw);
+    return optimizeSvg(sanitized);
+}
+/** Alias for `tracePipeline` — the package's headline `trace(buffer, preset|opts)`. */
+export const trace = tracePipeline;
+/** sanitize → optimize a raw SVG string (no tracing). */
+export async function cleanSvgPipeline(raw) {
+    const sanitized = await sanitizeSvg(raw);
+    return optimizeSvg(sanitized);
+}
+//# sourceMappingURL=trace.js.map

package/dist/trace.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,24 @@
+export type TracePreset = 'logo' | 'lettering' | 'lineArt' | 'stamp' | 'custom';
+export interface TraceOptions {
+    /** Suppress speckles smaller than N px². Higher = cleaner, loses detail. */
+    turdSize?: number;
+    /** Curve optimization tolerance. Higher = fewer, smoother curves. */
+    optTolerance?: number;
+    /** Black/white cutoff 0–255, or 'auto' for Otsu (+ auto-invert). */
+    threshold?: number | 'auto';
+    /** Corner threshold 0–1.334. Higher = rounder corners. */
+    alphaMax?: number;
+    /** Fill color of the traced paths. Default '#000000'. */
+    color?: string;
+    /** Named preset; merged under any explicit option above. */
+    preset?: TracePreset;
+}
+export interface SvgOptimizeOptions {
+    removeComments?: boolean;
+    removeMetadata?: boolean;
+    removeEditorData?: boolean;
+    removeEmptyGroups?: boolean;
+    minifyPaths?: boolean;
+    removeHiddenElements?: boolean;
+}
+//# 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":"AAEA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEhF,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC"}

package/dist/types.js

@@ -0,0 +1,3 @@
+// @visant/logo-trace — public types.
+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":"AAAA,qCAAqC"}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@visant/logo-trace",
+  "version": "0.1.0",
+  "description": "Raster → SVG vectorization tuned for logos. Potrace under the hood, with Otsu auto-threshold (+ auto-invert for light-on-light art), logo/lettering/lineArt/stamp presets, and a sanitize + optimize pass that yields a clean, minified SVG string.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Visant Labs",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pedrojaques99/visantlabs-os",
+    "directory": "packages/logo-trace"
+  },
+  "keywords": [
+    "potrace",
+    "trace",
+    "vectorize",
+    "raster-to-svg",
+    "png-to-svg",
+    "logo",
+    "svg",
+    "otsu",
+    "threshold"
+  ],
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./presets": {
+      "types": "./dist/presets.d.ts",
+      "import": "./dist/presets.js"
+    },
+    "./sanitize": {
+      "types": "./dist/sanitize.d.ts",
+      "import": "./dist/sanitize.js"
+    }
+  },
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepare": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "potrace": "^2.1.8"
+  },
+  "peerDependencies": {
+    "sharp": ">=0.32",
+    "jsdom": ">=22",
+    "dompurify": ">=3"
+  },
+  "peerDependenciesMeta": {
+    "sharp": {
+      "optional": true
+    },
+    "jsdom": {
+      "optional": true
+    },
+    "dompurify": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "typescript": "~5.8.2"
+  }
+}