@rickyzhangca/fpsr 0.0.1

package/dist/profile-CTN1Q5SI.d.ts

@@ -0,0 +1,365 @@
+import { m as FrameId, y as RenderLayerName } from "./render-db-BFQIspDB.js";
+
+//#region src/types/draw-list.d.ts
+/**
+ * Full Factorio `RenderLayer` enum (lowest → highest).
+ * Source: https://lua-api.factorio.com/latest/types/RenderLayer.html
+ * (same data as Factorio.app `doc-html/prototype-api.json`, 2.1.11).
+ * Values are the enum indices; order is the contract.
+ */
+declare const FACTORIO_RENDER_LAYERS: {
+  readonly zero: 0;
+  readonly "background-transitions": 1;
+  readonly "under-tiles": 2;
+  readonly decals: 3;
+  readonly "above-tiles": 4;
+  readonly "ground-layer-1": 5;
+  readonly "ground-layer-2": 6;
+  readonly "ground-layer-3": 7;
+  readonly "ground-layer-4": 8;
+  readonly "ground-layer-5": 9;
+  readonly "lower-radius-visualization": 10;
+  readonly "radius-visualization": 11;
+  readonly "transport-belt-integration": 12;
+  readonly resource: 13;
+  readonly "building-smoke": 14;
+  readonly "rail-stone-path-lower": 15;
+  readonly "rail-stone-path": 16;
+  readonly "rail-tie": 17;
+  readonly decorative: 18;
+  readonly "ground-patch": 19;
+  readonly "ground-patch-higher": 20;
+  readonly "ground-patch-higher2": 21;
+  readonly "rail-chain-signal-metal": 22;
+  readonly "rail-screw": 23;
+  readonly "rail-metal": 24;
+  readonly remnants: 25;
+  readonly floor: 26;
+  readonly "transport-belt": 27;
+  readonly "transport-belt-endings": 28;
+  readonly "floor-mechanics-under-corpse": 29;
+  readonly corpse: 30;
+  readonly "floor-mechanics": 31;
+  readonly item: 32;
+  readonly "transport-belt-reader": 33;
+  readonly "lower-object": 34;
+  readonly "transport-belt-circuit-connector": 35;
+  readonly "lower-object-above-shadow": 36;
+  readonly "lower-object-overlay": 37;
+  readonly "object-under": 38;
+  readonly object: 39;
+  readonly "cargo-hatch": 40;
+  readonly "higher-object-under": 41;
+  readonly "higher-object-above": 42;
+  readonly "train-stop-top": 43;
+  readonly "item-in-inserter-hand": 44;
+  readonly "above-inserters": 45;
+  readonly wires: 46;
+  readonly "under-elevated": 47;
+  readonly "elevated-rail-stone-path-lower": 48;
+  readonly "elevated-rail-stone-path": 49;
+  readonly "elevated-rail-tie": 50;
+  readonly "elevated-rail-screw": 51;
+  readonly "elevated-rail-metal": 52;
+  readonly "elevated-lower-object": 53;
+  readonly "elevated-object": 54;
+  readonly "elevated-higher-object": 55;
+  readonly "fluid-visualization": 56;
+  readonly "wires-above": 57;
+  readonly "entity-info-icon": 58;
+  readonly "entity-info-icon-above": 59;
+  readonly explosion: 60;
+  readonly projectile: 61;
+  readonly smoke: 62;
+  readonly "air-object": 63;
+  readonly "air-entity-info-icon": 64;
+  readonly "light-effect": 65;
+  readonly "selection-box": 66;
+  readonly "higher-selection-box": 67;
+  readonly "collision-selection-box": 68;
+  readonly arrow: 69;
+  readonly cursor: 70;
+};
+declare const RENDER_LAYERS: Record<RenderLayerName, number>;
+interface DrawCmdBase {
+  /** Numeric layer from RENDER_LAYERS. */
+  layer: number;
+  /** Y-sort key within the layer (entity collision-box bottom; 0 for non-object layers). */
+  sortY: number;
+  /**
+   * X-sort key within the layer (entity position.x for object layers; 0 otherwise).
+   * Same-Y neighbors paint west→east so baked hood shadows don’t cover eastern sprites.
+   */
+  sortX: number;
+  /** Owning entity_number (0 for tiles/background), for stable sort + debugging. */
+  entity: number;
+  /** Intra-entity sub-layer index. */
+  sub: number;
+}
+interface RectCmd extends DrawCmdBase {
+  kind: "rect";
+  x: number;
+  y: number;
+  w: number;
+  h: number;
+  color: [number, number, number, number];
+}
+interface SpriteCmd extends DrawCmdBase {
+  kind: "sprite";
+  frame: FrameId;
+  x: number;
+  y: number;
+  w: number;
+  h: number;
+  tint?: [number, number, number, number];
+  shadow?: boolean;
+  flipX?: boolean;
+  flipY?: boolean;
+  /** Clockwise degrees around the sprite center. */
+  rotation?: number;
+  /**
+   * Continue a small interior band beyond the authored destination. Legacy
+   * lower rail-bed sprites have sparse alpha-feathered ends that can otherwise
+   * expose terrain where straight and curved pieces meet.
+   */
+  seamBleed?: {
+    top?: true;
+    right?: true;
+    bottom?: true;
+    left?: true;
+  };
+  /**
+   * Optional sub-rect within the untrimmed source sprite (`FrameMeta.sw`×`sh`,
+   * pixels). When set, `x`/`y`/`w`/`h` are the destination rect for this slice.
+   */
+  src?: {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+  };
+  /**
+   * Optional destination-space clip rect (tile units, same space as x/y/w/h).
+   * Backend applies before drawing; used for UG/loader belt underlay halves.
+   */
+  clip?: {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+  };
+}
+interface WireCmd extends DrawCmdBase {
+  kind: "wire";
+  /** Wire color / copper. */
+  wire: "copper" | "red" | "green";
+  x1: number;
+  y1: number;
+  x2: number;
+  y2: number;
+}
+/**
+ * Rolling-stock coupling overlay: straight neon-green segments between joints
+ * plus hollow circles at each bogie joint.
+ */
+interface TrainChainCmd extends DrawCmdBase {
+  kind: "train-chain";
+  segments: {
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+  }[];
+  joints: {
+    x: number;
+    y: number;
+  }[];
+}
+/** Alt-mode entity-info icon, badge, backing, or directional indicator. */
+interface IconCmd extends DrawCmdBase {
+  kind: "icon";
+  frame: FrameId;
+  x: number;
+  y: number;
+  /** Destination size in tiles (square). */
+  size: number;
+  /** Draw a dark rounded backing behind the icon (recipe badge). */
+  backing?: boolean;
+  /** Atlas-backed Factorio entity-info background; preferred over synthetic backing. */
+  backingFrame?: FrameId;
+  /** Draw the entity-info black silhouette even when no backing is present. */
+  silhouette?: boolean;
+  /**
+   * How to composite `backingFrame` / silhouette:
+   * - `entity-info` (default): soft dark disc + black silhouette + color icon
+   * - `request-pin`: cyan item-request pin at full alpha, color icon only (no silhouette)
+   */
+  backingStyle?: "entity-info" | "request-pin";
+  /** Clockwise degrees around the icon center. */
+  rotation?: number;
+}
+/**
+ * Blueprint snap-to-grid visualization: dashed green perimeter along the snap cell.
+ */
+interface SnapGridCmd extends DrawCmdBase {
+  kind: "snap-grid";
+  x: number;
+  y: number;
+  w: number;
+  h: number;
+}
+/** Canvas text label in tile space (e.g. deconstruction planner section headers). */
+interface TextCmd extends DrawCmdBase {
+  kind: "text";
+  text: string;
+  x: number;
+  y: number;
+  /** Font size in tiles (scaled by pixels-per-tile at execute time). */
+  size: number;
+  color: [number, number, number, number];
+  align?: "left" | "center" | "right";
+  baseline?: "top" | "middle" | "alphabetic";
+}
+type DrawCmd = RectCmd | SpriteCmd | WireCmd | TrainChainCmd | IconCmd | SnapGridCmd | TextCmd;
+interface DrawListBounds {
+  minX: number;
+  minY: number;
+  maxX: number;
+  maxY: number;
+}
+interface DrawList {
+  schema: 1;
+  bounds: DrawListBounds;
+  /** Already sorted by (layer, sortY, sortX, entity, sub); backend executes in order. */
+  commands: DrawCmd[];
+}
+/** Comparator implementing the contract sort order. */
+declare function compareDrawCmd(a: DrawCmd, b: DrawCmd): number;
+/**
+ * Canonical serialization for Tier-2 snapshots: stable key order, numbers
+ * rounded to 4 decimals, one command per line for reviewable diffs.
+ */
+declare function serializeDrawList(list: DrawList): string;
+//#endregion
+//#region src/frame.d.ts
+/** Integer tile-space viewport used for canvas sizing and pan (maps minX/minY to pixel 0). */
+interface TileFrame {
+  minX: number;
+  minY: number;
+  maxX: number;
+  maxY: number;
+}
+/**
+ * Tile-aligned viewport from draw-list visual bounds, optionally plus `padTiles`
+ * on each side. Visual bounds already include sprite overhang, shadows, and wires;
+ * `padTiles` defaults to 0 in the renderer. All edges are integers so the canvas is
+ * an exact multiple of `pixelsPerTile` with no fragmented checker cells.
+ */
+declare function computeTileFrame(bounds: DrawListBounds, padTiles: number): TileFrame;
+//#endregion
+//#region src/profile.d.ts
+/** High-resolution clock; falls back to Date.now in exotic hosts. */
+declare function nowMs(): number;
+/** Best-effort Performance API mark (ignored when unavailable). */
+declare function perfMark(name: string): void;
+/** Best-effort Performance API measure between two marks. */
+declare function perfMeasure(name: string, startMark: string, endMark: string): void;
+interface DecodeStats {
+  mode: "compressed" | "json";
+  inputChars: number;
+  /** Base64-decoded zlib payload length (compressed mode only). */
+  compressedBytes?: number;
+  /** Inflated UTF-8 byte length (compressed mode only). */
+  inflatedBytes?: number;
+  /** JSON text character length. */
+  jsonChars: number;
+  /** inflatedBytes / compressedBytes when both known. */
+  compressionRatio?: number;
+  timings: {
+    totalMs: number;
+    base64Ms?: number;
+    inflateMs?: number;
+    utf8Ms?: number;
+    jsonParseMs: number;
+    validateMs: number;
+  };
+}
+interface PlanProfile {
+  migrateMs: number;
+  resolveMs: number;
+  tilesMs: number;
+  entitiesMs: number;
+  overlaysMs: number;
+  sortMs: number;
+  totalMs: number;
+}
+type AssetEventKind = "render-db" | "manifest" | "atlas";
+interface AssetEvent {
+  kind: AssetEventKind;
+  /** Atlas index when kind === "atlas". */
+  index?: number;
+  tier?: "1x" | "2x";
+  url?: string;
+  cached: boolean;
+  fetchMs?: number;
+  /** Time spent waiting for an available image decoder slot. */
+  queueMs?: number;
+  decodeMs?: number;
+  /** Decoded atlas area, independent of compressed blob size. */
+  decodedPixels?: number;
+  totalMs: number;
+  bytes?: number;
+}
+interface DrawListStats {
+  commandCount: number;
+  byKind: Record<string, number>;
+  uniqueFrames: number;
+  /** layer number → command count */
+  layerHistogram: Record<string, number>;
+  atlasIndices: number[];
+}
+interface RenderProfile {
+  selectMs: number;
+  plan: PlanProfile;
+  assets: AssetEvent[];
+  /** Wall-clock for the parallel atlas load phase (not sum of per-atlas times). */
+  assetsMs: number;
+  iconBakeMs: number;
+  iconBakeCount: number;
+  silhouetteBakeCount: number;
+  iconCacheHits: number;
+  iconCacheMisses: number;
+  silhouetteCacheHits: number;
+  silhouetteCacheMisses: number;
+  frameMs: number;
+  paintMs: number;
+  shadow: {
+    runs: number;
+    tiles: number;
+    compositedPixels: number;
+    peakScratchPixels: number;
+  };
+  totalMs: number;
+  /** True when any atlas referenced by this render was not already cached. */
+  cold: boolean;
+  drawList: DrawListStats;
+  output: {
+    width: number;
+    height: number;
+    megapixels: number;
+    pixelsPerTile: number;
+    requestedPixelsPerTile: number;
+    capped: boolean;
+    assetTier: "1x" | "2x";
+    tileFrame: TileFrame;
+  };
+  db: {
+    entityDefs: number;
+    tileDefs: number;
+    frameCount: number;
+    atlasCount: number;
+  };
+}
+//#endregion
+export { WireCmd as C, TrainChainCmd as S, serializeDrawList as T, RENDER_LAYERS as _, PlanProfile as a, SpriteCmd as b, perfMark as c, computeTileFrame as d, DrawCmd as f, IconCmd as g, FACTORIO_RENDER_LAYERS as h, DrawListStats as i, perfMeasure as l, DrawListBounds as m, AssetEventKind as n, RenderProfile as o, DrawList as p, DecodeStats as r, nowMs as s, AssetEvent as t, TileFrame as u, RectCmd as v, compareDrawCmd as w, TextCmd as x, SnapGridCmd as y };
+//# sourceMappingURL=profile-CTN1Q5SI.d.ts.map

package/dist/profile-CTN1Q5SI.d.ts.map

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