@forgeax/engine-render 0.0.0-dev.8d955ade1c79

package/dist/assembly/factory.d.ts

@@ -0,0 +1,207 @@
+import { MeshSsboCapacityExceededError, MeshSsboCeilingReachedError } from '@forgeax/engine-assets-runtime';
+import type { Buffer, PipelineLayout, RhiDevice } from '@forgeax/engine-rhi';
+import { type MaterialShaderManifestEntry } from '@forgeax/engine-shader';
+import type { ImportTransport } from '@forgeax/engine-types';
+import type { Renderer, RendererOptions } from '../render-contract';
+import { type RhiBackendPack } from './backend-contract';
+import type { RendererAssemblyImplementation, RendererHostImplementation } from './host-contract';
+export { assembleMaterialProjection } from './material/assembly';
+export { projectMaterialPipeline, routeMaterialPipeline, updateMaterialRuntimeValues, } from './material/pipeline-projection';
+/**
+ * Bundler-layer injection accepted by `createRenderer` (and proxied by
+ * `createApp`) as the optional third argument.
+ *
+ * feat-20260608-create-app-param-surface-trim / M2 / D-3: aggregates the two
+ * host-injected build-tool channels:
+ *
+ *   - shaderManifestUrl: the URL the host's vite-plugin-shader emit step
+ *     wrote `manifest.json` to. When this field is omitted (or `bundler`
+ *     itself is omitted), createRenderer falls back to
+ *     '/shaders/manifest.json' (D-2 q5-A) so the LO 1.1 zero-config takeoff
+ *     path keeps working without explicit injection. Tests can inject via a
+ *     `data:application/json,...` URL to bypass fetch.
+ *
+ *   - importTransport: dev-only ImportTransport forwarded verbatim to the
+ *     AssetRegistry third ctor slot so DDC-miss assets can lazy-import.
+ *     Absent => shipped form (a DDC miss fails fast with `asset-not-imported`).
+ *
+ * The interface is duplicated structurally in `@forgeax/engine-app`
+ * (BundlerOptions exported from packages/app); demos consume through the app
+ * package, the engine accepts via this local minimal shape so packages/runtime
+ * does NOT depend on packages/app (charter P4 + reverse-coupling deny-list).
+ * TypeScript structural typing makes the two interchangeable at every call
+ * site (M3 forgeaxBundlerAdapter() returns the same shape).
+ */
+export interface BundlerOptions {
+    readonly importTransport?: ImportTransport | undefined;
+    readonly shaderManifestUrl?: string | undefined;
+}
+/** Build a Renderer from the backend pack supplied by the Runtime host. */
+/**
+ * Per-variant PipelineLayout selector (M4.5 / D-10 option A).
+ *
+ * The HDRP variant (`CLUSTER_FORWARD_AVAILABLE=true` or canonical `''`
+ * all-true when the shader declares the cluster axis) needs the 7-slot
+ * group(2) BGL chain (`hdrpPbrPipelineLayout`); URP variants
+ * (`CLUSTER_FORWARD_AVAILABLE=false` / undefined / no axis) keep the
+ * 1-slot mesh-array BGL chain (`pbrPipelineLayout`).
+ *
+ * Returns `null` only when the URP fallback layout itself is null
+ * (Camera-only / empty-manifest path). When the HDRP layout is null but
+ * URP exists, the HDRP variant gracefully falls back to URP — the WGSL
+ * resolved upstream by `findVariantByKey` is the URP variant in that
+ * case (manifest entry with all-true definesKey === '' was registered
+ * with isHdrpActive=false at boot when storage-buffer caps are absent).
+ *
+ * Pure function — exported for unit-test access (M4.5 / w35).
+ */
+/**
+ * Closed enum of pipeline-layout kinds the selector can dispatch to.
+ *
+ * `pbr` — standard PBR (1-entry mesh-array BGL).
+ * `pbr-skin` — bug-20260611-skin-pipeline-layout: 2-entry mesh-array BGL
+ *   (binding 0 meshes + binding 1 palette) for the `forgeax::pbr-skin`
+ *   material shader.
+ * `hdrp-pbr` — feat-20260609 HDRP cluster-forward variant (7-slot group(2)
+ *   BGL substituted at slot 2).
+ * `sprite-urp` — bug-20260708 M2 (c): sprite / sprite-lit shaders reuse
+ *   the URP 1-slot mesh-array BGL (they don't declare
+ *   CLUSTER_FORWARD_AVAILABLE) but their canonical all-true variant key
+ *   `''` (`SPRITE_PASS_PER_INSTANCE_REGION_VARIANT_SET`) MUST NOT trigger
+ *   the `variantSet===''` → HDRP branch of the selector. Callers
+ *   (`buildPipelineContext`) resolve `sprite-urp` from the sprite
+ *   `materialShaderId` and pass it through; the selector short-circuits
+ *   to `pbrPipelineLayout` before the HDRP check.
+ *
+ * AC-09 grep gate: the selector body (`selectPipelineLayoutForVariant`)
+ * **MUST NOT** contain literal `'forgeax::pbr-skin'` (or another
+ * shader-id literal). The caller resolves `LayoutKind` upstream and passes
+ * the structured value through (charter P4 consistent abstraction). New
+ * material-shader layouts add a `LayoutKind` member + a PipelineState slot
+ * + a switch arm here in one cut (charter P3 extensibility).
+ */
+export type LayoutKind = 'pbr' | 'pbr-skin' | 'hdrp-pbr' | 'sprite-urp' | 'unlit-urp';
+/**
+ * Return every device-capability HDRP PBR variant that needs a lazy module
+ * label seeded during renderer boot. Color availability is intentionally not
+ * filtered: colored and no-color meshes use distinct composed WGSL modules.
+ */
+export declare function selectHdrpPbrPrewarmVariants(manifestEntry: MaterialShaderManifestEntry | undefined, storageBufferCapable: boolean): readonly MaterialShaderManifestEntry['variants'][number][];
+/**
+ * Select the PBR variant that matches a fallback mesh with no COLOR_0 input.
+ * Unknown/custom material IDs may still use the legacy PBR fallback, so that
+ * path must obey the same geometry-owned vertex-color axis as registered PBR.
+ */
+export declare function selectNoColorPbrVariant(manifestEntry: MaterialShaderManifestEntry | undefined, storageBufferCapable: boolean, variantSet: string | undefined): MaterialShaderManifestEntry['variants'][number] | undefined;
+export type MaterialShaderBindingContract = 'group-0' | 'group-0-resource' | 'view-only' | 'view-and-scene-depth' | 'render-material';
+export type MaterialShaderVertexInputContract = 'none' | 'render-material';
+export declare function resolveMaterialShaderBindingContract(source: string): MaterialShaderBindingContract;
+export declare function resolveMaterialShaderVertexInputContract(source: string): MaterialShaderVertexInputContract;
+export declare function allowsUnlitPreparedFallback(depthFormatOverride: GPUTextureFormat | null | undefined, vertexLayout: string | undefined, materialShaderId?: string): boolean;
+/**
+ * Prepared VFX draws own their vertex inputs and bind groups. A missing
+ * authored material shader is therefore retryable, but it is never safe to
+ * substitute the built-in PBR module: PBR declares mesh/instance groups that
+ * the VFX draw does not bind. Returning true keeps the feature on its
+ * structured next-frame recovery path instead of creating an invalid PSO.
+ */
+export declare function shouldDeferMissingPreparedMaterialShader(vertexLayout: string | undefined): boolean;
+export declare function selectPipelineLayoutForVariant(state: {
+    readonly pbrPipelineLayout: PipelineLayout | null;
+    readonly hdrpPbrPipelineLayout: PipelineLayout | null;
+    readonly pbrSkinPipelineLayout: PipelineLayout | null;
+} | null, variantSet: string | undefined, layoutKind?: LayoutKind): PipelineLayout | null;
+/**
+ * Resolve a requested material variant against the actual backend capabilities.
+ * Record callers use the native-capability request; the backend-owned axes
+ * must be rewritten before the request reaches shader lookup and PSO layout
+ * selection.
+ */
+export declare function resolveMaterialShaderVariantSet(requestedVariantSet: string | undefined, variants: ReadonlyArray<{
+    readonly defines: Readonly<Record<string, boolean>>;
+}>, backendKind: RhiDevice['caps']['backendKind'], storageBuffer: boolean): string | undefined;
+export declare function createRenderer(canvas: unknown, options?: RendererOptions, bundler?: BundlerOptions, backend?: RhiBackendPack): Promise<RendererAssemblyImplementation>;
+/** Narrow the concrete host to the lease/receipt-only public contract. */
+export declare function exposeRenderer(renderer: RendererHostImplementation): Renderer;
+/**
+ * Derive a usable storage-buffer ceiling from device limits.
+ *
+ * Mirrors the `SKIN_PALETTE_MAX_BINDING_BYTES` 0/undefined floor pattern
+ * (createRenderer.ts:4070-4073): when `maxStorageBufferBindingSize` is 0 or
+ * undefined (WebKit `downlevel_webgl2_defaults`), climb the fallback chain —
+ * `maxBufferSize` → `maxUniformBufferBindingSize` → WebGPU spec floor
+ * 134217728 (128 MiB).
+ *
+ * Pure helper — no device dependency, directly testable in node.
+ */
+export declare function deriveStorageBufferCeiling(limits: Readonly<{
+    maxStorageBufferBindingSize?: number;
+    maxBufferSize?: number;
+    maxUniformBufferBindingSize?: number;
+}>): number;
+/**
+ * Mesh + material buffer wrapper carrying the inner `Buffer` handle plus
+ * the byte-size at the time of allocation. The wrapper-object identity is
+ * stable across grow events — only `.buffer` and `.sizeInBytes` are mutated
+ * in place — so `PipelineState.meshStorageBuffer` / `materialUniformBuffer`
+ * fields capture the wrapper once and survive grow events without a re-bind
+ * cycle through the public Renderer surface (research §F8 R1).
+ */
+export interface MeshSsboBufferWrapper {
+    buffer: Buffer | null;
+    sizeInBytes: number;
+}
+/** Closure-local grow state surfaced for spy assertions in unit tests. */
+export interface MeshSsboState {
+    slotCount: number;
+    mesh: MeshSsboBufferWrapper;
+    material: MeshSsboBufferWrapper;
+}
+/** `growMeshSsbo` return shape (D-5: Result-like, never throws). */
+export type MeshSsboGrowResult = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly code: 'mesh-ssbo-ceiling-reached' | 'mesh-ssbo-capacity-exceeded';
+    /** Pre-grow slotCount — the caller can render up to this many slots (degraded subset). */
+    readonly degradedToSlotCount: number;
+};
+/** Minimal device surface the grow controller needs (mocked in unit tests). */
+export interface MeshSsboGrowDevice {
+    readonly limits: {
+        readonly maxStorageBufferBindingSize: number;
+    };
+    readonly createBuffer: (descriptor: {
+        readonly label?: string;
+        readonly size: number;
+        readonly usage: number;
+        readonly mappedAtCreation?: boolean;
+    }) => Buffer;
+}
+/** Minimal error-registry surface (just `fire` — `RhiErrorListenerRegistry` matches). */
+export interface MeshSsboGrowErrorRegistry {
+    fire: (e: MeshSsboCeilingReachedError | MeshSsboCapacityExceededError) => void;
+}
+export interface MeshSsboGrowControllerInit {
+    readonly device: MeshSsboGrowDevice;
+    readonly errorRegistry: MeshSsboGrowErrorRegistry;
+    readonly initialSlotCount: number;
+    readonly perEntityStride: number;
+    readonly meshUsage: number;
+    readonly materialUsage: number;
+}
+export interface MeshSsboGrowController {
+    readonly state: MeshSsboState;
+    /** Allocate the initial mesh + material buffer pair at `initialSlotCount`. */
+    readonly initialBuild: () => void;
+    /** Grow to satisfy `neededSlots`; idempotent + ceiling-aware. */
+    readonly growMeshSsbo: (neededSlots: number) => MeshSsboGrowResult;
+}
+/**
+ * Build a closure-scoped mesh-SSBO grow controller. Module-scope so unit
+ * tests (`__tests__/mesh-ssbo-grow.test.ts`) can construct it with a fake
+ * device + spy errorRegistry without spinning up the full WebGPU renderer
+ * (charter F2 minimal surface — the controller is the testable seam).
+ */
+export declare function createMeshSsboGrowController(init: MeshSsboGrowControllerInit): MeshSsboGrowController;
+//# sourceMappingURL=factory.d.ts.map

