@flighthq/spritesheet 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from './spritesheet';
+export * from './spritesheetAnimation';
+export * from './spritesheetData';
+export * from './spritesheetFrame';
+export * from './spritesheetFrom';
+export * from './spritesheetPlayer';
+export * from './spritesheetTimelineSource';
+export * from './spritesheetValidation';
+//# 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,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export * from './spritesheet';
+export * from './spritesheetAnimation';
+export * from './spritesheetData';
+export * from './spritesheetFrame';
+export * from './spritesheetFrom';
+export * from './spritesheetPlayer';
+export * from './spritesheetTimelineSource';
+export * from './spritesheetValidation';
+//# 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,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC"}

package/dist/spritesheet.d.ts

@@ -0,0 +1,5 @@
+import type { Spritesheet, SpritesheetAnimation } from '@flighthq/types';
+export declare function cloneSpritesheet(spritesheet: Readonly<Spritesheet>): Spritesheet;
+export declare function createSpritesheet(obj?: Partial<Spritesheet>): Spritesheet;
+export declare function getSpritesheetAnimation(spritesheet: Spritesheet, label: string): SpritesheetAnimation | null;
+//# sourceMappingURL=spritesheet.d.ts.map

package/dist/spritesheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spritesheet.d.ts","sourceRoot":"","sources":["../src/spritesheet.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAIzE,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,WAAW,CAgBhF;AAED,wBAAgB,iBAAiB,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAMzE;AAED,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAE5G"}

package/dist/spritesheet.js

@@ -0,0 +1,28 @@
+import { createEntity } from '@flighthq/entity';
+import { createSpritesheetFrame } from './spritesheetFrame';
+export function cloneSpritesheet(spritesheet) {
+    const frames = spritesheet.frames.map((f) => createSpritesheetFrame({
+        id: f.id,
+        offsetX: f.offsetX,
+        offsetY: f.offsetY,
+        pivotX: f.pivotX,
+        pivotY: f.pivotY,
+        rotated: f.rotated,
+    }));
+    return createEntity({
+        atlas: spritesheet.atlas,
+        animations: { ...spritesheet.animations },
+        frames,
+    });
+}
+export function createSpritesheet(obj) {
+    return createEntity({
+        atlas: obj?.atlas ?? null,
+        animations: obj?.animations ?? {},
+        frames: obj?.frames ?? [],
+    });
+}
+export function getSpritesheetAnimation(spritesheet, label) {
+    return spritesheet.animations[label] ?? null;
+}
+//# sourceMappingURL=spritesheet.js.map

package/dist/spritesheet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spritesheet.js","sourceRoot":"","sources":["../src/spritesheet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,MAAM,UAAU,gBAAgB,CAAC,WAAkC;IACjE,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC1C,sBAAsB,CAAC;QACrB,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,OAAO,EAAE,CAAC,CAAC,OAAO;KACnB,CAAC,CACH,CAAC;IACF,OAAO,YAAY,CAAC;QAClB,KAAK,EAAE,WAAW,CAAC,KAAK;QACxB,UAAU,EAAE,EAAE,GAAG,WAAW,CAAC,UAAU,EAAE;QACzC,MAAM;KACP,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAA0B;IAC1D,OAAO,YAAY,CAAC;QAClB,KAAK,EAAE,GAAG,EAAE,KAAK,IAAI,IAAI;QACzB,UAAU,EAAE,GAAG,EAAE,UAAU,IAAI,EAAE;QACjC,MAAM,EAAE,GAAG,EAAE,MAAM,IAAI,EAAE;KAC1B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,WAAwB,EAAE,KAAa;IAC7E,OAAO,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;AAC/C,CAAC"}

package/dist/spritesheetAnimation.d.ts

@@ -0,0 +1,4 @@
+import type { Spritesheet, SpritesheetAnimation } from '@flighthq/types';
+export declare function createSpritesheetAnimation(obj?: Partial<SpritesheetAnimation>): SpritesheetAnimation;
+export declare function createSpritesheetAnimationFromFrameNames(spritesheet: Readonly<Spritesheet>, pattern: string | RegExp, options?: Partial<Pick<SpritesheetAnimation, 'direction' | 'frameDuration' | 'frameDurations' | 'loop' | 'originX' | 'originY'>>): SpritesheetAnimation | null;
+//# sourceMappingURL=spritesheetAnimation.d.ts.map

