@flighthq/quadbatch 0.3.0-edge.1458.0c01b63

package/dist/contract.d.ts

@@ -0,0 +1,2 @@
+export * from './quadBatch';
+//# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/contract.js

@@ -0,0 +1,2 @@
+export * from './quadBatch';
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { appendQuadBatchInstance, clearQuadBatch, cloneQuadBatch, compactQuadBatch, computeQuadBatchLocalBoundsRectangle, createQuadBatch, enableQuadBatchSignals, getQuadBatchCapacity, getQuadBatchInstanceId, getQuadBatchInstanceTransform, getQuadBatchSignals, getQuadBatchTransformStride, hitTestQuadBatchPoint, hitTestQuadBatchPointExact, hitTestQuadBatchPointExactXY, hitTestQuadBatchPointXY, iterateQuadBatchInstances, removeQuadBatchInstance, reserveQuadBatch, resizeQuadBatch, setQuadBatchInstance, setQuadBatchInstanceMatrix, setQuadBatchInstanceRange, setQuadBatchInstanceTint, setQuadBatchLocalBoundsRectangle, setQuadBatchTransformType, } from './contract';
+//# 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":"AAAA,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,oCAAoC,EACpC,eAAe,EACf,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,EACtB,6BAA6B,EAC7B,mBAAmB,EACnB,2BAA2B,EAC3B,qBAAqB,EACrB,0BAA0B,EAC1B,4BAA4B,EAC5B,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,EACvB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,EACxB,gCAAgC,EAChC,yBAAyB,GAC1B,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { appendQuadBatchInstance, clearQuadBatch, cloneQuadBatch, compactQuadBatch, computeQuadBatchLocalBoundsRectangle, createQuadBatch, enableQuadBatchSignals, getQuadBatchCapacity, getQuadBatchInstanceId, getQuadBatchInstanceTransform, getQuadBatchSignals, getQuadBatchTransformStride, hitTestQuadBatchPoint, hitTestQuadBatchPointExact, hitTestQuadBatchPointExactXY, hitTestQuadBatchPointXY, iterateQuadBatchInstances, removeQuadBatchInstance, reserveQuadBatch, resizeQuadBatch, setQuadBatchInstance, setQuadBatchInstanceMatrix, setQuadBatchInstanceRange, setQuadBatchInstanceTint, setQuadBatchLocalBoundsRectangle, setQuadBatchTransformType, } from './contract';
+//# 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,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,oCAAoC,EACpC,eAAe,EACf,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,EACtB,6BAA6B,EAC7B,mBAAmB,EACnB,2BAA2B,EAC3B,qBAAqB,EACrB,0BAA0B,EAC1B,4BAA4B,EAC5B,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,EACvB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,EACxB,gCAAgC,EAChC,yBAAyB,GAC1B,MAAM,YAAY,CAAC"}

package/dist/quadBatch.d.ts