package/dist/assembly/factory.d.ts.map

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

package/dist/assembly/host-contract.d.ts

@@ -0,0 +1,84 @@
+import type { AssetRegistry } from '@forgeax/engine-assets-runtime';
+import type { World } from '@forgeax/engine-ecs';
+import type { Result, RhiDevice, RhiError, ShaderModule } from '@forgeax/engine-rhi';
+import type { RecoverFailure } from '../errors/recover';
+import type { ObservationUnavailableError, RenderError } from '../errors/render';
+import type { RenderFeature, RenderFeatureDiagnostics } from '../features/types';
+import type { MeshMaterialBindingObservation } from '../mesh-material-bindings';
+import type { FrameObservation, FrameObservationOptions } from '../record/frame';
+import type { DrawOwnerOptions, FrameObservationRequest, FrameReceipt, FrameReceiptObservation, HealthSnapshot, RenderDebugOverlay, RendererError, RendererErrorListener, RendererLostListener, RenderFrameInput, RenderInspection, RenderProfile, RenderResult, RenderWorldLease } from '../render-contract';
+import type { RenderSceneInspection } from '../render-system';
+type RenderShaderModuleFactory = (device: RhiDevice, desc: {
+    readonly label?: string | undefined;
+    readonly code: string;
+}) => Promise<Result<ShaderModule, RhiError>>;
+/** Package-local source projected to the sole public Renderer.subscribe channel. */
+export type RendererHostEvent = {
+    readonly kind: 'error';
+    readonly error: RendererError;
+} | {
+    readonly kind: 'health';
+    readonly health: HealthSnapshot;
+};
+export type RendererHostEventListener = (event: RendererHostEvent) => void;
+/**
+ * Narrow assembly contract consumed by exposeRenderer and constructRendererHost.
+ * Legacy diagnostics remain on RendererLegacyHostAdapter and cannot leak into
+ * the public Renderer type.
+ */
+export interface RendererHostImplementation {
+    attach(world: World): RenderResult<RenderWorldLease, RenderError>;
+    setProfile(profile: RenderProfile): RenderResult<void, RenderError>;
+    inspect(): RenderInspection;
+    drawFrame(request: RenderFrameInput): RenderResult<FrameReceipt, RhiError | RenderError>;
+    observe(receipt: FrameReceipt, request: FrameObservationRequest): Promise<RenderResult<FrameReceiptObservation, RenderError>>;
+    releaseSurface(): RenderResult<void, RhiError>;
+    restoreSurface(): RenderResult<void, RhiError>;
+    recover(): Promise<Result<void, RecoverFailure>>;
+    dispose(): RenderResult<void, RenderError>;
+    /** @internal Single event source used to construct public Renderer.subscribe. */
+    subscribeHostEvents(listener: RendererHostEventListener): () => void;
+    readonly device: RhiDevice;
+    /** @internal */
+    readonly _internal_createShaderModule: RenderShaderModuleFactory;
+    /** @internal */
+    readonly _internal_setRenderOverlay: (overlay: RenderDebugOverlay | undefined) => void;
+    readonly assetRegistry: AssetRegistry;
+    readonly initialization: Promise<RenderResult<void, RhiError>>;
+}
+/**
+ * @internal
+ * Temporary package-local compatibility surface for unmigrated render tests
+ * and producers. It is intentionally absent from RendererHostImplementation.
+ */
+export interface RendererLegacyHostAdapter {
+    attachScene(world: World): RenderResult<void, RhiError>;
+    detachScene(world: World): void;
+    draw(worldsOrRequest: readonly World[] | RenderFrameInput, options?: DrawOwnerOptions): RenderResult<void | FrameReceipt, RhiError | RenderError>;
+    observeCurrentFrame(options: FrameObservationOptions): Promise<RenderResult<FrameObservation, ObservationUnavailableError>>;
+    onLost(listener: RendererLostListener): () => void;
+    onError(listener: RendererErrorListener): () => void;
+    health(): HealthSnapshot;
+    readonly frustumStats: {
+        readonly culled: number;
+        readonly total: number;
+    };
+    readonly visibilityStats: {
+        readonly explicitlyHidden: number;
+    };
+    readonly renderScene: RenderSceneInspection;
+    readonly meshMaterialBindings: readonly MeshMaterialBindingObservation[];
+    readonly perFramePassNames: readonly string[];
+    renderFeatureDiagnostics(): readonly RenderFeatureDiagnostics[];
+    installRenderFeature(feature: RenderFeature<unknown>): Promise<RenderResult<void, RenderError>>;
+    uninstallRenderFeature(feature: RenderFeature<unknown>): Promise<RenderResult<void, RenderError>>;
+    readonly bindGroupCounts: {
+        readonly createBindGroup: number;
+        readonly keys: readonly string[];
+    };
+}
+/** @internal Concrete factory object before it is narrowed by exposeRenderer. */
+export interface RendererAssemblyImplementation extends RendererHostImplementation, RendererLegacyHostAdapter {
+}
+export {};
+//# sourceMappingURL=host-contract.d.ts.map

