Feat/reactive data editor by tmaneri · Pull Request #5667 · streamlabs/desktop

tmaneri · 2025-11-25T18:21:50Z

No description provided.

avacreeth

Just a few high level comments. I'm going to get someone on the desktop team to take a closer look also.

avacreeth · 2025-12-02T20:26:31Z

app/services/user-state/index.ts

+const sleep = (ms: number) => new Promise(resolve => setTimeout(resolve, ms));
+
+@InitAfter('UserService')
+export class UserStateService extends StatefulService<UserStateServiceState> {


This feels like a super generic name for a service. Does this have applications outside of vision? If not, it might be good to pick something a bit more specific.

So this is actually the "old" way to do a stateful service in desktop. We switched to realm for managing state in new services. I can help you get that set up.

agreed that this is a super generic name for what seems like a pretty specific service

I agree, the naming is not great here. It does/will have applications outside of vision so I didn't want to lock it in to "vision", since this will help manage all of the user's little data bits that you might see from stream labels, or game data like health, etc.

Igor is working on adding more than just the vision data here, and once it's ready we'll expand this out.

I have some places I'm calling things "user state" and other's where it's "reactive data" -- I would like to narrow it down to one.

Please let me know if you have any good ideas for the naming.

maybe something like DynamicDataService? just spitballing but if you need a sufficiently vague name that doesn't have namespace collisions (like this one has with UserService and UserAuthService) something like that could work

avacreeth · 2025-12-02T20:28:52Z

app/components-react/editor/elements/SourceSelector.tsx

              sourceProperties={() => this.sourceProperties(sceneNode.id)}
+              onEditReactiveData={
+                sceneNode.sourceId &&
+                this.sourcesService.state.sources[sceneNode.sourceId]?.propertiesManagerType ===


FYI, this is a non-reactive way to access this state in a React component. I think it's fine because properties manager almost never changes, but FYI.

Good call, I will make some changes to make it reactive

avacreeth · 2025-12-02T20:36:37Z

app/components-react/windows/reactive-data-editor/ReactiveDataEditorWindow.tsx

+    WindowsService.actions.closeChildWindow();
+  }
+
+  const [stateFlat, setStateFlat] = useState(UserStateService.state.stateFlat);


This is a somewhat unusual thing to do in react because you're not copying the object, you're just adding a reference to the original object in state. If the goal here was to be working off a local copy unique to this component then you would want to copy it when initializing the state. It's not a huge deal since you're not directly mutating the object, just an FYI.

Good catch 👍 I'll update to make a shallow copy since it's just a simple key-value structure

michelinewu · 2025-12-02T20:45:59Z

package.json

  "author": "General Workings, Inc.",
  "license": "GPL-3.0",
-  "version": "1.19.6",
+  "version": "1.19.6-tom",


Not sure if we want to update the version here?

gettinToasty · 2025-12-02T21:16:31Z

app/components-react/editor/elements/SourceSelector.tsx

+                  ? (sourceId => () =>
+                      this.sourcesService.actions.showReactiveDataEditorWindow(sourceId))(
+                      sceneNode.sourceId,
+                    )


this is kinda a nitpick but idk why you're bothering with all this function currying and invoking instead of just

() => this.sourcesService.actions.showReactiveDataEditorWindow(sceneNode.sourceId)

I think I did this due to sceneNode.sourceId (ISourceMetadata.sourceId?: string | undefined) potentially being undefined when onEditReactiveData() is called at a future point in time. I put this closure in to ensure it's by value and not reference

I can go your route, I would just need assert the type:

() => this.sourcesService.actions.showReactiveDataEditorWindow(sceneNode.sourceId as string)

Do you like that better? I could also do the checking this way:

() => sceneNode.sourceId && this.sourcesService.actions.showReactiveDataEditorWindow(sceneNode.sourceId)

Let me know which approach you like best 👍

the second one would work or you could also just add a guard clause in showReactiveDataEditorWindow which would also make it compliant with strict nulls, as far as i can tell the first one still wouldn't be TS kosher as is since folders for example never have a source id

That's actually perfect, I'll make it allow undefined, since later I was planning to make this ReactiveData window not need to be filtered for a source.

gettinToasty · 2025-12-02T21:17:47Z

app/components-react/editor/elements/SourceSelector.tsx

+              style={{ opacity: 0.7 }}
+            />
+          </Tooltip>
+        )}


just FYI we put all the optional actions at the top so it doesn't shift alignment for items that always show up

but also... this menu is starting to get extremely crowded

Sounds good, I will move it up with the others. I originally placed it here for the display order.

I agree, this menu is getting a bit wild 🤠

gettinToasty · 2025-12-02T21:19:53Z

app/components-react/windows/reactive-data-editor/ReactiveDataEditor.tsx