@@ -0,0 +1,118 @@
+import type { PartialNode, QuadBatch, QuadBatchData, QuadBatchRuntime, QuadBatchSignals, QuadTransformType, Rectangle, Vector2Like } from '@flighthq/types/contract';
+export declare const QUAD_BATCH_DELETED_ID = 65535;
+/**
+ * Appends a new instance at the end of `target` using vector2 (translation-only) transform,
+ * auto-growing capacity via `resizeQuadBatch`. Returns the new instance index.
+ * The materialData slot for the appended instance is not set — leave it null or assign after.
+ * Fires `onInstanceAppended` when signals are enabled.
+ */
+export declare function appendQuadBatchInstance(target: QuadBatch, id: number, x: number, y: number): number;
+/** Sets `target.data.instanceCount = 0`, keeping allocated capacity. Fires `onCleared` when signals are enabled. */
+export declare function clearQuadBatch(target: QuadBatch): void;
+/**
+ * Deep-copies `source` into a new `QuadBatch` with independent typed arrays and a fresh runtime.
+ * The new batch has the same `atlas`, `instanceCount`, `transformType`, and `materialData` (shallow copy),
+ * but its `ids` and `transforms` are cloned typed arrays.
+ */
+export declare function cloneQuadBatch(source: Readonly<QuadBatch>): QuadBatch;
+/**
+ * Removes swap-remove holes by compacting all live instances (`[0, instanceCount)`) to the
+ * front of the buffer in index order, skipping entries that have been logically deleted.
+ * This is not needed for swap-remove–only callers, but is useful when stable iteration order
+ * must be restored after a batch of removals. After compaction, `instanceCount` equals the
+ * number of entries whose id is `>= 0`.
+ *
+ * Note: this function does NOT filter by id; it simply copies all `instanceCount` entries to a
+ * fresh contiguous layout. To remove specific entries, call `removeQuadBatchInstance` first, then
+ * compact if needed.
+ */
+export declare function compactQuadBatch(target: QuadBatch): void;
+export declare function computeQuadBatchLocalBoundsRectangle(out: Rectangle, source: Readonly<QuadBatch>): void;
+export declare function createQuadBatch(obj?: Readonly<PartialNode<QuadBatch>>): QuadBatch;
+export declare function createQuadBatchData(data?: Readonly<Partial<QuadBatchData>>): QuadBatchData;
+export declare function createQuadBatchRuntime(): QuadBatchRuntime;
+export declare function createQuadBatchSignals(): QuadBatchSignals;
+/**
+ * Opt-in signals for a `QuadBatch` node. Returns the {@link QuadBatchSignals} group attached to
+ * `target`, creating it on the first call. Zero cost until enabled — honors the `enable*` convention.
+ * Use `getQuadBatchSignals` to read without creating.
+ */
+export declare function enableQuadBatchSignals(target: QuadBatch): QuadBatchSignals;
+export declare function getQuadBatchCapacity(source: Readonly<QuadBatch>): number;
+/**
+ * Returns the region id stored at `index`, or -1 when `index` is out of range.
+ * Bounds-checked against `instanceCount`.
+ */
+export declare function getQuadBatchInstanceId(source: Readonly<QuadBatch>, index: number): number;
+/**
+ * Writes the transform of instance `index` into `out`.
+ * For vector2 batches, writes `out.x = tx, out.y = ty` (matrix fields left unchanged).
+ * For matrix3x2 batches, writes `out.a/b/c/d/tx/ty`.
+ * Returns false and writes nothing when `index` is out of range.
+ */
+export declare function getQuadBatchInstanceTransform(out: Vector2Like, source: Readonly<QuadBatch>, index: number): boolean;
+export declare function getQuadBatchRuntime(source: Readonly<QuadBatch>): Readonly<QuadBatchRuntime>;
+/** Returns the {@link QuadBatchSignals} attached to `source`, or `null` if not yet enabled. */
+export declare function getQuadBatchSignals(source: Readonly<QuadBatch>): QuadBatchSignals | null;
+export declare function getQuadBatchTransformStride(transformType: QuadTransformType): number;
+export declare function hitTestQuadBatchPoint(source: Readonly<QuadBatch>, point: Readonly<Vector2Like>): number;
+/**
+ * Returns the topmost instance index whose quad polygon contains `(x, y)`, or -1 for a miss.
+ *
+ * For `vector2` batches this is equivalent to `hitTestQuadBatchPointXY` (axis-aligned quads have
+ * no rotation; AABB = exact polygon). For `matrix3x2` batches this performs a true point-in-quad
+ * test via the cross-product winding rule, while `hitTestQuadBatchPointXY` uses the AABB of the
+ * transformed quad (which over-reports for rotated quads). Use this variant when rotation accuracy
+ * matters; it is slightly more expensive than the AABB version.
+ */
+export declare function hitTestQuadBatchPointExact(source: Readonly<QuadBatch>, point: Readonly<Vector2Like>): number;
+/**
+ * XY variant of `hitTestQuadBatchPointExact`. See that function for details.
+ */
+export declare function hitTestQuadBatchPointExactXY(source: Readonly<QuadBatch>, x: number, y: number): number;
+export declare function hitTestQuadBatchPointXY(source: Readonly<QuadBatch>, x: number, y: number): number;
+/**
+ * Calls `visitor(index, id, transforms)` for each live instance in order. The `transforms`
+ * argument is a `Float32Array` subarray view beginning at instance `index`'s offset with
+ * length equal to the transform stride. Allocation-free: no per-call object is created.
+ */
+export declare function iterateQuadBatchInstances(source: Readonly<QuadBatch>, visitor: (index: number, id: number, transforms: Float32Array) => void): void;
+/**
+ * Swap-removes instance `index` with the last instance (O(1)), decrementing `instanceCount`.
+ * Does not preserve order — the instance that was at `instanceCount-1` moves to `index`.
+ * No-ops when `index` is out of range.
+ * Fires `onInstanceRemoved` when signals are enabled.
+ */
+export declare function removeQuadBatchInstance(target: QuadBatch, index: number): void;
+export declare function reserveQuadBatch(target: QuadBatch, capacity: number): void;
+export declare function resizeQuadBatch(target: QuadBatch, instanceCount: number): void;
+/**
+ * Writes the vector2 (translation-only) transform and id for instance `index`.
+ * No-ops when `index` is out of range (`[0, instanceCount)`).
+ * Target must use `transformType === 'vector2'`.
+ */
+export declare function setQuadBatchInstance(target: QuadBatch, index: number, id: number, x: number, y: number): void;
+/**
+ * Writes a full 2D affine (matrix3x2) transform and id for instance `index`.
+ * No-ops when `index` is out of range (`[0, instanceCount)`).
+ * Target must use `transformType === 'matrix3x2'`.
+ * Layout: `[a, b, c, d, tx, ty]` — standard column-major 2D affine.
+ */
+export declare function setQuadBatchInstanceMatrix(target: QuadBatch, index: number, id: number, a: number, b: number, c: number, d: number, tx: number, ty: number): void;
+/**
+ * Writes `count` contiguous transform entries from `source` into the batch starting at `startIndex`.
+ * Reads `count * stride` floats from `source` (where stride = `getQuadBatchTransformStride(target.data.transformType)`).
+ * No-ops when `startIndex + count` exceeds `instanceCount`.
+ * This is the bulk variant of `setQuadBatchInstance`/`setQuadBatchInstanceMatrix`.
+ */
+export declare function setQuadBatchInstanceRange(target: QuadBatch, startIndex: number, count: number, source: Readonly<Float32Array>): void;
+export declare function setQuadBatchInstanceTint(target: QuadBatch, index: number, rgba: number): void;
+export declare function setQuadBatchLocalBoundsRectangle(target: QuadBatch, rect: Readonly<Rectangle>): void;
+/**
+ * Switches `target`'s `transformType`, re-striding the `transforms` buffer in place.
+ * - `'vector2' → 'matrix3x2'`: each existing (x, y) pair is expanded to `[1, 0, 0, 1, x, y]` (identity + translation).
+ * - `'matrix3x2' → 'vector2'`: each matrix is collapsed to its `(tx, ty)` translation, discarding scale/rotation.
+ * Does nothing when `newType` matches the current `transformType`.
+ */
+export declare function setQuadBatchTransformType(target: QuadBatch, newType: QuadTransformType): void;
+//# sourceMappingURL=quadBatch.d.ts.map

package/dist/quadBatch.d.ts.map

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