package/dist/assembly/host-contract.d.ts.map

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

package/dist/assembly/material/assembly.d.ts

@@ -0,0 +1,21 @@
+import type { CookedMaterialRecord } from '@forgeax/engine-pack/material-cook';
+import type { MaterialValue } from '@forgeax/engine-types';
+export interface MaterialRenderPassProjection {
+    readonly name: string;
+    readonly module: string;
+    readonly vertexEntry?: string;
+    readonly fragmentEntry?: string;
+    readonly moduleSlots?: Readonly<Record<string, string>>;
+    readonly renderState?: Readonly<Record<string, unknown>>;
+    readonly artifactHash: string;
+}
+export interface MaterialRenderProjection {
+    readonly materialGuid: string;
+    readonly specializationKey: string;
+    readonly artifactHash: string;
+    readonly passes: readonly MaterialRenderPassProjection[];
+    readonly runtimeValues: Readonly<Record<string, MaterialValue | null>>;
+    readonly staticSelection: readonly string[];
+}
+export declare function assembleMaterialProjection(record: CookedMaterialRecord): MaterialRenderProjection;
+//# sourceMappingURL=assembly.d.ts.map

package/dist/assembly/material/assembly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assembly.d.ts","sourceRoot":"","sources":["../../../src/assembly/material/assembly.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACxD,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACzD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,4BAA4B,EAAE,CAAC;IACzD,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC,CAAC,CAAC;IACvE,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAkBD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,oBAAoB,GAAG,wBAAwB,CASjG"}

