@niivue/nv-ext-drawing 1.0.0-rc.3 → 1.0.0-rc.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@niivue/nv-ext-drawing",
-  "version": "1.0.0-rc.3",
+  "version": "1.0.0-rc.4",
   "type": "module",
   "description": "Drawing interpolation and segmentation tools for NiiVue",
   "main": "./dist/nv-ext-drawing.js",
@@ -16,10 +16,10 @@
     "dist"
   ],
   "peerDependencies": {
-    "@niivue/niivue": "workspace:*"
+    "@niivue/niivue": "1.0.0-rc.4"
   },
   "devDependencies": {
-    "@niivue/niivue": "workspace:*",
+    "@niivue/niivue": "1.0.0-rc.4",
     "typescript": "~5.8.3",
     "vite": "^6.3.2",
     "vite-plugin-dts": "^4.5.4"
@@ -27,5 +27,8 @@
   "scripts": {
     "build": "npx vite build",
     "typecheck": "bunx tsc --noEmit"
+  },
+  "publishConfig": {
+    "access": "public"
   }
 }

package/dist/index.d.ts

@@ -1,100 +0,0 @@
-import { DrawingDims, InterpolationOptions, SliceType } from './processing/drawing';
-import { Connectivity, MagicWandOptions, MagicWandResult, ThresholdMode } from './processing/magicWand';
-export type { Connectivity, DrawingDims, InterpolationOptions, MagicWandOptions, MagicWandResult, SliceType, ThresholdMode, };
-/**
- * Find the first and last slices containing drawing data along a given axis.
- * Runs in a Web Worker.
- */
-export declare function findDrawingBoundarySlices(sliceType: SliceType, drawBitmap: Uint8Array, dims: DrawingDims): Promise<{
-    first: number;
-    last: number;
-} | null>;
-/**
- * Interpolate between drawn slices to fill gaps in the drawing bitmap.
- * Runs in a Web Worker. Returns a new Uint8Array with the interpolated bitmap.
- *
- * Image data (`imageData`) must be in RAS voxel order. Use
- * `ctx.backgroundVolume.imgRAS` from the extension context.
- */
-export declare function interpolateMaskSlices(drawBitmap: Uint8Array, dims: DrawingDims, imageData: ArrayLike<number> | null, maxVal: number, sliceIndexLow: number | undefined, sliceIndexHigh: number | undefined, options?: InterpolationOptions): Promise<Uint8Array>;
-/**
- * Intensity-based flood fill (magic wand / click-to-segment).
- * Runs in a Web Worker. Returns the updated drawing bitmap **and** a
- * result summary (filled voxel count, thresholds used, seed intensity).
- *
- * Image data (`imageData`) must be in RAS voxel order. Use
- * `ctx.backgroundVolume.imgRAS` from the extension context.
- *
- * @param seed        - `[x, y, z]` RAS-voxel coordinate of the seed.
- * @param drawBitmap  - Drawing bitmap in RAS voxel order.
- * @param dims        - Volume dimensions in RAS space.
- * @param imageData   - Background intensity volume in RAS voxel order.
- * @param options     - See {@link MagicWandOptions}.
- * @param voxelSizeMM - Voxel size in mm `[sx, sy, sz]` for distance constraint.
- */
-export declare function magicWand(seed: [number, number, number], drawBitmap: Uint8Array, dims: DrawingDims, imageData: ArrayLike<number>, options?: MagicWandOptions, voxelSizeMM?: [number, number, number]): Promise<{
-    bitmap: Uint8Array;
-    result: MagicWandResult;
-}>;
-/**
- * Flood-fill a connected cluster of identically-coloured voxels in the
- * drawing bitmap (erase / recolour). Runs in a Web Worker.
- *
- * @param seed       - `[x, y, z]` RAS-voxel coordinate of the seed.
- * @param drawBitmap - Drawing bitmap in RAS voxel order.
- * @param dims       - Volume dimensions in RAS space.
- * @param newColor   - Colour to apply (0 = erase).
- * @param connectivity - Neighbour connectivity (default 6).
- */
-export declare function magicWandFromBitmap(seed: [number, number, number], drawBitmap: Uint8Array, dims: DrawingDims, newColor: number, connectivity?: Connectivity): Promise<{
-    bitmap: Uint8Array;
-    count: number;
-}>;
-/**
- * High-performance magic wand preview using SharedArrayBuffer.
- *
- * The working bitmap lives in shared memory. The worker restores the
- * committed state, runs the flood fill in-place, and posts back only
- * the result summary. The main thread reads the updated bitmap
- * directly — zero copies on the hot path.
- *
- * **Requires** cross-origin isolation headers (COOP + COEP) for
- * `SharedArrayBuffer` to be available.
- *
- * Image data must be in RAS voxel order. Use `ctx.backgroundVolume.imgRAS`
- * from the extension context.
- *
- * Usage with the extension context:
- * ```ts
- * const ctx = nv.createExtensionContext();
- * const dr = ctx.drawing;
- * const bg = ctx.backgroundVolume;
- * const wand = new MagicWandShared(dr.dims, bg.imgRAS, committed, dr.voxelSizeMM);
- * await wand.ready;
- * ```
- */
-export declare class MagicWandShared {
-    /** Uint8Array view over the SharedArrayBuffer — assign to `drawingVolume.img`. */
-    readonly bitmap: Uint8Array;
-    /** Resolves when the worker is initialized and ready for preview calls. */
-    readonly ready: Promise<void>;
-    private _worker;
-    private _gen;
-    constructor(dims: DrawingDims, imageData: ArrayLike<number>, committedBitmap: Uint8Array, voxelSizeMM?: [number, number, number]);
-    /**
-     * Send a new committed bitmap to the worker.
-     * Call after commit, undo, or clear.
-     */
-    updateCommitted(committed: Uint8Array): void;
-    /**
-     * Run a magic wand preview. The worker restores the committed bitmap
-     * into the shared working buffer, runs the flood fill, and returns
-     * the result summary. By the time the promise resolves, `this.bitmap`
-     * already contains the updated drawing.
-     *
-     * Returns `null` if a newer preview superseded this one.
-     */
-    preview(seed: [number, number, number], options?: MagicWandOptions): Promise<MagicWandResult | null>;
-    /** Terminate the worker and release resources. */
-    dispose(): void;
-}

