@aethervtt/shard-render 0.1.0 → 0.2.0

package/dist/vfx.d.ts

@@ -0,0 +1,69 @@
+import { type World } from '@aethervtt/shard-core';
+export declare const Trail: import("@aethervtt/shard-core").ComponentDef<{
+    readonly playing: import("@aethervtt/shard-core").FieldType<boolean, "u8">;
+    readonly paused: import("@aethervtt/shard-core").FieldType<boolean, "u8">;
+    readonly opacity: import("@aethervtt/shard-core").FieldType<number, "f32">;
+    readonly color: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Color, "f32">;
+    readonly texture: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").AssetRef<"Texture"> | null, "object">;
+    readonly blend: import("@aethervtt/shard-core").FieldType<"additive" | "alpha", "u8">;
+    readonly layers: import("@aethervtt/shard-core").FieldType<number, "u16">;
+    readonly width: import("@aethervtt/shard-core").FieldType<number, "f32">;
+    readonly endColor: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Color, "f32">;
+    readonly widthCurve: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").InferFields<{
+        at: import("@aethervtt/shard-core").FieldType<number, "f32">;
+        value: import("@aethervtt/shard-core").FieldType<number, "f32">;
+    }>[], "object">;
+    readonly repeat: import("@aethervtt/shard-core").FieldType<number, "f32">;
+    readonly scroll: import("@aethervtt/shard-core").FieldType<number, "f32">;
+    readonly offset: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec3, "f32">;
+    readonly lifetime: import("@aethervtt/shard-core").FieldType<number, "f32">;
+    readonly capacity: import("@aethervtt/shard-core").FieldType<number, "u16">;
+    readonly minDistance: import("@aethervtt/shard-core").FieldType<number, "f32">;
+    readonly breakDistance: import("@aethervtt/shard-core").FieldType<number, "f32">;
+}>;
+export declare const Beam: import("@aethervtt/shard-core").ComponentDef<{
+    readonly playing: import("@aethervtt/shard-core").FieldType<boolean, "u8">;
+    readonly paused: import("@aethervtt/shard-core").FieldType<boolean, "u8">;
+    readonly opacity: import("@aethervtt/shard-core").FieldType<number, "f32">;
+    readonly color: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Color, "f32">;
+    readonly texture: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").AssetRef<"Texture"> | null, "object">;
+    readonly blend: import("@aethervtt/shard-core").FieldType<"additive" | "alpha", "u8">;
+    readonly layers: import("@aethervtt/shard-core").FieldType<number, "u16">;
+    readonly width: import("@aethervtt/shard-core").FieldType<number, "f32">;
+    readonly endColor: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Color, "f32">;
+    readonly widthCurve: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").InferFields<{
+        at: import("@aethervtt/shard-core").FieldType<number, "f32">;
+        value: import("@aethervtt/shard-core").FieldType<number, "f32">;
+    }>[], "object">;
+    readonly repeat: import("@aethervtt/shard-core").FieldType<number, "f32">;
+    readonly scroll: import("@aethervtt/shard-core").FieldType<number, "f32">;
+    readonly start: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec3, "f32">;
+    readonly end: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec3, "f32">;
+    readonly target: import("@aethervtt/shard-core").FieldType<number | null, "f64">;
+    readonly points: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec3[], "object">;
+    readonly segments: import("@aethervtt/shard-core").FieldType<number, "u16">;
+    readonly noise: import("@aethervtt/shard-core").FieldType<number, "f32">;
+    readonly seed: import("@aethervtt/shard-core").FieldType<number, "u32">;
+}>;
+export declare const Decal: import("@aethervtt/shard-core").ComponentDef<{
+    readonly playing: import("@aethervtt/shard-core").FieldType<boolean, "u8">;
+    readonly paused: import("@aethervtt/shard-core").FieldType<boolean, "u8">;
+    readonly opacity: import("@aethervtt/shard-core").FieldType<number, "f32">;
+    readonly color: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Color, "f32">;
+    readonly texture: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").AssetRef<"Texture"> | null, "object">;
+    readonly blend: import("@aethervtt/shard-core").FieldType<"additive" | "alpha", "u8">;
+    readonly layers: import("@aethervtt/shard-core").FieldType<number, "u16">;
+    readonly size: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec3, "f32">;
+    readonly receiverMask: import("@aethervtt/shard-core").FieldType<number, "u16">;
+    readonly maxAngle: import("@aethervtt/shard-core").FieldType<number, "f32">;
+    readonly offset: import("@aethervtt/shard-core").FieldType<number, "f32">;
+    readonly lifetime: import("@aethervtt/shard-core").FieldType<number, "f32">;
+    readonly fadeOut: import("@aethervtt/shard-core").FieldType<number, "f32">;
+    readonly maxVertices: import("@aethervtt/shard-core").FieldType<number, "u32">;
+}>;
+export declare const DecalReceiver: import("@aethervtt/shard-core").ComponentDef<{
+    readonly mask: import("@aethervtt/shard-core").FieldType<number, "u16">;
+}>;
+export declare const RibbonsPath: import("@aethervtt/shard-core").ResourceDef<boolean>;
+export declare const DecalsPath: import("@aethervtt/shard-core").ResourceDef<boolean>;
+export declare function observeVfxWithoutPlugin(world: World): void;