package/dist/assembly/material/pipeline-projection.d.ts

@@ -0,0 +1,30 @@
+import type { MaterialRuntimeArtifact } from '@forgeax/engine-shader';
+import type { MaterialValue } from '@forgeax/engine-types';
+import type { MaterialRenderProjection } from './assembly.js';
+export interface MaterialPipelineProjection {
+    readonly specializationKey: string;
+    readonly artifactHash: string;
+    readonly passes: MaterialRenderProjection['passes'];
+}
+export interface MaterialPipelineReady extends MaterialPipelineProjection {
+    readonly kind: 'ready';
+    readonly artifact: MaterialRuntimeArtifact;
+}
+export interface MaterialPipelineMiss {
+    readonly kind: 'error';
+    readonly error: {
+        readonly code: 'material-specialization-not-cooked';
+        readonly expected: string;
+        readonly hint: string;
+        readonly detail: {
+            readonly specializationKey: string;
+        };
+    };
+}
+export declare function projectMaterialPipeline(projection: MaterialRenderProjection): MaterialPipelineProjection;
+export declare function updateMaterialRuntimeValues(projection: MaterialRenderProjection, values: Readonly<Record<string, MaterialValue | null>>): MaterialRenderProjection;
+export declare function routeMaterialPipeline(args: {
+    readonly projection: MaterialRenderProjection;
+    readonly lookupArtifact: (key: string) => MaterialRuntimeArtifact | undefined;
+}): MaterialPipelineReady | MaterialPipelineMiss;
+//# sourceMappingURL=pipeline-projection.d.ts.map