+  textWhite90: 'rgba(255, 255, 255, 0.9)',
+  textWhite60: 'rgba(255, 255, 255, 0.6)',
+  textWhite40: 'rgba(255, 255, 255, 0.4)',
+  textWhite20: 'rgba(255, 255, 255, 0.2)',


we shouldn't be using hard coded colors here, it wont match when users shift UI color schemes

there are var colors located in themes.g.less that should be preferred over this

gettinToasty · 2025-12-02T21:21:35Z

app/components-react/windows/reactive-data-editor/ReactiveDataEditor.tsx

+                    width: '200px',
+                  }}
+                >
+                  <input


should probably be using the NumberInput component here, makes things a lot easier

gettinToasty · 2025-12-02T21:22:04Z

app/components-react/windows/reactive-data-editor/ReactiveDataEditor.tsx

+                  borderTop: index === 0 ? 'none' : `1px solid ${colors.borderWhite5}`,
+                  alignItems: 'center',
+                  justifyContent: 'space-between',
+                }}


all of these styles should probably be extracted into a css module

gettinToasty · 2025-12-02T21:49:25Z

app/services/vision/index.ts


+//
+//
+


unused comment

gettinToasty · 2025-12-02T21:50:17Z

app/util/dot-tree.ts

  return tree;
 }
+
+export type Prettify<T> = { [K in keyof T]: T[K] } & {};


what is this type lol

it's just a handy utility type that I use on occasion, for more complicated types. Not needed, but makes DX a bit better imo. There's a bunch more online about it, but a couple references:

https://timdeschryver.dev/bits/pretty-typescript-types
https://www.totaltypescript.com/concepts/the-prettify-helper

It's handy for cases like:

const dotNotation = toDotNotation(
{ a: { b: { c: 1 } } },
(v): v is number => typeof v === 'number',
);

If you use that Prettify utility type, you get something like this

const dotNotation: { "a.b.c": number; }

And if you don't, you get:

const dotNotation: DotMap<{ a: { b: { c: number; }; }; }, number>

got it, i might be misunderstanding but i think i was thrown because it kind of seems to be a tautilogical type that defeats the purpose of TS? like for type T its enforcing that keys of K return the value of T[K] which would never not be the case? i think maybe something that asserts some sort of typechecking would be more useful, like maybe something like this could work?

for expected string keys
type NestedDictionary<T> = Dictionary<NestedDictionary<T>>

or for something like enum keys
type NestedRecord<K, T> = Record<K, NestedRecord<K, T>>

for whatever solution we end up with i would however recommend that a very general use-case utility type like this should be moved to index.d.ts, types of which can be used anywhere without needing to import/export

gettinToasty · 2025-12-02T21:55:06Z

app/services/user-state/index.ts

+  UserService,
+  WebsocketService,
+} from 'app-services';
+import { toDotNotation } from 'components-react/windows/reactive-data-editor/lib/dot-tree';


this is a wild import for something that can just be grabbed from util/dot-tree

very wild 🤠

I'll work on merging these two files together into one under util/dot-tree

app/util/menus/EditMenu.ts

gettinToasty · 2025-12-02T21:57:05Z

package.json

  "author": "General Workings, Inc.",
  "license": "GPL-3.0",
-  "version": "1.19.6",
+  "version": "1.19.6-tom",


we'll need to remove this before shipping

tmaneri

I'll get through the rest of these tomorrow 👍

tmaneri · 2025-12-03T00:21:42Z

app/components-react/editor/elements/SourceSelector.tsx

              sourceProperties={() => this.sourceProperties(sceneNode.id)}
+              onEditReactiveData={
+                sceneNode.sourceId &&
+                this.sourcesService.state.sources[sceneNode.sourceId]?.propertiesManagerType ===


Good call, I will make some changes to make it reactive

tmaneri · 2025-12-03T00:25:34Z

app/components-react/editor/elements/SourceSelector.tsx

+              style={{ opacity: 0.7 }}
+            />
+          </Tooltip>
+        )}


Sounds good, I will move it up with the others. I originally placed it here for the display order.

I agree, this menu is getting a bit wild 🤠

app/components-react/windows/reactive-data-editor/ReactiveDataEditorWindow.tsx

tmaneri · 2025-12-03T00:34:23Z

app/components-react/windows/reactive-data-editor/ReactiveDataEditorWindow.tsx

+    WindowsService.actions.closeChildWindow();
+  }
+
+  const [stateFlat, setStateFlat] = useState(UserStateService.state.stateFlat);


Good catch 👍 I'll update to make a shallow copy since it's just a simple key-value structure

tmaneri · 2025-12-03T00:44:59Z

app/components-react/windows/reactive-data-editor/ReactiveDataEditorWindow.tsx

