@nodecraft/rendermite 1.2.1 → 1.3.0

package/README.md

@@ -91,6 +91,14 @@ Everything the CLI does is exported, from the high-level `run()` and `exportBloc
 import { run, exportBlockPack, prepareModResources, builtinPackPath } from '@nodecraft/rendermite';
 ```
 
+Reading a published block pack needs none of that toolchain, so it has its own entry — no `sharp`,
+no `node:` builtin, 13 KB bundled:
+
+```ts
+import { evaluateBlockState } from '@nodecraft/rendermite/pack';
+import type { BlockPackModel } from '@nodecraft/rendermite/pack';
+```
+
 ## Performance
 
 Benchmarked against PHP renderchest v5.1.0 on the same machine, rendering the same extracted 1.21.8 assets at 64px (PNG + WebP):

package/dist/blocks/pack-format.d.ts

@@ -0,0 +1,2 @@
+import { a as BlockPackElement, c as BlockPackModel, d as BlockPackSprite, f as BlockPackSpriteFrame, i as BlockPackBlockStatesFile, l as BlockPackModelsFile, n as BlockPackAtlasPage, o as BlockPackFace, p as BlockPackTintsFile, r as BlockPackBlockState, s as BlockPackMetaFile, t as BlockPackAtlasFile, u as BlockPackRenderLayer } from "../pack-format-BO2FsorN.js";
+export { BlockPackAtlasFile, BlockPackAtlasPage, BlockPackBlockState, BlockPackBlockStatesFile, BlockPackElement, BlockPackFace, BlockPackMetaFile, BlockPackModel, BlockPackModelsFile, BlockPackRenderLayer, BlockPackSprite, BlockPackSpriteFrame, BlockPackTintsFile };

package/dist/blocks/pack-format.js

@@ -0,0 +1 @@
+export {};

package/dist/pack-format-BO2FsorN.d.ts

@@ -0,0 +1,121 @@
+import { a as FaceDirectionName, l as Vec3, o as ModelElementJson, u as Vec4 } from "./types-qlp3I8_-.js";
+import { r as BlockStateDefinition } from "./blockstate-eval-CObtPWzJ.js";
+import { t as MeshGroup } from "./obj-mesh-C6Sp4Ysc.js";
+import { n as BlockTintPack } from "./tints-2k3ZhkY3.js";
+//#region src/blocks/pack-format.d.ts
+/** How a sprite's alpha classifies it, inferred because assets rarely say. */
+type BlockPackRenderLayer = 'solid' | 'cutout' | 'translucent';
+interface BlockPackFace {
+  sprite: string;
+  /** [u1, v1, u2, v2] in 0–16 sprite space, derived when the model omits it. */
+  uv: Vec4;
+  rotation?: number;
+  tintindex?: number;
+  cullface?: FaceDirectionName;
+}
+interface BlockPackElement {
+  from: Vec3;
+  to: Vec3;
+  rotation?: ModelElementJson['rotation'];
+  shade?: false;
+  faces: Partial<Record<FaceDirectionName, BlockPackFace>>;
+}
+interface BlockPackModel {
+  ao: boolean;
+  elements: BlockPackElement[];
+  /**
+   * The model's `particle` texture. What the game throws when the block breaks
+   * or is walked on, and the only colour a consumer has to work with for a
+   * block that draws nothing — a placeholder cube for a chest comes out oak
+   * rather than magenta.
+   */
+  particle?: string;
+  /** Triangle geometry from an OBJ loader, when the model uses one. */
+  mesh?: MeshGroup[];
+  /**
+   * The layer the model states it draws on. Authoritative where present, and
+   * it beats the per-sprite alpha inference — the same sprite can be solid in
+   * one model and translucent in another.
+   */
+  renderType?: BlockPackRenderLayer;
+  /** Block offsets a split-multiblock mesh spans. */
+  multiblock?: Array<[number, number, number]>;
+  /**
+   * Present when the block is a fluid, whose real surface height and flow
+   * direction come from its neighbours and so cannot be baked. The cube here is
+   * a stand-in; these are the sheets to mesh the real thing with.
+   */
+  fluid?: {
+    still: string;
+    flow: string;
+    overlay?: string;
+  };
+}
+interface BlockPackSpriteFrame {
+  page: number;
+  x: number;
+  y: number;
+  /** Duration in game ticks. */
+  time: number;
+}
+interface BlockPackSprite {
+  page: number;
+  x: number;
+  y: number;
+  w: number;
+  h: number;
+  layer: BlockPackRenderLayer;
+  /** The displayed sequence, which can revisit a frame; absent when static. */
+  frames?: BlockPackSpriteFrame[];
+  interpolate?: true;
+}
+interface BlockPackAtlasPage {
+  file: string;
+  width: number;
+  height: number;
+}
+/** `atlas.json`. */
+interface BlockPackAtlasFile {
+  /** Edge-extended border per sprite, in pixels. */
+  padding: number;
+  pages: BlockPackAtlasPage[];
+  sprites: Record<string, BlockPackSprite>;
+}
+/** `models.json`, by fully-qualified model id. */
+type BlockPackModelsFile = Record<string, BlockPackModel>;
+/** `blockstates.json`, by block id, with keys and predicates already parsed. */
+type BlockPackBlockStatesFile = Record<string, BlockPackBlockState>;
+/**
+ * One block's cases as the pack writes them: the tagged union `evaluateBlockState`
+ * takes, flattened to the key the file uses.
+ */
+type BlockPackBlockState = {
+  variants: Extract<BlockStateDefinition, {
+    kind: 'variants';
+  }>['cases'];
+  multipart?: undefined;
+} | {
+  multipart: Extract<BlockStateDefinition, {
+    kind: 'multipart';
+  }>['cases'];
+  variants?: undefined;
+};
+/** `tints.json`. */
+type BlockPackTintsFile = BlockTintPack;
+/** `meta.json`, written last because it hashes every other file. */
+interface BlockPackMetaFile {
+  generator: string;
+  version: string;
+  namespaces: string[];
+  counts: {
+    blocks: number;
+    models: number;
+    sprites: number;
+    pages: number;
+    failures: number;
+  };
+  /** sha256 per file, enough to verify a cached copy without refetching it. */
+  hashes: Record<string, string>;
+}
+//#endregion
+export { BlockPackElement as a, BlockPackModel as c, BlockPackSprite as d, BlockPackSpriteFrame as f, BlockPackBlockStatesFile as i, BlockPackModelsFile as l, BlockPackAtlasPage as n, BlockPackFace as o, BlockPackTintsFile as p, BlockPackBlockState as r, BlockPackMetaFile as s, BlockPackAtlasFile as t, BlockPackRenderLayer as u };