package/dist/assembly/material/pipeline-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-projection.d.ts","sourceRoot":"","sources":["../../../src/assembly/material/pipeline-projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAE9D,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC,QAAQ,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,qBAAsB,SAAQ,0BAA0B;IACvE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;CAC5C;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,IAAI,EAAE,oCAAoC,CAAC;QACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,MAAM,EAAE;YAAE,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;SAAE,CAAC;KACzD,CAAC;CACH;AAED,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,wBAAwB,GACnC,0BAA0B,CAM5B;AAED,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,wBAAwB,EACpC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC,CAAC,GACrD,wBAAwB,CAK1B;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,QAAQ,CAAC,UAAU,EAAE,wBAAwB,CAAC;IAC9C,QAAQ,CAAC,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,uBAAuB,GAAG,SAAS,CAAC;CAC/E,GAAG,qBAAqB,GAAG,oBAAoB,CAc/C"}

package/dist/assets/asset-decoders.d.ts

@@ -0,0 +1,5 @@
+import { type AssetDecoderContribution, type MaterialAsset, type RenderPipelineAsset, type SamplerAsset } from '@forgeax/engine-types';
+export declare const materialContribution: AssetDecoderContribution<MaterialAsset, 'material'>;
+export declare const samplerContribution: AssetDecoderContribution<SamplerAsset, 'sampler'>;
+export declare const renderPipelineContribution: AssetDecoderContribution<RenderPipelineAsset, 'render-pipeline'>;
+//# sourceMappingURL=asset-decoders.d.ts.map

