@bloopjs/toodle 0.0.100

package/dist/textures/types.d.ts

@@ -0,0 +1,177 @@
+import type { Size, Vec2 } from "../coreTypes/mod";
+export type AtlasCoords = TextureRegion & {
+    atlasIndex: number;
+};
+/**
+ * A TextureRegion is a region of the texture atlas in normalized texels.
+ *
+ * It is a combination of a UvRegion and a cropOffset.
+ */
+export type TextureRegion = UvRegion & {
+    /** the offset from the top left of the texture in texels to begin drawing */
+    cropOffset: Vec2;
+    /** the original size of the texture in texels */
+    originalSize: Size;
+};
+/**
+ * A UvRegion is a region of the texture atlas in normalized texels.
+ */
+export type UvRegion = {
+    /**
+     * The offset of the UVs in normalized atlas texels. Relative to the un-cropped texture.
+     *
+     * @example
+     *
+     * { x: 10 / 4096, y: 10 / 4096 }
+     */
+    uvOffset: Vec2;
+    /**
+     * The scale of the UVs in normalized texels. Derived from the width and height of the un-cropped texture.
+     *
+     * @example
+     *
+     * { width: 1 / 4096, height: 1 / 4096 }
+     */
+    uvScale: Size;
+    /**
+     * The scale of the UVs in normalized texels. Derived from the width and height of the cropped texture.
+     *
+     * @example
+     *
+     * { width: 1 / 4096, height: 1 / 4096 }
+     */
+    uvScaleCropped?: Size;
+};
+/**
+ * A CpuTextureAtlas is a texture atlas that has been loaded into memory.
+ *
+ * It contains the texture and a map of texture ids to TextureRegions.
+ */
+export type CpuTextureAtlas = {
+    texture: ImageBitmap;
+    rg8Bytes?: Uint8Array<ArrayBuffer>;
+    textureRegions: Map<string, TextureRegion>;
+    width: number;
+    height: number;
+};
+/**
+ * A TextureWithMetadata is a texture that has been loaded into the gpu.
+ *
+ * It contains the gpu texture data and a cropOffset and originalSize for use with cropped textures.
+ */
+export type TextureWithMetadata = {
+    texture: GPUTexture;
+    /** crop offset from center in texel units */
+    cropOffset: Vec2;
+    /** original size in texel units before cropping */
+    originalSize: Size;
+};
+/** A definition for a pre-baked texture atlas */
+export type AtlasDef = {
+    /** The url of the atlas png file, if empty the png is assumed to be next to the json file */
+    png?: URL;
+    /** The url of the atlas json file, if empty the json is assumed to be next to the png file */
+    json: URL;
+} | {
+    /** The url of the atlas png file, if empty the png is assumed to be next to the json file */
+    png: URL;
+    /** The url of the atlas json file, if empty the json is assumed to be next to the png file */
+    json?: URL;
+};
+/** Bundle options for registering multiple individual textures */
+export type TextureBundleOpts = {
+    /**
+     * A record of texture ids and URLs.
+     * ids must be unique within a bundle
+     *
+     */
+    textures: Record<string, URL>;
+    /**
+     * Whether the image should be cropped down to the minimal bounding box for non-transparent pixels.
+     *
+     * See [Transparent Pixel Cropping](https://toodle.gg/f849595b3ed13fc956fc1459a5cb5f0228f9d259/examples/transparent-cropping.html) for more information.
+     */
+    cropTransparentPixels?: boolean;
+    /**
+     * Whether the bundle should be loaded automatically on registration
+     */
+    autoLoad?: boolean;
+};
+/** Bundle options for registering pre-generated texture atlases */
+export type AtlasBundleOpts = {
+    /**
+     * atlas definitions as pregenerated by a texture packer like https://github.com/pixijs/assetpack
+     *
+     * @example
+     *
+     * [
+     *   {
+     *     json: new URL('https://example.com/atlas.json'),
+     *   },
+     *   {
+     *     png: new URL('https://example.com/atlas.png'),
+     *   },
+     *   {
+     *     json: new URL('https://example.com/metadata/atlas.json'),
+     *     png: new URL('https://example.com/images/atlas.png'),
+     *   },
+     * ]
+     */
+    atlases: AtlasDef[];
+    /**
+     * Whether the bundle should be loaded automatically on registration
+     */
+    autoLoad?: boolean;
+    /**
+     * If true, png urls will be ignored and the texture path will be inferred to be next to the json file
+     * with a .rg8.gz extension.
+     */
+    rg8?: boolean;
+};
+/**
+ * A texel region defines a subregion of an individual texture in texel units.
+ *
+ * (0,0) is the top left corner of the original texture.
+ * (width, height) is the bottom right corner of the original texture.
+ *
+ * @example
+ * This is useful for something like spritesheet animations,
+ * for eg a 3-frame pose of a 32x32 character sprite might be 96x32 texels, and the animation could
+ * be done by alternating between:
+ *
+ * { x: 0, y: 0, width: 32, height: 32 }
+ * { x: 32, y: 0, width: 32, height: 32 }
+ * { x: 64, y: 0, width: 32, height: 32 }
+ *
+ */
+export type TexelRegion = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+/** A region specification from a pixi.js spritesheet or atlas paced with assetPack */
+export type PixiRegion = {
+    /** the position and size of the cropped region in the atlas, measured in texels*/
+    frame: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    rotated: boolean;
+    trimmed: boolean;
+    /** the original size of the texture in texels */
+    sourceSize: {
+        w: number;
+        h: number;
+    };
+    /** the position and size of the cropped region of the texture prior to packing in the atlas, measured in texels */
+    spriteSourceSize: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/textures/types.d.ts.map

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

package/dist/textures/util.d.ts

@@ -0,0 +1,8 @@
+import type { CpuTextureAtlas, TextureWithMetadata } from "./types";
+export declare function getBitmapFromUrl(url: URL): Promise<ImageBitmap>;
+export declare function loadZip(zipUrl: URL): Promise<{
+    path: string;
+    bitmap: ImageBitmap;
+}[]>;
+export declare function packBitmapsToAtlas(images: Map<string, TextureWithMetadata>, textureSize: number, device: GPUDevice): Promise<CpuTextureAtlas[]>;
+//# sourceMappingURL=util.d.ts.map

package/dist/textures/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/textures/util.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EAEf,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAEjB,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CASrE;AAmED,wBAAsB,OAAO,CAC3B,MAAM,EAAE,GAAG,GACV,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,EAAE,CAAC,CAsBlD;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,EACxC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,eAAe,EAAE,CAAC,CAqH5B"}

package/dist/utils/assert.d.ts

@@ -0,0 +1,2 @@
+export declare function assert(condition: any, message: string): asserts condition;
+//# sourceMappingURL=assert.d.ts.map

package/dist/utils/assert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../src/utils/assert.ts"],"names":[],"mappings":"AAAA,wBAAgB,MAAM,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAIzE"}

package/dist/utils/boilerplate.d.ts

@@ -0,0 +1,11 @@
+import type { ShaderDescriptor } from "../shaders/ShaderDescriptor";
+export declare function initGpu(canvas: HTMLCanvasElement, onUncapturedError?: (e: GPUUncapturedErrorEvent) => void): Promise<{
+    device: GPUDevice;
+    context: GPUCanvasContext;
+    presentationFormat: GPUTextureFormat;
+}>;
+export declare function getGpuPipelineDescriptor(shaderDescriptor: ShaderDescriptor, module: GPUShaderModule, presentationFormat: GPUTextureFormat, blend?: GPUBlendState): Omit<GPURenderPipelineDescriptor, "layout">;
+export declare function setVertexInstanceBufferLayout(pipeline: Omit<GPURenderPipelineDescriptor, "layout">, bufferLayout: GPUVertexBufferLayout): Omit<GPURenderPipelineDescriptor, "layout">;
+export declare function attachVertexInstanceBuffer(renderPass: GPURenderPassEncoder, instanceBuffer: GPUBuffer): void;
+export declare function createGpuPipeline(device: GPUDevice, shaderDescriptor: ShaderDescriptor, pipelineDescriptor: Omit<GPURenderPipelineDescriptor, "layout">): GPURenderPipeline;
+//# sourceMappingURL=boilerplate.d.ts.map

package/dist/utils/boilerplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boilerplate.d.ts","sourceRoot":"","sources":["../../src/utils/boilerplate.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAKpE,wBAAsB,OAAO,CAC3B,MAAM,EAAE,iBAAiB,EACzB,iBAAiB,CAAC,EAAE,CAAC,CAAC,EAAE,uBAAuB,KAAK,IAAI;;;;GAgCzD;AAED,wBAAgB,wBAAwB,CACtC,gBAAgB,EAAE,gBAAgB,EAClC,MAAM,EAAE,eAAe,EACvB,kBAAkB,EAAE,gBAAgB,EACpC,KAAK,CAAC,EAAE,aAAa,GACpB,IAAI,CAAC,2BAA2B,EAAE,QAAQ,CAAC,CAuB7C;AAED,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,IAAI,CAAC,2BAA2B,EAAE,QAAQ,CAAC,EACrD,YAAY,EAAE,qBAAqB,GAClC,IAAI,CAAC,2BAA2B,EAAE,QAAQ,CAAC,CAG7C;AAED,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,oBAAoB,EAChC,cAAc,EAAE,SAAS,QAG1B;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EACjB,gBAAgB,EAAE,gBAAgB,EAClC,kBAAkB,EAAE,IAAI,CAAC,2BAA2B,EAAE,QAAQ,CAAC,GAC9D,iBAAiB,CAenB"}

package/dist/utils/error.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Useful for warning in a function run every frame if you only want to warn once
+ *
+ * @param key a unique key to tag the warning
+ * @param msg message to console.warn
+ */
+export declare function warnOnce(key: string, msg?: string): void;
+//# sourceMappingURL=error.d.ts.map

package/dist/utils/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/utils/error.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,QAMjD"}

package/dist/utils/mod.d.ts

@@ -0,0 +1,3 @@
+export * from "./assert";
+export * from "./pool";
+//# sourceMappingURL=mod.d.ts.map

package/dist/utils/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/utils/mod.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC"}

package/dist/utils/pool.d.ts

@@ -0,0 +1,23 @@
+/**
+ * A simple pool for creating and reusing objects to avoid allocation between frames
+ *
+ * @example
+ *
+ * const pool = new Pool(() => new SomeObject(), 10);
+ *
+ * function animate() {
+ *   const obj = pool.get();
+ *   console.log(obj);
+ *   pool.free();
+ *   requestAnimationFrame(animate);
+ * }
+ *
+ * requestAnimationFrame(animate);
+ */
+export declare class Pool<T> {
+    #private;
+    constructor(create: () => T, initialSize?: number);
+    get(): T;
+    free(): void;
+}
+//# sourceMappingURL=pool.d.ts.map

package/dist/utils/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../src/utils/pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,IAAI,CAAC,CAAC;;gBAKL,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,SAAI;IAS5C,GAAG;IAQH,IAAI;CAGL"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@bloopjs/toodle",
+  "version": "0.0.100",
+  "type": "module",
+  "files": ["dist", "src"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bloopgames/toodle.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": "./src/mod.ts",
+      "types": "./src/mod.ts"
+    }
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "bun build src/mod.ts --outdir ./dist --sourcemap=linked && bun run build:tsc",
+    "build:tsc": "tsc -p scripts/tsconfig.publish.json",
+    "preview": "vite preview",
+    "biome:check": "biome check ./src ./examples",
+    "biome:write": "biome check ./src ./examples --write",
+    "ci": "bun run biome:check && bun test && bun tsc",
+    "docs:dev": "(cd docs && bun run docs:dev)",
+    "docs:build": "(cd docs && bun run docs:build)"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.1.2",
+    "@types/bun": "^1.1.13",
+    "@webgpu/types": "^0.1.51",
+    "vite": "^5.4.11"
+  },
+  "peerDependencies": {
+    "typescript": "^5.7.2"
+  },
+  "dependencies": {
+    "fflate": "^0.8.2",
+    "webgpu-utils": "^1.9.3",
+    "wgpu-matrix": "^3.3.0",
+    "wgsl_reflect": "^1.0.14"
+  }
+}