package/dist/spritesheetAnimation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spritesheetAnimation.d.ts","sourceRoot":"","sources":["../src/spritesheetAnimation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEzE,wBAAgB,0BAA0B,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,oBAAoB,CAUpG;AAMD,wBAAgB,wCAAwC,CACtD,WAAW,EAAE,QAAQ,CAAC,WAAW,CAAC,EAClC,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,OAAO,CAAC,EAAE,OAAO,CACf,IAAI,CAAC,oBAAoB,EAAE,WAAW,GAAG,eAAe,GAAG,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC,CAC9G,GACA,oBAAoB,GAAG,IAAI,CA0B7B"}

package/dist/spritesheetAnimation.js

@@ -0,0 +1,48 @@
+import { createEntity } from '@flighthq/entity';
+export function createSpritesheetAnimation(obj) {
+    return createEntity({
+        direction: obj?.direction ?? 'forward',
+        frameDuration: obj?.frameDuration ?? 0,
+        frameDurations: obj?.frameDurations ?? null,
+        frames: obj?.frames ?? [],
+        loop: obj?.loop ?? false,
+        originX: obj?.originX ?? 0,
+        originY: obj?.originY ?? 0,
+    });
+}
+// Builds a `SpritesheetAnimation` by selecting frames from a `Spritesheet` whose atlas region names
+// match the given `pattern`. Pattern may be an exact frame name, a prefix string (matched against
+// the start of each region name), or a `RegExp`. Frames are included in atlas-region index order.
+// Returns null when the spritesheet has no atlas or no regions match the pattern.
+export function createSpritesheetAnimationFromFrameNames(spritesheet, pattern, options) {
+    const { atlas, frames } = spritesheet;
+    if (atlas === null)
+        return null;
+    // Build a name→frame-index map using region names stored on the atlas.
+    const matchedIndices = [];
+    for (let i = 0; i < frames.length; i++) {
+        const regionId = frames[i].id;
+        const region = atlas.regions[regionId];
+        if (region === undefined)
+            continue;
+        const name = region.name;
+        if (name === null)
+            continue;
+        const matches = typeof pattern === 'string' ? name === pattern || name.startsWith(pattern) : pattern.test(name);
+        if (matches) {
+            matchedIndices.push(i);
+        }
+    }
+    if (matchedIndices.length === 0)
+        return null;
+    return createSpritesheetAnimation({
+        direction: options?.direction,
+        frameDuration: options?.frameDuration,
+        frameDurations: options?.frameDurations,
+        frames: matchedIndices,
+        loop: options?.loop,
+        originX: options?.originX,
+        originY: options?.originY,
+    });
+}
+//# sourceMappingURL=spritesheetAnimation.js.map

package/dist/spritesheetAnimation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spritesheetAnimation.js","sourceRoot":"","sources":["../src/spritesheetAnimation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,MAAM,UAAU,0BAA0B,CAAC,GAAmC;IAC5E,OAAO,YAAY,CAAC;QAClB,SAAS,EAAE,GAAG,EAAE,SAAS,IAAI,SAAS;QACtC,aAAa,EAAE,GAAG,EAAE,aAAa,IAAI,CAAC;QACtC,cAAc,EAAE,GAAG,EAAE,cAAc,IAAI,IAAI;QAC3C,MAAM,EAAE,GAAG,EAAE,MAAM,IAAI,EAAE;QACzB,IAAI,EAAE,GAAG,EAAE,IAAI,IAAI,KAAK;QACxB,OAAO,EAAE,GAAG,EAAE,OAAO,IAAI,CAAC;QAC1B,OAAO,EAAE,GAAG,EAAE,OAAO,IAAI,CAAC;KAC3B,CAAC,CAAC;AACL,CAAC;AAED,oGAAoG;AACpG,kGAAkG;AAClG,kGAAkG;AAClG,kFAAkF;AAClF,MAAM,UAAU,wCAAwC,CACtD,WAAkC,EAClC,OAAwB,EACxB,OAEC;IAED,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC;IACtC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,uEAAuE;IACvE,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACvC,IAAI,MAAM,KAAK,SAAS;YAAE,SAAS;QACnC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACzB,IAAI,IAAI,KAAK,IAAI;YAAE,SAAS;QAC5B,MAAM,OAAO,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChH,IAAI,OAAO,EAAE,CAAC;YACZ,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7C,OAAO,0BAA0B,CAAC;QAChC,SAAS,EAAE,OAAO,EAAE,SAAS;QAC7B,aAAa,EAAE,OAAO,EAAE,aAAa;QACrC,cAAc,EAAE,OAAO,EAAE,cAAc;QACvC,MAAM,EAAE,cAAc;QACtB,IAAI,EAAE,OAAO,EAAE,IAAI;QACnB,OAAO,EAAE,OAAO,EAAE,OAAO;QACzB,OAAO,EAAE,OAAO,EAAE,OAAO;KAC1B,CAAC,CAAC;AACL,CAAC"}