package/dist/pack.d.ts

@@ -0,0 +1,5 @@
+import { a as BlockStateMultipartCase, d as matchesCondition, n as BlockProperties, o as BlockStateVariantCase, p as weightedVariantIndex, r as BlockStateDefinition, s as MultipartCondition, t as BlockModelVariant, u as evaluateBlockState } from "./blockstate-eval-CObtPWzJ.js";
+import { n as ObjMesh, t as MeshGroup } from "./obj-mesh-C6Sp4Ysc.js";
+import { n as BlockTintPack, t as BlockTint } from "./tints-2k3ZhkY3.js";
+import { a as BlockPackElement, c as BlockPackModel, d as BlockPackSprite, f as BlockPackSpriteFrame, i as BlockPackBlockStatesFile, l as BlockPackModelsFile, n as BlockPackAtlasPage, o as BlockPackFace, p as BlockPackTintsFile, r as BlockPackBlockState, s as BlockPackMetaFile, t as BlockPackAtlasFile, u as BlockPackRenderLayer } from "./pack-format-BO2FsorN.js";
+export { type BlockModelVariant, type BlockPackAtlasFile, type BlockPackAtlasPage, type BlockPackBlockState, type BlockPackBlockStatesFile, type BlockPackElement, type BlockPackFace, type BlockPackMetaFile, type BlockPackModel, type BlockPackModelsFile, type BlockPackRenderLayer, type BlockPackSprite, type BlockPackSpriteFrame, type BlockPackTintsFile, type BlockProperties, type BlockStateDefinition, type BlockStateMultipartCase, type BlockStateVariantCase, type BlockTint, type BlockTintPack, type MeshGroup, type MultipartCondition, type ObjMesh, evaluateBlockState, matchesCondition, weightedVariantIndex };

package/dist/pack.js

@@ -0,0 +1,2 @@
+import { i as matchesCondition, o as weightedVariantIndex, r as evaluateBlockState } from "./blockstate-eval-BRQ3NWY2.js";
+export { evaluateBlockState, matchesCondition, weightedVariantIndex };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nodecraft/rendermite",
-	"version": "1.2.1",
+	"version": "1.3.0",
 	"description": "Minecraft item icon renderer: renders inventory-identical item icons from vanilla and modded assets across game versions, outputting optimized PNG/WebP/AVIF plus CSS and a JSON item library.",
 	"type": "module",
 	"license": "MIT",
@@ -28,6 +28,10 @@
 		".": {
 			"types": "./dist/index.d.ts",
 			"import": "./dist/index.js"
+		},
+		"./pack": {
+			"types": "./dist/pack.d.ts",
+			"import": "./dist/pack.js"
 		}
 	},
 	"files": [
@@ -65,6 +69,7 @@
 		"@types/yazl": "3.3.1",
 		"eslint": "10.8.0",
 		"rimraf": "6.1.3",
+		"rolldown": "1.2.3",
 		"semantic-release": "25.0.9",
 		"tsdown": "0.22.14",
 		"typescript": "6.0.3",