package/dist/nv-ext-drawing.js

@@ -1,193 +0,0 @@
-import { NVWorker as p } from "@niivue/niivue";
-const g = '(function(){"use strict";const X={AXIAL:0,CORONAL:1};function ct(t,e){const{dimX:o,dimY:r,dimZ:s}=e;return t===X.AXIAL?{w:o,h:r,depth:s}:t===X.CORONAL?{w:o,h:s,depth:r}:{w:r,h:s,depth:o}}function Y(t,e,o,r){return t+e*r.dimX+o*r.dimX*r.dimY}function j(t,e,o,r,s){if(!s)return Y(t,e,o,r);const{img2RASstep:i,img2RASstart:n}=s;return n[0]+t*i[0]+n[1]+e*i[1]+n[2]+o*i[2]}function U(t,e,o,r){const{dimX:s,dimY:i,dimZ:n}=r;if(e===X.AXIAL){const c=new Float32Array(s*i),f=t*s*i;for(let a=0;a<c.length;a++)c[a]=o[f+a];return c}if(e===X.CORONAL){const c=new Float32Array(s*n);for(let f=0;f<n;f++)for(let a=0;a<s;a++)c[a+f*s]=o[Y(a,t,f,r)];return c}const l=new Float32Array(i*n);for(let c=0;c<n;c++)for(let f=0;f<i;f++)l[f+c*i]=o[Y(t,f,c,r)];return l}function J(t,e,o,r,s,i){const{dimX:n,dimY:l,dimZ:c}=r,f=1/s;if(e===X.AXIAL){const u=new Float32Array(n*l);for(let h=0;h<l;h++)for(let p=0;p<n;p++)u[p+h*n]=o[j(p,h,t,r,i)]*f;return u}if(e===X.CORONAL){const u=new Float32Array(n*c);for(let h=0;h<c;h++)for(let p=0;p<n;p++)u[p+h*n]=o[j(p,t,h,r,i)]*f;return u}const a=new Float32Array(l*c);for(let u=0;u<c;u++)for(let h=0;h<l;h++)a[h+u*l]=o[j(t,h,u,r,i)]*f;return a}function wt(t,e,o,r,s,i,n){const{dimX:l,dimY:c,dimZ:f}=s;if(o===X.AXIAL){const a=e*l*c;for(let u=0;u<t.length;u++)t[u]>=i&&(r[a+u]=n)}else if(o===X.CORONAL)for(let a=0;a<f;a++)for(let u=0;u<l;u++)t[u+a*l]>=i&&(r[Y(u,e,a,s)]=n);else for(let a=0;a<f;a++)for(let u=0;u<c;u++)t[u+a*c]>=i&&(r[Y(e,u,a,s)]=n)}function ft(t,e,o){if(e<3||o<3)return;const r=new Float32Array(t.length);for(let s=0;s<o;s++)for(let i=0;i<e;i++){const n=i+s*e;r[n]=i===0||i===e-1?t[n]:(t[n-1]+2*t[n]+t[n+1])*.25}for(let s=0;s<o;s++)for(let i=0;i<e;i++){const n=i+s*e;t[n]=s===0||s===o-1?r[n]:(r[n-e]+2*r[n]+r[n+e])*.25}}function pt(t,e,o,r){const s=Math.abs(o-t),i=Math.abs(o-e),n=Math.exp(-s*s/(2*r*r)),l=Math.exp(-i*i/(2*r*r)),c=n+l;return c<1e-6?.5:n/c}function bt(t,e,o){const{depth:r}=ct(t,o);let s=-1,i=-1;for(let n=0;n<r;n++){const l=U(n,t,e,o);let c=!1;for(let f=0;f<l.length;f++)if(l[f]>0){c=!0;break}c&&(s===-1&&(s=n),i=n)}return s===-1?null:{first:s,last:i}}function xt(t,e,o,r,s,i,n,l){const c=n.sliceType??X.AXIAL,{w:f,h:a,depth:u}=ct(c,e),h=u-1,p={intensityWeight:n.intensityWeight??.7,binaryThreshold:n.binaryThreshold??.375,intensitySigma:n.intensitySigma??.1,applySmoothingToSlices:n.applySmoothingToSlices??!0,useIntensityGuided:n.useIntensityGuided??!1};if(s!==void 0&&i!==void 0){if(s>=i)throw new Error("Low slice index must be less than high slice index");if(s<0||i>h)throw new Error(`Slice indices out of bounds [0, ${h}]`)}const C=new Map;for(let b=0;b<=h;b++){const N=U(b,c,t,e);for(let y=0;y<N.length;y++){const g=N[y];if(g>0){const x=C.get(g);x?(x.min=Math.min(x.min,b),x.max=Math.max(x.max,b)):C.set(g,{min:b,max:b})}}}for(const[b,N]of C){const y=s!==void 0?Math.max(s,N.min):N.min,g=i!==void 0?Math.min(i,N.max):N.max;if(y>=g||g-y<2)continue;const x=U(y,c,t,e),O=U(g,c,t,e),M=new Float32Array(x.length),I=new Float32Array(O.length);for(let A=0;A<x.length;A++)M[A]=x[A]===b?1:0,I[A]=O[A]===b?1:0;p.applySmoothingToSlices&&(ft(M,f,a),ft(I,f,a));for(let A=y+1;A<g;A++){const E=new Float32Array(f*a),d=(A-y)/(g-y),w=1-d;if(p.useIntensityGuided&&o){const m=J(y,c,o,e,r,l),v=J(g,c,o,e,r,l),nt=J(A,c,o,e,r,l),Z=p.intensityWeight;for(let F=0;F<M.length;F++)if(M[F]>0||I[F]>0){const et=pt(m[F],v[F],nt[F],p.intensitySigma),D=Z*et+(1-Z)*w,ot=1-D;E[F]=M[F]*D+I[F]*ot}else E[F]=M[F]*w+I[F]*d}else for(let m=0;m<M.length;m++)E[m]=M[m]*w+I[m]*d;wt(E,A,c,t,e,p.binaryThreshold,b)}}return t}function k(t,e,o,r){return t+e*r.dimX+o*r.dimX*r.dimY}function lt(t,e,o,r,s){if(!s)return k(t,e,o,r);const{img2RASstep:i,img2RASstart:n}=s;return n[0]+t*i[0]+n[1]+e*i[1]+n[2]+o*i[2]}const K=[[-1,0,0],[1,0,0],[0,-1,0],[0,1,0],[0,0,-1],[0,0,1]],at=[[-1,-1,0],[1,-1,0],[-1,1,0],[1,1,0],[0,-1,-1],[0,1,-1],[-1,0,-1],[1,0,-1],[0,-1,1],[0,1,1],[-1,0,1],[1,0,1]],Mt=[[-1,-1,-1],[1,-1,-1],[-1,1,-1],[1,1,-1],[-1,-1,1],[1,-1,1],[-1,1,1],[1,1,1]];function ut(t){return t>=26?[...K,...at,...Mt]:t>=18?[...K,...at]:[...K]}function dt(t,e,o,r,s={},i,n){const{tolerance:l=0,thresholdMode:c="symmetric",percent:f=0,calMin:a=0,calMax:u=1,connectivity:h=6,maxDistanceMM:p=Number.POSITIVE_INFINITY,is2D:C=!1,sliceAxis:b=0,penValue:N=1}=s,{dimX:y,dimY:g,dimZ:x}=o,O=y*g*x,[M,I,A]=t;if(M<0||I<0||A<0||M>=y||I>=g||A>=x)return{filledCount:0,seedIntensity:0,intensityMin:0,intensityMax:0};const E=lt(M,I,A,o,i),d=Number(r[E]);let w,m,v;if(s.intensityMin!==void 0&&s.intensityMax!==void 0)w=s.intensityMin,m=s.intensityMax;else{let L=c==="auto"?"symmetric":c;switch(c==="auto"&&(v=d>(a+u)*.5,L=v?"bright":"dark"),L){case"percent":{const S=d===0?.01:d;w=S*(1-f),m=S*(1+f);break}case"bright":if(f>0){const S=d===0?.01:d;w=S*(1-f),m=S*(1+f)}else l>0?(w=d,m=d+l):(w=d,m=Number.POSITIVE_INFINITY);break;case"dark":if(f>0){const S=d===0?.01:d;w=S*(1-f),m=S*(1+f)}else l>0?(w=d-l,m=d):(w=Number.NEGATIVE_INFINITY,m=d);break;default:w=d-l,m=d+l;break}}const nt=ut(h),Z=n?n[0]:1,F=n?n[1]:1,et=n?n[2]:1,D=p*p;function ot(L,S,H){if(!Number.isFinite(D))return!0;const P=(L-M)*Z,q=(S-I)*F,$=(H-A)*et;return P*P+q*q+$*$<=D}let z=-1,G=-1;C&&(b===0?(z=2,G=A):b===1?(z=1,G=I):b===2&&(z=0,G=M));const it=new Uint8Array(O),yt=k(M,I,A,o);if(d<w||d>m)return{filledCount:0,seedIntensity:d,intensityMin:w,intensityMax:m,isBright:v};const rt=[yt];it[yt]=1;let gt=0;for(;rt.length>0;){const L=rt.shift(),S=Math.floor(L/(y*g)),H=Math.floor((L-S*y*g)/y),P=L-S*y*g-H*y;e[L]=N,gt++;for(const[q,$,St]of nt){const B=P+q,W=H+$,T=S+St;if(B<0||W<0||T<0||B>=y||W>=g||T>=x||z>=0&&(z===0?B:z===1?W:T)!==G)continue;const st=k(B,W,T,o);if(it[st]||(it[st]=1,!ot(B,W,T)))continue;const At=Number(r[lt(B,W,T,o,i)]);At<w||At>m||rt.push(st)}}return{filledCount:gt,seedIntensity:d,intensityMin:w,intensityMax:m,isBright:v}}function It(t,e,o,r,s=6){const{dimX:i,dimY:n,dimZ:l}=o,[c,f,a]=t;if(c<0||f<0||a<0||c>=i||f>=n||a>=l)return 0;const u=k(c,f,a,o),h=e[u];if(h===r||h===0)return 0;const p=i*n*l,C=new Uint8Array(p),b=ut(s),N=[u];C[u]=1;let y=0;for(;N.length>0;){const g=N.shift();e[g]=r,y++;const x=Math.floor(g/(i*n)),O=Math.floor((g-x*i*n)/i),M=g-x*i*n-O*i;for(const[I,A,E]of b){const d=M+I,w=O+A,m=x+E;if(d<0||w<0||m<0||d>=i||w>=n||m>=l)continue;const v=k(d,w,m,o);C[v]||(C[v]=1,e[v]===h&&N.push(v))}}return y}const R=self.postMessage.bind(self),Ft={findBoundarySlices(t){const e=t.sliceType,o=new Uint8Array(t.drawBitmap),r=t.dims;return{result:bt(e,o,r)}},interpolateMaskSlices(t){const e=new Uint8Array(t.drawBitmap),o=t.dims,r=t.imageData?new Float32Array(t.imageData):null,s=t.maxVal??1,i=t.sliceIndexLow,n=t.sliceIndexHigh,l=t.options??{},c=t.rasMap??void 0;return{drawBitmap:xt(e,o,r,s,i,n,l,c).buffer}},magicWand(t){const e=t.seed,o=new Uint8Array(t.drawBitmap),r=t.dims,s=new Float32Array(t.imageData),i=t.options??{},n=t.rasMap??void 0,l=t.voxelSizeMM??void 0,c=dt(e,o,r,s,i,n,l);return{drawBitmap:o.buffer,result:c}},magicWandFromBitmap(t){const e=t.seed,o=new Uint8Array(t.drawBitmap),r=t.dims,s=t.newColor??0,i=t.connectivity??6,n=It(e,o,r,s,i);return{drawBitmap:o.buffer,count:n}}};let V=null,Q=null,_=null,tt=null,mt,ht;self.onmessage=t=>{const e=t.data;if(e.type==="initShared"){V=new Uint8Array(e.workingBuffer),Q=new Float32Array(e.imageBuffer),_=new Uint8Array(e.committedBuffer),tt=e.dims,mt=e.rasMap??void 0,ht=e.voxelSizeMM??void 0,R({type:"initSharedDone"});return}if(e.type==="updateCommitted"){_=new Uint8Array(e.committed);return}if(e.type==="magicWandShared"){if(!V||!Q||!_||!tt){R({type:"magicWandSharedResult",error:"Not initialized",gen:e.gen});return}V.set(_);const n=dt(e.seed,V,tt,Q,e.options??{},mt,ht);R({type:"magicWandSharedResult",result:n,gen:e.gen});return}const{_wbId:o,name:r,...s}=e,i=Ft[r];if(!i){R({_wbId:o,_wbError:`Unknown operation: ${r}`});return}try{const n=i(s),l=[];for(const c of Object.values(n))c instanceof ArrayBuffer&&l.push(c);R({_wbId:o,...n},l)}catch(n){R({_wbId:o,_wbError:n instanceof Error?n.message:String(n)})}}})();\n', h = typeof self < "u" && self.Blob && new Blob([g], { type: "text/javascript;charset=utf-8" });
-function w(e) {
-  let t;
-  try {
-    if (t = h && (self.URL || self.webkitURL).createObjectURL(h), !t) throw "";
-    const n = new Worker(t, {
-      name: e == null ? void 0 : e.name
-    });
-    return n.addEventListener("error", () => {
-      (self.URL || self.webkitURL).revokeObjectURL(t);
-    }), n;
-  } catch {
-    return new Worker(
-      "data:text/javascript;charset=utf-8," + encodeURIComponent(g),
-      {
-        name: e == null ? void 0 : e.name
-      }
-    );
-  } finally {
-    t && (self.URL || self.webkitURL).revokeObjectURL(t);
-  }
-}
-function y(e) {
-  if (e instanceof Float32Array) return e;
-  const t = new Float32Array(e.length);
-  for (let n = 0; n < e.length; n++) t[n] = e[n];
-  return t;
-}
-let m = null;
-function d() {
-  return m || (m = new p(() => new w())), m;
-}
-async function M(e, t, n) {
-  const r = t.buffer.slice(
-    t.byteOffset,
-    t.byteOffset + t.byteLength
-  );
-  return (await d().execute(
-    {
-      name: "findBoundarySlices",
-      sliceType: e,
-      drawBitmap: r,
-      dims: n
-    },
-    [r]
-  )).result;
-}
-async function S(e, t, n, r, o, s, i) {
-  const a = e.buffer.slice(
-    e.byteOffset,
-    e.byteOffset + e.byteLength
-  ), c = [a];
-  let f = null;
-  if (n) {
-    const l = y(n);
-    f = l.buffer.slice(
-      l.byteOffset,
-      l.byteOffset + l.byteLength
-    ), c.push(f);
-  }
-  const u = await d().execute(
-    {
-      name: "interpolateMaskSlices",
-      drawBitmap: a,
-      dims: t,
-      imageData: f,
-      maxVal: r,
-      sliceIndexLow: o,
-      sliceIndexHigh: s,
-      options: i ?? {},
-      rasMap: null
-    },
-    c
-  );
-  return new Uint8Array(u.drawBitmap);
-}
-async function x(e, t, n, r, o, s) {
-  const i = t.buffer.slice(
-    t.byteOffset,
-    t.byteOffset + t.byteLength
-  ), a = y(r), c = a.buffer.slice(
-    a.byteOffset,
-    a.byteOffset + a.byteLength
-  ), f = [i, c], u = await d().execute(
-    {
-      name: "magicWand",
-      seed: e,
-      drawBitmap: i,
-      dims: n,
-      imageData: c,
-      options: o ?? {},
-      rasMap: null,
-      voxelSizeMM: s ?? null
-    },
-    f
-  );
-  return { bitmap: new Uint8Array(u.drawBitmap), result: u.result };
-}
-async function I(e, t, n, r, o = 6) {
-  const s = t.buffer.slice(
-    t.byteOffset,
-    t.byteOffset + t.byteLength
-  ), i = await d().execute(
-    {
-      name: "magicWandFromBitmap",
-      seed: e,
-      drawBitmap: s,
-      dims: n,
-      newColor: r,
-      connectivity: o
-    },
-    [s]
-  );
-  return { bitmap: new Uint8Array(i.drawBitmap), count: i.count };
-}
-class L {
-  constructor(t, n, r, o) {
-    this._gen = 0;
-    const s = t.dimX * t.dimY * t.dimZ, i = new SharedArrayBuffer(s);
-    this.bitmap = new Uint8Array(i), this.bitmap.set(r);
-    const a = y(n), c = new SharedArrayBuffer(a.byteLength);
-    new Float32Array(c).set(a);
-    const f = r.slice();
-    this._worker = new w(), this.ready = new Promise((u) => {
-      const l = (b) => {
-        b.data.type === "initSharedDone" && (this._worker.removeEventListener("message", l), u());
-      };
-      this._worker.addEventListener("message", l);
-    }), this._worker.postMessage(
-      {
-        type: "initShared",
-        workingBuffer: i,
-        imageBuffer: c,
-        committedBuffer: f.buffer,
-        dims: t,
-        rasMap: null,
-        voxelSizeMM: o ?? null
-      },
-      [f.buffer]
-    );
-  }
-  /**
-   * Send a new committed bitmap to the worker.
-   * Call after commit, undo, or clear.
-   */
-  updateCommitted(t) {
-    const n = t.slice();
-    this._worker.postMessage(
-      { type: "updateCommitted", committed: n.buffer },
-      [n.buffer]
-    );
-  }
-  /**
-   * Run a magic wand preview. The worker restores the committed bitmap
-   * into the shared working buffer, runs the flood fill, and returns
-   * the result summary. By the time the promise resolves, `this.bitmap`
-   * already contains the updated drawing.
-   *
-   * Returns `null` if a newer preview superseded this one.
-   */
-  preview(t, n) {
-    const r = ++this._gen;
-    return new Promise((o) => {
-      const s = (i) => {
-        if (i.data.type === "magicWandSharedResult") {
-          if (this._worker.removeEventListener("message", s), i.data.gen !== r) {
-            o(null);
-            return;
-          }
-          o(i.data.result);
-        }
-      };
-      this._worker.addEventListener("message", s), this._worker.postMessage({
-        type: "magicWandShared",
-        seed: t,
-        options: n ?? {},
-        gen: r
-      });
-    });
-  }
-  /** Terminate the worker and release resources. */
-  dispose() {
-    this._worker.terminate();
-  }
-}
-export {
-  L as MagicWandShared,
-  M as findDrawingBoundarySlices,
-  S as interpolateMaskSlices,
-  x as magicWand,
-  I as magicWandFromBitmap
-};