package/dist/spritesheetData.d.ts

@@ -0,0 +1,37 @@
+import type { SpritesheetAnimationDirection } from '@flighthq/types';
+export interface SpritesheetAnimationData {
+    direction: SpritesheetAnimationDirection;
+    frameDuration: number;
+    frameDurations: number[] | null;
+    frameNames: string[];
+    loop: boolean;
+    name: string;
+    originX: number;
+    originY: number;
+}
+export interface SpritesheetFrameData {
+    height: number;
+    name: string;
+    offsetX: number;
+    offsetY: number;
+    pivotX: number | null;
+    pivotY: number | null;
+    rotated: boolean;
+    sourceHeight: number;
+    sourceWidth: number;
+    width: number;
+    x: number;
+    y: number;
+}
+export interface SpritesheetData {
+    animations: SpritesheetAnimationData[];
+    frames: SpritesheetFrameData[];
+    imageFile: string;
+    imageHeight: number;
+    imageWidth: number;
+    scale: number;
+}
+export declare function createSpritesheetAnimationData(obj?: Partial<SpritesheetAnimationData>): SpritesheetAnimationData;
+export declare function createSpritesheetData(obj?: Partial<SpritesheetData>): SpritesheetData;
+export declare function createSpritesheetFrameData(obj?: Partial<SpritesheetFrameData>): SpritesheetFrameData;
+//# sourceMappingURL=spritesheetData.d.ts.map

package/dist/spritesheetData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spritesheetData.d.ts","sourceRoot":"","sources":["../src/spritesheetData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AAErE,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,6BAA6B,CAAC;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAChC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,wBAAwB,EAAE,CAAC;IACvC,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,8BAA8B,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,GAAG,wBAAwB,CAWhH;AAED,wBAAgB,qBAAqB,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CASrF;AAED,wBAAgB,0BAA0B,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,oBAAoB,CAepG"}

package/dist/spritesheetData.js

@@ -0,0 +1,39 @@
+export function createSpritesheetAnimationData(obj) {
+    return {
+        direction: obj?.direction ?? 'forward',
+        frameDuration: obj?.frameDuration ?? 100,
+        frameDurations: obj?.frameDurations ?? null,
+        frameNames: obj?.frameNames ?? [],
+        loop: obj?.loop ?? true,
+        name: obj?.name ?? '',
+        originX: obj?.originX ?? 0,
+        originY: obj?.originY ?? 0,
+    };
+}
+export function createSpritesheetData(obj) {
+    return {
+        animations: obj?.animations ?? [],
+        frames: obj?.frames ?? [],
+        imageFile: obj?.imageFile ?? '',
+        imageHeight: obj?.imageHeight ?? 0,
+        imageWidth: obj?.imageWidth ?? 0,
+        scale: obj?.scale ?? 1,
+    };
+}
+export function createSpritesheetFrameData(obj) {
+    return {
+        height: obj?.height ?? 0,
+        name: obj?.name ?? '',
+        offsetX: obj?.offsetX ?? 0,
+        offsetY: obj?.offsetY ?? 0,
+        pivotX: obj?.pivotX ?? null,
+        pivotY: obj?.pivotY ?? null,
+        rotated: obj?.rotated ?? false,
+        sourceHeight: obj?.sourceHeight ?? 0,
+        sourceWidth: obj?.sourceWidth ?? 0,
+        width: obj?.width ?? 0,
+        x: obj?.x ?? 0,
+        y: obj?.y ?? 0,
+    };
+}
+//# sourceMappingURL=spritesheetData.js.map