package/dist/vfx.js

@@ -0,0 +1,103 @@
+import { defineComponent, defineResource, onAdd, t } from "@aethervtt/shard-core";
+import { Transform } from "@aethervtt/shard-transform";
+import { warnFeatureMissing } from "./features.js";
+const presentation = {
+  playing: t.bool({ default: true }),
+  paused: t.bool(),
+  opacity: t.f32({ default: 1, min: 0, max: 1 }),
+  color: t.color({ default: [1, 1, 1, 1] }),
+  texture: t.handle("Texture"),
+  blend: t.enum(["alpha", "additive"]),
+  layers: t.u16({ default: 1 })
+};
+const ribbon = {
+  ...presentation,
+  width: t.f32({ default: 0.1, min: 0, max: 1e3 }),
+  endColor: t.color({ default: [1, 1, 1, 0] }),
+  widthCurve: t.list(
+    t.struct({ at: t.f32({ min: 0, max: 1 }), value: t.f32({ min: 0, max: 16 }) })
+  ),
+  repeat: t.f32({ default: 1, min: 1e-4, max: 1e4 }),
+  scroll: t.f32({ min: -1e4, max: 1e4 })
+};
+const Trail = defineComponent(
+  "render/Trail",
+  {
+    ...ribbon,
+    offset: t.vec3(),
+    lifetime: t.f32({ default: 0.5, min: 1e-3, max: 3600 }),
+    capacity: t.u16({ default: 64, min: 2, max: 256 }),
+    minDistance: t.f32({ default: 0.01, min: 1e-5, max: 1e3 }),
+    breakDistance: t.f32({ default: 10, min: 1e-3, max: 1e6 })
+  },
+  {
+    requires: [Transform],
+    description: "World-space ribbon history of this entity/bone; stops emitting when playing is false and drains by lifetime (0082)."
+  }
+);
+const Beam = defineComponent(
+  "render/Beam",
+  {
+    ...ribbon,
+    start: t.vec3(),
+    end: t.vec3({ default: [0, 0, -1] }),
+    target: t.entity(),
+    points: t.list(t.vec3()),
+    segments: t.u16({ default: 16, min: 1, max: 255 }),
+    noise: t.f32({ min: 0, max: 1e3 }),
+    seed: t.u32()
+  },
+  {
+    requires: [Transform],
+    description: "Camera-facing beam between transformed endpoints, or along local points; deterministic seeded displacement (0082)."
+  }
+);
+const Decal = defineComponent(
+  "render/Decal",
+  {
+    ...presentation,
+    size: t.vec3({ default: [1, 1, 1] }),
+    receiverMask: t.u16({ default: 1 }),
+    maxAngle: t.f32({ default: 80, min: 0, max: 89.9 }),
+    offset: t.f32({ default: 2e-3, min: 0, max: 1 }),
+    lifetime: t.f32({ min: 0, max: 86400 }),
+    fadeOut: t.f32({ default: 1, min: 0, max: 86400 }),
+    maxVertices: t.u32({ default: 12288, min: 3, max: 65535 })
+  },
+  {
+    requires: [Transform],
+    description: "Box projection onto DecalReceiver rigid meshes: local XY is UV, projection along -Z. Zero lifetime persists (0083)."
+  }
+);
+const DecalReceiver = defineComponent(
+  "render/DecalReceiver",
+  {
+    mask: t.u16({ default: 1 })
+  },
+  { description: "Eligible rigid Mesh3d surface for matching decal receiver masks (0083)." }
+);
+const RibbonsPath = defineResource("render/RibbonsPath", { init: () => true });
+const DecalsPath = defineResource("render/DecalsPath", { init: () => true });
+function observeVfxWithoutPlugin(world) {
+  world.observe(onAdd(Trail), ({ world: w }) => {
+    if (!w.hasResource(RibbonsPath))
+      warnFeatureMissing(w, "Trail", "ribbonsPlugin", "it draws no ribbon");
+  });
+  world.observe(onAdd(Beam), ({ world: w }) => {
+    if (!w.hasResource(RibbonsPath))
+      warnFeatureMissing(w, "Beam", "ribbonsPlugin", "it draws no ribbon");
+  });
+  world.observe(onAdd(Decal), ({ world: w }) => {
+    if (!w.hasResource(DecalsPath))
+      warnFeatureMissing(w, "Decal", "decalsPlugin", "it draws no decal");
+  });
+}
+export {
+  Beam,
+  Decal,
+  DecalReceiver,
+  DecalsPath,
+  RibbonsPath,
+  Trail,
+  observeVfxWithoutPlugin
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aethervtt/shard-render",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "license": "MIT",
   "type": "module",
   "sideEffects": false,
@@ -9,6 +9,14 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
+    "./crowd": {
+      "types": "./dist/crowd.d.ts",
+      "default": "./dist/crowd.js"
+    },
+    "./post-scene": {
+      "types": "./dist/post-scene.d.ts",
+      "default": "./dist/post-scene.js"
+    },
     "./testing": {
       "types": "./dist/testing.d.ts",
       "default": "./dist/testing.js"
@@ -28,15 +36,15 @@
     "README.md"
   ],
   "dependencies": {
-    "@aethervtt/shard-assets": "0.1.0",
-    "@aethervtt/shard-core": "0.1.0",
-    "@aethervtt/shard-gpu": "0.1.0",
-    "@aethervtt/shard-mesh": "0.1.0",
-    "@aethervtt/shard-noise": "0.1.0",
-    "@aethervtt/shard-runtime": "0.1.0",
-    "@aethervtt/shard-shader": "0.1.0",
-    "@aethervtt/shard-texture": "0.1.0",
-    "@aethervtt/shard-transform": "0.1.0"
+    "@aethervtt/shard-assets": "0.2.0",
+    "@aethervtt/shard-core": "0.2.0",
+    "@aethervtt/shard-gpu": "0.2.0",
+    "@aethervtt/shard-mesh": "0.2.0",
+    "@aethervtt/shard-noise": "0.2.0",
+    "@aethervtt/shard-runtime": "0.2.0",
+    "@aethervtt/shard-shader": "0.2.0",
+    "@aethervtt/shard-texture": "0.2.0",
+    "@aethervtt/shard-transform": "0.2.0"
   },
   "repository": {
     "type": "git",
@@ -48,6 +56,6 @@
     "provenance": true
   },
   "shard": {
-    "buildSha": "8e14c9896f82a3554b156f1ffdd68f2cc3e7d78a"
+    "buildSha": "32c22a3944ed23f5d1baa90bf7cc9fae724f5fd8"
   }
 }