+  if (!schemaFlat || !stateFlat) {
+    return (
+      <ModalLayout bodyStyle={{ padding: '20px' }} hideFooter={true}>
+        {!schemaFlat ? <div>Waiting for schema...</div> : <div>Waiting for state...</div>}


I'll wrap in $t. State is async, it starts out as undefined until it's fetched from the API.

Schema is... supposed to be coming from the API and not from this PoC file lib/schema so thank you for bringing it up. I'll update it 👍

tmaneri · 2025-12-03T00:52:39Z

app/components-react/windows/reactive-data-editor/types.ts

@@ -0,0 +1,3 @@
+export type ReactiveDataEditorProps = {
+  stateKeysOfInterest: string[];


Sounds good, I'll move it to ReactiveDataEditorWindow.tsx

tmaneri · 2025-12-03T00:54:05Z

app/services/sources/properties-managers/smart-browser-source-manager.ts

+ * This enforces a consistent hostname across all reactive browser sources,
+ * enabling centralized testing and deployment of new reactive overlay features.
+ */
+const REACTIVE_SOURCES_ORIGIN = 'https://alpha-sl-dynamic-overlays-demo.streamlabs.workers.dev';


Yeah, when this goes live I'll need to update this to the live URL. I just made this a draft PR for that reason.

Is there a better approach for this kind of thing? The TL;DR is that I want this origin to be one way for testing the next version of the rive wrapper I made, and another way when we go live or want to test the live rive wrapper.

tmaneri · 2025-12-03T00:55:08Z

app/services/user-state/index.ts

+  UserService,
+  WebsocketService,
+} from 'app-services';
+import { toDotNotation } from 'components-react/windows/reactive-data-editor/lib/dot-tree';


very wild 🤠

I'll work on merging these two files together into one under util/dot-tree

tmaneri · 2025-12-03T00:57:53Z

app/services/user-state/index.ts

+const sleep = (ms: number) => new Promise(resolve => setTimeout(resolve, ms));
+
+@InitAfter('UserService')
+export class UserStateService extends StatefulService<UserStateServiceState> {


I agree, the naming is not great here. It does/will have applications outside of vision so I didn't want to lock it in to "vision", since this will help manage all of the user's little data bits that you might see from stream labels, or game data like health, etc.

Igor is working on adding more than just the vision data here, and once it's ready we'll expand this out.

I have some places I'm calling things "user state" and other's where it's "reactive data" -- I would like to narrow it down to one.

Please let me know if you have any good ideas for the naming.

tmaneri · 2025-12-03T01:01:39Z

app/services/reactive-data/index.ts

+    // subscribe to websocket events to keep state updated
+    this.socketSub = this.websocketService.socketEvent.subscribe(e => {
+      if (['visionEvent', 'userStateUpdated'].includes(e.type)) {
+        this.log(e);


This is to help debug any issues with the new reactive sources. We utilize websocketService.socketEvent.subscribe in some other places, this was placed to write things out to the user's log file if there is an issue with a reactive source not updating.

…ry new ideas after this commit

michelinewu · 2026-01-12T17:44:15Z

/Azurepipelines run

azure-pipelines · 2026-01-12T17:44:26Z

Azure Pipelines successfully started running 1 pipeline(s).

…tive-data-editor

tmaneri added 6 commits November 3, 2025 15:12

initial work on reactive data editor

d588892

few tweaks for race conditions

89bcef7

merged with master

263294f

fixing number inputs to be a bit more helpful with 0s

e1bb63c

commenting, a bit of extra cleanup

dee4fd1

moving some constants around

eb8ad8f

avacreeth reviewed Dec 2, 2025

View reviewed changes

michelinewu approved these changes Dec 2, 2025

View reviewed changes

gettinToasty requested changes Dec 2, 2025

View reviewed changes

tmaneri commented Dec 3, 2025

View reviewed changes

tmaneri added 13 commits December 3, 2025 10:06

consolidate dot-tree, add reactivity, remove small types file

cdaf0d6

rename some types, use .actions

caaa2e7

renaming UserState to ReactiveData

526198a

moving type back to it's own file, circular reference issue

ffa4869

adding type file back in

1931882

not the ideal Realm solution, but it works for the time being. will t…

2b94308

…ry new ideas after this commit

add some json caching, improve typing

3e5e078

improving some typings

44271ab

updating reactive source base url handling

3ff2bda

remove source list quick button

33eca82

removing tom stylings to try to use the built-ins

8d7144e

removing custom version

8353204

moving styles out, moving utility type out

f59e38a

Merge branch 'master' of github.com:streamlabs/desktop into feat/reac…

02c6afa

…tive-data-editor

		@@ -0,0 +1,3 @@
		export type ReactiveDataEditorProps = {
		stateKeysOfInterest: string[];

Conversation

tmaneri commented Nov 25, 2025

Uh oh!

avacreeth left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

tmaneri Dec 3, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

tmaneri left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

tmaneri Dec 3, 2025 •

edited

Loading