package/dist/spritesheetData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spritesheetData.js","sourceRoot":"","sources":["../src/spritesheetData.ts"],"names":[],"mappings":"AAqCA,MAAM,UAAU,8BAA8B,CAAC,GAAuC;IACpF,OAAO;QACL,SAAS,EAAE,GAAG,EAAE,SAAS,IAAI,SAAS;QACtC,aAAa,EAAE,GAAG,EAAE,aAAa,IAAI,GAAG;QACxC,cAAc,EAAE,GAAG,EAAE,cAAc,IAAI,IAAI;QAC3C,UAAU,EAAE,GAAG,EAAE,UAAU,IAAI,EAAE;QACjC,IAAI,EAAE,GAAG,EAAE,IAAI,IAAI,IAAI;QACvB,IAAI,EAAE,GAAG,EAAE,IAAI,IAAI,EAAE;QACrB,OAAO,EAAE,GAAG,EAAE,OAAO,IAAI,CAAC;QAC1B,OAAO,EAAE,GAAG,EAAE,OAAO,IAAI,CAAC;KAC3B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAA8B;IAClE,OAAO;QACL,UAAU,EAAE,GAAG,EAAE,UAAU,IAAI,EAAE;QACjC,MAAM,EAAE,GAAG,EAAE,MAAM,IAAI,EAAE;QACzB,SAAS,EAAE,GAAG,EAAE,SAAS,IAAI,EAAE;QAC/B,WAAW,EAAE,GAAG,EAAE,WAAW,IAAI,CAAC;QAClC,UAAU,EAAE,GAAG,EAAE,UAAU,IAAI,CAAC;QAChC,KAAK,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,GAAmC;IAC5E,OAAO;QACL,MAAM,EAAE,GAAG,EAAE,MAAM,IAAI,CAAC;QACxB,IAAI,EAAE,GAAG,EAAE,IAAI,IAAI,EAAE;QACrB,OAAO,EAAE,GAAG,EAAE,OAAO,IAAI,CAAC;QAC1B,OAAO,EAAE,GAAG,EAAE,OAAO,IAAI,CAAC;QAC1B,MAAM,EAAE,GAAG,EAAE,MAAM,IAAI,IAAI;QAC3B,MAAM,EAAE,GAAG,EAAE,MAAM,IAAI,IAAI;QAC3B,OAAO,EAAE,GAAG,EAAE,OAAO,IAAI,KAAK;QAC9B,YAAY,EAAE,GAAG,EAAE,YAAY,IAAI,CAAC;QACpC,WAAW,EAAE,GAAG,EAAE,WAAW,IAAI,CAAC;QAClC,KAAK,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;QACtB,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC;QACd,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC;KACf,CAAC;AACJ,CAAC"}

package/dist/spritesheetFrame.d.ts

@@ -0,0 +1,3 @@
+import type { SpritesheetFrame } from '@flighthq/types';
+export declare function createSpritesheetFrame(obj?: Partial<SpritesheetFrame>): SpritesheetFrame;
+//# sourceMappingURL=spritesheetFrame.d.ts.map

package/dist/spritesheetFrame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spritesheetFrame.d.ts","sourceRoot":"","sources":["../src/spritesheetFrame.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,wBAAgB,sBAAsB,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,CASxF"}

package/dist/spritesheetFrame.js

@@ -0,0 +1,11 @@
+export function createSpritesheetFrame(obj) {
+    return {
+        id: obj?.id ?? 0,
+        offsetX: obj?.offsetX ?? 0,
+        offsetY: obj?.offsetY ?? 0,
+        pivotX: obj?.pivotX ?? null,
+        pivotY: obj?.pivotY ?? null,
+        rotated: obj?.rotated ?? false,
+    };
+}
+//# sourceMappingURL=spritesheetFrame.js.map

package/dist/spritesheetFrame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spritesheetFrame.js","sourceRoot":"","sources":["../src/spritesheetFrame.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,sBAAsB,CAAC,GAA+B;IACpE,OAAO;QACL,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,CAAC;QAChB,OAAO,EAAE,GAAG,EAAE,OAAO,IAAI,CAAC;QAC1B,OAAO,EAAE,GAAG,EAAE,OAAO,IAAI,CAAC;QAC1B,MAAM,EAAE,GAAG,EAAE,MAAM,IAAI,IAAI;QAC3B,MAAM,EAAE,GAAG,EAAE,MAAM,IAAI,IAAI;QAC3B,OAAO,EAAE,GAAG,EAAE,OAAO,IAAI,KAAK;KAC/B,CAAC;AACJ,CAAC"}