package/dist/processing/drawing.d.ts

@@ -1,54 +0,0 @@
-/**
- * Pure drawing interpolation algorithms.
- * No DOM or Worker dependencies — runs in either main thread or worker.
- */
-/** Slice orientation constants (mirrors @niivue/niivue SLICE_TYPE values). */
-export declare const SLICE_TYPE: {
-    readonly AXIAL: 0;
-    readonly CORONAL: 1;
-    readonly SAGITTAL: 2;
-};
-export type SliceType = (typeof SLICE_TYPE)[keyof typeof SLICE_TYPE];
-export interface DrawingDims {
-    dimX: number;
-    dimY: number;
-    dimZ: number;
-}
-/**
- * Mapping from RAS voxel coordinates to a flat index in header-space image
- * data. For RAS voxel (rx, ry, rz) the flat index is:
- *   start[0] + rx*step[0] + start[1] + ry*step[1] + start[2] + rz*step[2]
- *
- * When the volume is already in RAS orientation (identity permutation, no
- * flips) this simplifies to the standard row-major layout and can be omitted.
- */
-export interface RASIndexMap {
-    img2RASstep: number[];
-    img2RASstart: number[];
-}
-export interface InterpolationOptions {
-    sliceType?: SliceType;
-    intensityWeight?: number;
-    binaryThreshold?: number;
-    intensitySigma?: number;
-    applySmoothingToSlices?: boolean;
-    useIntensityGuided?: boolean;
-}
-/**
- * Find the first and last slices containing drawing data along a given axis.
- */
-export declare function findBoundarySlices(sliceType: SliceType, drawBitmap: Uint8Array, dims: DrawingDims): {
-    first: number;
-    last: number;
-} | null;
-/**
- * Interpolate between drawn slices to fill gaps in the drawing bitmap.
- *
- * The drawing bitmap must be in RAS voxel order (matching the pen tool).
- * The optional imageData may be in header order; pass rasMap to handle
- * the RAS↔header mapping. If rasMap is omitted, imageData is assumed to
- * be in the same order as the bitmap.
- *
- * Modifies `drawBitmap` in-place and returns it.
- */
-export declare function interpolateMaskSlices(drawBitmap: Uint8Array, dims: DrawingDims, imageData: ArrayLike<number> | null, maxVal: number, sliceIndexLow: number | undefined, sliceIndexHigh: number | undefined, options: InterpolationOptions, rasMap?: RASIndexMap): Uint8Array;

