@call-me-sensei/toonlab 0.3.1 → 0.4.20

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (761) hide show
  1. package/NPM-LIBRARY.md +225 -0
  2. package/README.md +588 -184
  3. package/agents/PROMPTS.md +87 -0
  4. package/agents/README.md +54 -0
  5. package/agents/claude/CLAUDE.md +8 -0
  6. package/agents/codex/AGENTS.md +159 -0
  7. package/agents/cursor/toonlab.mdc +37 -0
  8. package/agents/references/anime-art-direction.md +24 -0
  9. package/agents/references/asset-sourcing-policy.md +23 -0
  10. package/agents/references/custom-gap-report.md +16 -0
  11. package/agents/references/mcp-asset-discovery.md +104 -0
  12. package/agents/references/runtime-entry-points.md +175 -0
  13. package/agents/references/style-bundles.md +71 -0
  14. package/agents/skills/claude/asset-sourcing/SKILL.md +275 -0
  15. package/agents/skills/claude/environment/SKILL.md +59 -0
  16. package/agents/skills/claude/game-dev/SKILL.md +100 -0
  17. package/agents/skills/claude/post-processing/SKILL.md +44 -0
  18. package/agents/skills/claude/rock-ground-shaders/SKILL.md +134 -0
  19. package/agents/skills/claude/rockgen/SKILL.md +30 -0
  20. package/agents/skills/claude/scene-style-application/SKILL.md +74 -0
  21. package/agents/skills/claude/style-presets/SKILL.md +101 -0
  22. package/agents/skills/claude/toon-shading/SKILL.md +44 -0
  23. package/agents/skills/claude/vegetation-sky/SKILL.md +167 -0
  24. package/agents/skills/claude/visual-verification/SKILL.md +136 -0
  25. package/agents/skills/claude/water/SKILL.md +105 -0
  26. package/agents/skills/codex/asset-sourcing/SKILL.md +275 -0
  27. package/agents/skills/codex/environment/SKILL.md +59 -0
  28. package/agents/skills/codex/game-dev/SKILL.md +100 -0
  29. package/agents/skills/codex/post-processing/SKILL.md +44 -0
  30. package/agents/skills/codex/rock-ground-shaders/SKILL.md +134 -0
  31. package/agents/skills/codex/rockgen/SKILL.md +30 -0
  32. package/agents/skills/codex/scene-style-application/SKILL.md +74 -0
  33. package/agents/skills/codex/style-presets/SKILL.md +101 -0
  34. package/agents/skills/codex/toon-shading/SKILL.md +44 -0
  35. package/agents/skills/codex/vegetation-sky/SKILL.md +167 -0
  36. package/agents/skills/codex/visual-verification/SKILL.md +136 -0
  37. package/agents/skills/codex/water/SKILL.md +105 -0
  38. package/cli/toonlab.mjs +53 -0
  39. package/compose.yaml +20 -0
  40. package/database/apply-sql.mjs +141 -0
  41. package/database/client.mjs +39 -0
  42. package/database/creation-tags.mjs +23 -0
  43. package/database/env.mjs +16 -0
  44. package/database/fal-patina.mjs +131 -0
  45. package/database/generation-service.mjs +415 -0
  46. package/database/migrations/0001_local_workspace.sql +120 -0
  47. package/database/migrations/0002_file_ownership.sql +11 -0
  48. package/database/migrations/0003_remove_autosaves_from_library.sql +7 -0
  49. package/database/migrations/0004_catalog_asset_packs.sql +39 -0
  50. package/database/migrations/0005_creation_tag_discovery.sql +1 -0
  51. package/database/migrations/0006_normalize_creation_tags.sql +28 -0
  52. package/database/migrations/0007_creation_revisions.sql +80 -0
  53. package/database/migrations/0008_creation_revision_hardening.sql +98 -0
  54. package/database/migrations/0009_creation_revision_delete_integrity.sql +11 -0
  55. package/database/migrations/0010_external_catalog_assets.sql +28 -0
  56. package/database/providers.mjs +644 -0
  57. package/database/repository.mjs +1073 -0
  58. package/database/seeds/catalog/0001_empty_official_catalog.sql +4 -0
  59. package/database/seeds/catalog/0002_2026-08.sql +19454 -0
  60. package/database/seeds/catalog/0003_2026-08-open-assets.sql +159086 -0
  61. package/database/seeds/catalog/0004_2026-08-c7-rocks.sql +39405 -0
  62. package/mcp/lab-management.mjs +629 -0
  63. package/mcp/public-catalog.mjs +168 -0
  64. package/mcp/server.mjs +1044 -63
  65. package/mcp/vite-plugin.mjs +519 -26
  66. package/mcp/workspace.mjs +26 -1
  67. package/package.json +334 -46
  68. package/scripts/generate-catalog-seed.mjs +324 -0
  69. package/scripts/setup-local.mjs +128 -0
  70. package/src/agents/index.js +7 -0
  71. package/src/agents/sceneStyleOperations.js +169 -0
  72. package/src/asset-policy/catalogLicenses.js +102 -0
  73. package/src/asset-policy/index.js +315 -0
  74. package/src/assetlib/assetRef.js +1 -1
  75. package/src/assetlib/galleryMaterialFamily.js +165 -0
  76. package/src/assetlib/index.js +6 -2
  77. package/src/assetlib/loadImported.js +15 -1
  78. package/src/assetlib/plateau.js +188 -0
  79. package/src/assetlib/plateauLandmarks.js +144 -0
  80. package/src/assetlib/plateauViewer.js +348 -0
  81. package/src/assetlib/sources.js +16 -2
  82. package/src/catalog/manifest.js +11 -1
  83. package/src/catalog/officialCatalog.js +4 -0
  84. package/src/catalog/officialCatalogAssetRuntime.js +324 -0
  85. package/src/catalog/officialCatalogLod.js +183 -0
  86. package/src/catalog/officialCatalogPlacement.js +243 -0
  87. package/src/catalog/officialCatalogProvider.js +334 -0
  88. package/src/character/animationRetarget.js +1084 -0
  89. package/src/character/characterRig.js +6 -1
  90. package/src/character/characterRuntime.js +544 -0
  91. package/src/character/groundStabilizer.js +137 -0
  92. package/src/character/index.js +8 -0
  93. package/src/character/locomotionActions.js +74 -0
  94. package/src/character/locomotionStateMachine.js +241 -0
  95. package/src/character/mannequinAsset.js +15 -0
  96. package/src/character/mannequinAssetUrl.browser.js +4 -0
  97. package/src/character/mannequinAssetUrl.node.js +3 -0
  98. package/src/character/modelLoader.js +92 -12
  99. package/src/character/walkableCharacterRuntime.js +284 -0
  100. package/src/character/waterInteractionController.js +217 -0
  101. package/src/cloud/ambientSkyBaker.js +248 -0
  102. package/src/cloud/cloudLighting.js +1114 -0
  103. package/src/cloud/cloudParams.js +819 -0
  104. package/src/cloud/cloudReprojection.js +563 -0
  105. package/src/cloud/cloudStyle.js +780 -0
  106. package/src/cloud/cloudStyleSnapshots.js +387 -0
  107. package/src/cloud/cloudVolume.js +1903 -0
  108. package/src/cloud/heroCloudRecipe.js +404 -0
  109. package/src/cloud/index.js +42 -0
  110. package/src/cloud/noise/baseShapeVolume.js +331 -0
  111. package/src/cloud/noise/cirrusMap.js +131 -0
  112. package/src/cloud/noise/curlNoise.js +289 -0
  113. package/src/cloud/noise/erosionVolume.js +188 -0
  114. package/src/cloud/noise/noiseVolume.js +202 -0
  115. package/src/cloud/noise/periodicNoise3.js +295 -0
  116. package/src/cloud/noise/weatherMap.js +470 -0
  117. package/src/cloud/paramSchema.js +458 -0
  118. package/src/collisionMetadata.js +320 -0
  119. package/src/core/systemStylePolicy.js +32 -0
  120. package/src/environment/dayCurves.js +146 -0
  121. package/src/environment/environmentGroundFieldPass.js +354 -0
  122. package/src/environment/environmentMaterialAdapter.js +144 -6
  123. package/src/environment/environmentPresets.js +486 -90
  124. package/src/environment/environmentRigs.js +17 -2
  125. package/src/environment/environmentSettings.js +37 -1
  126. package/src/environment/environmentShaderMaterials.js +37 -6
  127. package/src/environment/environmentState.js +133 -0
  128. package/src/environment/environmentSunShadowPass.js +399 -6
  129. package/src/environment/environmentTextureResolver.js +7 -0
  130. package/src/environment/index.js +51 -0
  131. package/src/environment/manufacturedMaterialContract.js +837 -0
  132. package/src/environment/manufacturedReflectionProvider.js +114 -0
  133. package/src/environment/scanAssetStylize.js +4 -4
  134. package/src/environment/surfaceMaterialModes.js +71 -0
  135. package/src/environment/toonLabEnvironmentMaterials.js +353 -0
  136. package/src/environment/toonLabMaterialPassCoupling.js +347 -0
  137. package/src/environment/toonLabNormalIntegration.js +171 -0
  138. package/src/environment/toonLabRockMaterialResolver.js +592 -0
  139. package/src/environment/toonLabSourceDefaultLit.js +444 -0
  140. package/src/environment/toonLabSourceLibrary.js +762 -0
  141. package/src/environment/toonLabSourceMaterials.js +3718 -0
  142. package/src/environment/toonLabSourceSubsurfaceLighting.js +415 -0
  143. package/src/environment/toonLabSourceTemporal.js +717 -0
  144. package/src/environment/toonLabSurfaceLighting.js +462 -0
  145. package/src/environment/toonLabTextureReadiness.js +105 -0
  146. package/src/environment/toonLabTreeMaterials.js +450 -0
  147. package/src/environment/transparentMaterialProfile.js +87 -0
  148. package/src/environment/urbanPropMaterial.js +2976 -0
  149. package/src/ground-shader/groundPrintLayer.js +375 -0
  150. package/src/ground-shader/groundShaderMaterial.js +851 -0
  151. package/src/ground-shader/groundShaderSettings.js +468 -0
  152. package/src/ground-shader/index.js +3 -0
  153. package/src/index.js +52 -22
  154. package/src/lighting/callMeSenseiLightingContract.js +163 -0
  155. package/src/lighting/index.js +14 -7
  156. package/src/lighting/lightingCapabilities.js +2 -2
  157. package/src/lighting/lightingPresets.js +6 -3
  158. package/src/lighting/lightingStyle.js +41 -6
  159. package/src/lighting/lightingSystem.js +200 -6
  160. package/src/lighting/{unrealExport.js → toonLabExport.js} +40 -41
  161. package/src/post/postProcessing.js +71 -12
  162. package/src/react/index.js +66 -0
  163. package/src/renderer/index.js +16 -0
  164. package/src/renderer/rendererConfiguration.js +250 -0
  165. package/src/renderer/styleComparison.js +985 -0
  166. package/src/rock-shader/index.js +8 -0
  167. package/src/rock-shader/rockGeometryDetail.js +701 -0
  168. package/src/rock-shader/rockMaterial.js +2586 -0
  169. package/src/rock-shader/rockRegionRuntime.js +185 -0
  170. package/src/rock-shader/rockSemanticMaterialRuntime.js +337 -0
  171. package/src/rock-shader/rockShaderRuntime.js +781 -0
  172. package/src/rock-shader/rockShaderSettings.js +1099 -0
  173. package/src/rock-shader/rockTangentIntegrity.js +136 -0
  174. package/src/rock-shader/rockTextureIntegrity.js +115 -0
  175. package/src/rockgen/export/glbExport.js +104 -14
  176. package/src/rockgen/index.js +5 -3
  177. package/src/rockgen/lod/index.js +6 -0
  178. package/src/rockgen/lod/rockLodMetrics.js +168 -0
  179. package/src/rockgen/lod/rockLodPlanner.js +372 -0
  180. package/src/rockgen/lod/rockLodPolicy.js +235 -0
  181. package/src/rockgen/lod/rockLodRuntime.js +124 -0
  182. package/src/rockgen/lod/rockLodSimplifier.js +173 -0
  183. package/src/rockgen/lod/rockLodValidation.js +113 -0
  184. package/src/rockgen/mesh/meshAttributes.js +17 -0
  185. package/src/rockgen/mesh/meshDocument.js +6 -0
  186. package/src/rockgen/rockDocument.js +376 -9
  187. package/src/rockgen/rockgenPresets.js +114 -13
  188. package/src/rockgen/rockgenSettings.js +62 -11
  189. package/src/rockgen/surface/c7GeologySurface.js +372 -0
  190. package/src/runtime/index.js +14 -0
  191. package/src/runtime/sceneCollisionRuntime.js +317 -0
  192. package/src/runtime/sceneSurfaceRuntime.js +451 -0
  193. package/src/runtime/sceneUpdateScheduler.js +203 -0
  194. package/src/shaders-tsl/anime.js +9 -2
  195. package/src/shaders-tsl/chunks/environment-ground-field.js +174 -0
  196. package/src/shaders-tsl/chunks/environment-state.js +79 -0
  197. package/src/shaders-tsl/chunks/environment-sun-shadow.js +99 -32
  198. package/src/shaders-tsl/chunks/normalized-hue.js +41 -0
  199. package/src/shaders-tsl/chunks/pass-depth-color.js +4 -2
  200. package/src/shaders-tsl/chunks/scene-depth-color-pass.js +273 -0
  201. package/src/shaders-tsl/chunks/vegetation-style.js +116 -8
  202. package/src/shaders-tsl/chunks/water-color.js +19 -5
  203. package/src/shaders-tsl/chunks/water-shore-state.js +8 -1
  204. package/src/shaders-tsl/chunks/world-noise.js +30 -0
  205. package/src/shaders-tsl/environment.js +123 -17
  206. package/src/shaders-tsl/flower.js +51 -8
  207. package/src/shaders-tsl/grass.js +194 -29
  208. package/src/shaders-tsl/post-composite.js +83 -2
  209. package/src/shaders-tsl/tree-leaf.js +107 -16
  210. package/src/shaders-tsl/water-breaker.js +18 -4
  211. package/src/shaders-tsl/water.js +51 -3
  212. package/src/shaders-tsl/woody-surface.js +59 -7
  213. package/src/sky/atmosphereDome.js +193 -0
  214. package/src/sky/atmosphereParams.js +396 -0
  215. package/src/sky/atmosphereScattering.js +593 -0
  216. package/src/sky/atmosphereSky.js +371 -0
  217. package/src/sky/cloudShadow.js +379 -0
  218. package/src/sky/godRays.js +257 -0
  219. package/src/sky/index.js +55 -1
  220. package/src/sky/nightSky.js +1190 -0
  221. package/src/sky/renderLayers.js +120 -0
  222. package/src/sky/skyColor.js +582 -0
  223. package/src/sky/skyDayCycle.js +244 -0
  224. package/src/sky/skyParams.js +661 -0
  225. package/src/sky/skyPresets.js +772 -0
  226. package/src/sky/skyQualityTiers.js +383 -0
  227. package/src/sky/skyShaderSettings.js +699 -0
  228. package/src/sky/skyStyleSnapshots.js +211 -0
  229. package/src/sky/skySystem.js +1447 -0
  230. package/src/sky/skyTimeKeyframes.js +361 -0
  231. package/src/sky/stylizedSky.js +405 -116
  232. package/src/sky/sunDriver.js +499 -0
  233. package/src/sky/timeOfDay.js +335 -0
  234. package/src/styles/animeGameProfile.js +44 -0
  235. package/src/styles/index.js +157 -0
  236. package/src/styles/manufacturedStyleLabeling.js +204 -0
  237. package/src/styles/neutralStylePresets.js +712 -0
  238. package/src/styles/sceneLayerDocuments.js +185 -0
  239. package/src/styles/sceneLookComposition.js +156 -0
  240. package/src/styles/sceneQualityApplication.js +152 -0
  241. package/src/styles/sceneQualityProfiles.js +268 -0
  242. package/src/styles/sceneStyleAudit.js +512 -0
  243. package/src/styles/sceneStyleRuntime.js +923 -0
  244. package/src/styles/styleAdapters.js +177 -0
  245. package/src/styles/styleApplication.js +369 -0
  246. package/src/styles/styleBundle.js +445 -92
  247. package/src/styles/styleBundleProvider.js +83 -0
  248. package/src/styles/styleDomains.js +21 -0
  249. package/src/styles/styleInspector.js +262 -0
  250. package/src/styles/styleMaterialContract.js +375 -0
  251. package/src/styles/styleMetadata.js +73 -0
  252. package/src/styles/styleTargetDiscovery.js +162 -0
  253. package/src/styles/styleTargetLabels.js +206 -0
  254. package/src/styles/styleTargetMaterialCoverage.js +137 -0
  255. package/src/styles/styleTransaction.js +272 -0
  256. package/src/texgen/evaluateTexture.js +30 -3
  257. package/src/texgen/textureGenerators.js +83 -35
  258. package/src/texgen/textureSettings.js +25 -8
  259. package/src/toon/toonSettings.js +100 -2
  260. package/src/vegetation/branchTree.js +587 -0
  261. package/src/vegetation/callMeSenseiGrass.js +183 -0
  262. package/src/vegetation/compiledTree.js +506 -0
  263. package/src/vegetation/contactShadowField.js +107 -0
  264. package/src/vegetation/flowerSpecies.js +10 -2
  265. package/src/vegetation/grass.js +13 -0
  266. package/src/vegetation/grassClump.js +1179 -0
  267. package/src/vegetation/importedVegetationMaterial.js +183 -0
  268. package/src/vegetation/index.js +17 -1
  269. package/src/vegetation/legacyTreePresets.js +120 -0
  270. package/src/vegetation/scatter.js +688 -3
  271. package/src/vegetation/stylizedBush.js +14 -0
  272. package/src/vegetation/stylizedFlower.js +31 -0
  273. package/src/vegetation/stylizedFlowers.js +59 -7
  274. package/src/vegetation/stylizedForest.js +455 -147
  275. package/src/vegetation/stylizedGrass.js +188 -24
  276. package/src/vegetation/stylizedTree.js +676 -54
  277. package/src/vegetation/stylizedTreeFoliage.js +1111 -38
  278. package/src/vegetation/stylizedUnderstory.js +230 -0
  279. package/src/vegetation/treeExport.js +262 -47
  280. package/src/vegetation/treeSurfaceTextures.js +665 -0
  281. package/src/vegetation/vegetationShaders.js +617 -28
  282. package/src/version.js +3 -0
  283. package/src/water/water.js +2 -0
  284. package/src/water/waterBreakerSystem.js +2 -0
  285. package/src/water/waterCurrentField.js +1 -0
  286. package/src/water/waterMaterial.js +3 -0
  287. package/src/water/waterRain.js +2 -0
  288. package/src/water/waterScenePasses.js +170 -7
  289. package/src/water/waterSettings.js +250 -50
  290. package/src/water/waterShoreMaterial.js +16 -2
  291. package/src/water/waterShoreStateField.js +1 -1
  292. package/src/water/waterSplashSystem.js +2 -0
  293. package/src/water/waterStageSettings.js +60 -0
  294. package/src/water/waterSurface.js +144 -4
  295. package/src/water/waterUnderwaterAtmosphere.js +288 -0
  296. package/src/water/waterVegetation.js +20 -4
  297. package/src/worldCollision.js +64 -9
  298. package/types/agents/index.d.ts +1 -0
  299. package/types/agents/sceneStyleOperations.d.ts +484 -0
  300. package/types/asset-policy/catalogLicenses.d.ts +7 -0
  301. package/types/asset-policy/index.d.ts +20 -0
  302. package/types/assetlib/ambientcg.d.ts +81 -0
  303. package/types/assetlib/assetRef.d.ts +26 -0
  304. package/types/assetlib/galleryMaterialFamily.d.ts +13 -0
  305. package/types/assetlib/importedEntry.d.ts +18 -0
  306. package/types/assetlib/index.d.ts +16 -0
  307. package/types/assetlib/kaykit.d.ts +112 -0
  308. package/types/assetlib/kaykitStaticIndex.d.ts +38 -0
  309. package/types/assetlib/loadImported.d.ts +56 -0
  310. package/types/assetlib/opensource3d.d.ts +55 -0
  311. package/types/assetlib/plateau.d.ts +67 -0
  312. package/types/assetlib/plateauLandmarks.d.ts +238 -0
  313. package/types/assetlib/plateauViewer.d.ts +3 -0
  314. package/types/assetlib/polyhaven.d.ts +90 -0
  315. package/types/assetlib/polypizza.d.ts +10 -0
  316. package/types/assetlib/smithsonian.d.ts +9 -0
  317. package/types/assetlib/sources.d.ts +22 -0
  318. package/types/assetlib/zip.d.ts +8 -0
  319. package/types/catalog/manifest.d.ts +26 -0
  320. package/types/catalog/officialCatalog.d.ts +4 -0
  321. package/types/catalog/officialCatalogAssetRuntime.d.ts +2 -0
  322. package/types/catalog/officialCatalogLod.d.ts +63 -0
  323. package/types/catalog/officialCatalogPlacement.d.ts +49 -0
  324. package/types/catalog/officialCatalogProvider.d.ts +7 -0
  325. package/types/character/animationRetarget.d.ts +20 -0
  326. package/types/character/characterRig.d.ts +87 -0
  327. package/types/character/characterRuntime.d.ts +5 -0
  328. package/types/character/freestyleSwimClip.d.ts +5 -0
  329. package/types/character/groundStabilizer.d.ts +55 -0
  330. package/types/character/index.d.ts +10 -0
  331. package/types/character/locomotionActions.d.ts +4 -0
  332. package/types/character/locomotionStateMachine.d.ts +62 -0
  333. package/types/character/mannequinAsset.d.ts +12 -0
  334. package/types/character/mannequinAssetUrl.node.d.ts +1 -0
  335. package/types/character/modelLoader.d.ts +7 -0
  336. package/types/character/walkableCharacterRuntime.d.ts +343 -0
  337. package/types/character/waterInteractionController.d.ts +114 -0
  338. package/types/cloud/ambientSkyBaker.d.ts +18 -0
  339. package/types/cloud/cloudLighting.d.ts +38 -0
  340. package/types/cloud/cloudParams.d.ts +18 -0
  341. package/types/cloud/cloudReprojection.d.ts +15 -0
  342. package/types/cloud/cloudStyle.d.ts +1380 -0
  343. package/types/cloud/cloudStyleSnapshots.d.ts +10 -0
  344. package/types/cloud/cloudVolume.d.ts +43 -0
  345. package/types/cloud/heroCloudRecipe.d.ts +167 -0
  346. package/types/cloud/index.d.ts +12 -0
  347. package/types/cloud/noise/baseShapeVolume.d.ts +86 -0
  348. package/types/cloud/noise/cirrusMap.d.ts +24 -0
  349. package/types/cloud/noise/curlNoise.d.ts +106 -0
  350. package/types/cloud/noise/erosionVolume.d.ts +58 -0
  351. package/types/cloud/noise/noiseVolume.d.ts +63 -0
  352. package/types/cloud/noise/periodicNoise3.d.ts +75 -0
  353. package/types/cloud/noise/weatherMap.d.ts +227 -0
  354. package/types/cloud/paramSchema.d.ts +142 -0
  355. package/types/collisionMetadata.d.ts +11 -0
  356. package/types/core/generation.d.ts +95 -0
  357. package/types/core/materialRoles.d.ts +102 -0
  358. package/types/core/presetDocuments.d.ts +25 -0
  359. package/types/core/systemStylePolicy.d.ts +4 -0
  360. package/types/environment/dayCurves.d.ts +47 -0
  361. package/types/environment/environmentAmbientProbe.d.ts +2 -0
  362. package/types/environment/environmentGroundFieldPass.d.ts +2 -0
  363. package/types/environment/environmentMaterialAdapter.d.ts +44 -0
  364. package/types/environment/environmentMaterialClassifier.d.ts +26 -0
  365. package/types/environment/environmentPlanarReflection.d.ts +3 -0
  366. package/types/environment/environmentPresets.d.ts +171 -0
  367. package/types/environment/environmentRigs.d.ts +13 -0
  368. package/types/environment/environmentSettings.d.ts +161 -0
  369. package/types/environment/environmentShaderMaterials.d.ts +14 -0
  370. package/types/environment/environmentState.d.ts +6 -0
  371. package/types/environment/environmentSunShadowPass.d.ts +2 -0
  372. package/types/environment/environmentTextureResolver.d.ts +30 -0
  373. package/types/environment/environmentTimeOfDay.d.ts +25 -0
  374. package/types/environment/environmentVertexAo.d.ts +18 -0
  375. package/types/environment/index.d.ts +27 -0
  376. package/types/environment/manufacturedMaterialContract.d.ts +129 -0
  377. package/types/environment/manufacturedReflectionProvider.d.ts +3 -0
  378. package/types/environment/scanAssetStylize.d.ts +43 -0
  379. package/types/environment/surfaceMaterialModes.d.ts +14 -0
  380. package/types/environment/toonLabEnvironmentMaterials.d.ts +139 -0
  381. package/types/environment/toonLabMaterialPassCoupling.d.ts +7 -0
  382. package/types/environment/toonLabNormalIntegration.d.ts +29 -0
  383. package/types/environment/toonLabRockMaterialResolver.d.ts +270 -0
  384. package/types/environment/toonLabSourceDefaultLit.d.ts +136 -0
  385. package/types/environment/toonLabSourceLibrary.d.ts +19 -0
  386. package/types/environment/toonLabSourceMaterials.d.ts +14 -0
  387. package/types/environment/toonLabSourceSubsurfaceLighting.d.ts +85 -0
  388. package/types/environment/toonLabSourceTemporal.d.ts +20 -0
  389. package/types/environment/toonLabSurfaceLighting.d.ts +153 -0
  390. package/types/environment/toonLabTextureReadiness.d.ts +8 -0
  391. package/types/environment/toonLabTreeMaterials.d.ts +7 -0
  392. package/types/environment/transparentMaterialProfile.d.ts +76 -0
  393. package/types/environment/urbanPropMaterial.d.ts +25 -0
  394. package/types/ground-shader/groundPrintLayer.d.ts +4 -0
  395. package/types/ground-shader/groundShaderMaterial.d.ts +11 -0
  396. package/types/ground-shader/groundShaderSettings.d.ts +90 -0
  397. package/types/ground-shader/index.d.ts +3 -0
  398. package/types/index.d.ts +1591 -0
  399. package/types/lighting/callMeSenseiLightingContract.d.ts +14 -0
  400. package/types/lighting/colorIntensity.d.ts +44 -0
  401. package/types/lighting/index.d.ts +12 -0
  402. package/types/lighting/lightDescriptors.d.ts +803 -0
  403. package/types/lighting/lightingCapabilities.d.ts +85 -0
  404. package/types/lighting/lightingDocuments.d.ts +140 -0
  405. package/types/lighting/lightingFixtures.d.ts +171 -0
  406. package/types/lighting/lightingGenerator.d.ts +403 -0
  407. package/types/lighting/lightingPresets.d.ts +264 -0
  408. package/types/lighting/lightingRuntime.d.ts +401 -0
  409. package/types/lighting/lightingStyle.d.ts +156 -0
  410. package/types/lighting/lightingSystem.d.ts +440 -0
  411. package/types/lighting/toonLabExport.d.ts +46 -0
  412. package/types/lighting/utils.d.ts +18 -0
  413. package/types/loaders/index.d.ts +1 -0
  414. package/types/post/index.d.ts +2 -0
  415. package/types/post/postGenerator.d.ts +282 -0
  416. package/types/post/postProcessing.d.ts +16 -0
  417. package/types/react/index.d.ts +1785 -0
  418. package/types/renderer/index.d.ts +2 -0
  419. package/types/renderer/rendererConfiguration.d.ts +8 -0
  420. package/types/renderer/styleComparison.d.ts +409 -0
  421. package/types/rock-shader/index.d.ts +8 -0
  422. package/types/rock-shader/rockGeometryDetail.d.ts +300 -0
  423. package/types/rock-shader/rockMaterial.d.ts +21 -0
  424. package/types/rock-shader/rockRegionRuntime.d.ts +86 -0
  425. package/types/rock-shader/rockSemanticMaterialRuntime.d.ts +29 -0
  426. package/types/rock-shader/rockShaderRuntime.d.ts +10 -0
  427. package/types/rock-shader/rockShaderSettings.d.ts +184 -0
  428. package/types/rock-shader/rockTangentIntegrity.d.ts +51 -0
  429. package/types/rock-shader/rockTextureIntegrity.d.ts +61 -0
  430. package/types/rockgen/export/glbExport.d.ts +58 -0
  431. package/types/rockgen/heightfield/heightfieldErosion.d.ts +10 -0
  432. package/types/rockgen/heightfield/heightfieldPatch.d.ts +15 -0
  433. package/types/rockgen/heightfield/stylizedErosionSim.d.ts +41 -0
  434. package/types/rockgen/index.d.ts +12 -0
  435. package/types/rockgen/lod/index.d.ts +6 -0
  436. package/types/rockgen/lod/rockLodMetrics.d.ts +62 -0
  437. package/types/rockgen/lod/rockLodPlanner.d.ts +86 -0
  438. package/types/rockgen/lod/rockLodPolicy.d.ts +76 -0
  439. package/types/rockgen/lod/rockLodRuntime.d.ts +95 -0
  440. package/types/rockgen/lod/rockLodSimplifier.d.ts +15 -0
  441. package/types/rockgen/lod/rockLodValidation.d.ts +16 -0
  442. package/types/rockgen/mesh/meshAttributes.d.ts +32 -0
  443. package/types/rockgen/mesh/meshDocument.d.ts +40 -0
  444. package/types/rockgen/mesh/surfaceNets.d.ts +42 -0
  445. package/types/rockgen/noise/cellularNoise3.d.ts +24 -0
  446. package/types/rockgen/noise/prng.d.ts +16 -0
  447. package/types/rockgen/noise/simplexNoise3.d.ts +2 -0
  448. package/types/rockgen/noise/valueNoise3.d.ts +12 -0
  449. package/types/rockgen/rockDocument.d.ts +243 -0
  450. package/types/rockgen/rockHelpers.d.ts +2 -0
  451. package/types/rockgen/rockgenPresets.d.ts +10 -0
  452. package/types/rockgen/rockgenSettings.d.ts +531 -0
  453. package/types/rockgen/sdf/fieldCompiler.d.ts +20 -0
  454. package/types/rockgen/sdf/sculptEdits.d.ts +30 -0
  455. package/types/rockgen/sdf/sdfModifiers.d.ts +19 -0
  456. package/types/rockgen/sdf/sdfOps.d.ts +8 -0
  457. package/types/rockgen/sdf/sdfPrimitives.d.ts +22 -0
  458. package/types/rockgen/surface/c7GeologySurface.d.ts +8 -0
  459. package/types/runtime/index.d.ts +3 -0
  460. package/types/runtime/sceneCollisionRuntime.d.ts +94 -0
  461. package/types/runtime/sceneSurfaceRuntime.d.ts +90 -0
  462. package/types/runtime/sceneUpdateScheduler.d.ts +28 -0
  463. package/types/shaders-tsl/anime.d.ts +9 -0
  464. package/types/shaders-tsl/chunks/character-color.d.ts +6 -0
  465. package/types/shaders-tsl/chunks/character-highlights.d.ts +12 -0
  466. package/types/shaders-tsl/chunks/character-lighting.d.ts +20 -0
  467. package/types/shaders-tsl/chunks/character-material-maps.d.ts +18 -0
  468. package/types/shaders-tsl/chunks/character-roles.d.ts +21 -0
  469. package/types/shaders-tsl/chunks/character-scene-lights.d.ts +48 -0
  470. package/types/shaders-tsl/chunks/character-shadow-color.d.ts +5 -0
  471. package/types/shaders-tsl/chunks/character-skinning.d.ts +23 -0
  472. package/types/shaders-tsl/chunks/environment-color.d.ts +9 -0
  473. package/types/shaders-tsl/chunks/environment-debug.d.ts +24 -0
  474. package/types/shaders-tsl/chunks/environment-ground-field.d.ts +40 -0
  475. package/types/shaders-tsl/chunks/environment-lighting.d.ts +22 -0
  476. package/types/shaders-tsl/chunks/environment-state.d.ts +42 -0
  477. package/types/shaders-tsl/chunks/environment-sun-shadow.d.ts +19 -0
  478. package/types/shaders-tsl/chunks/foliage-fog.d.ts +21 -0
  479. package/types/shaders-tsl/chunks/normalized-hue.d.ts +1 -0
  480. package/types/shaders-tsl/chunks/pass-depth-color.d.ts +20 -0
  481. package/types/shaders-tsl/chunks/projected-water-caustics.d.ts +24 -0
  482. package/types/shaders-tsl/chunks/scene-depth-color-pass.d.ts +39 -0
  483. package/types/shaders-tsl/chunks/stylized-cloud-shadow.d.ts +9 -0
  484. package/types/shaders-tsl/chunks/vegetation-style.d.ts +60 -0
  485. package/types/shaders-tsl/chunks/water-color.d.ts +15 -0
  486. package/types/shaders-tsl/chunks/water-common.d.ts +9 -0
  487. package/types/shaders-tsl/chunks/water-foam.d.ts +8 -0
  488. package/types/shaders-tsl/chunks/water-lighting.d.ts +9 -0
  489. package/types/shaders-tsl/chunks/water-ripple.d.ts +8 -0
  490. package/types/shaders-tsl/chunks/water-shore-state.d.ts +7 -0
  491. package/types/shaders-tsl/chunks/water-waves.d.ts +18 -0
  492. package/types/shaders-tsl/chunks/world-noise.d.ts +4 -0
  493. package/types/shaders-tsl/environment-ao-overlay.d.ts +5 -0
  494. package/types/shaders-tsl/environment.d.ts +34 -0
  495. package/types/shaders-tsl/flower.d.ts +6 -0
  496. package/types/shaders-tsl/grass.d.ts +4 -0
  497. package/types/shaders-tsl/post-composite.d.ts +25 -0
  498. package/types/shaders-tsl/sky.d.ts +4 -0
  499. package/types/shaders-tsl/tree-leaf.d.ts +2 -0
  500. package/types/shaders-tsl/water-breaker.d.ts +15 -0
  501. package/types/shaders-tsl/water-kelp.d.ts +5 -0
  502. package/types/shaders-tsl/water-rain.d.ts +10 -0
  503. package/types/shaders-tsl/water-shore-state-simulation.d.ts +12 -0
  504. package/types/shaders-tsl/water-simulation.d.ts +5 -0
  505. package/types/shaders-tsl/water-splash.d.ts +12 -0
  506. package/types/shaders-tsl/water.d.ts +22 -0
  507. package/types/shaders-tsl/woody-surface.d.ts +3 -0
  508. package/types/sky/atmosphereDome.d.ts +2 -0
  509. package/types/sky/atmosphereParams.d.ts +185 -0
  510. package/types/sky/atmosphereScattering.d.ts +11 -0
  511. package/types/sky/atmosphereSky.d.ts +2 -0
  512. package/types/sky/cloudShadow.d.ts +69 -0
  513. package/types/sky/godRays.d.ts +5 -0
  514. package/types/sky/index.d.ts +18 -0
  515. package/types/sky/nightSky.d.ts +22 -0
  516. package/types/sky/renderLayers.d.ts +59 -0
  517. package/types/sky/sceneOverrideLayers.d.ts +10 -0
  518. package/types/sky/skyColor.d.ts +704 -0
  519. package/types/sky/skyDayCycle.d.ts +86 -0
  520. package/types/sky/skyParams.d.ts +3407 -0
  521. package/types/sky/skyPresets.d.ts +160 -0
  522. package/types/sky/skyQuality.d.ts +21 -0
  523. package/types/sky/skyQualityTiers.d.ts +223 -0
  524. package/types/sky/skyShaderSettings.d.ts +152 -0
  525. package/types/sky/skyStyleSnapshots.d.ts +11 -0
  526. package/types/sky/skySystem.d.ts +3 -0
  527. package/types/sky/skyTimeKeyframes.d.ts +230 -0
  528. package/types/sky/stylizedSky.d.ts +341 -0
  529. package/types/sky/sunDriver.d.ts +15 -0
  530. package/types/sky/timeOfDay.d.ts +145 -0
  531. package/types/styles/animeGameProfile.d.ts +27 -0
  532. package/types/styles/index.d.ts +18 -0
  533. package/types/styles/manufacturedStyleLabeling.d.ts +119 -0
  534. package/types/styles/neutralStylePresets.d.ts +944 -0
  535. package/types/styles/sceneLayerDocuments.d.ts +145 -0
  536. package/types/styles/sceneLookComposition.d.ts +53 -0
  537. package/types/styles/sceneQualityApplication.d.ts +34 -0
  538. package/types/styles/sceneQualityProfiles.d.ts +13 -0
  539. package/types/styles/sceneStyleAudit.d.ts +80 -0
  540. package/types/styles/sceneStyleRuntime.d.ts +1802 -0
  541. package/types/styles/styleAdapters.d.ts +14 -0
  542. package/types/styles/styleApplication.d.ts +47 -0
  543. package/types/styles/styleBundle.d.ts +19 -0
  544. package/types/styles/styleBundleProvider.d.ts +44 -0
  545. package/types/styles/styleDomains.d.ts +18 -0
  546. package/types/styles/styleInspector.d.ts +59 -0
  547. package/types/styles/styleMaterialContract.d.ts +46 -0
  548. package/types/styles/styleMetadata.d.ts +11 -0
  549. package/types/styles/styleTargetDiscovery.d.ts +48 -0
  550. package/types/styles/styleTargetLabels.d.ts +32 -0
  551. package/types/styles/styleTargetMaterialCoverage.d.ts +20 -0
  552. package/types/styles/styleTransaction.d.ts +10 -0
  553. package/types/styles/styleTypes.d.ts +66 -0
  554. package/types/texgen/evaluateTexture.d.ts +40 -0
  555. package/types/texgen/index.d.ts +7 -0
  556. package/types/texgen/noise2.d.ts +46 -0
  557. package/types/texgen/textureAi.d.ts +6 -0
  558. package/types/texgen/textureGenerators.d.ts +261 -0
  559. package/types/texgen/texturePresets.d.ts +45 -0
  560. package/types/texgen/textureSettings.d.ts +121 -0
  561. package/types/texgen/textureThree.d.ts +13 -0
  562. package/types/toon/characterRenderPasses.d.ts +3 -0
  563. package/types/toon/index.d.ts +3 -0
  564. package/types/toon/settings/alphaSettings.d.ts +125 -0
  565. package/types/toon/settings/averageShadowSettings.d.ts +39 -0
  566. package/types/toon/settings/baseTextureSettings.d.ts +39 -0
  567. package/types/toon/settings/celShadeSettings.d.ts +37 -0
  568. package/types/toon/settings/contactShadowSettings.d.ts +30 -0
  569. package/types/toon/settings/eyeHighlightSettings.d.ts +55 -0
  570. package/types/toon/settings/faceLightingSettings.d.ts +32 -0
  571. package/types/toon/settings/furSettings.d.ts +23 -0
  572. package/types/toon/settings/glitterSettings.d.ts +43 -0
  573. package/types/toon/settings/hairHighlightSettings.d.ts +89 -0
  574. package/types/toon/settings/indirectLightSettings.d.ts +43 -0
  575. package/types/toon/settings/localLightSettings.d.ts +46 -0
  576. package/types/toon/settings/materialMapSettings.d.ts +86 -0
  577. package/types/toon/settings/outlineSettings.d.ts +125 -0
  578. package/types/toon/settings/perspectiveRemovalSettings.d.ts +14 -0
  579. package/types/toon/settings/rimLightSettings.d.ts +79 -0
  580. package/types/toon/settings/sceneShadowSettings.d.ts +32 -0
  581. package/types/toon/settings/selfShadowSettings.d.ts +44 -0
  582. package/types/toon/settings/shadowColorSettings.d.ts +77 -0
  583. package/types/toon/settings/skinToneSettings.d.ts +30 -0
  584. package/types/toon/settings/specularSettings.d.ts +96 -0
  585. package/types/toon/settings/stickerSettings.d.ts +40 -0
  586. package/types/toon/toonMaterialAdapter.d.ts +883 -0
  587. package/types/toon/toonSettings.d.ts +1182 -0
  588. package/types/vegetation/branchTree.d.ts +14 -0
  589. package/types/vegetation/callMeSenseiGrass.d.ts +8 -0
  590. package/types/vegetation/compiledTree.d.ts +75 -0
  591. package/types/vegetation/contactShadowField.d.ts +26 -0
  592. package/types/vegetation/flowerSpecies.d.ts +107 -0
  593. package/types/vegetation/grass.d.ts +4 -0
  594. package/types/vegetation/grassClump.d.ts +7 -0
  595. package/types/vegetation/grassPalettes.d.ts +29 -0
  596. package/types/vegetation/importedVegetationMaterial.d.ts +13 -0
  597. package/types/vegetation/index.d.ts +225 -0
  598. package/types/vegetation/legacyTreePresets.d.ts +22 -0
  599. package/types/vegetation/scatter.d.ts +13 -0
  600. package/types/vegetation/stylizedBush.d.ts +2 -0
  601. package/types/vegetation/stylizedFlower.d.ts +2 -0
  602. package/types/vegetation/stylizedFlowers.d.ts +8 -0
  603. package/types/vegetation/stylizedForest.d.ts +3 -0
  604. package/types/vegetation/stylizedGrass.d.ts +21 -0
  605. package/types/vegetation/stylizedTree.d.ts +20 -0
  606. package/types/vegetation/stylizedTreeFoliage.d.ts +19 -0
  607. package/types/vegetation/stylizedUnderstory.d.ts +50 -0
  608. package/types/vegetation/treeExport.d.ts +6 -0
  609. package/types/vegetation/treeSurfaceTextures.d.ts +72 -0
  610. package/types/vegetation/vegetationShaders.d.ts +74 -0
  611. package/types/version.d.ts +1 -0
  612. package/types/water/index.d.ts +1 -0
  613. package/types/water/sceneOverrideLayers.d.ts +16 -0
  614. package/types/water/water.d.ts +17 -0
  615. package/types/water/waterBreakerSystem.d.ts +46 -0
  616. package/types/water/waterCurrentField.d.ts +115 -0
  617. package/types/water/waterInteraction.d.ts +21 -0
  618. package/types/water/waterMaterial.d.ts +60 -0
  619. package/types/water/waterNearshorePhase.d.ts +5 -0
  620. package/types/water/waterRain.d.ts +17 -0
  621. package/types/water/waterRippleSimulation.d.ts +52 -0
  622. package/types/water/waterScenePasses.d.ts +70 -0
  623. package/types/water/waterSettings.d.ts +648 -0
  624. package/types/water/waterShoreMaterial.d.ts +3 -0
  625. package/types/water/waterShoreStateField.d.ts +2 -0
  626. package/types/water/waterSplashSystem.d.ts +2 -0
  627. package/types/water/waterStageSettings.d.ts +9 -0
  628. package/types/water/waterSurface.d.ts +2 -0
  629. package/types/water/waterUnderwaterAtmosphere.d.ts +103 -0
  630. package/types/water/waterVegetation.d.ts +16 -0
  631. package/types/worldCollision.d.ts +22 -0
  632. package/AGENTS.md +0 -254
  633. package/ATTRIBUTION.md +0 -78
  634. package/docs/characters.md +0 -144
  635. package/docs/debug-panel.md +0 -126
  636. package/docs/docs.css +0 -589
  637. package/docs/environment.md +0 -186
  638. package/docs/getting-started.md +0 -180
  639. package/docs/index.html +0 -14
  640. package/docs/lab-architecture.md +0 -100
  641. package/docs/lighting.md +0 -825
  642. package/docs/main.jsx +0 -752
  643. package/docs/mcp.md +0 -97
  644. package/docs/post-processing.md +0 -98
  645. package/docs/settings-reference.md +0 -1878
  646. package/docs/shader-constants.md +0 -77
  647. package/docs/sky.md +0 -182
  648. package/docs/style-labs.md +0 -309
  649. package/docs/texture-lab.md +0 -135
  650. package/docs/toon-shading.md +0 -183
  651. package/docs/tsl-conventions.md +0 -167
  652. package/docs/vegetation-sky.md +0 -275
  653. package/docs/water.md +0 -430
  654. package/docs/weather.md +0 -200
  655. package/docs/world-scale.md +0 -111
  656. package/mcp/style-lab-tools.mjs +0 -371
  657. package/src/ambientfx/INTEGRATION.md +0 -164
  658. package/src/ambientfx/ambientFxPresets.js +0 -83
  659. package/src/ambientfx/ambientFxSettings.js +0 -368
  660. package/src/ambientfx/emitters.js +0 -169
  661. package/src/ambientfx/index.js +0 -5
  662. package/src/ambientfx/particleBackbone.js +0 -493
  663. package/src/ambientfx/stylizedAmbientFx.js +0 -450
  664. package/src/biome/biomeGenerator.js +0 -385
  665. package/src/biome/biomeRuntime.js +0 -299
  666. package/src/biome/index.js +0 -2
  667. package/src/buildinggen/buildingAsset.js +0 -44
  668. package/src/buildinggen/buildingGrammar.js +0 -311
  669. package/src/buildinggen/buildingMesh.js +0 -451
  670. package/src/buildinggen/buildingPresets.js +0 -46
  671. package/src/buildinggen/buildingRecipe.js +0 -100
  672. package/src/buildinggen/buildingSettings.js +0 -238
  673. package/src/buildinggen/index.js +0 -6
  674. package/src/camera/cameraDirector.js +0 -157
  675. package/src/camera/cameraGenerator.js +0 -367
  676. package/src/camera/cameraRig.js +0 -570
  677. package/src/camera/cameraSettings.js +0 -236
  678. package/src/camera/index.js +0 -7
  679. package/src/catalog/builtinEntries.js +0 -245
  680. package/src/catalog/catalog.js +0 -210
  681. package/src/catalog/index.js +0 -3
  682. package/src/core/shaderBackend.js +0 -24
  683. package/src/debrisgen/debrisFields.js +0 -544
  684. package/src/debrisgen/debrisGenerator.js +0 -1929
  685. package/src/debrisgen/debrisPalettes.js +0 -71
  686. package/src/debrisgen/debrisPhysics.js +0 -198
  687. package/src/debrisgen/debrisPresets.js +0 -162
  688. package/src/debrisgen/debrisSettings.js +0 -333
  689. package/src/debrisgen/debrisTextures.js +0 -380
  690. package/src/debrisgen/index.js +0 -5
  691. package/src/debug/fieldValues.js +0 -95
  692. package/src/debug/index.js +0 -7
  693. package/src/debug/settingsPanel.js +0 -170
  694. package/src/fauna/INTEGRATION.md +0 -174
  695. package/src/fauna/boids.js +0 -861
  696. package/src/fauna/faunaBodies.js +0 -492
  697. package/src/fauna/faunaPresets.js +0 -52
  698. package/src/fauna/faunaSettings.js +0 -525
  699. package/src/fauna/index.js +0 -5
  700. package/src/fauna/stylizedFauna.js +0 -395
  701. package/src/game-feel/gameFeelGenerator.js +0 -402
  702. package/src/game-feel/gameFeelRuntime.js +0 -549
  703. package/src/game-feel/index.js +0 -2
  704. package/src/motion/index.js +0 -5
  705. package/src/motion/motionClip.js +0 -441
  706. package/src/motion/motionController.js +0 -628
  707. package/src/motion/motionDocuments.js +0 -225
  708. package/src/motion/motionGraph.js +0 -307
  709. package/src/motion/motionSettings.js +0 -222
  710. package/src/pathgen/index.js +0 -7
  711. package/src/pathgen/pathBridge.js +0 -232
  712. package/src/pathgen/pathPresets.js +0 -35
  713. package/src/pathgen/pathRibbon.js +0 -410
  714. package/src/pathgen/pathRouter.js +0 -380
  715. package/src/pathgen/pathSettings.js +0 -335
  716. package/src/pathgen/pathTextures.js +0 -123
  717. package/src/pathgen/stylizedPaths.js +0 -453
  718. package/src/propgen/generatorsWave1.js +0 -379
  719. package/src/propgen/generatorsWave2.js +0 -462
  720. package/src/propgen/index.js +0 -5
  721. package/src/propgen/propAsset.js +0 -323
  722. package/src/propgen/propParts.js +0 -170
  723. package/src/propgen/propPlacement.js +0 -459
  724. package/src/propgen/propPresets.js +0 -82
  725. package/src/propgen/propSettings.js +0 -395
  726. package/src/soundscape/index.js +0 -4
  727. package/src/soundscape/soundscapeGenerator.js +0 -179
  728. package/src/soundscape/soundscapeRuntime.js +0 -806
  729. package/src/soundscape/soundscapeSettings.js +0 -292
  730. package/src/stylizedTerrain.js +0 -631
  731. package/src/stylizedWorld.js +0 -903
  732. package/src/vegetation/treeRecipe.js +0 -647
  733. package/src/vfxgen/INTEGRATION.md +0 -145
  734. package/src/vfxgen/core/burstBackbone.js +0 -380
  735. package/src/vfxgen/core/projectileCore.js +0 -92
  736. package/src/vfxgen/core/spriteShapes.js +0 -98
  737. package/src/vfxgen/core/trailRibbon.js +0 -272
  738. package/src/vfxgen/core/vfxRandom.js +0 -29
  739. package/src/vfxgen/effects/emitHelpers.js +0 -37
  740. package/src/vfxgen/effects/magicEffects.js +0 -162
  741. package/src/vfxgen/effects/movementEffects.js +0 -87
  742. package/src/vfxgen/effects/weaponEffects.js +0 -118
  743. package/src/vfxgen/index.js +0 -18
  744. package/src/vfxgen/moves/moveController.js +0 -146
  745. package/src/vfxgen/moves/moveLibrary.js +0 -335
  746. package/src/vfxgen/vfxPresets.js +0 -98
  747. package/src/vfxgen/vfxSettings.js +0 -384
  748. package/src/vfxgen/vfxSystem.js +0 -449
  749. package/src/vfxgen/weapons/stylizedWeapons.js +0 -137
  750. package/src/villagegen/index.js +0 -4
  751. package/src/villagegen/stylizedVillage.js +0 -490
  752. package/src/villagegen/villageArchetypes.js +0 -160
  753. package/src/villagegen/villageNames.js +0 -40
  754. package/src/villagegen/villageSites.js +0 -105
  755. package/src/weather/index.js +0 -6
  756. package/src/weather/weatherPrecipitation.js +0 -221
  757. package/src/weather/weatherPresets.js +0 -258
  758. package/src/weather/weatherSettings.js +0 -269
  759. package/src/weather/weatherSystem.js +0 -871
  760. package/src/worldMinimap.js +0 -214
  761. package/src/worldPresets.js +0 -125
