f1ow 0.1.0

package/dist/utils/spatialSoA.d.ts

@@ -0,0 +1,82 @@
+import { CanvasElement, ViewportState } from '../types';
+/** Numeric encoding for element types (used in SoA type array) */
+export declare const ELEMENT_TYPE_MAP: Record<string, number>;
+/**
+ * Structure-of-Arrays view for spatial queries.
+ * All arrays are indexed in parallel — index `i` in each array
+ * corresponds to the same element.
+ */
+export interface SpatialSoAData {
+    /** Element IDs, indexed in parallel */
+    ids: string[];
+    /** X position (world-space) */
+    x: Float64Array;
+    /** Y position (world-space) */
+    y: Float64Array;
+    /** Width (world-space) */
+    w: Float64Array;
+    /** Height (world-space) */
+    h: Float64Array;
+    /** Element type as numeric code */
+    types: Uint8Array;
+    /** Active element count (may be less than array capacity) */
+    length: number;
+}
+/**
+ * Maintains SoA parallel views synchronized with the element array.
+ *
+ * Usage:
+ * ```ts
+ * const soa = new SpatialSoA();
+ * soa.rebuild(elements);
+ * const visibleIds = soa.cullViewport(viewport, stageW, stageH);
+ * ```
+ */
+export declare class SpatialSoA {
+    private _data;
+    /** Pre-allocated capacity (grows on demand) */
+    private _capacity;
+    /** ID → SoA index for O(1) single-element updates */
+    private _indexMap;
+    constructor(initialCapacity?: number);
+    /** Current element count */
+    get length(): number;
+    /** Read-only access to the SoA data */
+    get data(): Readonly<SpatialSoAData>;
+    private _allocate;
+    private _ensureCapacity;
+    /**
+     * Full rebuild from the canonical element array.
+     * Call when elements reference changes (add/remove/reorder).
+     * ~1.2ms for 10K elements.
+     */
+    rebuild(elements: CanvasElement[]): void;
+    /**
+     * Update a single element's spatial data in-place.
+     * O(1) — no array copying.
+     * Returns false if the element is not in the SoA.
+     */
+    updateElement(el: CanvasElement): boolean;
+    /**
+     * Viewport culling using SoA iteration.
+     * Returns IDs of elements whose AABB overlaps the viewport.
+     *
+     * 2-3× faster than AoS iteration for large sets because:
+     * - Sequential memory access (cache-line friendly)
+     * - No object pointer dereferencing per element
+     * - TypedArray iteration compiles to tight machine code in V8
+     */
+    cullViewport(viewport: ViewportState, stageWidth: number, stageHeight: number, padding?: number): string[];
+    /**
+     * Rectangle query — return IDs of elements overlapping a world-space rect.
+     */
+    queryRect(minX: number, minY: number, maxX: number, maxY: number): string[];
+    /**
+     * Point query — return IDs of elements containing a world-space point.
+     */
+    queryPoint(wx: number, wy: number): string[];
+    /** Clear all data (does not release typed array memory) */
+    clear(): void;
+}
+/** Get or create a shared SpatialSoA singleton */
+export declare function getSharedSpatialSoA(): SpatialSoA;

package/dist/workers/elbowWorker.d.ts

@@ -0,0 +1,18 @@
+/**
+ * elbowWorker.ts — Web Worker for off-main-thread elbow connector routing.
+ *
+ * Runs the expensive A* grid-search algorithm in a background thread so
+ * the main thread stays at 60fps during intensive drag operations that
+ * trigger many simultaneous route recomputations.
+ *
+ * Communication protocol:
+ *   Main → Worker:
+ *     { type: 'updateElements', elements: SerializedElement[] }
+ *     { type: 'computeRoute', requestId, params: RouteParams }
+ *   Worker → Main:
+ *     { type: 'routeResult', requestId, points: number[] }
+ *
+ * Uses Vite's native Worker module support — imported with:
+ *   new Worker(new URL('./elbowWorker.ts', import.meta.url), { type: 'module' })
+ */
+export {};

package/dist/workers/exportWorker.d.ts

@@ -0,0 +1,18 @@
+/**
+ * exportWorker.ts — Web Worker for off-main-thread SVG export.
+ *
+ * Generates SVG strings from serialized element data in a background
+ * thread, keeping the main thread responsive during export of large
+ * canvases (10K+ elements).
+ *
+ * Communication protocol:
+ *   Main → Worker:
+ *     { type: 'exportSVG', requestId: string, elements: CanvasElement[] }
+ *   Worker → Main:
+ *     { type: 'svgResult', requestId: string, svg: string }
+ *     { type: 'error', requestId: string, message: string }
+ *
+ * Uses Vite's native Worker module support — imported with:
+ *   new Worker(new URL('./exportWorker.ts', import.meta.url), { type: 'module' })
+ */
+export {};

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "f1ow",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Interactive canvas drawing toolkit built on KonvaJS — drop-in React component for diagrams, sketches & whiteboards",
+  "author": "Nuumz <info@nuumz.com>",
+  "homepage": "https://github.com/nuumz/f1ow-canvas#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nuumz/f1ow-canvas.git"
+  },
+  "bugs": {
+    "url": "https://github.com/nuumz/f1ow-canvas/issues"
+  },
+  "main": "./dist/f1ow.umd.cjs",
+  "module": "./dist/f1ow.js",
+  "types": "./dist/lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/lib/index.d.ts",
+      "import": "./dist/f1ow.js",
+      "require": "./dist/f1ow.umd.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "build:lib": "vite build --mode lib",
+    "preview": "vite preview",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run typecheck && npm run build:lib"
+  },
+  "peerDependencies": {
+    "react": ">=17.0.0",
+    "react-dom": ">=17.0.0"
+  },
+  "dependencies": {
+    "konva": "^9.3.18",
+    "lucide-react": "^0.468.0",
+    "nanoid": "^5.0.9",
+    "rbush": "^4.0.1",
+    "react-konva": "^18.2.10",
+    "y-websocket": "^3.0.0",
+    "yjs": "^13.6.29",
+    "zustand": "^5.0.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.1",
+    "@types/rbush": "^4.0.0",
+    "@types/react": "^18.3.18",
+    "@types/react-dom": "^18.3.5",
+    "@vitejs/plugin-react": "^4.3.4",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "typescript": "^5.7.3",
+    "vite": "^6.0.7",
+    "vite-plugin-dts": "^4.3.0"
+  },
+  "keywords": [
+    "canvas",
+    "drawing",
+    "konvajs",
+    "react",
+    "whiteboard",
+    "diagram",
+    "flowchart",
+    "react-component",
+    "konva",
+    "collaborative",
+    "vector",
+    "sketch"
+  ],
+  "license": "MIT"
+}