@alpsckr/unitycli 0.4.0

package/extensions/vfx-graph/bridge/domains/vfx.ts

@@ -0,0 +1,337 @@
+import { boolFlag, compactArgs, floatFlag, numberFlag, stringFlag, targetArgs } from "../args.js";
+import type { BridgeCommandSpec, BridgeFlags } from "../types.js";
+
+export const vfxBridgeSpecs: BridgeCommandSpec[] = markToolsOnly([
+  { group: "vfx", command: "graph.info", bridgeCommand: "project-tool.run", toolName: "vfx.graph.info", buildArgs: vfxGraphInfoArgs },
+  { group: "vfx", command: "graph.create", bridgeCommand: "project-tool.run", toolName: "vfx.graph.create", buildArgs: vfxGraphCreateArgs, destructiveHint: true, supportsDryRun: true },
+  { group: "vfx", command: "effect.info", bridgeCommand: "project-tool.run", toolName: "vfx.effect.info", buildArgs: vfxTargetArgs },
+  { group: "vfx", command: "effect.add", bridgeCommand: "project-tool.run", toolName: "vfx.effect.add", buildArgs: vfxEffectGraphArgs },
+  { group: "vfx", command: "effect.assign", bridgeCommand: "project-tool.run", toolName: "vfx.effect.assign", buildArgs: vfxEffectGraphArgs },
+  { group: "vfx", command: "parameter", bridgeCommand: "project-tool.run", toolName: "vfx.parameter", buildArgs: vfxParameterArgs },
+  { group: "vfx", command: "control.play", bridgeCommand: "project-tool.run", toolName: "vfx.control.play", buildArgs: vfxTargetArgs },
+  { group: "vfx", command: "control.stop", bridgeCommand: "project-tool.run", toolName: "vfx.control.stop", buildArgs: vfxTargetArgs },
+  { group: "vfx", command: "control.pause", bridgeCommand: "project-tool.run", toolName: "vfx.control.pause", buildArgs: vfxTargetArgs },
+  { group: "vfx", command: "control.reinitialize", bridgeCommand: "project-tool.run", toolName: "vfx.control.reinitialize", buildArgs: vfxTargetArgs },
+  { group: "vfx", command: "control.set-rate", bridgeCommand: "project-tool.run", toolName: "vfx.control.set-rate", buildArgs: vfxControlRateArgs },
+  { group: "vfx", command: "control.set-seed", bridgeCommand: "project-tool.run", toolName: "vfx.control.set-seed", buildArgs: vfxControlSeedArgs },
+  { group: "vfx", command: "template.list", bridgeCommand: "project-tool.run", toolName: "vfx.template.list", buildArgs: vfxEmptyArgs },
+  { group: "vfx", command: "template.create", bridgeCommand: "project-tool.run", toolName: "vfx.template.create", buildArgs: vfxTemplateCreateArgs, destructiveHint: true, supportsDryRun: true },
+  { group: "vfx", command: "particle-create", bridgeCommand: "project-tool.run", toolName: "vfx.particle-create", buildArgs: vfxParticleArgs },
+  { group: "vfx", command: "particle-info", bridgeCommand: "project-tool.run", toolName: "vfx.particle-info", buildArgs: vfxParticleInfoArgs },
+  { group: "vfx", command: "particle-main", bridgeCommand: "project-tool.run", toolName: "vfx.particle-main", buildArgs: vfxParticleMainArgs },
+  { group: "vfx", command: "particle-emission", bridgeCommand: "project-tool.run", toolName: "vfx.particle-emission", buildArgs: vfxParticleEmissionArgs },
+  { group: "vfx", command: "particle-shape", bridgeCommand: "project-tool.run", toolName: "vfx.particle-shape", buildArgs: vfxParticleShapeArgs },
+  { group: "vfx", command: "particle.play", bridgeCommand: "project-tool.run", toolName: "vfx.particle.play", buildArgs: vfxParticleActionArgs },
+  { group: "vfx", command: "particle.stop", bridgeCommand: "project-tool.run", toolName: "vfx.particle.stop", buildArgs: vfxParticleStopArgs },
+  { group: "vfx", command: "particle.pause", bridgeCommand: "project-tool.run", toolName: "vfx.particle.pause", buildArgs: vfxParticleActionArgs },
+  { group: "vfx", command: "particle.clear", bridgeCommand: "project-tool.run", toolName: "vfx.particle.clear", buildArgs: vfxParticleActionArgs },
+  { group: "vfx", command: "line-create", bridgeCommand: "project-tool.run", toolName: "vfx.line-create", buildArgs: vfxLineCreateArgs },
+  { group: "vfx", command: "line-positions", bridgeCommand: "project-tool.run", toolName: "vfx.line-positions", buildArgs: vfxLinePositionsArgs },
+  { group: "vfx", command: "trail.create", bridgeCommand: "project-tool.run", toolName: "vfx.trail.create", buildArgs: vfxTrailCreateArgs },
+  { group: "vfx", command: "trail.set", bridgeCommand: "project-tool.run", toolName: "vfx.trail.set", buildArgs: vfxTrailSetArgs }
+]);
+
+function markToolsOnly(specs: BridgeCommandSpec[]): BridgeCommandSpec[] {
+  return specs.map((spec) => ({ ...spec, toolsOnly: true }));
+}
+
+function vfxGraphInfoArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  const structured = structuredInput(flags);
+  return compactArgs({ path: positionalTarget ?? stringFlag(flags, "path") ?? stringFlag(flags, "graph") ?? stringValue(structured.path) });
+}
+
+function vfxGraphCreateArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  const structured = structuredInput(flags);
+  return compactArgs({
+    path: positionalTarget ?? stringFlag(flags, "path") ?? stringFlag(flags, "graph") ?? stringValue(structured.path),
+    overwrite: boolFlag(flags, "overwrite") ?? boolValue(structured.overwrite)
+  });
+}
+
+function vfxTargetArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  const structured = structuredInput(flags);
+  return compactArgs({ target: positionalTarget ?? stringFlag(flags, "target") ?? stringFlag(flags, "name") ?? stringValue(structured.target) });
+}
+
+function vfxEffectGraphArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  const structured = structuredInput(flags);
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringFlag(flags, "name") ?? stringValue(structured.target),
+    graph: stringFlag(flags, "graph") ?? stringFlag(flags, "path") ?? stringValue(structured.graph)
+  });
+}
+
+function vfxParameterArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  const structured = structuredInput(flags);
+  const type = stringFlag(flags, "type") ?? stringFlag(flags, "param-type") ?? stringValue(structured.type);
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringFlag(flags, "name") ?? stringValue(structured.target),
+    name: stringFlag(flags, "name") ?? stringValue(structured.name),
+    type,
+    numberValue: type === "float" ? floatFlag(flags, "value") ?? numberValue(structured.numberValue) ?? numberValue(structured.value) : numberValue(structured.numberValue),
+    intValue: type === "int" ? numberFlag(flags, "value") ?? numberValue(structured.intValue) ?? numberValue(structured.value) : numberValue(structured.intValue),
+    boolValue: type === "bool" ? boolFlag(flags, "value") ?? boolValue(structured.boolValue) ?? boolValue(structured.value) : boolValue(structured.boolValue),
+    assetPath: stringFlag(flags, "value") ?? stringValue(structured.assetPath) ?? stringValue(structured.value),
+    x: floatFlag(flags, "x") ?? numberValue(structured.x),
+    y: floatFlag(flags, "y") ?? numberValue(structured.y),
+    z: floatFlag(flags, "z") ?? numberValue(structured.z),
+    w: floatFlag(flags, "w") ?? numberValue(structured.w),
+    r: floatFlag(flags, "r") ?? numberValue(structured.r),
+    g: floatFlag(flags, "g") ?? numberValue(structured.g),
+    b: floatFlag(flags, "b") ?? numberValue(structured.b),
+    a: floatFlag(flags, "a") ?? numberValue(structured.a)
+  });
+}
+
+function vfxControlRateArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  const structured = structuredInput(flags);
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringFlag(flags, "name") ?? stringValue(structured.target),
+    rate: floatFlag(flags, "rate") ?? numberValue(structured.rate)
+  });
+}
+
+function vfxControlSeedArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  const structured = structuredInput(flags);
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringFlag(flags, "name") ?? stringValue(structured.target),
+    seed: numberFlag(flags, "seed") ?? numberValue(structured.seed),
+    resetSeedOnPlay: boolFlag(flags, "reset-seed-on-play") ?? boolValue(structured.resetSeedOnPlay)
+  });
+}
+
+function vfxEmptyArgs(): Record<string, unknown> {
+  return {};
+}
+
+function vfxTemplateCreateArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  const structured = structuredInput(flags);
+  return compactArgs({
+    path: positionalTarget ?? stringFlag(flags, "path") ?? stringValue(structured.path),
+    template: stringFlag(flags, "template") ?? stringValue(structured.template),
+    overwrite: boolFlag(flags, "overwrite") ?? boolValue(structured.overwrite)
+  });
+}
+
+function vfxParticleArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  const structured = structuredInput(flags);
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringFlag(flags, "name") ?? stringValue(structured.target),
+    name: stringFlag(flags, "name") ?? stringValue(structured.name),
+    duration: floatFlag(flags, "duration") ?? numberValue(structured.duration),
+    startLifetime: floatFlag(flags, "start-lifetime") ?? numberValue(structured.startLifetime),
+    startSpeed: floatFlag(flags, "start-speed") ?? numberValue(structured.startSpeed),
+    startSize: floatFlag(flags, "start-size") ?? numberValue(structured.startSize),
+    startColor: stringFlag(flags, "start-color") ?? stringValue(structured.startColor),
+    maxParticles: numberFlag(flags, "max-particles") ?? numberValue(structured.maxParticles),
+    loop: boolFlag(flags, "loop") ?? boolValue(structured.loop)
+  });
+}
+
+function vfxParticleInfoArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  const structured = structuredInput(flags);
+  return compactArgs({ target: positionalTarget ?? stringFlag(flags, "target") ?? stringFlag(flags, "name") ?? stringValue(structured.target) });
+}
+
+function vfxParticleMainArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  const structured = structuredInput(flags);
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringFlag(flags, "name") ?? stringValue(structured.target),
+    duration: floatFlag(flags, "duration") ?? numberValue(structured.duration),
+    startLifetime: floatFlag(flags, "start-lifetime") ?? numberValue(structured.startLifetime),
+    startSpeed: floatFlag(flags, "start-speed") ?? numberValue(structured.startSpeed),
+    startSize: floatFlag(flags, "start-size") ?? numberValue(structured.startSize),
+    startColor: stringFlag(flags, "start-color") ?? stringValue(structured.startColor),
+    startRotation: floatFlag(flags, "start-rotation") ?? numberValue(structured.startRotation),
+    gravityModifier: floatFlag(flags, "gravity-modifier") ?? numberValue(structured.gravityModifier),
+    maxParticles: numberFlag(flags, "max-particles") ?? numberValue(structured.maxParticles),
+    loop: boolFlag(flags, "loop") ?? boolValue(structured.loop),
+    playOnAwake: boolFlag(flags, "play-on-awake") ?? boolValue(structured.playOnAwake),
+    simulationSpace: stringFlag(flags, "simulation-space") ?? stringValue(structured.simulationSpace),
+    scalingMode: stringFlag(flags, "scaling-mode") ?? stringValue(structured.scalingMode)
+  });
+}
+
+function vfxParticleEmissionArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  const structured = structuredInput(flags);
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringFlag(flags, "name") ?? stringValue(structured.target),
+    enabled: boolFlag(flags, "enabled") ?? boolValue(structured.enabled),
+    rateOverTime: floatFlag(flags, "rate-over-time") ?? numberValue(structured.rateOverTime),
+    rateOverDistance: floatFlag(flags, "rate-over-distance") ?? numberValue(structured.rateOverDistance),
+    burstCount: numberFlag(flags, "burst-count") ?? numberValue(structured.burstCount),
+    bursts: arrayValue(structured.bursts)
+  });
+}
+
+function vfxParticleShapeArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  const structured = structuredInput(flags);
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringFlag(flags, "name") ?? stringValue(structured.target),
+    enabled: boolFlag(flags, "enabled") ?? boolValue(structured.enabled),
+    shapeType: stringFlag(flags, "shape-type") ?? stringValue(structured.shapeType),
+    radius: floatFlag(flags, "radius") ?? numberValue(structured.radius),
+    angle: floatFlag(flags, "angle") ?? numberValue(structured.angle),
+    arc: floatFlag(flags, "arc") ?? numberValue(structured.arc),
+    length: floatFlag(flags, "length") ?? numberValue(structured.length),
+    boxX: floatFlag(flags, "box-x") ?? numberValue(structured.boxX),
+    boxY: floatFlag(flags, "box-y") ?? numberValue(structured.boxY),
+    boxZ: floatFlag(flags, "box-z") ?? numberValue(structured.boxZ),
+    randomDirection: boolFlag(flags, "random-direction") ?? boolValue(structured.randomDirection)
+  });
+}
+
+function vfxParticleActionArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  const structured = structuredInput(flags);
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringFlag(flags, "name") ?? stringValue(structured.target),
+    withChildren: boolFlag(flags, "with-children") ?? boolValue(structured.withChildren)
+  });
+}
+
+function vfxParticleStopArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  const structured = structuredInput(flags);
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringFlag(flags, "name") ?? stringValue(structured.target),
+    withChildren: boolFlag(flags, "with-children") ?? boolValue(structured.withChildren),
+    stopBehavior: stringFlag(flags, "stop-behavior") ?? stringValue(structured.stopBehavior)
+  });
+}
+
+
+function vfxLineCreateArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  const structured = structuredInput(flags);
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringValue(structured.target),
+    name: stringFlag(flags, "name") ?? stringValue(structured.name),
+    startWidth: floatFlag(flags, "start-width") ?? numberValue(structured.startWidth),
+    endWidth: floatFlag(flags, "end-width") ?? numberValue(structured.endWidth),
+    widthMultiplier: floatFlag(flags, "width-multiplier") ?? numberValue(structured.widthMultiplier),
+    widthCurve: parseCurveFlag(stringFlag(flags, "width-curve")) ?? arrayValue(structured.widthCurve),
+    startColor: stringFlag(flags, "start-color") ?? stringValue(structured.startColor),
+    endColor: stringFlag(flags, "end-color") ?? stringValue(structured.endColor),
+    colorGradient: parseGradientFlag(stringFlag(flags, "color-gradient")) ?? arrayValue(structured.colorGradient),
+    material: stringFlag(flags, "material") ?? stringValue(structured.material),
+    positionCount: numberFlag(flags, "position-count") ?? numberValue(structured.positionCount),
+    positions: parseVector3ArrayFlag(stringFlag(flags, "positions")) ?? arrayValue(structured.positions),
+    loop: boolFlag(flags, "loop") ?? boolValue(structured.loop),
+    useWorldSpace: boolFlag(flags, "use-world-space") ?? boolValue(structured.useWorldSpace),
+    alignment: stringFlag(flags, "alignment") ?? stringValue(structured.alignment),
+    textureMode: stringFlag(flags, "texture-mode") ?? stringValue(structured.textureMode),
+    numCornerVertices: numberFlag(flags, "num-corner-vertices") ?? numberValue(structured.numCornerVertices),
+    numCapVertices: numberFlag(flags, "num-cap-vertices") ?? numberValue(structured.numCapVertices)
+  });
+}
+
+function vfxLinePositionsArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  const structured = structuredInput(flags);
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringFlag(flags, "name") ?? stringValue(structured.target),
+    positions: parseVector3ArrayFlag(stringFlag(flags, "positions")) ?? arrayValue(structured.positions),
+    index: numberFlag(flags, "index") ?? numberValue(structured.index),
+    position: parseVector3Flag(stringFlag(flags, "position")) ?? objectValue(structured.position)
+  });
+}
+
+function vfxTrailCreateArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  const structured = structuredInput(flags);
+  return compactArgs({ name: positionalTarget ?? stringFlag(flags, "name") ?? stringValue(structured.name), ...vfxTrailFields(flags, structured) });
+}
+
+function vfxTrailSetArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  const structured = structuredInput(flags);
+  return compactArgs({ target: positionalTarget ?? stringFlag(flags, "target") ?? stringValue(structured.target), ...vfxTrailFields(flags, structured) });
+}
+
+function vfxTrailFields(flags: BridgeFlags, structured: Record<string, unknown>): Record<string, unknown> {
+  return {
+    time: floatFlag(flags, "time") ?? numberValue(structured.time),
+    startWidth: floatFlag(flags, "start-width") ?? numberValue(structured.startWidth),
+    endWidth: floatFlag(flags, "end-width") ?? numberValue(structured.endWidth),
+    widthMultiplier: floatFlag(flags, "width-multiplier") ?? numberValue(structured.widthMultiplier),
+    widthCurve: parseCurveFlag(stringFlag(flags, "width-curve")) ?? arrayValue(structured.widthCurve),
+    startColor: stringFlag(flags, "start-color") ?? stringValue(structured.startColor),
+    endColor: stringFlag(flags, "end-color") ?? stringValue(structured.endColor),
+    colorGradient: parseGradientFlag(stringFlag(flags, "color-gradient")) ?? arrayValue(structured.colorGradient),
+    material: stringFlag(flags, "material") ?? stringValue(structured.material),
+    minVertexDistance: floatFlag(flags, "min-vertex-distance") ?? numberValue(structured.minVertexDistance),
+    autodestruct: boolFlag(flags, "autodestruct") ?? boolValue(structured.autodestruct),
+    emitting: boolFlag(flags, "emitting") ?? boolValue(structured.emitting),
+    alignment: stringFlag(flags, "alignment") ?? stringValue(structured.alignment),
+    textureMode: stringFlag(flags, "texture-mode") ?? stringValue(structured.textureMode),
+    numCornerVertices: numberFlag(flags, "num-corner-vertices") ?? numberValue(structured.numCornerVertices),
+    numCapVertices: numberFlag(flags, "num-cap-vertices") ?? numberValue(structured.numCapVertices)
+  };
+}
+
+function structuredInput(flags: BridgeFlags): Record<string, unknown> {
+  const raw = typeof flags.__structuredInput === "string" ? flags.__structuredInput : undefined;
+  if (!raw) return {};
+  try {
+    const parsed = JSON.parse(raw);
+    return typeof parsed === "object" && parsed !== null && !Array.isArray(parsed) ? parsed as Record<string, unknown> : {};
+  } catch {
+    return {};
+  }
+}
+
+function stringValue(value: unknown): string | undefined {
+  return typeof value === "string" ? value : undefined;
+}
+
+function numberValue(value: unknown): number | undefined {
+  return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+
+function boolValue(value: unknown): boolean | undefined {
+  return typeof value === "boolean" ? value : undefined;
+}
+
+function arrayValue(value: unknown): unknown[] | undefined {
+  return Array.isArray(value) ? value : undefined;
+}
+
+function objectValue(value: unknown): Record<string, unknown> | undefined {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value as Record<string, unknown> : undefined;
+}
+
+function parseVector3Flag(value: string | undefined): Record<string, number> | undefined {
+  if (!value) return undefined;
+  const parts = value.split(",").map((item) => Number.parseFloat(item.trim()));
+  if (parts.length < 3 || parts.some((item) => !Number.isFinite(item))) return undefined;
+  return { x: parts[0], y: parts[1], z: parts[2] };
+}
+
+function parseVector3ArrayFlag(value: string | undefined): Array<Record<string, number>> | undefined {
+  if (!value) return undefined;
+  const items = value.split(/\s+/).map((item) => item.trim()).filter(Boolean);
+  const parsed = items.map((item) => parseVector3Flag(item.replace(/[\[\]()]/g, ""))).filter((item): item is Record<string, number> => item !== undefined);
+  return parsed.length === 0 ? undefined : parsed;
+}
+
+function parseCurveFlag(value: string | undefined): Array<Record<string, number>> | undefined {
+  if (!value) return undefined;
+  const result: Array<Record<string, number>> = [];
+  for (const part of value.split(",").map((item) => item.trim()).filter(Boolean)) {
+    const [timeRaw, valueRaw] = part.split(":").map((item) => item.trim());
+    const time = Number.parseFloat(timeRaw ?? "");
+    const y = Number.parseFloat(valueRaw ?? "");
+    if (Number.isFinite(time) && Number.isFinite(y)) {
+      result.push({ time, value: y });
+    }
+  }
+  return result.length === 0 ? undefined : result;
+}
+
+function parseGradientFlag(value: string | undefined): Array<Record<string, unknown>> | undefined {
+  if (!value) return undefined;
+  const result: Array<Record<string, unknown>> = [];
+  for (const part of value.split(",").map((item) => item.trim()).filter(Boolean)) {
+    const [timeRaw, colorRaw] = part.split(":").map((item) => item.trim());
+    const time = Number.parseFloat(timeRaw ?? "");
+    if (Number.isFinite(time) && colorRaw) {
+      result.push({ time, color: colorRaw });
+    }
+  }
+  return result.length === 0 ? undefined : result;
+}

package/extensions/vfx-graph/docs/vfx.md

@@ -0,0 +1,28 @@
+# VFX Tools
+
+The extension contributes independent tools for Visual Effect Graph components and Unity ParticleSystem/LineRenderer/TrailRenderer workflows.
+
+## Visual Effect Graph
+
+| Tool | Description |
+| --- | --- |
+| `vfx.graph.info` | Read one existing Visual Effect Graph asset. |
+| `vfx.graph.create` | Create or overwrite one Visual Effect Graph asset. |
+| `vfx.effect.info` | Read the VisualEffect component and assigned graph. |
+| `vfx.effect.add` | Ensure a target has a VisualEffect component. |
+| `vfx.effect.assign` | Assign an existing graph to a VisualEffect component. |
+| `vfx.parameter` | Set one exposed VisualEffect parameter and verify the matching Has*/Get* typed readback. |
+| `vfx.control.play` | Play a VisualEffect. |
+| `vfx.control.stop` | Stop a VisualEffect. |
+| `vfx.control.pause` | Toggle VisualEffect pause state. |
+| `vfx.control.reinitialize` | Reinitialize a VisualEffect. |
+| `vfx.control.set-rate` | Set VisualEffect playback rate and return the public-property readback. |
+| `vfx.control.set-seed` | Set VisualEffect random seed and return the public-property readback. |
+| `vfx.template.list` | List installed graph templates. |
+| `vfx.template.create` | Create a graph from a supported template. |
+
+These tools require `com.unity.visualeffectgraph`.
+
+## Particle And Renderer Tools
+
+The extension also contributes `vfx.particle-create`, `vfx.particle-info`, `vfx.particle-main`, `vfx.particle-emission`, `vfx.particle-shape`, `vfx.particle.play`, `vfx.particle.stop`, `vfx.particle.pause`, `vfx.particle.clear`, `vfx.line-create`, `vfx.line-positions`, `vfx.trail.create`, and `vfx.trail.set`.

package/extensions/vfx-graph/extension.json

@@ -0,0 +1,72 @@
+{
+  "id": "vfx-graph",
+  "name": "VFX Graph",
+  "version": "1.0.0",
+  "description": "Visual effects tools for VFX Graph assets and components, exposed parameters, ParticleSystem modules, LineRenderer, and TrailRenderer.",
+  "unityPackages": [],
+  "contributions": {
+    "tools": [
+      { "name": "vfx.graph.info", "requiresPackages": ["com.unity.visualeffectgraph"] },
+      { "name": "vfx.graph.create", "requiresPackages": ["com.unity.visualeffectgraph"] },
+      { "name": "vfx.effect.info", "requiresPackages": ["com.unity.visualeffectgraph"] },
+      { "name": "vfx.effect.add", "requiresPackages": ["com.unity.visualeffectgraph"] },
+      { "name": "vfx.effect.assign", "requiresPackages": ["com.unity.visualeffectgraph"] },
+      { "name": "vfx.parameter", "requiresPackages": ["com.unity.visualeffectgraph"] },
+      { "name": "vfx.control.play", "requiresPackages": ["com.unity.visualeffectgraph"] },
+      { "name": "vfx.control.stop", "requiresPackages": ["com.unity.visualeffectgraph"] },
+      { "name": "vfx.control.pause", "requiresPackages": ["com.unity.visualeffectgraph"] },
+      { "name": "vfx.control.reinitialize", "requiresPackages": ["com.unity.visualeffectgraph"] },
+      { "name": "vfx.control.set-rate", "requiresPackages": ["com.unity.visualeffectgraph"] },
+      { "name": "vfx.control.set-seed", "requiresPackages": ["com.unity.visualeffectgraph"] },
+      { "name": "vfx.template.list", "requiresPackages": ["com.unity.visualeffectgraph"] },
+      { "name": "vfx.template.create", "requiresPackages": ["com.unity.visualeffectgraph"] },
+      { "name": "vfx.particle-create", "requiresPackages": [] },
+      { "name": "vfx.particle-info", "requiresPackages": [] },
+      { "name": "vfx.particle-main", "requiresPackages": [] },
+      { "name": "vfx.particle-emission", "requiresPackages": [] },
+      { "name": "vfx.particle-shape", "requiresPackages": [] },
+      { "name": "vfx.particle.play", "requiresPackages": [] },
+      { "name": "vfx.particle.stop", "requiresPackages": [] },
+      { "name": "vfx.particle.pause", "requiresPackages": [] },
+      { "name": "vfx.particle.clear", "requiresPackages": [] },
+      { "name": "vfx.line-create", "requiresPackages": [] },
+      { "name": "vfx.line-positions", "requiresPackages": [] },
+      { "name": "vfx.trail.create", "requiresPackages": [] },
+      { "name": "vfx.trail.set", "requiresPackages": [] }
+    ],
+    "csharpEntries": [
+      { "type": "UnityCli.VfxGraphInfoTool", "description": "Implements vfx.graph.info." },
+      { "type": "UnityCli.VfxGraphCreateTool", "description": "Implements vfx.graph.create." },
+      { "type": "UnityCli.VfxEffectInfoTool", "description": "Implements vfx.effect.info." },
+      { "type": "UnityCli.VfxEffectAddTool", "description": "Implements vfx.effect.add." },
+      { "type": "UnityCli.VfxEffectAssignTool", "description": "Implements vfx.effect.assign." },
+      { "type": "UnityCli.VfxParameterTool", "description": "Implements vfx.parameter." },
+      { "type": "UnityCli.VfxControlPlayTool", "description": "Implements vfx.control.play." },
+      { "type": "UnityCli.VfxControlStopTool", "description": "Implements vfx.control.stop." },
+      { "type": "UnityCli.VfxControlPauseTool", "description": "Implements vfx.control.pause." },
+      { "type": "UnityCli.VfxControlReinitializeTool", "description": "Implements vfx.control.reinitialize." },
+      { "type": "UnityCli.VfxControlSetRateTool", "description": "Implements vfx.control.set-rate." },
+      { "type": "UnityCli.VfxControlSetSeedTool", "description": "Implements vfx.control.set-seed." },
+      { "type": "UnityCli.VfxTemplateListTool", "description": "Implements vfx.template.list." },
+      { "type": "UnityCli.VfxTemplateCreateTool", "description": "Implements vfx.template.create." },
+      { "type": "UnityCli.VfxParticleCreateTool", "description": "Implements vfx.particle-create." },
+      { "type": "UnityCli.VfxParticleInfoTool", "description": "Implements vfx.particle-info." },
+      { "type": "UnityCli.VfxParticleMainTool", "description": "Implements vfx.particle-main." },
+      { "type": "UnityCli.VfxParticleEmissionTool", "description": "Implements vfx.particle-emission." },
+      { "type": "UnityCli.VfxParticleShapeTool", "description": "Implements vfx.particle-shape." },
+      { "type": "UnityCli.VfxParticlePlayTool", "description": "Implements vfx.particle.play." },
+      { "type": "UnityCli.VfxParticleStopTool", "description": "Implements vfx.particle.stop." },
+      { "type": "UnityCli.VfxParticlePauseTool", "description": "Implements vfx.particle.pause." },
+      { "type": "UnityCli.VfxParticleClearTool", "description": "Implements vfx.particle.clear." },
+      { "type": "UnityCli.VfxLineCreateTool", "description": "Implements vfx.line-create." },
+      { "type": "UnityCli.VfxLinePositionsTool", "description": "Implements vfx.line-positions." },
+      { "type": "UnityCli.VfxTrailCreateTool", "description": "Implements vfx.trail.create." },
+      { "type": "UnityCli.VfxTrailSetTool", "description": "Implements vfx.trail.set." }
+    ]
+  },
+  "unityInstall": {
+    "layout": "directory",
+    "include": ["extension.json", "unitypkg/", "docs/"]
+  },
+  "tags": ["vfx", "particles", "effects"]
+}