package/dist/processing/magicWand.d.ts

@@ -1,110 +0,0 @@
-import { DrawingDims, RASIndexMap } from './drawing';
-/** Neighbour connectivity for the flood fill BFS. */
-export type Connectivity = 6 | 18 | 26;
-/**
- * Threshold mode controls how the intensity range is computed from the seed.
- *
- * - `"symmetric"` (default) — range = `[seed - tolerance, seed + tolerance]`.
- * - `"percent"` — range = `[seed * (1 - percent), seed * (1 + percent)]`.
- *   Requires {@link MagicWandOptions.percent}.
- * - `"bright"` — only voxels **≥** seed are included:
- *   range = `[seed, seed + tolerance]` (or `[seed, Infinity]` when tolerance is 0).
- * - `"dark"` — only voxels **≤** seed are included:
- *   range = `[seed - tolerance, seed]` (or `[-Infinity, seed]` when tolerance is 0).
- * - `"auto"` — automatically choose `"bright"` or `"dark"` based on whether
- *   the seed intensity is above or below the midpoint of `calMin`/`calMax`.
- *   Requires {@link MagicWandOptions.calMin} and {@link MagicWandOptions.calMax}.
- *   When combined with `percent`, the range is computed as percent-based
- *   but only on the bright or dark side.
- */
-export type ThresholdMode = 'symmetric' | 'percent' | 'bright' | 'dark' | 'auto';
-/** Options that control the magic-wand behaviour. */
-export interface MagicWandOptions {
-    /**
-     * Absolute tolerance around the seed intensity (default 0).
-     * Range becomes `[seed - tolerance, seed + tolerance]`.
-     * Ignored when `intensityMin`/`intensityMax` are both provided,
-     * or when `thresholdMode` is `"percent"`.
-     */
-    tolerance?: number;
-    /** Explicit minimum intensity threshold (overrides all other range logic). */
-    intensityMin?: number;
-    /** Explicit maximum intensity threshold (overrides all other range logic). */
-    intensityMax?: number;
-    /**
-     * How the intensity range is derived from the seed (default `"symmetric"`).
-     * See {@link ThresholdMode} for details.
-     */
-    thresholdMode?: ThresholdMode;
-    /**
-     * Percentage threshold (0–1) used when `thresholdMode` is `"percent"` or
-     * `"auto"`. Range becomes `[seed * (1-pct), seed * (1+pct)]`.
-     * Equivalent to `clickToSegmentPercent` in the old niivue API.
-     */
-    percent?: number;
-    /**
-     * Volume calibration minimum — needed for `thresholdMode: "auto"` to
-     * determine bright vs dark. Equivalent to `back.cal_min`.
-     */
-    calMin?: number;
-    /**
-     * Volume calibration maximum — needed for `thresholdMode: "auto"` to
-     * determine bright vs dark. Equivalent to `back.cal_max`.
-     */
-    calMax?: number;
-    /** Neighbour connectivity (default 6). */
-    connectivity?: Connectivity;
-    /** Maximum Euclidean distance from the seed in **mm** (default Infinity). */
-    maxDistanceMM?: number;
-    /** If true, constrain fill to the seed's 2-D slice. */
-    is2D?: boolean;
-    /** Slice axis when `is2D` is true (0 = axial/Z, 1 = coronal/Y, 2 = sagittal/X). */
-    sliceAxis?: number;
-    /** Pen colour to write into the bitmap (default 1). */
-    penValue?: number;
-}
-/** Result returned by `magicWand`. */
-export interface MagicWandResult {
-    /** Number of voxels that were filled. */
-    filledCount: number;
-    /** The seed voxel intensity. */
-    seedIntensity: number;
-    /** Actual intensity min used. */
-    intensityMin: number;
-    /** Actual intensity max used. */
-    intensityMax: number;
-    /**
-     * Whether the auto-detect resolved to "bright" (`true`) or "dark" (`false`).
-     * Only meaningful when `thresholdMode` was `"auto"`.
-     */
-    isBright?: boolean;
-}
-/**
- * Flood-fill (magic wand / click-to-segment) starting from a **RAS-voxel**
- * seed coordinate.
- *
- * @param seed        - `[x, y, z]` RAS-voxel coordinate of the seed.
- * @param drawBitmap  - Drawing bitmap in RAS voxel order (modified **in-place**).
- * @param dims        - Volume dimensions in RAS space.
- * @param imageData   - Background intensity volume (may be header-ordered).
- * @param options     - See {@link MagicWandOptions}.
- * @param rasMap      - Optional RAS→header index mapping for `imageData`.
- * @param voxelSizeMM - Voxel size in mm `[sx, sy, sz]` for distance constraints.
- *                       Required when `maxDistanceMM` is finite.
- * @returns Result summary (number of voxels filled, thresholds used, etc.).
- */
-export declare function magicWand(seed: [number, number, number], drawBitmap: Uint8Array, dims: DrawingDims, imageData: ArrayLike<number>, options?: MagicWandOptions, rasMap?: RASIndexMap, voxelSizeMM?: [number, number, number]): MagicWandResult;
-/**
- * Flood-fill a connected cluster of identically-coloured voxels
- * in the drawing bitmap, starting from `seed`.  Useful for erasing
- * or recolouring an existing drawn region without reference to the
- * underlying image intensity.
- *
- * @param seed       - `[x, y, z]` RAS-voxel coordinate of the seed.
- * @param drawBitmap - Drawing bitmap in RAS voxel order (modified **in-place**).
- * @param dims       - Volume dimensions in RAS space.
- * @param newColor   - Colour to apply (0 = erase).
- * @param connectivity - Neighbour connectivity (default 6).
- * @returns Number of voxels changed.
- */
-export declare function magicWandFromBitmap(seed: [number, number, number], drawBitmap: Uint8Array, dims: DrawingDims, newColor: number, connectivity?: Connectivity): number;

package/dist/worker.d.ts

@@ -1,9 +0,0 @@
-/**
- * Web Worker for nv-ext-drawing operations.
- *
- * Protocol (NVWorker bridge):
- *   Request:  { _wbId, name, ...payload }
- *   Response: { _wbId, ...result }
- *   Error:    { _wbId, _wbError: string }
- */
-export {};