@flighthq/shading 0.5.1-next.815.cc08b93 → 0.5.1-next.903.f434bc2

package/README.md

@@ -13,5 +13,5 @@ Import the supported application-facing API from `@flighthq/shading`. The `@flig
 This package is part of the locked-version Flight SDK graph. Applications may instead install and import `@flighthq/sdk` when package-level tree shaking is sufficient.
 
 - [Flight project](https://github.com/flighthq/flight)
-- [Source for @flighthq/shading@0.5.1-next.815.cc08b93](https://github.com/flighthq/flight/tree/cc08b93ef981080fa86bdd5143dc61dbdbf2665b/packages/shading)
-- [License](https://github.com/flighthq/flight/blob/cc08b93ef981080fa86bdd5143dc61dbdbf2665b/LICENSE.md)
+- [Source for @flighthq/shading@0.5.1-next.903.f434bc2](https://github.com/flighthq/flight/tree/f434bc233778d75aeea61995df3a8cfaec459a85/packages/shading)
+- [License](https://github.com/flighthq/flight/blob/f434bc233778d75aeea61995df3a8cfaec459a85/LICENSE.md)

package/dist/contract.d.ts

@@ -1,4 +1,5 @@
 export * from './createAnimatedNormalModifier';
+export * from './modifier';
 export * from './createDissolveModifier';
 export * from './createEmissiveModifier';
 export * from './createEnvReflectModifier';
@@ -14,4 +15,14 @@ export * from './isModifierStackValid';
 export * from './modifierRegistry';
 export * from './orderModifierStack';
 export * from './registerBuiltInModifiers';
+export { initializeVertexDisplaceModifier } from './createVertexDisplaceModifier';
+export { initializeShadedMaterial } from './createShadedMaterial';
+export { initializeEnvReflectModifier } from './createEnvReflectModifier';
+export { initializeEmissiveModifier } from './createEmissiveModifier';
+export { initializeAnimatedNormalModifier } from './createAnimatedNormalModifier';
+export { initializeToonModifier } from './createToonModifier';
+export { initializeDissolveModifier } from './createDissolveModifier';
+export { initializeFogModifier } from './createFogModifier';
+export { initializeRimModifier } from './createRimModifier';
+export { initializeModifierRegistry } from './modifierRegistry';
 //# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC"}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAAE,gCAAgC,EAAE,MAAM,gCAAgC,CAAC;AAClF,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,gCAAgC,EAAE,MAAM,gCAAgC,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/contract.js

@@ -1,4 +1,5 @@
 export * from './createAnimatedNormalModifier';
+export * from './modifier';
 export * from './createDissolveModifier';
 export * from './createEmissiveModifier';
 export * from './createEnvReflectModifier';
@@ -14,4 +15,14 @@ export * from './isModifierStackValid';
 export * from './modifierRegistry';
 export * from './orderModifierStack';
 export * from './registerBuiltInModifiers';
+export { initializeVertexDisplaceModifier } from './createVertexDisplaceModifier';
+export { initializeShadedMaterial } from './createShadedMaterial';
+export { initializeEnvReflectModifier } from './createEnvReflectModifier';
+export { initializeEmissiveModifier } from './createEmissiveModifier';
+export { initializeAnimatedNormalModifier } from './createAnimatedNormalModifier';
+export { initializeToonModifier } from './createToonModifier';
+export { initializeDissolveModifier } from './createDissolveModifier';
+export { initializeFogModifier } from './createFogModifier';
+export { initializeRimModifier } from './createRimModifier';
+export { initializeModifierRegistry } from './modifierRegistry';
 //# sourceMappingURL=contract.js.map

package/dist/contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC"}
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAAE,gCAAgC,EAAE,MAAM,gCAAgC,CAAC;AAClF,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,gCAAgC,EAAE,MAAM,gCAAgC,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/createAnimatedNormalModifier.d.ts

@@ -1,3 +1,4 @@
-import type { AnimatedNormalModifier, AnimatedNormalModifierOptions, NonEntityCreateResult } from '@flighthq/types/contract';
-export declare function createAnimatedNormalModifier(options: Readonly<AnimatedNormalModifierOptions>): NonEntityCreateResult<AnimatedNormalModifier, 'descriptor'>;
+import type { AnimatedNormalModifier, AnimatedNormalModifierOptions, EntityConstruction } from '@flighthq/types/contract';
+export declare function createAnimatedNormalModifier(options: Readonly<AnimatedNormalModifierOptions>): AnimatedNormalModifier;
+export declare function initializeAnimatedNormalModifier(out: EntityConstruction<AnimatedNormalModifier>, options: Readonly<AnimatedNormalModifierOptions>): void;
 //# sourceMappingURL=createAnimatedNormalModifier.d.ts.map

package/dist/createAnimatedNormalModifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createAnimatedNormalModifier.d.ts","sourceRoot":"","sources":["../src/createAnimatedNormalModifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,6BAA6B,EAC7B,qBAAqB,EACtB,MAAM,0BAA0B,CAAC;AAclC,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,QAAQ,CAAC,6BAA6B,CAAC,GAC/C,qBAAqB,CAAC,sBAAsB,EAAE,YAAY,CAAC,CAW7D"}
+{"version":3,"file":"createAnimatedNormalModifier.d.ts","sourceRoot":"","sources":["../src/createAnimatedNormalModifier.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,sBAAsB,EACtB,6BAA6B,EAC7B,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAUlC,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,QAAQ,CAAC,6BAA6B,CAAC,GAAG,sBAAsB,CAIrH;AAQD,wBAAgB,gCAAgC,CAC9C,GAAG,EAAE,kBAAkB,CAAC,sBAAsB,CAAC,EAC/C,OAAO,EAAE,QAAQ,CAAC,6BAA6B,CAAC,GAC/C,IAAI,CAON"}

package/dist/createAnimatedNormalModifier.js

@@ -1,26 +1,29 @@
+import { allocateEntity, finishEntity } from '@flighthq/entity/contract';
 import { AnimatedNormalModifierKind, ModifierSlot } from '@flighthq/types/contract';
+import { initializeModifier } from './modifier';
 // The options for `createAnimatedNormalModifier`. `map` (nullable) and `scroll` are required; the
 // optional second layer and `strength` carry documented defaults. `map` presence and `secondaryMap`
 // presence are compile-time structural — they drive the define-key signature (disabled / single /
 // dual) — while `scroll`/`strength` are uniform-fed.
+export function createAnimatedNormalModifier(options) {
+    const out = allocateEntity();
+    initializeAnimatedNormalModifier(out, options);
+    return finishEntity(out);
+}
 // Builds an AnimatedNormalModifier (slot: Normal) — a UV-panned normal map that perturbs the surface
 // normal, scrolled by the shading tier's per-frame `time` uniform. Covers animated water, lava, and
 // flow. `scroll` is the pan speed in UV units per second (a plain Vector2Like value, copied by
 // reference); `strength` defaults to 1. An optional `secondaryMap` (+ `secondaryScroll`) adds a
 // second layer panning at a different rate to break up tiling — omitted leaves the modifier a single
 // layer.
-export function createAnimatedNormalModifier(options) {
-    const modifier = {
-        kind: AnimatedNormalModifierKind,
-        slot: ModifierSlot.Normal,
-        map: options.map,
-        scroll: options.scroll,
-        strength: options.strength ?? 1,
-    };
+export function initializeAnimatedNormalModifier(out, options) {
+    initializeModifier(out, AnimatedNormalModifierKind, ModifierSlot.Normal);
+    out.map = options.map;
+    out.scroll = options.scroll;
+    out.strength = options.strength ?? 1;
     if (options.secondaryMap !== undefined)
-        modifier.secondaryMap = options.secondaryMap;
+        out.secondaryMap = options.secondaryMap;
     if (options.secondaryScroll !== undefined)
-        modifier.secondaryScroll = options.secondaryScroll;
-    return modifier;
+        out.secondaryScroll = options.secondaryScroll;
 }
 //# sourceMappingURL=createAnimatedNormalModifier.js.map

package/dist/createAnimatedNormalModifier.js.map

@@ -1 +1 @@
-{"version":3,"file":"createAnimatedNormalModifier.js","sourceRoot":"","sources":["../src/createAnimatedNormalModifier.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,0BAA0B,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAEpF,kGAAkG;AAClG,oGAAoG;AACpG,kGAAkG;AAClG,qDAAqD;AAErD,qGAAqG;AACrG,oGAAoG;AACpG,+FAA+F;AAC/F,gGAAgG;AAChG,qGAAqG;AACrG,SAAS;AACT,MAAM,UAAU,4BAA4B,CAC1C,OAAgD;IAEhD,MAAM,QAAQ,GAA2B;QACvC,IAAI,EAAE,0BAA0B;QAChC,IAAI,EAAE,YAAY,CAAC,MAAM;QACzB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC;KAChC,CAAC;IACF,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS;QAAE,QAAQ,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IACrF,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS;QAAE,QAAQ,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAC9F,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"createAnimatedNormalModifier.js","sourceRoot":"","sources":["../src/createAnimatedNormalModifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAMzE,OAAO,EAAE,0BAA0B,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAEpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,kGAAkG;AAClG,oGAAoG;AACpG,kGAAkG;AAClG,qDAAqD;AAErD,MAAM,UAAU,4BAA4B,CAAC,OAAgD;IAC3F,MAAM,GAAG,GAAG,cAAc,EAA0B,CAAC;IACrD,gCAAgC,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC/C,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED,qGAAqG;AACrG,oGAAoG;AACpG,+FAA+F;AAC/F,gGAAgG;AAChG,qGAAqG;AACrG,SAAS;AACT,MAAM,UAAU,gCAAgC,CAC9C,GAA+C,EAC/C,OAAgD;IAEhD,kBAAkB,CAAC,GAAG,EAAE,0BAA0B,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IACzE,GAAG,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IACtB,GAAG,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC5B,GAAG,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;IACrC,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS;QAAE,GAAG,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAChF,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS;QAAE,GAAG,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;AAC3F,CAAC"}

package/dist/createDissolveModifier.d.ts

@@ -1,3 +1,4 @@
-import type { DissolveModifier, DissolveModifierOptions, NonEntityCreateResult } from '@flighthq/types/contract';
-export declare function createDissolveModifier(options: Readonly<DissolveModifierOptions>): NonEntityCreateResult<DissolveModifier, 'descriptor'>;
+import type { DissolveModifier, DissolveModifierOptions, EntityConstruction } from '@flighthq/types/contract';
+export declare function createDissolveModifier(options: Readonly<DissolveModifierOptions>): DissolveModifier;
+export declare function initializeDissolveModifier(out: EntityConstruction<DissolveModifier>, options: Readonly<DissolveModifierOptions>): void;
 //# sourceMappingURL=createDissolveModifier.d.ts.map

package/dist/createDissolveModifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createDissolveModifier.d.ts","sourceRoot":"","sources":["../src/createDissolveModifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAajH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,QAAQ,CAAC,uBAAuB,CAAC,GACzC,qBAAqB,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAWvD"}
+{"version":3,"file":"createDissolveModifier.d.ts","sourceRoot":"","sources":["../src/createDissolveModifier.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAS9G,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,QAAQ,CAAC,uBAAuB,CAAC,GAAG,gBAAgB,CAInG;AAQD,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,kBAAkB,CAAC,gBAAgB,CAAC,EACzC,OAAO,EAAE,QAAQ,CAAC,uBAAuB,CAAC,GACzC,IAAI,CAON"}

package/dist/createDissolveModifier.js

@@ -1,24 +1,27 @@
+import { allocateEntity, finishEntity } from '@flighthq/entity/contract';
 import { DissolveModifierKind, ModifierSlot } from '@flighthq/types/contract';
+import { initializeModifier } from './modifier';
 // The options for `createDissolveModifier`. Only `threshold` is required; the rest carry documented
 // defaults. `map` presence is compile-time structural (sampled mask vs procedural noise, driving the
 // define-key signature); `threshold`/`edgeWidth`/`scale` are uniform-fed and `edgeColor` is packed.
+export function createDissolveModifier(options) {
+    const out = allocateEntity();
+    initializeDissolveModifier(out, options);
+    return finishEntity(out);
+}
 // Builds a DissolveModifier (slot: Effect) — a clip/burn dissolve of the shaded output. A per-fragment
 // noise value (procedural over the UV, or sampled from `map`'s red channel) is compared against
 // `threshold`; fragments below it are discarded and a band of width `edgeWidth` above it glows
 // `edgeColor`. Animate `threshold` from 0 to 1 to disintegrate the surface. `edgeColor` is packed sRgb
 // RGBA (default 0xff6600ff); `edgeWidth` defaults to 0.05 (0 = hard clip); `scale` (procedural-noise
 // frequency, ignored with `map`) defaults to 8. `map` is copied by reference only when provided.
-export function createDissolveModifier(options) {
-    const modifier = {
-        kind: DissolveModifierKind,
-        slot: ModifierSlot.Effect,
-        threshold: options.threshold,
-        edgeColor: options.edgeColor ?? 0xff6600ff,
-        edgeWidth: options.edgeWidth ?? 0.05,
-        scale: options.scale ?? 8,
-    };
+export function initializeDissolveModifier(out, options) {
+    initializeModifier(out, DissolveModifierKind, ModifierSlot.Effect);
+    out.threshold = options.threshold;
+    out.edgeColor = options.edgeColor ?? 0xff6600ff;
+    out.edgeWidth = options.edgeWidth ?? 0.05;
+    out.scale = options.scale ?? 8;
     if (options.map !== undefined)
-        modifier.map = options.map;
-    return modifier;
+        out.map = options.map;
 }
 //# sourceMappingURL=createDissolveModifier.js.map

package/dist/createDissolveModifier.js.map

@@ -1 +1 @@
-{"version":3,"file":"createDissolveModifier.js","sourceRoot":"","sources":["../src/createDissolveModifier.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE9E,oGAAoG;AACpG,qGAAqG;AACrG,oGAAoG;AAEpG,uGAAuG;AACvG,gGAAgG;AAChG,+FAA+F;AAC/F,uGAAuG;AACvG,qGAAqG;AACrG,iGAAiG;AACjG,MAAM,UAAU,sBAAsB,CACpC,OAA0C;IAE1C,MAAM,QAAQ,GAAqB;QACjC,IAAI,EAAE,oBAAoB;QAC1B,IAAI,EAAE,YAAY,CAAC,MAAM;QACzB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,UAAU;QAC1C,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;QACpC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;KAC1B,CAAC;IACF,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS;QAAE,QAAQ,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAC1D,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"createDissolveModifier.js","sourceRoot":"","sources":["../src/createDissolveModifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzE,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,oGAAoG;AACpG,qGAAqG;AACrG,oGAAoG;AAEpG,MAAM,UAAU,sBAAsB,CAAC,OAA0C;IAC/E,MAAM,GAAG,GAAG,cAAc,EAAoB,CAAC;IAC/C,0BAA0B,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACzC,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED,uGAAuG;AACvG,gGAAgG;AAChG,+FAA+F;AAC/F,uGAAuG;AACvG,qGAAqG;AACrG,iGAAiG;AACjG,MAAM,UAAU,0BAA0B,CACxC,GAAyC,EACzC,OAA0C;IAE1C,kBAAkB,CAAC,GAAG,EAAE,oBAAoB,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IACnE,GAAG,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAClC,GAAG,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,UAAU,CAAC;IAChD,GAAG,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC;IAC1C,GAAG,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;IAC/B,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS;QAAE,GAAG,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;AACvD,CAAC"}

package/dist/createEmissiveModifier.d.ts

@@ -1,3 +1,4 @@
-import type { EmissiveModifier, EmissiveModifierOptions, NonEntityCreateResult } from '@flighthq/types/contract';
-export declare function createEmissiveModifier(options: Readonly<EmissiveModifierOptions>): NonEntityCreateResult<EmissiveModifier, 'descriptor'>;
+import type { EmissiveModifier, EmissiveModifierOptions, EntityConstruction } from '@flighthq/types/contract';
+export declare function createEmissiveModifier(options: Readonly<EmissiveModifierOptions>): EmissiveModifier;
+export declare function initializeEmissiveModifier(out: EntityConstruction<EmissiveModifier>, options: Readonly<EmissiveModifierOptions>): void;
 //# sourceMappingURL=createEmissiveModifier.d.ts.map

package/dist/createEmissiveModifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createEmissiveModifier.d.ts","sourceRoot":"","sources":["../src/createEmissiveModifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAcjH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,QAAQ,CAAC,uBAAuB,CAAC,GACzC,qBAAqB,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAWvD"}
+{"version":3,"file":"createEmissiveModifier.d.ts","sourceRoot":"","sources":["../src/createEmissiveModifier.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAU9G,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,QAAQ,CAAC,uBAAuB,CAAC,GAAG,gBAAgB,CAInG;AAQD,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,kBAAkB,CAAC,gBAAgB,CAAC,EACzC,OAAO,EAAE,QAAQ,CAAC,uBAAuB,CAAC,GACzC,IAAI,CAON"}

package/dist/createEmissiveModifier.js

@@ -1,25 +1,28 @@
+import { allocateEntity, finishEntity } from '@flighthq/entity/contract';
 import { EmissiveModifierFacing, EmissiveModifierKind, ModifierSlot } from '@flighthq/types/contract';
+import { initializeModifier } from './modifier';
 // The options for `createEmissiveModifier`. Only `color` is required; every other field carries a
 // documented default so the returned descriptor is fully populated (the define-key signature reads
 // `mask`/`facing` structurally, so leaving them at their defaults yields the unmasked, ungated
 // program variant).
+export function createEmissiveModifier(options) {
+    const out = allocateEntity();
+    initializeEmissiveModifier(out, options);
+    return finishEntity(out);
+}
 // Builds an EmissiveModifier (slot: Emissive) — a self-illuminating contribution added to the shaded
 // output, optionally masked and optionally gated by surface facing (the night-side city-lights case
 // uses `AwayFromLight`). `color` is packed sRgb-albedo RGBA (0xrrggbbaa); `strength` scales linear
 // radiance and defaults to 1; `facing` defaults to Ignore (emit everywhere) and `facingSoftness` to
 // 0 (a hard terminator). `mask` is copied by reference only when provided — omitted leaves the
 // descriptor unmasked.
-export function createEmissiveModifier(options) {
-    const modifier = {
-        kind: EmissiveModifierKind,
-        slot: ModifierSlot.Emissive,
-        color: options.color,
-        strength: options.strength ?? 1,
-        facing: options.facing ?? EmissiveModifierFacing.Ignore,
-        facingSoftness: options.facingSoftness ?? 0,
-    };
+export function initializeEmissiveModifier(out, options) {
+    initializeModifier(out, EmissiveModifierKind, ModifierSlot.Emissive);
+    out.color = options.color;
+    out.strength = options.strength ?? 1;
+    out.facing = options.facing ?? EmissiveModifierFacing.Ignore;
+    out.facingSoftness = options.facingSoftness ?? 0;
     if (options.mask !== undefined)
-        modifier.mask = options.mask;
-    return modifier;
+        out.mask = options.mask;
 }
 //# sourceMappingURL=createEmissiveModifier.js.map

package/dist/createEmissiveModifier.js.map

@@ -1 +1 @@
-{"version":3,"file":"createEmissiveModifier.js","sourceRoot":"","sources":["../src/createEmissiveModifier.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAEtG,kGAAkG;AAClG,mGAAmG;AACnG,+FAA+F;AAC/F,oBAAoB;AAEpB,qGAAqG;AACrG,oGAAoG;AACpG,mGAAmG;AACnG,oGAAoG;AACpG,+FAA+F;AAC/F,uBAAuB;AACvB,MAAM,UAAU,sBAAsB,CACpC,OAA0C;IAE1C,MAAM,QAAQ,GAAqB;QACjC,IAAI,EAAE,oBAAoB;QAC1B,IAAI,EAAE,YAAY,CAAC,QAAQ;QAC3B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC;QAC/B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,sBAAsB,CAAC,MAAM;QACvD,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,CAAC;KAC5C,CAAC;IACF,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;QAAE,QAAQ,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC7D,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"createEmissiveModifier.js","sourceRoot":"","sources":["../src/createEmissiveModifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzE,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAEtG,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,kGAAkG;AAClG,mGAAmG;AACnG,+FAA+F;AAC/F,oBAAoB;AAEpB,MAAM,UAAU,sBAAsB,CAAC,OAA0C;IAC/E,MAAM,GAAG,GAAG,cAAc,EAAoB,CAAC;IAC/C,0BAA0B,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACzC,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED,qGAAqG;AACrG,oGAAoG;AACpG,mGAAmG;AACnG,oGAAoG;AACpG,+FAA+F;AAC/F,uBAAuB;AACvB,MAAM,UAAU,0BAA0B,CACxC,GAAyC,EACzC,OAA0C;IAE1C,kBAAkB,CAAC,GAAG,EAAE,oBAAoB,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;IACrE,GAAG,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC1B,GAAG,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;IACrC,GAAG,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,sBAAsB,CAAC,MAAM,CAAC;IAC7D,GAAG,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,CAAC,CAAC;IACjD,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;QAAE,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;AAC1D,CAAC"}

package/dist/createEnvReflectModifier.d.ts

@@ -1,3 +1,4 @@
-import type { EnvReflectModifier, EnvReflectModifierOptions, NonEntityCreateResult } from '@flighthq/types/contract';
-export declare function createEnvReflectModifier(options?: Readonly<EnvReflectModifierOptions>): NonEntityCreateResult<EnvReflectModifier, 'descriptor'>;
+import type { EnvReflectModifier, EnvReflectModifierOptions, EntityConstruction } from '@flighthq/types/contract';
+export declare function createEnvReflectModifier(options?: Readonly<EnvReflectModifierOptions>): EnvReflectModifier;
+export declare function initializeEnvReflectModifier(out: EntityConstruction<EnvReflectModifier>, options?: Readonly<EnvReflectModifierOptions>): void;
 //# sourceMappingURL=createEnvReflectModifier.d.ts.map

package/dist/createEnvReflectModifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createEnvReflectModifier.d.ts","sourceRoot":"","sources":["../src/createEnvReflectModifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAarH,wBAAgB,wBAAwB,CACtC,OAAO,CAAC,EAAE,QAAQ,CAAC,yBAAyB,CAAC,GAC5C,qBAAqB,CAAC,kBAAkB,EAAE,YAAY,CAAC,CASzD"}
+{"version":3,"file":"createEnvReflectModifier.d.ts","sourceRoot":"","sources":["../src/createEnvReflectModifier.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AASlH,wBAAgB,wBAAwB,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,yBAAyB,CAAC,GAAG,kBAAkB,CAI1G;AAQD,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,kBAAkB,CAAC,kBAAkB,CAAC,EAC3C,OAAO,CAAC,EAAE,QAAQ,CAAC,yBAAyB,CAAC,GAC5C,IAAI,CAMN"}

package/dist/createEnvReflectModifier.js

@@ -1,21 +1,25 @@
+import { allocateEntity, finishEntity } from '@flighthq/entity/contract';
 import { EnvReflectModifierKind, ModifierSlot } from '@flighthq/types/contract';
+import { initializeModifier } from './modifier';
 // The options for `createEnvReflectModifier`. Every field is optional and carries a documented
 // default so the returned descriptor is fully populated (all four are uniform-fed scalars, so an
 // env-reflect modifier has a single define-key signature regardless of their values).
+export function createEnvReflectModifier(options) {
+    const out = allocateEntity();
+    initializeEnvReflectModifier(out, options);
+    return finishEntity(out);
+}
 // Builds an EnvReflectModifier (slot: Effect) — a view-dependent reflection of the scene's baked
 // environment cubemap added to the shaded output. It samples the SAME prefiltered environment the lit
 // block already binds (no second cubemap), reflecting the view vector about the surface normal and
 // blending by a Fresnel-Schlick ramp. `tint` is packed sRgb RGBA over the sampled color and defaults
 // to opaque white; `intensity` scales the whole term (default 1); `fresnelBias` is f0 (default 0.04,
 // a dielectric); `roughness` selects a blurrier prefiltered mip (default 0 = mirror-sharp).
-export function createEnvReflectModifier(options) {
-    return {
-        kind: EnvReflectModifierKind,
-        slot: ModifierSlot.Effect,
-        tint: options?.tint ?? 0xffffffff,
-        intensity: options?.intensity ?? 1,
-        fresnelBias: options?.fresnelBias ?? 0.04,
-        roughness: options?.roughness ?? 0,
-    };
+export function initializeEnvReflectModifier(out, options) {
+    initializeModifier(out, EnvReflectModifierKind, ModifierSlot.Effect);
+    out.tint = options?.tint ?? 0xffffffff;
+    out.intensity = options?.intensity ?? 1;
+    out.fresnelBias = options?.fresnelBias ?? 0.04;
+    out.roughness = options?.roughness ?? 0;
 }
 //# sourceMappingURL=createEnvReflectModifier.js.map

package/dist/createEnvReflectModifier.js.map

@@ -1 +1 @@
-{"version":3,"file":"createEnvReflectModifier.js","sourceRoot":"","sources":["../src/createEnvReflectModifier.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAEhF,+FAA+F;AAC/F,iGAAiG;AACjG,sFAAsF;AAEtF,iGAAiG;AACjG,sGAAsG;AACtG,mGAAmG;AACnG,qGAAqG;AACrG,qGAAqG;AACrG,4FAA4F;AAC5F,MAAM,UAAU,wBAAwB,CACtC,OAA6C;IAE7C,OAAO;QACL,IAAI,EAAE,sBAAsB;QAC5B,IAAI,EAAE,YAAY,CAAC,MAAM;QACzB,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,UAAU;QACjC,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,CAAC;QAClC,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,IAAI;QACzC,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,CAAC;KACnC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"createEnvReflectModifier.js","sourceRoot":"","sources":["../src/createEnvReflectModifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzE,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAEhF,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,+FAA+F;AAC/F,iGAAiG;AACjG,sFAAsF;AAEtF,MAAM,UAAU,wBAAwB,CAAC,OAA6C;IACpF,MAAM,GAAG,GAAG,cAAc,EAAsB,CAAC;IACjD,4BAA4B,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC3C,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED,iGAAiG;AACjG,sGAAsG;AACtG,mGAAmG;AACnG,qGAAqG;AACrG,qGAAqG;AACrG,4FAA4F;AAC5F,MAAM,UAAU,4BAA4B,CAC1C,GAA2C,EAC3C,OAA6C;IAE7C,kBAAkB,CAAC,GAAG,EAAE,sBAAsB,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IACrE,GAAG,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,UAAU,CAAC;IACvC,GAAG,CAAC,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,CAAC,CAAC;IACxC,GAAG,CAAC,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,IAAI,CAAC;IAC/C,GAAG,CAAC,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,CAAC,CAAC;AAC1C,CAAC"}

package/dist/createFogModifier.d.ts

@@ -1,3 +1,4 @@
-import type { FogModifier, FogModifierOptions, NonEntityCreateResult } from '@flighthq/types/contract';
-export declare function createFogModifier(options: Readonly<FogModifierOptions>): NonEntityCreateResult<FogModifier, 'descriptor'>;
+import type { FogModifier, FogModifierOptions, EntityConstruction } from '@flighthq/types/contract';
+export declare function createFogModifier(options: Readonly<FogModifierOptions>): FogModifier;
+export declare function initializeFogModifier(out: EntityConstruction<FogModifier>, options: Readonly<FogModifierOptions>): void;
 //# sourceMappingURL=createFogModifier.d.ts.map

package/dist/createFogModifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createFogModifier.d.ts","sourceRoot":"","sources":["../src/createFogModifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAavG,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GACpC,qBAAqB,CAAC,WAAW,EAAE,YAAY,CAAC,CAUlD"}
+{"version":3,"file":"createFogModifier.d.ts","sourceRoot":"","sources":["../src/createFogModifier.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAUpG,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GAAG,WAAW,CAIpF;AAOD,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,kBAAkB,CAAC,WAAW,CAAC,EACpC,OAAO,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GACpC,IAAI,CAON"}

package/dist/createFogModifier.js

@@ -1,22 +1,26 @@
+import { allocateEntity, finishEntity } from '@flighthq/entity/contract';
 import { FogModifierKind, FogModifierMode, ModifierSlot } from '@flighthq/types/contract';
+import { initializeModifier } from './modifier';
 // The options for `createFogModifier`. Only `color` is required; `mode`/`near`/`far`/`density` carry
 // documented defaults. `mode` is compile-time structural (each curve emits different GLSL, so it
 // drives the define-key signature); the numeric fields are uniform-fed and leave the program shape
 // identical.
+export function createFogModifier(options) {
+    const out = allocateEntity();
+    initializeFogModifier(out, options);
+    return finishEntity(out);
+}
 // Builds a FogModifier (slot: Effect) — blends the shaded output toward `color` by camera-distance
 // density. `color` is packed sRgb RGBA. `mode` defaults to Linear (using `near`/`far` as the ramp
 // endpoints, defaults 0 and 1); the Exponential/Exponential2 modes use `density` (default 1) as the
 // falloff rate. This is the per-material forward-shaded fog term, the compiled sibling of the
 // post-process ScreenSpaceFogEffect.
-export function createFogModifier(options) {
-    return {
-        kind: FogModifierKind,
-        slot: ModifierSlot.Effect,
-        color: options.color,
-        mode: options.mode ?? FogModifierMode.Linear,
-        near: options.near ?? 0,
-        far: options.far ?? 1,
-        density: options.density ?? 1,
-    };
+export function initializeFogModifier(out, options) {
+    initializeModifier(out, FogModifierKind, ModifierSlot.Effect);
+    out.color = options.color;
+    out.mode = options.mode ?? FogModifierMode.Linear;
+    out.near = options.near ?? 0;
+    out.far = options.far ?? 1;
+    out.density = options.density ?? 1;
 }
 //# sourceMappingURL=createFogModifier.js.map

package/dist/createFogModifier.js.map

@@ -1 +1 @@
-{"version":3,"file":"createFogModifier.js","sourceRoot":"","sources":["../src/createFogModifier.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE1F,qGAAqG;AACrG,iGAAiG;AACjG,mGAAmG;AACnG,aAAa;AAEb,mGAAmG;AACnG,kGAAkG;AAClG,oGAAoG;AACpG,8FAA8F;AAC9F,qCAAqC;AACrC,MAAM,UAAU,iBAAiB,CAC/B,OAAqC;IAErC,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,YAAY,CAAC,MAAM;QACzB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,eAAe,CAAC,MAAM;QAC5C,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC;QACvB,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;QACrB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC;KAC9B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"createFogModifier.js","sourceRoot":"","sources":["../src/createFogModifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE1F,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,qGAAqG;AACrG,iGAAiG;AACjG,mGAAmG;AACnG,aAAa;AAEb,MAAM,UAAU,iBAAiB,CAAC,OAAqC;IACrE,MAAM,GAAG,GAAG,cAAc,EAAe,CAAC;IAC1C,qBAAqB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACpC,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED,mGAAmG;AACnG,kGAAkG;AAClG,oGAAoG;AACpG,8FAA8F;AAC9F,qCAAqC;AACrC,MAAM,UAAU,qBAAqB,CACnC,GAAoC,EACpC,OAAqC;IAErC,kBAAkB,CAAC,GAAG,EAAE,eAAe,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAC9D,GAAG,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC1B,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,eAAe,CAAC,MAAM,CAAC;IAClD,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC;IAC7B,GAAG,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IAC3B,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC;AACrC,CAAC"}

package/dist/createRimModifier.d.ts

@@ -1,3 +1,4 @@
-import type { NonEntityCreateResult, RimModifier, RimModifierOptions } from '@flighthq/types/contract';
-export declare function createRimModifier(options: Readonly<RimModifierOptions>): NonEntityCreateResult<RimModifier, 'descriptor'>;
+import type { RimModifier, RimModifierOptions, EntityConstruction } from '@flighthq/types/contract';
+export declare function createRimModifier(options: Readonly<RimModifierOptions>): RimModifier;
+export declare function initializeRimModifier(out: EntityConstruction<RimModifier>, options: Readonly<RimModifierOptions>): void;
 //# sourceMappingURL=createRimModifier.d.ts.map

package/dist/createRimModifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createRimModifier.d.ts","sourceRoot":"","sources":["../src/createRimModifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAYvG,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GACpC,qBAAqB,CAAC,WAAW,EAAE,YAAY,CAAC,CASlD"}
+{"version":3,"file":"createRimModifier.d.ts","sourceRoot":"","sources":["../src/createRimModifier.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AASpG,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GAAG,WAAW,CAIpF;AAOD,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,kBAAkB,CAAC,WAAW,CAAC,EACpC,OAAO,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GACpC,IAAI,CAMN"}

package/dist/createRimModifier.js

@@ -1,20 +1,24 @@
+import { allocateEntity, finishEntity } from '@flighthq/entity/contract';
 import { ModifierSlot, RimModifierKind } from '@flighthq/types/contract';
+import { initializeModifier } from './modifier';
 // The options for `createRimModifier`. Only `color` is required; `power`/`intensity`/`bias` carry
 // documented defaults. All three are uniform-fed scalars — they do not change the emitted program,
 // so a rim modifier has a single define-key signature regardless of their values.
+export function createRimModifier(options) {
+    const out = allocateEntity();
+    initializeRimModifier(out, options);
+    return finishEntity(out);
+}
 // Builds a RimModifier (slot: Effect) — a view-dependent Fresnel rim added to the shaded output at
 // grazing angles, following `bias + intensity * pow(1 - dot(N, V), power)`. Covers the atmospheric
 // halo, force-field shields, and NPR rim light. `color` is packed sRgb-albedo RGBA (0xrrggbbaa);
 // `power` (falloff exponent, higher = tighter) defaults to 3, `intensity` to 1, and `bias` (the
 // constant floor before the falloff) to 0 (pure Fresnel).
-export function createRimModifier(options) {
-    return {
-        kind: RimModifierKind,
-        slot: ModifierSlot.Effect,
-        color: options.color,
-        power: options.power ?? 3,
-        intensity: options.intensity ?? 1,
-        bias: options.bias ?? 0,
-    };
+export function initializeRimModifier(out, options) {
+    initializeModifier(out, RimModifierKind, ModifierSlot.Effect);
+    out.color = options.color;
+    out.power = options.power ?? 3;
+    out.intensity = options.intensity ?? 1;
+    out.bias = options.bias ?? 0;
 }
 //# sourceMappingURL=createRimModifier.js.map

package/dist/createRimModifier.js.map

@@ -1 +1 @@
-{"version":3,"file":"createRimModifier.js","sourceRoot":"","sources":["../src/createRimModifier.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEzE,kGAAkG;AAClG,mGAAmG;AACnG,kFAAkF;AAElF,mGAAmG;AACnG,mGAAmG;AACnG,iGAAiG;AACjG,gGAAgG;AAChG,0DAA0D;AAC1D,MAAM,UAAU,iBAAiB,CAC/B,OAAqC;IAErC,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,YAAY,CAAC,MAAM;QACzB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;QACzB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,CAAC;QACjC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC;KACxB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"createRimModifier.js","sourceRoot":"","sources":["../src/createRimModifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,kGAAkG;AAClG,mGAAmG;AACnG,kFAAkF;AAElF,MAAM,UAAU,iBAAiB,CAAC,OAAqC;IACrE,MAAM,GAAG,GAAG,cAAc,EAAe,CAAC;IAC1C,qBAAqB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACpC,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED,mGAAmG;AACnG,mGAAmG;AACnG,iGAAiG;AACjG,gGAAgG;AAChG,0DAA0D;AAC1D,MAAM,UAAU,qBAAqB,CACnC,GAAoC,EACpC,OAAqC;IAErC,kBAAkB,CAAC,GAAG,EAAE,eAAe,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAC9D,GAAG,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC1B,GAAG,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;IAC/B,GAAG,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC;IACvC,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC;AAC/B,CAAC"}

package/dist/createShadedMaterial.d.ts

@@ -1,3 +1,4 @@
-import type { ShadedMaterial, ShadedMaterialOptions } from '@flighthq/types/contract';
+import type { EntityConstruction, ShadedMaterial, ShadedMaterialOptions } from '@flighthq/types/contract';
 export declare function createShadedMaterial(options?: Readonly<ShadedMaterialOptions>): ShadedMaterial;
+export declare function initializeShadedMaterial(out: EntityConstruction<ShadedMaterial>, options: Readonly<ShadedMaterialOptions>): void;
 //# sourceMappingURL=createShadedMaterial.d.ts.map

package/dist/createShadedMaterial.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createShadedMaterial.d.ts","sourceRoot":"","sources":["../src/createShadedMaterial.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAiBtF,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GAAG,cAAc,CAe9F"}
+{"version":3,"file":"createShadedMaterial.d.ts","sourceRoot":"","sources":["../src/createShadedMaterial.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAiB1G,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GAAG,cAAc,CAI9F;AAED,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,kBAAkB,CAAC,cAAc,CAAC,EACvC,OAAO,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GACvC,IAAI,CAcN"}

package/dist/createShadedMaterial.js

@@ -1,4 +1,4 @@
-import { createEntity } from '@flighthq/entity/contract';
+import { allocateEntity, finishEntity } from '@flighthq/entity/contract';
 import { BlendMode, ShadedMaterialKind } from '@flighthq/types/contract';
 // The options for `createShadedMaterial`. Every field is optional and defaults to the classic lit
 // base at neutral values (white diffuse/specular, shininess 32, no maps, an empty modifier stack);
@@ -14,19 +14,23 @@ import { BlendMode, ShadedMaterialKind } from '@flighthq/types/contract';
 // construction, exactly as for BlinnPhong/PBR. The result is an entity (it carries runtime/binding
 // identity), not a plain literal.
 export function createShadedMaterial(options) {
-    const material = createEntity({ kind: ShadedMaterialKind });
-    material.alphaCutoff = options?.alphaCutoff ?? 0.5;
-    material.alphaMode = options?.alphaMode ?? 'opaque';
-    material.blendMode = options?.blendMode ?? BlendMode.Normal;
-    material.diffuse = options?.diffuse ?? 0xffffffff;
-    material.diffuseMap = options?.diffuseMap ?? null;
-    material.doubleSided = options?.doubleSided ?? false;
-    material.modifiers = options?.modifiers ?? [];
-    material.normalMap = options?.normalMap ?? null;
-    material.normalScale = options?.normalScale ?? 1;
-    material.shininess = options?.shininess ?? 32;
-    material.specular = options?.specular ?? 0xffffffff;
-    material.specularMap = options?.specularMap ?? null;
-    return material;
+    const out = allocateEntity();
+    initializeShadedMaterial(out, options ?? {});
+    return finishEntity(out);
+}
+export function initializeShadedMaterial(out, options) {
+    out.kind = ShadedMaterialKind;
+    out.alphaCutoff = options.alphaCutoff ?? 0.5;
+    out.alphaMode = options.alphaMode ?? 'opaque';
+    out.blendMode = options.blendMode ?? BlendMode.Normal;
+    out.diffuse = options.diffuse ?? 0xffffffff;
+    out.diffuseMap = options.diffuseMap ?? null;
+    out.doubleSided = options.doubleSided ?? false;
+    out.modifiers = options.modifiers ?? [];
+    out.normalMap = options.normalMap ?? null;
+    out.normalScale = options.normalScale ?? 1;
+    out.shininess = options.shininess ?? 32;
+    out.specular = options.specular ?? 0xffffffff;
+    out.specularMap = options.specularMap ?? null;
 }
 //# sourceMappingURL=createShadedMaterial.js.map

package/dist/createShadedMaterial.js.map

@@ -1 +1 @@
-{"version":3,"file":"createShadedMaterial.js","sourceRoot":"","sources":["../src/createShadedMaterial.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEzE,kGAAkG;AAClG,mGAAmG;AACnG,mEAAmE;AAEnE,+FAA+F;AAC/F,qGAAqG;AACrG,iGAAiG;AACjG,oGAAoG;AACpG,mGAAmG;AACnG,wGAAwG;AACxG,0GAA0G;AAC1G,uGAAuG;AACvG,mGAAmG;AACnG,kCAAkC;AAClC,MAAM,UAAU,oBAAoB,CAAC,OAAyC;IAC5E,MAAM,QAAQ,GAAG,YAAY,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAmB,CAAC;IAC9E,QAAQ,CAAC,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,GAAG,CAAC;IACnD,QAAQ,CAAC,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,QAAQ,CAAC;IACpD,QAAQ,CAAC,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,SAAS,CAAC,MAAM,CAAC;IAC5D,QAAQ,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,UAAU,CAAC;IAClD,QAAQ,CAAC,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,IAAI,CAAC;IAClD,QAAQ,CAAC,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,KAAK,CAAC;IACrD,QAAQ,CAAC,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,EAAE,CAAC;IAC9C,QAAQ,CAAC,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,IAAI,CAAC;IAChD,QAAQ,CAAC,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,CAAC,CAAC;IACjD,QAAQ,CAAC,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,EAAE,CAAC;IAC9C,QAAQ,CAAC,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,UAAU,CAAC;IACpD,QAAQ,CAAC,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,IAAI,CAAC;IACpD,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"createShadedMaterial.js","sourceRoot":"","sources":["../src/createShadedMaterial.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzE,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEzE,kGAAkG;AAClG,mGAAmG;AACnG,mEAAmE;AAEnE,+FAA+F;AAC/F,qGAAqG;AACrG,iGAAiG;AACjG,oGAAoG;AACpG,mGAAmG;AACnG,wGAAwG;AACxG,0GAA0G;AAC1G,uGAAuG;AACvG,mGAAmG;AACnG,kCAAkC;AAClC,MAAM,UAAU,oBAAoB,CAAC,OAAyC;IAC5E,MAAM,GAAG,GAAG,cAAc,EAAkB,CAAC;IAC7C,wBAAwB,CAAC,GAAG,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;IAC7C,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,GAAuC,EACvC,OAAwC;IAExC,GAAG,CAAC,IAAI,GAAG,kBAAkB,CAAC;IAC9B,GAAG,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,GAAG,CAAC;IAC7C,GAAG,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,QAAQ,CAAC;IAC9C,GAAG,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,CAAC;IACtD,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,UAAU,CAAC;IAC5C,GAAG,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC;IAC5C,GAAG,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,KAAK,CAAC;IAC/C,GAAG,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;IACxC,GAAG,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC;IAC1C,GAAG,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC;IAC3C,GAAG,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;IACxC,GAAG,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,UAAU,CAAC;IAC9C,GAAG,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC;AAChD,CAAC"}

package/dist/createToonModifier.d.ts

@@ -1,3 +1,4 @@
-import type { NonEntityCreateResult, ToonModifier, ToonModifierOptions } from '@flighthq/types/contract';
-export declare function createToonModifier(options: Readonly<ToonModifierOptions>): NonEntityCreateResult<ToonModifier, 'descriptor'>;
+import type { ToonModifier, ToonModifierOptions, EntityConstruction } from '@flighthq/types/contract';
+export declare function createToonModifier(options: Readonly<ToonModifierOptions>): ToonModifier;
+export declare function initializeToonModifier(out: EntityConstruction<ToonModifier>, options: Readonly<ToonModifierOptions>): void;
 //# sourceMappingURL=createToonModifier.d.ts.map

package/dist/createToonModifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createToonModifier.d.ts","sourceRoot":"","sources":["../src/createToonModifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAYzG,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,QAAQ,CAAC,mBAAmB,CAAC,GACrC,qBAAqB,CAAC,YAAY,EAAE,YAAY,CAAC,CAOnD"}
+{"version":3,"file":"createToonModifier.d.ts","sourceRoot":"","sources":["../src/createToonModifier.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAStG,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,QAAQ,CAAC,mBAAmB,CAAC,GAAG,YAAY,CAIvF;AAOD,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,kBAAkB,CAAC,YAAY,CAAC,EACrC,OAAO,EAAE,QAAQ,CAAC,mBAAmB,CAAC,GACrC,IAAI,CAIN"}

package/dist/createToonModifier.js

@@ -1,18 +1,22 @@
+import { allocateEntity, finishEntity } from '@flighthq/entity/contract';
 import { ModifierSlot, ToonModifierKind } from '@flighthq/types/contract';
+import { initializeModifier } from './modifier';
 // The options for `createToonModifier`. Only `steps` is required; `smoothness` carries a documented
 // default. Both are uniform-fed scalars — they do not change the emitted program, so a toon modifier
 // has a single define-key signature regardless of their values.
+export function createToonModifier(options) {
+    const out = allocateEntity();
+    initializeToonModifier(out, options);
+    return finishEntity(out);
+}
 // Builds a ToonModifier (slot: Effect) — quantizes the shaded radiance into `steps` flat cel bands,
 // producing the hard light/shadow terminator of toon shading as a MODIFIER over the ShadedMaterial
 // base (the compiled sibling of the standalone ToonMaterial, so a toon look stacks with emissive/rim/
 // fog). `steps` is the number of shading bands (values below 2 clamp to 2 in the shader); `smoothness`
 // softens each band edge and defaults to 0 (crisp cel edges).
-export function createToonModifier(options) {
-    return {
-        kind: ToonModifierKind,
-        slot: ModifierSlot.Effect,
-        steps: options.steps,
-        smoothness: options.smoothness ?? 0,
-    };
+export function initializeToonModifier(out, options) {
+    initializeModifier(out, ToonModifierKind, ModifierSlot.Effect);
+    out.steps = options.steps;
+    out.smoothness = options.smoothness ?? 0;
 }
 //# sourceMappingURL=createToonModifier.js.map

package/dist/createToonModifier.js.map

@@ -1 +1 @@
-{"version":3,"file":"createToonModifier.js","sourceRoot":"","sources":["../src/createToonModifier.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE1E,oGAAoG;AACpG,qGAAqG;AACrG,gEAAgE;AAEhE,oGAAoG;AACpG,mGAAmG;AACnG,sGAAsG;AACtG,uGAAuG;AACvG,8DAA8D;AAC9D,MAAM,UAAU,kBAAkB,CAChC,OAAsC;IAEtC,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,YAAY,CAAC,MAAM;QACzB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,CAAC;KACpC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"createToonModifier.js","sourceRoot":"","sources":["../src/createToonModifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,oGAAoG;AACpG,qGAAqG;AACrG,gEAAgE;AAEhE,MAAM,UAAU,kBAAkB,CAAC,OAAsC;IACvE,MAAM,GAAG,GAAG,cAAc,EAAgB,CAAC;IAC3C,sBAAsB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED,oGAAoG;AACpG,mGAAmG;AACnG,sGAAsG;AACtG,uGAAuG;AACvG,8DAA8D;AAC9D,MAAM,UAAU,sBAAsB,CACpC,GAAqC,EACrC,OAAsC;IAEtC,kBAAkB,CAAC,GAAG,EAAE,gBAAgB,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAC/D,GAAG,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC1B,GAAG,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC;AAC3C,CAAC"}

package/dist/createVertexDisplaceModifier.d.ts

@@ -1,4 +1,4 @@
-import type { NonEntityCreateResult, VertexDisplaceModifierOptions } from '@flighthq/types/contract';
-import type { VertexDisplaceModifier } from '@flighthq/types/contract';
-export declare function createVertexDisplaceModifier(options: Readonly<VertexDisplaceModifierOptions>): NonEntityCreateResult<VertexDisplaceModifier, 'descriptor'>;
+import type { VertexDisplaceModifier, VertexDisplaceModifierOptions, EntityConstruction } from '@flighthq/types/contract';
+export declare function createVertexDisplaceModifier(options: Readonly<VertexDisplaceModifierOptions>): VertexDisplaceModifier;
+export declare function initializeVertexDisplaceModifier(out: EntityConstruction<VertexDisplaceModifier>, options: Readonly<VertexDisplaceModifierOptions>): void;
 //# sourceMappingURL=createVertexDisplaceModifier.d.ts.map

package/dist/createVertexDisplaceModifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createVertexDisplaceModifier.d.ts","sourceRoot":"","sources":["../src/createVertexDisplaceModifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAe,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAElH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAYvE,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,QAAQ,CAAC,6BAA6B,CAAC,GAC/C,qBAAqB,CAAC,sBAAsB,EAAE,YAAY,CAAC,CAa7D"}
+{"version":3,"file":"createVertexDisplaceModifier.d.ts","sourceRoot":"","sources":["../src/createVertexDisplaceModifier.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,sBAAsB,EACtB,6BAA6B,EAC7B,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAUlC,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,QAAQ,CAAC,6BAA6B,CAAC,GAAG,sBAAsB,CAIrH;AAOD,wBAAgB,gCAAgC,CAC9C,GAAG,EAAE,kBAAkB,CAAC,sBAAsB,CAAC,EAC/C,OAAO,EAAE,QAAQ,CAAC,6BAA6B,CAAC,GAC/C,IAAI,CASN"}

package/dist/createVertexDisplaceModifier.js

@@ -1,28 +1,31 @@
+import { allocateEntity, finishEntity } from '@flighthq/entity/contract';
 import { ModifierSlot, VertexDisplaceModifierKind } from '@flighthq/types/contract';
+import { initializeModifier } from './modifier';
 // The options for `createVertexDisplaceModifier`. `source` and `amplitude` are required; the rest
 // carry documented defaults. `source`, `axis` presence, and (for HeightMap) `map` presence are
 // compile-time structural — they drive the define-key signature — while `amplitude`/`frequency`/
 // `speed` are uniform-fed.
+export function createVertexDisplaceModifier(options) {
+    const out = allocateEntity();
+    initializeVertexDisplaceModifier(out, options);
+    return finishEntity(out);
+}
 // Builds a VertexDisplaceModifier (slot: Vertex) — the one built-in VERTEX-scene2d modifier, displacing
 // each vertex along its normal (or a fixed `axis`) before the model transform. `Sine` is a procedural
 // traveling wave animated by the shading tier's per-frame `time` (using `frequency` default 1, `speed`
 // default 1, `direction` default +X); `HeightMap` reads the amount from `map`'s red channel. `axis`,
 // `map`, and `direction` are plain value pairs copied by reference only when provided.
-export function createVertexDisplaceModifier(options) {
-    const modifier = {
-        kind: VertexDisplaceModifierKind,
-        slot: ModifierSlot.Vertex,
-        source: options.source,
-        amplitude: options.amplitude,
-        frequency: options.frequency ?? 1,
-        speed: options.speed ?? 1,
-        direction: options.direction ?? DEFAULT_DIRECTION,
-    };
+export function initializeVertexDisplaceModifier(out, options) {
+    initializeModifier(out, VertexDisplaceModifierKind, ModifierSlot.Vertex);
+    out.source = options.source;
+    out.amplitude = options.amplitude;
+    out.frequency = options.frequency ?? 1;
+    out.speed = options.speed ?? 1;
+    out.direction = options.direction ?? DEFAULT_DIRECTION;
     if (options.axis !== undefined)
-        modifier.axis = options.axis;
+        out.axis = options.axis;
     if (options.map !== undefined)
-        modifier.map = options.map;
-    return modifier;
+        out.map = options.map;
 }
 const DEFAULT_DIRECTION = { x: 1, y: 0, z: 0 };
 //# sourceMappingURL=createVertexDisplaceModifier.js.map

package/dist/createVertexDisplaceModifier.js.map

@@ -1 +1 @@
-{"version":3,"file":"createVertexDisplaceModifier.js","sourceRoot":"","sources":["../src/createVertexDisplaceModifier.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAGpF,kGAAkG;AAClG,+FAA+F;AAC/F,iGAAiG;AACjG,2BAA2B;AAE3B,wGAAwG;AACxG,sGAAsG;AACtG,uGAAuG;AACvG,qGAAqG;AACrG,uFAAuF;AACvF,MAAM,UAAU,4BAA4B,CAC1C,OAAgD;IAEhD,MAAM,QAAQ,GAA2B;QACvC,IAAI,EAAE,0BAA0B;QAChC,IAAI,EAAE,YAAY,CAAC,MAAM;QACzB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,CAAC;QACjC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;QACzB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,iBAAiB;KAClD,CAAC;IACF,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;QAAE,QAAQ,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC7D,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS;QAAE,QAAQ,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAC1D,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,iBAAiB,GAAgB,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC"}
+{"version":3,"file":"createVertexDisplaceModifier.js","sourceRoot":"","sources":["../src/createVertexDisplaceModifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAOzE,OAAO,EAAE,YAAY,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAEpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,kGAAkG;AAClG,+FAA+F;AAC/F,iGAAiG;AACjG,2BAA2B;AAE3B,MAAM,UAAU,4BAA4B,CAAC,OAAgD;IAC3F,MAAM,GAAG,GAAG,cAAc,EAA0B,CAAC;IACrD,gCAAgC,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC/C,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED,wGAAwG;AACxG,sGAAsG;AACtG,uGAAuG;AACvG,qGAAqG;AACrG,uFAAuF;AACvF,MAAM,UAAU,gCAAgC,CAC9C,GAA+C,EAC/C,OAAgD;IAEhD,kBAAkB,CAAC,GAAG,EAAE,0BAA0B,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IACzE,GAAG,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC5B,GAAG,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAClC,GAAG,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC;IACvC,GAAG,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;IAC/B,GAAG,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,iBAAiB,CAAC;IACvD,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;QAAE,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IACxD,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS;QAAE,GAAG,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;AACvD,CAAC;AAED,MAAM,iBAAiB,GAAgB,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC"}

package/dist/modifier.d.ts

@@ -0,0 +1,3 @@
+import type { EntityConstruction, Modifier, ModifierKind, ModifierSlot } from '@flighthq/types/contract';
+export declare function initializeModifier<T extends Modifier>(out: EntityConstruction<T>, kind: ModifierKind, slot: ModifierSlot): void;
+//# sourceMappingURL=modifier.d.ts.map

package/dist/modifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modifier.d.ts","sourceRoot":"","sources":["../src/modifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAEzG,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,QAAQ,EACnD,GAAG,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC1B,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,YAAY,GACjB,IAAI,CAGN"}

package/dist/modifier.js

@@ -0,0 +1,5 @@
+export function initializeModifier(out, kind, slot) {
+    out.kind = kind;
+    out.slot = slot;
+}
+//# sourceMappingURL=modifier.js.map

package/dist/modifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modifier.js","sourceRoot":"","sources":["../src/modifier.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,kBAAkB,CAChC,GAA0B,EAC1B,IAAkB,EAClB,IAAkB;IAElB,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;IAChB,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;AAClB,CAAC"}

package/dist/modifierRegistry.d.ts

@@ -1,5 +1,6 @@
-import type { ModifierDefinition, ModifierKind, ModifierRegistry } from '@flighthq/types/contract';
+import type { EntityConstruction, ModifierDefinition, ModifierKind, ModifierRegistry } from '@flighthq/types/contract';
 export declare function createModifierRegistry(): ModifierRegistry;
+export declare function initializeModifierRegistry(out: EntityConstruction<ModifierRegistry>): void;
 export declare function registerModifier(registry: Readonly<ModifierRegistry>, definition: Readonly<ModifierDefinition>): void;
 export declare function resolveModifier(registry: Readonly<ModifierRegistry>, kind: ModifierKind): ModifierDefinition | null;
 //# sourceMappingURL=modifierRegistry.d.ts.map

package/dist/modifierRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"modifierRegistry.d.ts","sourceRoot":"","sources":["../src/modifierRegistry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAsBnG,wBAAgB,sBAAsB,IAAI,gBAAgB,CAEzD;AAMD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAErH;AAID,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,YAAY,GAAG,kBAAkB,GAAG,IAAI,CAEnH"}
+{"version":3,"file":"modifierRegistry.d.ts","sourceRoot":"","sources":["../src/modifierRegistry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAsBvH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAIzD;AAED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,kBAAkB,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAE1F;AAMD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAErH;AAID,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,YAAY,GAAG,kBAAkB,GAAG,IAAI,CAEnH"}

package/dist/modifierRegistry.js

@@ -1,4 +1,4 @@
-import { createEntity } from '@flighthq/entity/contract';
+import { allocateEntity, finishEntity } from '@flighthq/entity/contract';
 // The substrate-agnostic registration record for one modifier kind: where it injects (`slot`) and
 // how its descriptor's compile-time structure contributes to the define-key (`getDefineSignature`).
 // It carries NO backend GLSL — per-backend compilers (e.g. @flighthq/scene3d-gl) register their own
@@ -18,7 +18,12 @@ import { createEntity } from '@flighthq/entity/contract';
 // Allocates an empty modifier registry. The only allocating registry function; register and resolve
 // read or mutate an existing registry in place.
 export function createModifierRegistry() {
-    return createEntity({ definitions: new Map() });
+    const out = allocateEntity();
+    initializeModifierRegistry(out);
+    return finishEntity(out);
+}
+export function initializeModifierRegistry(out) {
+    out.definitions = new Map();
 }
 // Registers (or replaces) the definition for `definition.kind`. Last-write-wins: a later
 // registration of the same kind overrides the earlier one, so a user can shadow a built-in with a

package/dist/modifierRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"modifierRegistry.js","sourceRoot":"","sources":["../src/modifierRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGzD,kGAAkG;AAClG,oGAAoG;AACpG,oGAAoG;AACpG,kGAAkG;AAClG,0FAA0F;AAC1F,EAAE;AACF,oGAAoG;AACpG,kGAAkG;AAClG,qGAAqG;AACrG,oGAAoG;AACpG,wFAAwF;AAExF,mGAAmG;AACnG,kGAAkG;AAClG,mGAAmG;AACnG,mGAAmG;AACnG,gGAAgG;AAEhG,oGAAoG;AACpG,gDAAgD;AAChD,MAAM,UAAU,sBAAsB;IACpC,OAAO,YAAY,CAAC,EAAE,WAAW,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;AAClD,CAAC;AAED,yFAAyF;AACzF,kGAAkG;AAClG,oGAAoG;AACpG,gDAAgD;AAChD,MAAM,UAAU,gBAAgB,CAAC,QAAoC,EAAE,UAAwC;IAC7G,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AACxD,CAAC;AAED,iGAAiG;AACjG,2EAA2E;AAC3E,MAAM,UAAU,eAAe,CAAC,QAAoC,EAAE,IAAkB;IACtF,OAAO,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AAChD,CAAC"}
+{"version":3,"file":"modifierRegistry.js","sourceRoot":"","sources":["../src/modifierRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGzE,kGAAkG;AAClG,oGAAoG;AACpG,oGAAoG;AACpG,kGAAkG;AAClG,0FAA0F;AAC1F,EAAE;AACF,oGAAoG;AACpG,kGAAkG;AAClG,qGAAqG;AACrG,oGAAoG;AACpG,wFAAwF;AAExF,mGAAmG;AACnG,kGAAkG;AAClG,mGAAmG;AACnG,mGAAmG;AACnG,gGAAgG;AAEhG,oGAAoG;AACpG,gDAAgD;AAChD,MAAM,UAAU,sBAAsB;IACpC,MAAM,GAAG,GAAG,cAAc,EAAoB,CAAC;IAC/C,0BAA0B,CAAC,GAAG,CAAC,CAAC;IAChC,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,GAAyC;IAClF,GAAG,CAAC,WAAW,GAAG,IAAI,GAAG,EAAE,CAAC;AAC9B,CAAC;AAED,yFAAyF;AACzF,kGAAkG;AAClG,oGAAoG;AACpG,gDAAgD;AAChD,MAAM,UAAU,gBAAgB,CAAC,QAAoC,EAAE,UAAwC;IAC7G,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AACxD,CAAC;AAED,iGAAiG;AACjG,2EAA2E;AAC3E,MAAM,UAAU,eAAe,CAAC,QAAoC,EAAE,IAAkB;IACtF,OAAO,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AAChD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/shading",
-  "version": "0.5.1-next.815.cc08b93",
+  "version": "0.5.1-next.903.f434bc2",
   "author": "Joshua Granick and other contributors",
   "license": "MIT",
   "repository": {
@@ -38,8 +38,8 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/entity": "0.5.1-next.815.cc08b93",
-    "@flighthq/types": "0.5.1-next.815.cc08b93"
+    "@flighthq/entity": "0.5.1-next.903.f434bc2",
+    "@flighthq/types": "0.5.1-next.903.f434bc2"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/src/getUnregisteredModifierKinds.test.ts

@@ -1,3 +1,4 @@
+import { allocateEntity, finishEntity } from '@flighthq/entity/contract';
 import type { Modifier } from '@flighthq/types/contract';
 import { EmissiveModifierKind } from '@flighthq/types/contract';
 import { describe, expect, it } from 'vitest';
@@ -24,10 +25,25 @@ describe('getUnregisteredModifierKinds', () => {
     const registry = createModifierRegistry();
     registerBuiltInModifiers(registry);
     const stack: Modifier[] = [
-      { kind: 'acme.Missing', slot: 'Effect' },
+      (() => {
+        const out = allocateEntity<any>();
+        out.kind = 'acme.Missing';
+        out.slot = 'Effect';
+        return finishEntity(out);
+      })(),
       createEmissiveModifier({ color: 0xffffffff }),
-      { kind: 'acme.Other', slot: 'Normal' },
-      { kind: 'acme.Missing', slot: 'Effect' },
+      (() => {
+        const out = allocateEntity<any>();
+        out.kind = 'acme.Other';
+        out.slot = 'Normal';
+        return finishEntity(out);
+      })(),
+      (() => {
+        const out = allocateEntity<any>();
+        out.kind = 'acme.Missing';
+        out.slot = 'Effect';
+        return finishEntity(out);
+      })(),
     ];
     expect(getUnregisteredModifierKinds(registry, stack)).toEqual(['acme.Missing', 'acme.Other']);
   });

package/src/isModifierStackValid.test.ts

@@ -1,3 +1,4 @@
+import { allocateEntity, finishEntity } from '@flighthq/entity/contract';
 import type { Modifier } from '@flighthq/types/contract';
 import { describe, expect, it } from 'vitest';
 
@@ -21,7 +22,15 @@ describe('isModifierStackValid', () => {
   it('is false when any kind is unregistered', () => {
     const registry = createModifierRegistry();
     registerBuiltInModifiers(registry);
-    const stack: Modifier[] = [createEmissiveModifier({ color: 0xffffffff }), { kind: 'acme.Missing', slot: 'Effect' }];
+    const stack: Modifier[] = [
+      createEmissiveModifier({ color: 0xffffffff }),
+      (() => {
+        const out = allocateEntity<any>();
+        out.kind = 'acme.Missing';
+        out.slot = 'Effect';
+        return finishEntity(out);
+      })(),
+    ];
     expect(isModifierStackValid(registry, stack)).toBe(false);
   });
 });

package/src/modifierRegistry.test.ts

@@ -1,3 +1,4 @@
+import { allocateEntity, finishEntity } from '@flighthq/entity/contract';
 import type { Modifier } from '@flighthq/types/contract';
 import { describe, expect, it } from 'vitest';
 
@@ -40,7 +41,16 @@ describe('registerModifier', () => {
       getDefineSignature: (modifier: Readonly<Modifier>) => modifier.slot,
     });
     const definition = resolveModifier(registry, 'acme.Foo');
-    expect(definition?.getDefineSignature?.({ kind: 'acme.Foo', slot: 'Effect' })).toBe('Effect');
+    expect(
+      definition?.getDefineSignature?.(
+        (() => {
+          const out = allocateEntity<any>();
+          out.kind = 'acme.Foo';
+          out.slot = 'Effect';
+          return finishEntity(out);
+        })(),
+      ),
+    ).toBe('Effect');
   });
 });
 

package/src/orderModifierStack.test.ts

@@ -1,3 +1,4 @@
+import { allocateEntity, finishEntity } from '@flighthq/entity/contract';
 import type { Modifier } from '@flighthq/types/contract';
 import { describe, expect, it } from 'vitest';
 
@@ -30,8 +31,12 @@ describe('orderModifierStack', () => {
   });
 
   it('sorts unknown and reserved slots after every built-in slot, stably', () => {
-    const ambient: Modifier = { kind: 'acme.Ambient', slot: 'Ambient' };
-    const vendor: Modifier = { kind: 'acme.Custom', slot: 'acme.Weird' };
+    const ambient = allocateEntity<Modifier>();
+    ambient.kind = 'acme.Ambient';
+    ambient.slot = 'Ambient';
+    const vendor = allocateEntity<Modifier>();
+    vendor.kind = 'acme.Custom';
+    vendor.slot = 'acme.Weird';
     const ordered = orderModifierStack([ambient, rim, vendor, normal]);
     expect(ordered).toEqual([normal, rim, ambient, vendor]);
   });