feat(react, plugin-history-sync, link): unsafe api for register activity dynamically

[tonyfromundefined]

Description

Exposes an unsafe api (react context) for dynamically registering activities. You can use it as follows

import { UNSAFE_ActivityComponentMapContext, UNSAFE_CoreActionsContext } from "@stackflow/react/future";

function NewActivity() {
  // ...
}

function MyComponent() {
  const { push } = useFlow()
  const { dispatchEvent } = useContext(UNSAFE_CoreActionsContext);
  const { setActivityComponentMap } = useContext(UNSAFE_ActivityComponentMapContext);

  const onSomethingHappened = () => {
    const activityName = crypto.randomUUID();

    dispatchEvent("ActivityRegistered", {
      activityName,
    });
    setActivityComponentMap({
      activityName,
      Component: NewActivity,
    });

    push(activityName as string, {});
  }

  // ...
}

or you can create your own custom push()

function useDynamicFlow() {
  const { push } = useFlow()
  const { dispatchEvent } = useContext(UNSAFE_CoreActionsContext);
  const { setActivityComponentMap } = useContext(UNSAFE_ActivityComponentMapContext);

  return {
    push(Component: ActivityComponentType<any>) {
      const activityName = crypto.randomUUID();

      dispatchEvent("ActivityRegistered", {
        activityName,
      });
      setActivityComponentMap({
        activityName,
        Component,
      });

      push(activityName as string, {});
    },
  };
}

function NewActivity() {
  // ...
}

function MyComponent() {
  const { push } = useDynamicFlow();

  const onClick = () => {
    push(NewActivity);
  }

  // ...
}

[changeset-bot]

🦋 Changeset detected

Latest commit: 419779a

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 3 packages

Name	Type
@stackflow/plugin-history-sync	Minor
@stackflow/react	Minor
@stackflow/link	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Updated (UTC)
stackflow-docs	✅ Ready (Inspect)	Visit Preview	Jan 20, 2025 0:08am

[pkg-pr-new]

Open in Stackblitz • @stackflow/demo

yarn add https://pkg.pr.new/@stackflow/[email protected]

yarn add https://pkg.pr.new/@stackflow/[email protected]

yarn add https://pkg.pr.new/@stackflow/[email protected]

commit: 419779a