@@ -0,0 +1,699 @@
1
+ // Portable Sky Shader settings for ToonLab's authored anime sky renderer.
2
+ //
3
+ // The profile owns visible background treatment, sun/moon appearance, and
4
+ // stars. Current time, celestial direction, cloud rendering, atmosphere,
5
+ // weather, exposure, source meshes/textures/atlases, and camera are host
6
+ // inputs and never enter this document.
7
+
8
+ import {
9
+ CALL_ME_SENSEI_SKY_ATMOSPHERE,
10
+ CALL_ME_SENSEI_SKY_TIME_KEYFRAMES,
11
+ DEFAULT_SKY_ATMOSPHERE,
12
+ DEFAULT_SKY_TIME_KEYFRAMES,
13
+ createSkyAtmosphereSettings,
14
+ createSkyTimeKeyframes,
15
+ } from './skyTimeKeyframes.js';
16
+ import { isProtectedSystemStyleId } from '../core/systemStylePolicy.js';
17
+
18
+ export const SKY_SHADER_DOCUMENT_TYPE = 'toonlab/sky-shader-preset';
19
+ export const SKY_SHADER_SCHEMA_VERSION = 2;
20
+ export const DEFAULT_SKY_SHADER_PRESET = 'call_me_sensei';
21
+
22
+ const DEFINITIONS = Object.freeze({
23
+ atlasBrightness: Object.freeze({
24
+ description: 'Brightness multiplier applied after the authored anime sky color-curve lookup.',
25
+ group: 'gradient',
26
+ label: 'Sky Brightness',
27
+ range: Object.freeze({ max: 4, min: 0, step: 0.01 }),
28
+ type: 'number',
29
+ value: 1,
30
+ }),
31
+ atlasSaturation: Object.freeze({
32
+ description: 'Saturation of the authored sky gradient. 1 preserves the source color curve.',
33
+ group: 'gradient',
34
+ label: 'Sky Saturation',
35
+ range: Object.freeze({ max: 2, min: 0, step: 0.01 }),
36
+ type: 'number',
37
+ value: 1,
38
+ }),
39
+ atlasContrast: Object.freeze({
40
+ description: 'Contrast around middle gray after the authored sky color-curve lookup.',
41
+ group: 'gradient',
42
+ label: 'Sky Contrast',
43
+ range: Object.freeze({ max: 2, min: 0, step: 0.01 }),
44
+ type: 'number',
45
+ value: 1,
46
+ }),
47
+ atlasSampleOffset: Object.freeze({
48
+ description: 'Vertical offset into the authored sky color curve.',
49
+ group: 'gradient',
50
+ label: 'Gradient Offset',
51
+ range: Object.freeze({ max: 0.5, min: -0.5, step: 0.001 }),
52
+ type: 'number',
53
+ value: 0,
54
+ }),
55
+ atlasSampleScale: Object.freeze({
56
+ description: 'Vertical scale of the authored sky color curve around its midpoint.',
57
+ group: 'gradient',
58
+ label: 'Gradient Scale',
59
+ range: Object.freeze({ max: 3, min: 0.1, step: 0.01 }),
60
+ type: 'number',
61
+ value: 1,
62
+ }),
63
+ skyTint: Object.freeze({
64
+ description: 'Master tint multiplied into the complete sky background.',
65
+ group: 'gradient',
66
+ label: 'Sky Tint',
67
+ type: 'color',
68
+ value: Object.freeze([1, 1, 1]),
69
+ }),
70
+ zenithTint: Object.freeze({
71
+ description: 'Additional tint toward the top of the sky dome.',
72
+ group: 'gradient',
73
+ label: 'Zenith Tint',
74
+ type: 'color',
75
+ value: Object.freeze([1, 1, 1]),
76
+ }),
77
+ horizonTint: Object.freeze({
78
+ description: 'Additional tint centered on the visible horizon band.',
79
+ group: 'gradient',
80
+ label: 'Horizon Tint',
81
+ type: 'color',
82
+ value: Object.freeze([1, 1, 1]),
83
+ }),
84
+ belowHorizonTint: Object.freeze({
85
+ description: 'Additional tint below the horizon. It affects background presentation, not ground materials.',
86
+ group: 'gradient',
87
+ label: 'Below-horizon Tint',
88
+ type: 'color',
89
+ value: Object.freeze([1, 1, 1]),
90
+ }),
91
+ horizonPosition: Object.freeze({
92
+ description: 'Vertical center of the horizon treatment in dome UV space.',
93
+ group: 'gradient',
94
+ label: 'Horizon Position',
95
+ range: Object.freeze({ max: 0.8, min: 0.2, step: 0.001 }),
96
+ type: 'number',
97
+ value: 0.5,
98
+ }),
99
+ horizonBlend: Object.freeze({
100
+ description: 'Width used to blend the zenith, horizon, and below-horizon tint regions.',
101
+ group: 'gradient',
102
+ label: 'Horizon Blend',
103
+ range: Object.freeze({ max: 0.5, min: 0.01, step: 0.001 }),
104
+ type: 'number',
105
+ value: 0.18,
106
+ }),
107
+ horizonGlowColor: Object.freeze({
108
+ description: 'Tint of the optional sunward horizon glow.',
109
+ group: 'gradient',
110
+ label: 'Horizon Glow Color',
111
+ type: 'color',
112
+ value: Object.freeze([1, 0.72, 0.5]),
113
+ }),
114
+ horizonGlowStrength: Object.freeze({
115
+ description: 'Strength of the sunward glow centered on the horizon.',
116
+ group: 'gradient',
117
+ label: 'Horizon Glow Strength',
118
+ range: Object.freeze({ max: 3, min: 0, step: 0.01 }),
119
+ type: 'number',
120
+ value: 0,
121
+ }),
122
+ horizonGlowWidth: Object.freeze({
123
+ description: 'Vertical width of the sunward horizon glow.',
124
+ group: 'gradient',
125
+ label: 'Horizon Glow Width',
126
+ range: Object.freeze({ max: 0.5, min: 0.01, step: 0.001 }),
127
+ type: 'number',
128
+ value: 0.12,
129
+ }),
130
+ horizonGlowFocus: Object.freeze({
131
+ description: 'Angular focus of the horizon glow toward the current sun direction.',
132
+ group: 'gradient',
133
+ label: 'Horizon Glow Focus',
134
+ range: Object.freeze({ max: 24, min: 0.5, step: 0.1 }),
135
+ type: 'number',
136
+ value: 5,
137
+ }),
138
+ sunColor: Object.freeze({
139
+ description: 'Tint of the visible sun disc.',
140
+ group: 'sun',
141
+ label: 'Sun Disc Color',
142
+ type: 'color',
143
+ value: Object.freeze([1, 0.96, 0.86]),
144
+ }),
145
+ sunDiscSize: Object.freeze({
146
+ description: 'Angular radius of the visible sun disc.',
147
+ group: 'sun',
148
+ label: 'Sun Disc Size',
149
+ range: Object.freeze({ max: 0.16, min: 0, step: 0.001 }),
150
+ type: 'number',
151
+ value: 0.026,
152
+ }),
153
+ sunDiscSoftness: Object.freeze({
154
+ description: 'Fraction of the sun radius used for its anti-aliased edge.',
155
+ group: 'sun',
156
+ label: 'Sun Edge Softness',
157
+ range: Object.freeze({ max: 1, min: 0.01, step: 0.01 }),
158
+ type: 'number',
159
+ value: 0.28,
160
+ }),
161
+ sunDiscIntensity: Object.freeze({
162
+ description: 'Brightness of the visible sun disc. The current time controls visibility, not this value.',
163
+ group: 'sun',
164
+ label: 'Sun Disc Intensity',
165
+ range: Object.freeze({ max: 8, min: 0, step: 0.05 }),
166
+ type: 'number',
167
+ value: 1.8,
168
+ }),
169
+ sunGlowColor: Object.freeze({
170
+ description: 'Tint of the broad and core sun glow.',
171
+ group: 'sun',
172
+ label: 'Sun Glow Color',
173
+ type: 'color',
174
+ value: Object.freeze([1, 0.82, 0.62]),
175
+ }),
176
+ sunGlowStrength: Object.freeze({
177
+ description: 'Master intensity of the sun glow.',
178
+ group: 'sun',
179
+ label: 'Sun Glow Strength',
180
+ range: Object.freeze({ max: 4, min: 0, step: 0.01 }),
181
+ type: 'number',
182
+ value: 0.45,
183
+ }),
184
+ sunGlowSpread: Object.freeze({
185
+ description: 'Falloff power of the broad sun halo. Lower values make a wider glow.',
186
+ group: 'sun',
187
+ label: 'Sun Glow Spread',
188
+ range: Object.freeze({ max: 24, min: 1, step: 0.1 }),
189
+ type: 'number',
190
+ value: 5,
191
+ }),
192
+ sunGlowCoreStrength: Object.freeze({
193
+ description: 'Relative strength of the tight inner sun halo.',
194
+ group: 'sun',
195
+ label: 'Sun Core Glow',
196
+ range: Object.freeze({ max: 2, min: 0, step: 0.01 }),
197
+ type: 'number',
198
+ value: 0.45,
199
+ }),
200
+ sunGlowCoreSharpness: Object.freeze({
201
+ description: 'Falloff power of the tight inner sun halo.',
202
+ group: 'sun',
203
+ label: 'Sun Core Sharpness',
204
+ range: Object.freeze({ max: 200, min: 5, step: 1 }),
205
+ type: 'number',
206
+ value: 64,
207
+ }),
208
+ moonColor: Object.freeze({
209
+ description: 'Tint of the visible moon disc.',
210
+ group: 'moon',
211
+ label: 'Moon Disc Color',
212
+ type: 'color',
213
+ value: Object.freeze([0.76, 0.86, 1]),
214
+ }),
215
+ moonDiscSize: Object.freeze({
216
+ description: 'Angular radius of the visible moon disc.',
217
+ group: 'moon',
218
+ label: 'Moon Disc Size',
219
+ range: Object.freeze({ max: 0.16, min: 0, step: 0.001 }),
220
+ type: 'number',
221
+ value: 0.022,
222
+ }),
223
+ moonDiscSoftness: Object.freeze({
224
+ description: 'Fraction of the moon radius used for its anti-aliased edge.',
225
+ group: 'moon',
226
+ label: 'Moon Edge Softness',
227
+ range: Object.freeze({ max: 1, min: 0.01, step: 0.01 }),
228
+ type: 'number',
229
+ value: 0.32,
230
+ }),
231
+ moonDiscIntensity: Object.freeze({
232
+ description: 'Brightness of the visible moon disc. The current time controls visibility, not this value.',
233
+ group: 'moon',
234
+ label: 'Moon Disc Intensity',
235
+ range: Object.freeze({ max: 8, min: 0, step: 0.05 }),
236
+ type: 'number',
237
+ value: 1.25,
238
+ }),
239
+ moonGlowColor: Object.freeze({
240
+ description: 'Tint of the moon halo.',
241
+ group: 'moon',
242
+ label: 'Moon Glow Color',
243
+ type: 'color',
244
+ value: Object.freeze([0.45, 0.62, 1]),
245
+ }),
246
+ moonGlowStrength: Object.freeze({
247
+ description: 'Intensity of the moon halo.',
248
+ group: 'moon',
249
+ label: 'Moon Glow Strength',
250
+ range: Object.freeze({ max: 4, min: 0, step: 0.01 }),
251
+ type: 'number',
252
+ value: 0.32,
253
+ }),
254
+ moonGlowSpread: Object.freeze({
255
+ description: 'Falloff power of the moon halo. Lower values make a wider glow.',
256
+ group: 'moon',
257
+ label: 'Moon Glow Spread',
258
+ range: Object.freeze({ max: 24, min: 1, step: 0.1 }),
259
+ type: 'number',
260
+ value: 7,
261
+ }),
262
+ starsColor: Object.freeze({
263
+ description: 'Tint of the procedural night-sky star glints.',
264
+ group: 'stars',
265
+ label: 'Stars Color',
266
+ type: 'color',
267
+ value: Object.freeze([0.82, 0.9, 1]),
268
+ }),
269
+ starsStrength: Object.freeze({
270
+ description: 'Maximum night-time brightness of the star field. Day/night visibility comes from the runtime clock.',
271
+ group: 'stars',
272
+ label: 'Stars Strength',
273
+ range: Object.freeze({ max: 3, min: 0, step: 0.01 }),
274
+ type: 'number',
275
+ value: 1,
276
+ }),
277
+ starsSeed: Object.freeze({
278
+ description: 'Offsets the deterministic star pattern without changing density or size.',
279
+ group: 'stars',
280
+ integer: true,
281
+ label: 'Stars Pattern Seed',
282
+ range: Object.freeze({ max: 1000, min: 0, step: 1 }),
283
+ type: 'number',
284
+ value: 173,
285
+ }),
286
+ starsDensity: Object.freeze({
287
+ description: 'Fraction of candidate cells allowed to contain a visible star.',
288
+ group: 'stars',
289
+ label: 'Stars Density',
290
+ range: Object.freeze({ max: 1, min: 0, step: 0.01 }),
291
+ type: 'number',
292
+ value: 0.34,
293
+ }),
294
+ starsScale: Object.freeze({
295
+ description: 'Scale of the projected star grid. Higher values create more, smaller cells.',
296
+ group: 'stars',
297
+ label: 'Stars Scale',
298
+ range: Object.freeze({ max: 64, min: 2, step: 0.5 }),
299
+ type: 'number',
300
+ value: 18,
301
+ }),
302
+ starsSize: Object.freeze({
303
+ description: 'Size of each procedural star glint inside its cell.',
304
+ group: 'stars',
305
+ label: 'Stars Size',
306
+ range: Object.freeze({ max: 0.2, min: 0.005, step: 0.005 }),
307
+ type: 'number',
308
+ value: 0.045,
309
+ }),
310
+ starsTwinkleStrength: Object.freeze({
311
+ description: 'Depth of per-star brightness animation. 0 disables twinkle.',
312
+ group: 'stars',
313
+ label: 'Twinkle Strength',
314
+ range: Object.freeze({ max: 1, min: 0, step: 0.01 }),
315
+ type: 'number',
316
+ value: 0.35,
317
+ }),
318
+ starsTwinkleSpeed: Object.freeze({
319
+ description: 'Speed multiplier of seeded star twinkle.',
320
+ group: 'stars',
321
+ label: 'Twinkle Speed',
322
+ range: Object.freeze({ max: 4, min: 0, step: 0.01 }),
323
+ type: 'number',
324
+ value: 0.8,
325
+ }),
326
+ starsHorizonFade: Object.freeze({
327
+ description: 'Altitude at which the star field reaches full brightness above the horizon.',
328
+ group: 'stars',
329
+ label: 'Stars Horizon Fade',
330
+ range: Object.freeze({ max: 1, min: 0.04, step: 0.01 }),
331
+ type: 'number',
332
+ value: 0.2,
333
+ }),
334
+ });
335
+
336
+ const GROUP_KEYS = Object.freeze({
337
+ gradient: Object.freeze([
338
+ 'atlasBrightness',
339
+ 'atlasSaturation',
340
+ 'atlasContrast',
341
+ 'atlasSampleOffset',
342
+ 'atlasSampleScale',
343
+ 'skyTint',
344
+ 'zenithTint',
345
+ 'horizonTint',
346
+ 'belowHorizonTint',
347
+ 'horizonPosition',
348
+ 'horizonBlend',
349
+ 'horizonGlowColor',
350
+ 'horizonGlowStrength',
351
+ 'horizonGlowWidth',
352
+ 'horizonGlowFocus',
353
+ ]),
354
+ sun: Object.freeze([
355
+ 'sunColor',
356
+ 'sunDiscSize',
357
+ 'sunDiscSoftness',
358
+ 'sunDiscIntensity',
359
+ 'sunGlowColor',
360
+ 'sunGlowStrength',
361
+ 'sunGlowSpread',
362
+ 'sunGlowCoreStrength',
363
+ 'sunGlowCoreSharpness',
364
+ ]),
365
+ moon: Object.freeze([
366
+ 'moonColor',
367
+ 'moonDiscSize',
368
+ 'moonDiscSoftness',
369
+ 'moonDiscIntensity',
370
+ 'moonGlowColor',
371
+ 'moonGlowStrength',
372
+ 'moonGlowSpread',
373
+ ]),
374
+ stars: Object.freeze([
375
+ 'starsColor',
376
+ 'starsStrength',
377
+ 'starsSeed',
378
+ 'starsDensity',
379
+ 'starsScale',
380
+ 'starsSize',
381
+ 'starsTwinkleStrength',
382
+ 'starsTwinkleSpeed',
383
+ 'starsHorizonFade',
384
+ ]),
385
+ });
386
+
387
+ export const SKY_SHADER_SETTING_GROUPS = Object.freeze([
388
+ Object.freeze({
389
+ description: 'Anime color-curve sampling, grading, region tints, and visible horizon treatment.',
390
+ id: 'gradient',
391
+ label: 'Gradient',
392
+ }),
393
+ Object.freeze({
394
+ description: 'Appearance of the visible sun disc and halo. Direction and visibility come from time of day.',
395
+ id: 'sun',
396
+ label: 'Sun',
397
+ }),
398
+ Object.freeze({
399
+ description: 'Appearance of the visible moon disc and halo. Direction and visibility come from time of day.',
400
+ id: 'moon',
401
+ label: 'Moon',
402
+ }),
403
+ Object.freeze({
404
+ description: 'Procedural star-field appearance. The runtime clock controls day/night visibility.',
405
+ id: 'stars',
406
+ label: 'Stars',
407
+ }),
408
+ ]);
409
+
410
+ export const SKY_SHADER_FIELD_SCHEMA = Object.freeze(Object.fromEntries(
411
+ SKY_SHADER_SETTING_GROUPS.map((group) => [
412
+ group.id,
413
+ Object.freeze(Object.fromEntries(GROUP_KEYS[group.id].map((key) => {
414
+ const definition = DEFINITIONS[key];
415
+ return [key, Object.freeze({
416
+ defaultValue: definition.value,
417
+ description: definition.description,
418
+ group: group.id,
419
+ id: `${group.id}.${key}`,
420
+ integer: definition.integer ?? false,
421
+ key,
422
+ label: definition.label,
423
+ ...(definition.range ? { range: definition.range } : {}),
424
+ serializable: true,
425
+ type: definition.type,
426
+ })];
427
+ }))),
428
+ ]),
429
+ ));
430
+
431
+ export const SKY_SHADER_FIELD_COUNT = Object.keys(DEFINITIONS).length;
432
+
433
+ const SKY_SHADER_KEYS = Object.freeze(Object.values(GROUP_KEYS).flat());
434
+ const SKY_SHADER_KEY_SET = new Set(SKY_SHADER_KEYS);
435
+ const presetRegistry = new Map();
436
+
437
+ function clone(value) {
438
+ return Array.isArray(value) ? [...value] : value;
439
+ }
440
+
441
+ function isObject(value) {
442
+ return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
443
+ }
444
+
445
+ function normalizeId(value) {
446
+ return String(value ?? '').trim();
447
+ }
448
+
449
+ function normalizeField(key, value, fallback) {
450
+ const definition = DEFINITIONS[key];
451
+ if (definition.type === 'color') {
452
+ if (!Array.isArray(value)
453
+ || value.length < 3
454
+ || !value.slice(0, 3).every((channel) => Number.isFinite(Number(channel)))) {
455
+ return clone(fallback);
456
+ }
457
+ return value.slice(0, 3).map((channel) =>
458
+ Math.min(Math.max(Number(channel), 0), 1));
459
+ }
460
+ const number = Number(value);
461
+ if (!Number.isFinite(number)) return clone(fallback);
462
+ const normalized = Math.min(
463
+ Math.max(number, definition.range.min),
464
+ definition.range.max,
465
+ );
466
+ return definition.integer ? Math.round(normalized) : normalized;
467
+ }
468
+
469
+ function pickSettings(input = {}) {
470
+ const source = isObject(input) ? input : {};
471
+ return Object.fromEntries(
472
+ SKY_SHADER_KEYS
473
+ .filter((key) => source[key] !== undefined)
474
+ .map((key) => [key, clone(source[key])]),
475
+ );
476
+ }
477
+
478
+ export const DEFAULT_SKY_SHADER_SETTINGS = Object.freeze(Object.fromEntries(
479
+ SKY_SHADER_KEYS.map((key) => [
480
+ key,
481
+ Array.isArray(DEFINITIONS[key].value)
482
+ ? Object.freeze([...DEFINITIONS[key].value])
483
+ : DEFINITIONS[key].value,
484
+ ]),
485
+ ));
486
+
487
+ export const CALL_ME_SENSEI_SKY_SHADER_SETTINGS = Object.freeze({
488
+ ...DEFAULT_SKY_SHADER_SETTINGS,
489
+ atlasContrast: 1.04,
490
+ atlasSaturation: 1.2,
491
+ belowHorizonTint: Object.freeze([0.3, 0.65, 0.84]),
492
+ horizonGlowStrength: 0.24,
493
+ horizonTint: Object.freeze([0.46, 0.78, 0.94]),
494
+ skyTint: Object.freeze([0.7, 0.9, 1]),
495
+ starsStrength: 0.86,
496
+ sunGlowStrength: 0.52,
497
+ zenithTint: Object.freeze([0.045, 0.29, 0.7]),
498
+ });
499
+
500
+ export function createSkyShaderSettings(options = {}) {
501
+ const source = typeof options === 'string'
502
+ ? { preset: options }
503
+ : (isObject(options) ? options : {});
504
+ const presetId = normalizeId(source.preset) || DEFAULT_SKY_SHADER_PRESET;
505
+ const preset = presetRegistry.get(presetId)
506
+ ?? presetRegistry.get(DEFAULT_SKY_SHADER_PRESET);
507
+ const input = isObject(source.settings) ? source.settings : source;
508
+ return Object.fromEntries(SKY_SHADER_KEYS.map((key) => {
509
+ const fallback = preset?.settings?.[key] ?? DEFAULT_SKY_SHADER_SETTINGS[key];
510
+ return [key, normalizeField(key, input[key], fallback)];
511
+ }));
512
+ }
513
+
514
+ function canonicalDocument(id, definition = {}) {
515
+ const source = isObject(definition) ? definition : {};
516
+ const presetId = normalizeId(source.preset) || DEFAULT_SKY_SHADER_PRESET;
517
+ const preset = presetRegistry.get(presetId)
518
+ ?? presetRegistry.get(DEFAULT_SKY_SHADER_PRESET);
519
+ return {
520
+ atmosphere: createSkyAtmosphereSettings(source.atmosphere ?? preset?.atmosphere),
521
+ description: String(source.description ?? ''),
522
+ id: normalizeId(id ?? source.id),
523
+ label: String(source.label ?? source.title ?? id ?? source.id ?? '').trim(),
524
+ settings: createSkyShaderSettings({
525
+ preset: source.preset ?? DEFAULT_SKY_SHADER_PRESET,
526
+ settings: source.settings ?? pickSettings(source),
527
+ }),
528
+ timeKeyframes: createSkyTimeKeyframes(source.timeKeyframes ?? preset?.timeKeyframes),
529
+ type: SKY_SHADER_DOCUMENT_TYPE,
530
+ version: SKY_SHADER_SCHEMA_VERSION,
531
+ };
532
+ }
533
+
534
+ export function validateSkyShaderPresetDocument(input) {
535
+ let source = input;
536
+ if (typeof source === 'string') {
537
+ try {
538
+ source = JSON.parse(source);
539
+ } catch (error) {
540
+ return {
541
+ errors: [`Invalid Sky Shader JSON: ${error.message}`],
542
+ ok: false,
543
+ value: null,
544
+ warnings: [],
545
+ };
546
+ }
547
+ }
548
+ if (!isObject(source)) {
549
+ return {
550
+ errors: ['Sky Shader preset must be a JSON object.'],
551
+ ok: false,
552
+ value: null,
553
+ warnings: [],
554
+ };
555
+ }
556
+ const errors = [];
557
+ const warnings = [];
558
+ if (source.type !== SKY_SHADER_DOCUMENT_TYPE) {
559
+ errors.push(`Sky Shader preset type must be "${SKY_SHADER_DOCUMENT_TYPE}".`);
560
+ }
561
+ const version = Number(
562
+ source.version ?? source.schemaVersion ?? SKY_SHADER_SCHEMA_VERSION,
563
+ );
564
+ if (!Number.isFinite(version)) errors.push('Sky Shader version must be a number.');
565
+ else if (version > SKY_SHADER_SCHEMA_VERSION) {
566
+ errors.push(
567
+ `Sky Shader version ${version} is newer than supported version ${SKY_SHADER_SCHEMA_VERSION}.`,
568
+ );
569
+ }
570
+ if (version < SKY_SHADER_SCHEMA_VERSION) {
571
+ warnings.push(
572
+ `Sky Shader version ${version} was migrated to version ${SKY_SHADER_SCHEMA_VERSION} with the default atmosphere and time curve.`,
573
+ );
574
+ }
575
+ if (!normalizeId(source.id)) errors.push('Sky Shader preset id is required.');
576
+ if (source.timeKeyframes !== undefined) {
577
+ if (!Array.isArray(source.timeKeyframes)) {
578
+ errors.push('Sky Shader timeKeyframes must be an array.');
579
+ } else {
580
+ const uniqueHours = new Set(source.timeKeyframes.map((entry) =>
581
+ Number(entry?.hour)).filter(Number.isFinite).map((hour) =>
582
+ (((hour % 24) + 24) % 24).toFixed(6)));
583
+ if (uniqueHours.size < 2) {
584
+ errors.push('Sky Shader timeKeyframes must contain at least two unique hours.');
585
+ }
586
+ }
587
+ }
588
+ for (const key of Object.keys(isObject(source.settings) ? source.settings : {})) {
589
+ if (!SKY_SHADER_KEY_SET.has(key)) {
590
+ warnings.push(`Unknown Sky Shader setting "${key}" was ignored.`);
591
+ }
592
+ }
593
+ return {
594
+ errors,
595
+ ok: errors.length === 0,
596
+ value: errors.length === 0 ? canonicalDocument(source.id, source) : null,
597
+ warnings,
598
+ };
599
+ }
600
+
601
+ export const parseSkyShaderPresetDocument = validateSkyShaderPresetDocument;
602
+
603
+ export function createSkyShaderPresetDocument(id, definition = {}) {
604
+ const document = canonicalDocument(id, definition);
605
+ const result = validateSkyShaderPresetDocument(document);
606
+ if (!result.ok) throw new Error(result.errors.join(' '));
607
+ return result.value;
608
+ }
609
+
610
+ export function serializeSkyShaderPreset(
611
+ idOrDocument,
612
+ definition = {},
613
+ { pretty = true } = {},
614
+ ) {
615
+ const document = isObject(idOrDocument)
616
+ && idOrDocument.type === SKY_SHADER_DOCUMENT_TYPE
617
+ ? createSkyShaderPresetDocument(idOrDocument.id, idOrDocument)
618
+ : createSkyShaderPresetDocument(idOrDocument, definition);
619
+ return JSON.stringify(document, null, pretty ? 2 : 0);
620
+ }
621
+
622
+ export function registerSkyShaderPreset(
623
+ id,
624
+ definition = {},
625
+ { overwrite = false } = {},
626
+ ) {
627
+ const document = createSkyShaderPresetDocument(id, definition);
628
+ if (overwrite && isProtectedSystemStyleId(document.id) && presetRegistry.has(document.id)) {
629
+ throw new Error(`System style "${document.id}" is read-only.`);
630
+ }
631
+ if (!overwrite && presetRegistry.has(document.id)) {
632
+ throw new Error(`Sky Shader preset "${document.id}" already exists.`);
633
+ }
634
+ presetRegistry.set(document.id, document);
635
+ return {
636
+ description: document.description,
637
+ id: document.id,
638
+ label: document.label,
639
+ value: document.id,
640
+ };
641
+ }
642
+
643
+ export function registerSerializedSkyShaderPreset(input, options = {}) {
644
+ const result = parseSkyShaderPresetDocument(input);
645
+ if (!result.ok) throw new Error(result.errors.join(' '));
646
+ return registerSkyShaderPreset(result.value.id, result.value, {
647
+ overwrite: options.overwrite ?? true,
648
+ });
649
+ }
650
+
651
+ export function getSkyShaderPresetOptions() {
652
+ return Array.from(presetRegistry.values()).map((document) => ({
653
+ description: document.description,
654
+ id: document.id,
655
+ label: document.label,
656
+ value: document.id,
657
+ }));
658
+ }
659
+
660
+ export function applySkyShaderSettings(target, options = {}) {
661
+ const source = isObject(options) ? options : {};
662
+ const settings = createSkyShaderSettings(
663
+ source.type === SKY_SHADER_DOCUMENT_TYPE ? source.settings : options,
664
+ );
665
+ if (typeof target?.applySkyShaderProfile === 'function') {
666
+ const profile = source.type === SKY_SHADER_DOCUMENT_TYPE
667
+ ? canonicalDocument(source.id || 'runtime', source)
668
+ : {
669
+ atmosphere: createSkyAtmosphereSettings(source.atmosphere),
670
+ settings,
671
+ timeKeyframes: createSkyTimeKeyframes(source.timeKeyframes),
672
+ };
673
+ target.applySkyShaderProfile(profile);
674
+ return profile;
675
+ }
676
+ if (typeof target?.applySkyShaderSettings !== 'function') {
677
+ throw new Error(
678
+ 'Sky Shader target must expose applySkyShaderSettings(settings).',
679
+ );
680
+ }
681
+ target.applySkyShaderSettings(settings);
682
+ return settings;
683
+ }
684
+
685
+ registerSkyShaderPreset('default', {
686
+ description: 'Neutral authored sky-dome color-curve treatment.',
687
+ label: 'Default',
688
+ atmosphere: DEFAULT_SKY_ATMOSPHERE,
689
+ settings: DEFAULT_SKY_SHADER_SETTINGS,
690
+ timeKeyframes: DEFAULT_SKY_TIME_KEYFRAMES,
691
+ });
692
+
693
+ registerSkyShaderPreset('call_me_sensei', {
694
+ description: 'The Call Me Sensei house sky: a Genshin-inspired open-world treatment with a saturated cyan-blue zenith, luminous horizon, lifted aerial perspective, and graphic celestial accents.',
695
+ label: 'Call Me Sensei',
696
+ atmosphere: CALL_ME_SENSEI_SKY_ATMOSPHERE,
697
+ settings: CALL_ME_SENSEI_SKY_SHADER_SETTINGS,
698
+ timeKeyframes: CALL_ME_SENSEI_SKY_TIME_KEYFRAMES,
699
+ });