package/dist/spritesheetFrom.d.ts

@@ -0,0 +1,6 @@
+import type { GridSliceOptions, Spritesheet, TextureAtlas, Tileset } from '@flighthq/types';
+import type { SpritesheetData } from './spritesheetData';
+export declare function createSpritesheetFromData(data: Readonly<SpritesheetData>, atlas: Readonly<TextureAtlas>): Spritesheet;
+export declare function createSpritesheetFromGrid(options: Readonly<GridSliceOptions>): Spritesheet;
+export declare function createSpritesheetFromTileset(tileset: Tileset): Spritesheet;
+//# sourceMappingURL=spritesheetFrom.d.ts.map

package/dist/spritesheetFrom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spritesheetFrom.d.ts","sourceRoot":"","sources":["../src/spritesheetFrom.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAwB,YAAY,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAIlH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAOzD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,WAAW,CA8CrH;AAMD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,WAAW,CAmC1F;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAI1E"}

package/dist/spritesheetFrom.js

@@ -0,0 +1,90 @@
+import { createTextureAtlas, createTextureAtlasRegion } from '@flighthq/textureatlas';
+import { createSpritesheet } from './spritesheet';
+import { createSpritesheetAnimation } from './spritesheetAnimation';
+import { createSpritesheetFrame } from './spritesheetFrame';
+// Hydrates a runtime `Spritesheet` from a `SpritesheetData` descriptor and a pre-built `TextureAtlas`.
+// Resolves `frameNames` to atlas region IDs via name lookup (or positional index when a name is absent),
+// carries `direction`, `frameDurations`, pivot, and rotation onto the runtime types, and builds the
+// `animations` record keyed by `SpritesheetAnimationData.name`.
+export function createSpritesheetFromData(data, atlas) {
+    // Build a name→region-id map for fast frame name lookup.
+    const nameToRegionId = new Map();
+    for (const region of atlas.regions) {
+        if (region.name !== null) {
+            nameToRegionId.set(region.name, region.id);
+        }
+    }
+    // Build runtime frames — one per SpritesheetFrameData entry, resolved to an atlas region id.
+    const frames = data.frames.map((fd, index) => {
+        const regionId = fd.name !== '' ? (nameToRegionId.get(fd.name) ?? index) : index;
+        return createSpritesheetFrame({
+            id: regionId,
+            offsetX: fd.offsetX,
+            offsetY: fd.offsetY,
+            pivotX: fd.pivotX,
+            pivotY: fd.pivotY,
+            rotated: fd.rotated,
+        });
+    });
+    // Build a frame-name → frame-index map for animation frameNames resolution.
+    const frameNameToIndex = new Map();
+    for (let i = 0; i < data.frames.length; i++) {
+        const name = data.frames[i].name;
+        if (name !== '') {
+            frameNameToIndex.set(name, i);
+        }
+    }
+    // Build runtime animations keyed by name.
+    const animations = {};
+    for (const ad of data.animations) {
+        const resolvedFrames = ad.frameNames.length > 0
+            ? ad.frameNames.map((n) => frameNameToIndex.get(n)).filter((i) => i !== undefined)
+            : Array.from({ length: data.frames.length }, (_, i) => i);
+        animations[ad.name] = createSpritesheetAnimation({
+            direction: ad.direction,
+            frameDuration: ad.frameDuration,
+            frameDurations: ad.frameDurations,
+            frames: resolvedFrames,
+            loop: ad.loop,
+            originX: ad.originX,
+            originY: ad.originY,
+        });
+    }
+    return createSpritesheet({ animations, atlas, frames });
+}
+// Builds a runtime `Spritesheet` by slicing a regular grid out of a source image.
+// `frameWidth`/`frameHeight` default to the largest cell that fits after margins and inter-cell spacing.
+// Frames are generated row-major (left-to-right, top-to-bottom), each backed by an atlas region named
+// `${namePrefix}${id}`.
+export function createSpritesheetFromGrid(options) {
+    const { columns, rows, imageWidth, imageHeight, marginX = 0, marginY = 0, spacingX = 0, spacingY = 0, namePrefix = 'frame_', } = options;
+    const frameWidth = options.frameWidth ?? Math.floor((imageWidth - 2 * marginX - spacingX * (columns - 1)) / columns);
+    const frameHeight = options.frameHeight ?? Math.floor((imageHeight - 2 * marginY - spacingY * (rows - 1)) / rows);
+    const atlas = createTextureAtlas();
+    const frames = [];
+    let id = 0;
+    for (let row = 0; row < rows; row++) {
+        for (let col = 0; col < columns; col++) {
+            const x = marginX + col * (frameWidth + spacingX);
+            const y = marginY + row * (frameHeight + spacingY);
+            const region = createTextureAtlasRegion({
+                height: frameHeight,
+                id,
+                name: `${namePrefix}${id}`,
+                width: frameWidth,
+                x,
+                y,
+            });
+            atlas.regions.push(region);
+            frames.push(createSpritesheetFrame({ id }));
+            id++;
+        }
+    }
+    return createSpritesheet({ atlas, frames });
+}
+export function createSpritesheetFromTileset(tileset) {
+    const { atlas } = tileset;
+    const frames = (atlas?.regions ?? []).map((region) => createSpritesheetFrame({ id: region.id }));
+    return createSpritesheet({ atlas, frames });
+}
+//# sourceMappingURL=spritesheetFrom.js.map