package/dist/assets/asset-decoders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-decoders.d.ts","sourceRoot":"","sources":["../../src/assets/asset-decoders.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,wBAAwB,EAK7B,KAAK,aAAa,EAElB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAmG/B,eAAO,MAAM,oBAAoB,EAAE,wBAAwB,CAAC,aAAa,EAAE,UAAU,CAepF,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,wBAAwB,CAAC,YAAY,EAAE,SAAS,CAUjF,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,wBAAwB,CAC/D,mBAAmB,EACnB,iBAAiB,CAgBlB,CAAC"}

package/dist/assets/render-asset-port.d.ts

@@ -0,0 +1,17 @@
+import type { ShaderRegistry } from '@forgeax/engine-shader';
+import type { Asset } from '@forgeax/engine-types';
+/** Render-only projection supplied by the owner of decoded asset payloads. */
+export interface RenderAssetResolver {
+    readonly epoch: number;
+    lookup<T extends Asset>(guid: string): T | undefined;
+    guidOf(asset: Asset): string | undefined;
+}
+export interface RenderAssetPort {
+    readonly epoch: number;
+    readonly shaderRegistry: ShaderRegistry;
+    lookup<T extends Asset>(guid: string): T | undefined;
+    guidOf(asset: Asset): string | undefined;
+    materialShaderTextureFieldNames(shaderId: string): readonly string[];
+}
+export declare function createRenderAssetPort(shaderRegistry: ShaderRegistry, resolver?: RenderAssetResolver): RenderAssetPort;
+//# sourceMappingURL=render-asset-port.d.ts.map

