@forgeax/engine-render 0.1.21 → 0.1.23

package/dist/chunk-4NPUASZR.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/materials.ts"],"names":[],"mappings":"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","file":"chunk-4NPUASZR.mjs","sourcesContent":["import { DEFAULT_STANDARD_PBR_PARAM_SCHEMA } from '@forgeax/engine-shader';\nimport type {\n  MaterialAsset,\n  MaterialColorSpace,\n  MaterialParameter,\n  MaterialPass,\n  MaterialRenderState,\n  MaterialValue,\n} from '@forgeax/engine-types';\n\nexport type MaterialTransmissionValidationReason =\n  | 'non-finite'\n  | 'range'\n  | 'shape'\n  | 'blend'\n  | 'depth-write';\n\n/** Structured authoring failure for the Standard transmission contract. */\nexport class MaterialTransmissionContractError extends Error {\n  readonly code = 'material-transmission-contract-invalid' as const;\n  readonly expected = 'transmission material values satisfy finite ranges and Forward depth rules';\n  readonly hint =\n    'repair the named transmission value or pass state before publishing the material';\n  readonly detail: {\n    readonly code: 'material-transmission-contract-invalid';\n    readonly material: 'Standard';\n    readonly parameter:\n      | 'transmission'\n      | 'ior'\n      | 'thickness'\n      | 'attenuationColor'\n      | 'attenuationDistance';\n    readonly reason: MaterialTransmissionValidationReason;\n    readonly actual?: unknown;\n  };\n\n  constructor(\n    parameter: (typeof MaterialTransmissionContractError.prototype.detail)['parameter'],\n    reason: MaterialTransmissionValidationReason,\n    actual?: unknown,\n  ) {\n    super(`Materials.standard: ${parameter} violates the transmission contract (${reason})`);\n    this.name = 'MaterialTransmissionContractError';\n    this.detail = {\n      code: 'material-transmission-contract-invalid',\n      material: 'Standard',\n      parameter,\n      reason,\n      ...(actual === undefined ? {} : { actual }),\n    };\n  }\n}\n\nexport const SPRITE_PREMULTIPLIED_ALPHA_BLEND: GPUBlendState = {\n  color: { srcFactor: 'one', dstFactor: 'one-minus-src-alpha', operation: 'add' },\n  alpha: { srcFactor: 'one', dstFactor: 'one-minus-src-alpha', operation: 'add' },\n};\n\nconst STANDARD_MODULE = 'forgeax_material::standard';\nconst UNLIT_MODULE = 'forgeax_material::unlit';\nconst SPRITE_MODULE = 'forgeax_material::sprite';\n\nfunction authoredColorParameter(\n  name: string,\n  type: 'color' | 'vec3',\n  colorSpace: MaterialColorSpace,\n  optional = false,\n): MaterialParameter {\n  return {\n    name,\n    type,\n    ...(type === 'color' && colorSpace === 'srgb' ? {} : { colorSpace }),\n    ...(optional ? { optional: true } : {}),\n  };\n}\n\nfunction standardParameters(colorSpace: MaterialColorSpace): readonly MaterialParameter[] {\n  return DEFAULT_STANDARD_PBR_PARAM_SCHEMA.map((entry) => {\n    const type = entry.type.startsWith('texture') ? 'texture' : entry.type;\n    const isRequired =\n      entry.name === 'baseColor' || entry.name === 'metallic' || entry.name === 'roughness';\n    const authoredColor =\n      entry.type === 'color' || (entry.type === 'vec3' && entry.name !== 'attenuationColor');\n    const schemaColorSpace = 'colorSpace' in entry ? entry.colorSpace : undefined;\n    const colorSpaceProjection: { colorSpace?: MaterialColorSpace } = {};\n    if (authoredColor && !(type === 'color' && colorSpace === 'srgb')) {\n      colorSpaceProjection.colorSpace = colorSpace;\n    } else if (!authoredColor && schemaColorSpace !== undefined) {\n      colorSpaceProjection.colorSpace = schemaColorSpace;\n    }\n    return {\n      name: entry.name,\n      type,\n      ...colorSpaceProjection,\n      ...(isRequired ? {} : { optional: true }),\n    } as MaterialParameter;\n  });\n}\n\nfunction unlitParameters(colorSpace: MaterialColorSpace): readonly MaterialParameter[] {\n  return [\n    authoredColorParameter('baseColor', 'color', colorSpace),\n    { name: 'alphaCutoff', type: 'f32', optional: true },\n    { name: 'baseColorTexture', type: 'texture', optional: true },\n  ];\n}\n\nfunction pass(\n  name: string,\n  module: string,\n  renderState: MaterialRenderState | undefined,\n  fragmentEntry?: string,\n  queue?: number,\n): MaterialPass {\n  const lightMode =\n    name === 'shadow-caster' ? 'ShadowCaster' : name === 'deferred' ? 'Deferred' : 'Forward';\n  const authoredState = (renderState ?? {}) as Readonly<Record<string, unknown>>;\n  const authoredTags = authoredState.tags as Readonly<Record<string, string>> | undefined;\n  return {\n    name,\n    program: {\n      module,\n      ...(fragmentEntry === undefined ? {} : { fragmentEntry }),\n    },\n    renderState: {\n      ...authoredState,\n      tags: { LightMode: lightMode, ...authoredTags },\n      ...(queue === undefined ? {} : { queue }),\n    },\n  };\n}\n\nfunction shadowCasterRenderState(\n  renderState: MaterialRenderState | undefined,\n): MaterialRenderState | undefined {\n  if (renderState?.cullMode === undefined && renderState?.frontFace === undefined) return undefined;\n  return {\n    ...(renderState.cullMode === undefined ? {} : { cullMode: renderState.cullMode }),\n    ...(renderState.frontFace === undefined ? {} : { frontFace: renderState.frontFace }),\n  };\n}\n\ninterface UnlitOpts {\n  /** Asset-side authored color space. Defaults to sRGB. */\n  readonly colorSpace?: MaterialColorSpace;\n  readonly castShadow?: boolean;\n  readonly baseColorTexture?: MaterialValue;\n  readonly alphaCutoff?: number;\n  readonly renderState?: MaterialRenderState;\n  readonly queue?: number;\n}\n\nfunction unlit(rgba: readonly [number, number, number, number], opts?: UnlitOpts): MaterialAsset {\n  if (opts?.alphaCutoff !== undefined && (opts.alphaCutoff < 0 || opts.alphaCutoff > 1)) {\n    throw new Error(`Materials.unlit: alphaCutoff must be in [0, 1], got ${opts.alphaCutoff}`);\n  }\n  const values: Record<string, MaterialValue> = { baseColor: rgba };\n  if (opts?.baseColorTexture !== undefined) values.baseColorTexture = opts.baseColorTexture;\n  if (opts?.alphaCutoff !== undefined) values.alphaCutoff = opts.alphaCutoff;\n  const passes: [MaterialPass, ...MaterialPass[]] = [\n    pass('forward', UNLIT_MODULE, opts?.renderState, undefined, opts?.queue),\n  ];\n  if (opts?.castShadow !== false) {\n    passes.push(pass('shadow-caster', UNLIT_MODULE, shadowCasterRenderState(opts?.renderState)));\n  }\n  return {\n    kind: 'material',\n    ...(opts?.colorSpace === undefined || opts.colorSpace === 'srgb'\n      ? {}\n      : { colorSpace: opts.colorSpace }),\n    passes,\n    parameters: unlitParameters(opts?.colorSpace ?? 'srgb'),\n    values,\n  };\n}\n\ninterface StandardOpts {\n  /** Asset-side authored color space for baseColor/emissive/specularTint. Defaults to sRGB. */\n  readonly colorSpace?: MaterialColorSpace;\n  readonly baseColor: readonly [number, number, number, number];\n  readonly metallic?: number;\n  readonly roughness?: number;\n  /** Texture channel used for the metallic factor; glTF defaults to B (2). */\n  readonly metallicChannel?: number;\n  /** Texture channel used for the roughness factor; glTF defaults to G (1). */\n  readonly roughnessChannel?: number;\n  readonly clearcoat?: number;\n  readonly clearcoatRoughness?: number;\n  readonly specularTint?: readonly [number, number, number];\n  readonly specularTintTexture?: MaterialValue;\n  readonly emissive?: readonly [number, number, number];\n  readonly emissiveIntensity?: number;\n  readonly emissiveTexture?: MaterialValue;\n  readonly baseColorTexture?: MaterialValue;\n  readonly metallicRoughnessTexture?: MaterialValue;\n  readonly normalTexture?: MaterialValue;\n  readonly occlusionTexture?: MaterialValue;\n  readonly occlusionStrength?: number;\n  readonly alphaCutoff?: number;\n  readonly transmission?: number;\n  readonly transmissionTexture?: MaterialValue;\n  readonly ior?: number;\n  readonly thickness?: number;\n  readonly thicknessTexture?: MaterialValue;\n  readonly attenuationColor?: readonly [number, number, number];\n  readonly attenuationDistance?: number;\n  readonly renderState?: MaterialRenderState;\n  readonly castShadow?: boolean;\n  readonly queue?: number;\n}\n\nfunction validateChannel(\n  name: 'metallicChannel' | 'roughnessChannel',\n  value: number | undefined,\n): void {\n  if (value !== undefined && (!Number.isInteger(value) || value < 0 || value > 3)) {\n    throw new Error(`Materials.standard: ${name} must be an integer in [0, 3], got ${value}`);\n  }\n}\n\nfunction validateFiniteRange(\n  name: 'transmission' | 'ior' | 'thickness' | 'attenuationDistance',\n  value: number | undefined,\n  minimum: number,\n  maximum?: number,\n): void {\n  if (value === undefined || !Number.isFinite(value)) {\n    if (value === undefined) return;\n    throw new MaterialTransmissionContractError(name, 'non-finite', value);\n  }\n  if (value < minimum || (maximum !== undefined && value > maximum)) {\n    throw new MaterialTransmissionContractError(name, 'range', value);\n  }\n}\n\nfunction standard(opts: StandardOpts): MaterialAsset {\n  const occlusionStrength = opts.occlusionStrength ?? 1;\n  if (occlusionStrength < 0 || occlusionStrength > 1) {\n    throw new Error(\n      `Materials.standard: occlusionStrength must be in [0, 1], got ${occlusionStrength}`,\n    );\n  }\n  if (opts.alphaCutoff !== undefined && (opts.alphaCutoff < 0 || opts.alphaCutoff > 1)) {\n    throw new Error(`Materials.standard: alphaCutoff must be in [0, 1], got ${opts.alphaCutoff}`);\n  }\n  validateChannel('metallicChannel', opts.metallicChannel);\n  validateChannel('roughnessChannel', opts.roughnessChannel);\n  const transmission = opts.transmission ?? 0;\n  const ior = opts.ior ?? 1.5;\n  const thickness = opts.thickness ?? 0;\n  const attenuationColor = opts.attenuationColor ?? [1, 1, 1];\n  validateFiniteRange('transmission', transmission, 0, 1);\n  validateFiniteRange('ior', ior, 1);\n  validateFiniteRange('thickness', thickness, 0);\n  validateFiniteRange('attenuationDistance', opts.attenuationDistance, Number.MIN_VALUE);\n  if (\n    attenuationColor.length !== 3 ||\n    attenuationColor.some((value) => !Number.isFinite(value) || value < 0 || value > 1)\n  ) {\n    throw new MaterialTransmissionContractError('attenuationColor', 'shape', attenuationColor);\n  }\n  if (transmission > 0 && opts.renderState?.blend !== undefined) {\n    throw new MaterialTransmissionContractError('transmission', 'blend', opts.renderState.blend);\n  }\n  if (transmission > 0 && opts.renderState?.depthWriteEnabled === true) {\n    throw new MaterialTransmissionContractError('transmission', 'depth-write', true);\n  }\n  const values: Record<string, MaterialValue> = {\n    baseColor: opts.baseColor,\n    metallic: opts.metallic ?? 0,\n    roughness: opts.roughness ?? 0.5,\n    occlusionStrength,\n    specularTint: opts.specularTint ?? [1, 1, 1],\n    transmission,\n    ior,\n    thickness,\n    attenuationColor,\n  };\n  if (opts.metallicChannel !== undefined) values.metallicChannel = opts.metallicChannel;\n  if (opts.roughnessChannel !== undefined) values.roughnessChannel = opts.roughnessChannel;\n  if (opts.clearcoat !== undefined) values.clearcoat = opts.clearcoat;\n  if (opts.clearcoatRoughness !== undefined) values.clearcoatRoughness = opts.clearcoatRoughness;\n  if (opts.emissive !== undefined) values.emissive = opts.emissive;\n  if (opts.emissiveIntensity !== undefined) values.emissiveIntensity = opts.emissiveIntensity;\n  if (opts.emissiveTexture !== undefined) values.emissiveTexture = opts.emissiveTexture;\n  if (opts.baseColorTexture !== undefined) values.baseColorTexture = opts.baseColorTexture;\n  if (opts.metallicRoughnessTexture !== undefined) {\n    values.metallicRoughnessTexture = opts.metallicRoughnessTexture;\n  }\n  if (opts.normalTexture !== undefined) values.normalTexture = opts.normalTexture;\n  if (opts.occlusionTexture !== undefined) values.occlusionTexture = opts.occlusionTexture;\n  if (opts.specularTintTexture !== undefined) {\n    values.specularTintTexture = opts.specularTintTexture;\n  }\n  if (opts.alphaCutoff !== undefined) values.alphaCutoff = opts.alphaCutoff;\n  if (opts.transmissionTexture !== undefined) values.transmissionTexture = opts.transmissionTexture;\n  if (opts.thicknessTexture !== undefined) values.thicknessTexture = opts.thicknessTexture;\n  if (opts.attenuationDistance !== undefined) values.attenuationDistance = opts.attenuationDistance;\n  const forwardRenderState =\n    transmission > 0 ? { ...(opts.renderState ?? {}), depthWriteEnabled: false } : opts.renderState;\n  const passes: [MaterialPass, ...MaterialPass[]] = [\n    pass('forward', STANDARD_MODULE, forwardRenderState, 'fs_main', opts.queue),\n  ];\n  if (transmission === 0) {\n    passes.push(pass('deferred', STANDARD_MODULE, opts.renderState, 'fs_gbuffer', opts.queue));\n  }\n  if (opts.castShadow !== false) {\n    passes.push(pass('shadow-caster', STANDARD_MODULE, shadowCasterRenderState(opts.renderState)));\n  }\n  return {\n    kind: 'material',\n    ...(opts.colorSpace === undefined || opts.colorSpace === 'srgb'\n      ? {}\n      : { colorSpace: opts.colorSpace }),\n    passes,\n    parameters: standardParameters(opts.colorSpace ?? 'srgb'),\n    values,\n  };\n}\n\nexport const Materials = { unlit, standard } as const;\n\nexport { SPRITE_MODULE };\n"]}