package/dist/spritesheetFrom.js.map

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

package/dist/spritesheetPlayer.d.ts

@@ -0,0 +1,17 @@
+import type { Spritesheet, SpritesheetAnimation, SpritesheetFrame, SpritesheetPlayer } from '@flighthq/types';
+export declare function acquireSpritesheetPlayer(): SpritesheetPlayer;
+export declare function cloneSpritesheetPlayer(player: Readonly<SpritesheetPlayer>): SpritesheetPlayer;
+export declare function createSpritesheetPlayer(obj?: Partial<SpritesheetPlayer>): SpritesheetPlayer;
+export declare function disposeSpritesheetPlayer(player: SpritesheetPlayer): void;
+export declare function getSpritesheetPlayerFrame(player: Readonly<SpritesheetPlayer>, spritesheet: Readonly<Spritesheet>): SpritesheetFrame | null;
+export declare function getSpritesheetPlayerFrameAt(player: Readonly<SpritesheetPlayer>, spritesheet: Readonly<Spritesheet>, frameOffset: number): SpritesheetFrame | null;
+export declare function pauseSpritesheetPlayer(player: SpritesheetPlayer): void;
+export declare function playSpritesheetAnimation(player: SpritesheetPlayer, animation: Readonly<SpritesheetAnimation> | null, restart?: boolean): void;
+export declare function queueSpritesheetAnimation(player: SpritesheetPlayer, animation: Readonly<SpritesheetAnimation>): void;
+export declare function releaseSpritesheetPlayer(player: SpritesheetPlayer): void;
+export declare function resumeSpritesheetPlayer(player: SpritesheetPlayer): void;
+export declare function seekSpritesheetPlayerToFrame(player: SpritesheetPlayer, frameIndex: number): void;
+export declare function seekSpritesheetPlayerToTime(player: SpritesheetPlayer, time: number): void;
+export declare function stopSpritesheetPlayer(player: SpritesheetPlayer): void;
+export declare function updateSpritesheetPlayer(player: SpritesheetPlayer, deltaTime: number): boolean;
+//# sourceMappingURL=spritesheetPlayer.d.ts.map

package/dist/spritesheetPlayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spritesheetPlayer.d.ts","sourceRoot":"","sources":["../src/spritesheetPlayer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE9G,wBAAgB,wBAAwB,IAAI,iBAAiB,CAc5D;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GAAG,iBAAiB,CAY7F;AAED,wBAAgB,uBAAuB,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,iBAAiB,CAY3F;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAMxE;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EACnC,WAAW,EAAE,QAAQ,CAAC,WAAW,CAAC,GACjC,gBAAgB,GAAG,IAAI,CAKzB;AAOD,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EACnC,WAAW,EAAE,QAAQ,CAAC,WAAW,CAAC,EAClC,WAAW,EAAE,MAAM,GAClB,gBAAgB,GAAG,IAAI,CAQzB;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAEtE;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,IAAI,EAChD,OAAO,UAAO,GACb,IAAI,CAON;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAEpH;AAKD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAWxE;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAEvE;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAQhG;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAMzF;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAKrE;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CA4B7F"}