package/dist/assets/render-asset-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-asset-port.d.ts","sourceRoot":"","sources":["../../src/assets/render-asset-port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAEnD,8EAA8E;AAC9E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,CAAC,SAAS,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IACrD,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,MAAM,CAAC,CAAC,SAAS,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IACrD,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;IACzC,+BAA+B,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;CACtE;AAED,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,cAAc,EAC9B,QAAQ,GAAE,mBAAmC,GAC5C,eAAe,CAgBjB"}

package/dist/assets/resolve-render-asset.d.ts

@@ -0,0 +1,6 @@
+import type { World } from '@forgeax/engine-ecs';
+import type { Asset, Handle, Result } from '@forgeax/engine-types';
+export type RenderAssetResolutionError = ReturnType<World['sharedRefs']['resolve']> extends Result<unknown, infer E> ? E : never;
+/** Resolve a render handle through the World that owns its shared-reference lifetime. */
+export declare function resolveRenderAsset<T extends Asset>(world: World, handle: Handle<string, 'shared'>): Result<T, RenderAssetResolutionError>;
+//# sourceMappingURL=resolve-render-asset.d.ts.map

package/dist/assets/resolve-render-asset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-render-asset.d.ts","sourceRoot":"","sources":["../../src/assets/resolve-render-asset.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEnE,MAAM,MAAM,0BAA0B,GACpC,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAE1F,yFAAyF;AACzF,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,KAAK,EAChD,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAC/B,MAAM,CAAC,CAAC,EAAE,0BAA0B,CAAC,CAEvC"}

package/dist/authoring.d.ts

@@ -0,0 +1,12 @@
+export { GlyphText } from './components/glyph-text';
+export { SpriteAnimation } from './components/sprite-animation';
+export { SpriteInstances, type SpriteInstancesData } from './components/sprite-instances';
+export { SpritePlayback, spritePlaybackModeFromU32 } from './components/sprite-playback-mode';
+export { SpriteRegionOverride } from './components/sprite-region-override';
+export { TileLayer, TilemapSort } from './components/tile-layer';
+export { Tilemap } from './components/tilemap';
+export { createFullscreenRenderFeature, type FullscreenRenderFeatureOptions, } from './features/fullscreen';
+export { SPRITE_PREMULTIPLIED_ALPHA_BLEND } from './materials';
+export { setActiveCamera } from './systems/active-camera';
+export { TransparentSort } from './systems/transparent-sort-config';
+//# sourceMappingURL=authoring.d.ts.map

package/dist/authoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring.d.ts","sourceRoot":"","sources":["../src/authoring.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,KAAK,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAC1F,OAAO,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9F,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EACL,6BAA6B,EAC7B,KAAK,8BAA8B,GACpC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,gCAAgC,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/authoring.mjs

@@ -0,0 +1,27 @@
+export { GlyphText, SpritePlayback, TransparentSort, setActiveCamera, spritePlaybackModeFromU32 } from './chunk-HCOGPHKS.mjs';
+export { SPRITE_PREMULTIPLIED_ALPHA_BLEND, SpriteAnimation, SpriteInstances, SpriteRegionOverride, TileLayer, Tilemap, TilemapSort } from './chunk-CQXZC5XI.mjs';
+import { ok } from '@forgeax/engine-types';
+
+function createFullscreenRenderFeature(options) {
+  const resourceName = `fullscreen.${options.identity.replace(/[^a-z0-9.-]/gi, "-").toLowerCase()}`;
+  return Object.freeze({
+    identity: options.identity,
+    extract: (_context) => ok(void 0),
+    plan: (_data, _context) => ok({
+      resources: [
+        {
+          kind: "fullscreen-program",
+          name: resourceName,
+          source: options.source,
+          ...options.reads === void 0 ? {} : { reads: options.reads },
+          ...options.params === void 0 ? {} : { params: options.params }
+        }
+      ],
+      passes: []
+    })
+  });
+}
+
+export { createFullscreenRenderFeature };
+//# sourceMappingURL=authoring.mjs.map
+//# sourceMappingURL=authoring.mjs.map

