@slithy/prim-interface 0.3.1 → 0.3.3

package/README.md

@@ -6,6 +6,21 @@ Browser-facing API for `@slithy/prim-lib`. Consumed by `apps/prim-demo`.
 
 Wraps `prim-lib` in a `run()` / `runWorker()` API and provides save/copy/share helpers for exporting results. `run()` runs the optimizer on the main thread; `runWorker()` moves computation into a Web Worker, keeping the main thread responsive during long jobs. Both share the same callback API.
 
+## Vite setup
+
+This package ships a Web Worker and is incompatible with Vite's dependency optimizer. Add it to `optimizeDeps.exclude` in your Vite config:
+
+```ts
+// vite.config.ts
+optimizeDeps: {
+  exclude: ['@slithy/prim-interface']
+}
+```
+
+The same applies to `electron-vite` projects — the exclusion goes under `renderer.optimizeDeps.exclude`.
+
+---
+
 ## Exports
 
 ### `run(source, config, callbacks)` / `runWorker(source, config, callbacks)`
@@ -34,7 +49,7 @@ job.resume();
 
 **`run()`** — runs the optimizer on the main thread via `requestAnimationFrame`. Simpler; no worker overhead. UI may feel sluggish during compute-heavy steps at high `shapes` / `mutations` settings.
 
-**`runWorker()`** — moves all computation into a Web Worker using `OffscreenCanvas`. The main thread only handles DOM updates (appending the canvas/SVG, calling callbacks). Requires a bundler that understands `new Worker(new URL(..., import.meta.url))` — Vite handles this automatically. Shape constructors in `config.shapeTypes` are mapped to names internally; only the built-in shapes (`Triangle`, `Rectangle`, `Ellipse`, `Circle`, `Square`, `Hexagon`, `Glyph`) are supported.
+**`runWorker()`** — moves all computation into a Web Worker using `OffscreenCanvas`. The main thread only handles DOM updates (appending the canvas/SVG, calling callbacks). Requires a bundler that understands `new Worker(new URL(..., import.meta.url))` — Vite handles this, but see the Vite setup section above for a required config change. Shape constructors in `config.shapeTypes` are mapped to names internally; only the built-in shapes (`Triangle`, `Rectangle`, `Ellipse`, `Circle`, `Square`, `Hexagon`, `Glyph`) are supported.
 
 ### Config
 

package/dist/index.d.ts

@@ -11,6 +11,7 @@ interface Config {
     viewSize: number;
     allowUpscale?: boolean;
     pixelRatio?: number;
+    glyphChar?: string;
     shapeTypes: Array<new (w: number, h: number) => ShapeInterface>;
     shapeWeights?: number[];
     fill: 'auto' | string;

package/dist/index.js

@@ -74,7 +74,7 @@ function run(source, cfg, callbacks = {}) {
 // src/runWorker.ts
 import { Canvas as Canvas2, renderStepToCtx, stepDataToSVGElement } from "@slithy/prim-lib";
 function runWorker(source, cfg, callbacks = {}) {
-  const url = source instanceof File ? URL.createObjectURL(source) : source;
+  const url = source instanceof File ? URL.createObjectURL(source) : new URL(source, globalThis.location.href).href;
   const isBlob = source instanceof File;
   let stopped = false;
   let result = null;

package/dist/worker-entry.d.ts

@@ -2,6 +2,7 @@ import { PreCfg, StepData, SerializedOutput } from '@slithy/prim-lib';
 
 type WorkerCfg = Omit<PreCfg, 'shapeTypes'> & {
     shapeTypeNames: string[];
+    glyphChar?: string;
 };
 type WorkerInbound = {
     type: 'start';

package/dist/worker-entry.js

@@ -16,10 +16,18 @@ self.onmessage = async (e) => {
   switch (msg.type) {
     case "start": {
       const { url, cfg: workerCfg } = msg;
-      const { shapeTypeNames, ...rest } = workerCfg;
+      const { shapeTypeNames, glyphChar, ...rest } = workerCfg;
       const shapeTypes = shapeTypeNames.map((name) => {
         const ctor = SHAPES[name];
         if (!ctor) throw new Error(`[prim worker] Unknown shape type: ${name}`);
+        if (name === "Glyph" && glyphChar) {
+          const char = glyphChar;
+          return class GlyphWithChar extends Glyph {
+            constructor(w, h) {
+              super(w, h, char);
+            }
+          };
+        }
         return ctor;
       });
       const preCfg = { ...rest, shapeTypes };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slithy/prim-interface",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Browser-facing API for primitive-based image reconstruction.",
   "type": "module",
   "exports": {