package/dist/authoring.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/features/fullscreen.ts"],"names":[],"mappings":";;;;AAwBO,SAAS,8BACd,OAAA,EAC0B;AAC1B,EAAA,MAAM,YAAA,GAAe,cAAc,OAAA,CAAQ,QAAA,CAAS,QAAQ,eAAA,EAAiB,GAAG,CAAA,CAAE,WAAA,EAAa,CAAA,CAAA;AAC/F,EAAA,OAAO,OAAO,MAAA,CAAO;AAAA,IACnB,UAAU,OAAA,CAAQ,QAAA;AAAA,IAClB,OAAA,EAAS,CAAC,QAAA,KAA0C,EAAA,CAAG,MAAS,CAAA;AAAA,IAChE,IAAA,EAAM,CAAC,KAAA,EAAkB,QAAA,KACvB,EAAA,CAAG;AAAA,MACD,SAAA,EAAW;AAAA,QACT;AAAA,UACE,IAAA,EAAM,oBAAA;AAAA,UACN,IAAA,EAAM,YAAA;AAAA,UACN,QAAQ,OAAA,CAAQ,MAAA;AAAA,UAChB,GAAI,QAAQ,KAAA,KAAU,MAAA,GAAY,EAAC,GAAI,EAAE,KAAA,EAAO,OAAA,CAAQ,KAAA,EAAM;AAAA,UAC9D,GAAI,QAAQ,MAAA,KAAW,MAAA,GAAY,EAAC,GAAI,EAAE,MAAA,EAAQ,OAAA,CAAQ,MAAA;AAAO;AACnE,OACF;AAAA,MACA,QAAQ;AAAC,KACkB;AAAA,GAChC,CAAA;AACH","file":"authoring.mjs","sourcesContent":["import { ok } from '@forgeax/engine-types';\nimport type {\n  RenderFeatureFullscreenRead,\n  RenderFeaturePlan,\n  RenderFeaturePlanContext,\n} from './plan';\nimport type { RenderFeature, RenderFeatureExtractContext } from './types';\n\n/** Host-owned fullscreen effect declaration carried by one RenderFeature. */\nexport interface FullscreenRenderFeatureOptions {\n  readonly identity: string;\n  readonly source: string;\n  readonly reads?: readonly RenderFeatureFullscreenRead[];\n  readonly params?: {\n    readonly byteSize: number;\n    readonly defaultValue: Uint8Array;\n  };\n}\n\n/**\n * Describe a fullscreen effect for the single feature host.\n * The producer returns this closed feature; GPU registration and lifetime stay\n * with the renderer host.\n */\nexport function createFullscreenRenderFeature(\n  options: FullscreenRenderFeatureOptions,\n): RenderFeature<undefined> {\n  const resourceName = `fullscreen.${options.identity.replace(/[^a-z0-9.-]/gi, '-').toLowerCase()}`;\n  return Object.freeze({\n    identity: options.identity,\n    extract: (_context: RenderFeatureExtractContext) => ok(undefined),\n    plan: (_data: undefined, _context: RenderFeaturePlanContext) =>\n      ok({\n        resources: [\n          {\n            kind: 'fullscreen-program',\n            name: resourceName,\n            source: options.source,\n            ...(options.reads === undefined ? {} : { reads: options.reads }),\n            ...(options.params === undefined ? {} : { params: options.params }),\n          },\n        ],\n        passes: [],\n      } satisfies RenderFeaturePlan),\n  });\n}\n"]}