@myriadcodelabs/uiflow 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MyriadCode
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,190 @@
+# UIFlow
+
+Explicit, code-first UI flow orchestration for React. UIFlow lets you define flows as plain objects with named steps, mix UI and logic steps, and move between them by returning the next step name. It’s useful when you want predictable, testable multi‑step experiences without wiring up routers, wizards, or state machines by hand.
+
+## Why it matters
+
+- **Clarity:** Flows are defined in one place with explicit step names and transitions.
+- **Flexibility:** Combine UI steps and async logic steps in the same flow.
+- **Reusability:** Share cross‑flow state through event channels.
+
+## Quick example
+
+```tsx
+import React from "react";
+import { FlowRunner, defineFlow, createFlowChannel } from "@myriadcodelabs/uiflow";
+
+type StudyData = {
+  deckId: string;
+  cards: CardWithState[];
+  activeCardId: string | null;
+};
+
+type CardWithState = {
+  id: string;
+  question: string;
+  answer: string;
+  flipped: boolean;
+  rating: "easy" | "medium" | "hard" | null;
+};
+
+export type ShowCardOutput =
+    | { action: "flip"; cardId: string }
+    | { action: "rate"; rating: Rating; cardId: string }
+    | { action: "next"; cardId: string };
+
+const studiedCounter = createFlowChannel<number>(0);
+
+
+const studyFlow = defineFlow<StudyData>(
+  {
+    // step 1
+    fetchCards: {
+      input: (data) => ({ deckId: data.deckId }),
+      action: async ({ deckId }, data) => {
+        const cards = await fakeFetchCards(deckId);
+        data.cards = cards.map((card) => ({ ...card, flipped: false, rating: null }));
+        data.activeCardId = null;
+        return { ok: true };
+      },
+      onOutput: () => "decide",
+    },
+
+    // step 2
+    decide: {
+      input: (data) => ({ hasCards: data.cards.length > 0 }),
+      action: ({ hasCards }) => hasCards,
+      onOutput: (_, exists) => (exists ? "study" : "noCard"),
+    },
+    // if no card present
+    noCard: {
+      input: () => ({}),
+      view: NoCardView,
+      onOutput: () => {},
+    },
+    // step 3
+    study: {
+      input: (data) => ({ cards: data.cards }),
+      view: CardView,
+      onOutput: (data, output, events) => {
+        const card = data.cards.find((c) => c.id === output.cardId);
+        if (!card) return "study";
+
+        if (output.action === "flip") {
+          data.activeCardId = card.id;
+          card.flipped = true;
+          return "study";
+        }
+
+        if (output.action === "rate") {
+          data.activeCardId = card.id;
+          card.rating = output.rating ?? null;
+          return "review";
+        }
+
+        if (output.action === "next") {
+          events?.studiedCounter.emit((c) => c + 1);
+          data.activeCardId = null;
+          return "fetchCards";
+        }
+      },
+    },
+
+    // step 4: if user does review
+    review: {
+      input: (data) => ({
+        deckId: data.deckId,
+        cardId: data.activeCardId!,
+        rating: data.cards.find((c) => c.id === data.activeCardId)?.rating!,
+      }),
+      action: async ({ deckId, cardId, rating }) => {
+        await fakeReviewCard(deckId, cardId, rating);
+        return { ok: true };
+      },
+      onOutput: (data, _, events) => {
+        events?.studiedCounter.emit((c) => c + 1);
+        data.activeCardId = null;
+        return "fetchCards";
+      },
+    },
+  },
+  { start: "fetchCards" }
+);
+```
+
+The example components are defined here.
+
+```tsx
+const CardView: React.FC<{
+  input: { cards: CardWithState[] };
+  output: OutputHandle<ShowCardOutput>;
+}> = ({ input, output }) => (
+  <div>
+    {input.cards.map((card) => (
+      <div key={card.id}>
+        <div>{card.question}</div>
+        {card.flipped ? <div>{card.answer}</div> : null}
+        <button onClick={() => output.emit({ cardId: card.id, action: "flip" })}>Show Answer</button>
+        <button onClick={() => output.emit({ cardId: card.id, action: "rate", rating: "easy" })}>Easy</button>
+        <button onClick={() => output.emit({ cardId: card.id, action: "rate", rating: "medium" })}>Medium</button>
+        <button onClick={() => output.emit({ cardId: card.id, action: "rate", rating: "hard" })}>Hard</button>
+        <button onClick={() => output.emit({ cardId: card.id, action: "next" })}>Next</button>
+      </div>
+    ))}
+  </div>
+);
+
+const NoCardView: React.FC<{ input: {}; output: { emit: () => void } }> = () => (
+  <div>No cards available.</div>
+);
+```
+The FlowRunner is used to call the flow and set initial data and channels.
+
+```tsx
+export function App() {
+  return (
+    <FlowRunner
+      flow={studyFlow}
+      initialData={{ deckId: "deck-1", cards: [], activeCardId: null }}
+      eventChannels={{ studiedCounter }}
+    />
+  );
+}
+```
+
+## API Reference (exported only)
+
+### 1) Where the flow is called
+
+#### `FlowRunner` (React component)
+Runs a flow and renders UI steps.
+
+```tsx
+<FlowRunner flow={flow} initialData={initialData} eventChannels={channels} />
+```
+
+- `flow: FlowDefinition<D>` — created by `defineFlow`.
+- `initialData: D` — shared mutable data for this flow instance.
+- `eventChannels?: EventChannels` — optional shared channels; emitting causes re-render.
+
+### 2) Where the flow is defined
+
+#### `defineFlow<D>(steps: FlowSteps<D>, options: DefineFlowOptions): FlowDefinition<D>`
+Creates a flow definition from a steps map and a required `start` step name.
+
+- `DefineFlowOptions.start: string` — name of the first step.
+
+#### `createFlowChannel<T>(initial: T): FlowChannel<T>`
+Creates a shared channel for cross‑flow communication.
+
+- `FlowChannel.get(): T` — read the current value.
+- `FlowChannel.emit(update: T | (prev: T) => T): void` — update value and notify subscribers.
+- `FlowChannel.subscribe(listener: () => void): () => void` — listen for changes.
+
+
+### 3) A UI component
+
+#### `OutputHandle<O>`
+Used by UI steps to emit output back into the flow.
+
+- `OutputHandle.emit(output: O): void`

package/dist/flow.d.ts

@@ -0,0 +1,89 @@
+import React from "react";
+export type Updater<T> = T | ((prev: T) => T);
+export interface FlowChannel<T> {
+    get: () => T;
+    emit: (update: Updater<T>) => void;
+    subscribe: (listener: () => void) => () => void;
+}
+export type EventChannels = Record<string, FlowChannel<any>>;
+export declare function createFlowChannel<T>(initial: T): FlowChannel<T>;
+/**
+ * Shared mutable data for a flow instance.
+ * You can refine this to a generic later, e.g. <D>.
+ */
+export type FlowData = Record<string, any>;
+/**
+ * Output handle given to UI components.
+ * They call output.done(...) when they're finished.
+ */
+export interface OutputHandle<O = any> {
+    emit: (output: O) => void;
+}
+/**
+ * UI step:
+ * - Prepares `input` from `data`
+ * - Renders `view`
+ * - Receives `output` from the component via output.done()
+ * - `onOutput` decides next step and can mutate data
+ */
+export interface UiStep<D extends FlowData = FlowData, I = any, O = any> {
+    input: (data: D, events?: EventChannels) => I;
+    view: React.ComponentType<{
+        input: I;
+        output: OutputHandle<O>;
+    }>;
+    onOutput: (data: D, output: O, events?: EventChannels) => string | void | Promise<string | void>;
+}
+/**
+ * Action (logic) step:
+ * - Prepares `args` from `data`
+ * - Executes `action` (sync/async)
+ * - `onOutput` decides next step and can mutate data
+ * - No UI
+ */
+export interface ActionStep<D extends FlowData = FlowData, I = any, O = any> {
+    input: (data: D, events?: EventChannels) => I;
+    action: (input: I, data: D, events?: EventChannels) => O | Promise<O>;
+    onOutput: (data: D, output: O, events?: EventChannels) => string | void | Promise<string | void>;
+}
+/**
+ * A flow step is either:
+ *  - a UI step (has `view`)
+ *  - an action step (has `action`)
+ * but never both at the same time by convention.
+ */
+export type FlowStep<D extends FlowData = FlowData> = UiStep<D, any, any> | ActionStep<D, any, any>;
+/**
+ * Map of step names -> step definitions.
+ */
+export type FlowSteps<D extends FlowData = FlowData> = Record<string, FlowStep<D>>;
+/**
+ * Flow definition object returned by defineFlow.
+ */
+export interface FlowDefinition<D extends FlowData = FlowData> {
+    steps: FlowSteps<D>;
+    start: string;
+}
+/**
+ * Options when defining a flow.
+ */
+export interface DefineFlowOptions {
+    start: string;
+}
+/**
+ * Main entry point to define a flow.
+ */
+export declare function defineFlow<D extends FlowData = FlowData>(steps: FlowSteps<D>, options: DefineFlowOptions): FlowDefinition<D>;
+export interface FlowRunnerProps<D extends FlowData = FlowData> {
+    flow: FlowDefinition<D>;
+    initialData: D;
+    eventChannels?: EventChannels;
+}
+/**
+ * FlowRunner:
+ * - drives the current step (UI or action)
+ * - manages transitions
+ * - renders UI steps
+ */
+export declare function FlowRunner<D extends FlowData = FlowData>(props: Readonly<FlowRunnerProps<D>>): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=flow.d.ts.map

package/dist/flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.d.ts","sourceRoot":"","sources":["../src/flow.tsx"],"names":[],"mappings":"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"}

package/dist/flow.js

@@ -0,0 +1,149 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/* eslint-disable react/no-unescaped-entities */
+// src/flow.tsx
+import React, { useEffect, useRef, useState } from "react";
+// Factory function to create a channel.
+// IMPORTANT: This lives OUTSIDE React, so multiple FlowRunners can share it.
+export function createFlowChannel(initial) {
+    let value = initial;
+    const listeners = new Set();
+    return {
+        get: () => value,
+        emit: (update) => {
+            value = typeof update === "function" ? update(value) : update;
+            listeners.forEach((l) => l()); // notify all subscribers
+        },
+        subscribe: (listener) => {
+            listeners.add(listener);
+            return () => listeners.delete(listener);
+        },
+    };
+}
+/**
+ * Main entry point to define a flow.
+ */
+export function defineFlow(steps, options) {
+    if (!options.start || !steps[options.start]) {
+        throw new Error(`defineFlow: 'start' must be provided and exist in steps. Got '${options.start}'.`);
+    }
+    return {
+        steps,
+        start: options.start,
+    };
+}
+/**
+ * FlowRunner:
+ * - drives the current step (UI or action)
+ * - manages transitions
+ * - renders UI steps
+ */
+export function FlowRunner(props) {
+    const eventChannelsRef = useRef(undefined);
+    eventChannelsRef.current ?? (eventChannelsRef.current = props.eventChannels);
+    const eventChannels = eventChannelsRef.current;
+    const { flow, initialData } = props;
+    // We keep data and currentStep in state so React re-renders on change.
+    const [state, setState] = useState({
+        currentStep: flow.start,
+        data: { ...initialData },
+    });
+    const [busy, setBusy] = useState(false); // for action steps
+    const isMountedRef = useRef(true);
+    // NEW:
+    // This state is never used directly.
+    // It only exists to force a re-render when event channels change.
+    const [_tick, setTick] = useState(0);
+    // NEW:
+    // Subscribe to every provided channel.
+    // When any channel emits, we trigger a re-render of this FlowRunner.
+    useEffect(() => {
+        if (!eventChannels)
+            return;
+        const unsubs = Object.values(eventChannels).map((ch) => ch.subscribe(() => setTick((x) => x + 1)));
+        return () => unsubs.forEach((u) => u());
+    }, []);
+    const { currentStep, data } = state;
+    const applyTransition = (nextStepName) => {
+        if (!isMountedRef.current)
+            return;
+        if (nextStepName && flow.steps[nextStepName]) {
+            setState((prev) => ({
+                ...prev,
+                currentStep: nextStepName,
+                data: { ...prev.data }, // new reference to trigger React updates (memo-safe)
+            }));
+        }
+        else {
+            // no next step: just re-render with updated data if any
+            setState((prev) => ({
+                ...prev,
+                data: { ...prev.data },
+            }));
+        }
+    };
+    useEffect(() => {
+        return () => {
+            isMountedRef.current = false;
+        };
+    }, []);
+    const step = flow.steps[currentStep];
+    // If the step is an action (no view), run it in an effect.
+    const isActionStep = step.action && !step.view;
+    useEffect(() => {
+        if (!isActionStep)
+            return;
+        const actionStep = step;
+        (async () => {
+            try {
+                setBusy(true);
+                const input = actionStep.input(state.data, eventChannels);
+                const output = await actionStep.action(input, state.data, eventChannels);
+                const next = await actionStep.onOutput(state.data, output, eventChannels);
+                applyTransition(next);
+            }
+            catch (e) {
+                console.error("FlowRunner action step error:", e);
+                // In a real lib, route to a dedicated error step or surface error up
+            }
+            finally {
+                if (isMountedRef.current)
+                    setBusy(false);
+            }
+        })();
+        // We only want to run this when step changes, not on arbitrary data changes.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [currentStep]);
+    if (!step) {
+        // Fails fast if flow is misconfigured.
+        return (_jsxs("div", { children: [_jsx("strong", { children: "FlowRunner error:" }), " Unknown step \"", currentStep, "\"."] }));
+    }
+    // Helper to apply a next step (if returned) and ensure React re-renders
+    // -----------------------
+    // ACTION STEP HANDLING
+    // -----------------------
+    // If it's an action step, show a simple placeholder or nothing.
+    if (isActionStep) {
+        // You can customize this: spinner, skeleton, etc.
+        return _jsx("div", { children: busy ? "Processing..." : null });
+    }
+    // -----------------------
+    // UI STEP HANDLING
+    // -----------------------
+    const uiStep = step;
+    const ViewComponent = uiStep.view;
+    const input = uiStep.input(data, eventChannels);
+    const outputHandle = {
+        emit: async (output) => {
+            try {
+                const next = await uiStep.onOutput(data, output, eventChannels);
+                applyTransition(next);
+            }
+            catch (e) {
+                console.error("FlowRunner UI step onOutput error:", e);
+            }
+        },
+    };
+    return _jsx(ViewComponent, { input: input, output: outputHandle });
+}
+//# sourceMappingURL=flow.js.map

package/dist/flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.js","sourceRoot":"","sources":["../src/flow.tsx"],"names":[],"mappings":"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"}

package/dist/uiflow.d.ts

@@ -0,0 +1,2 @@
+export * from "./flow";
+//# sourceMappingURL=uiflow.d.ts.map

package/dist/uiflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uiflow.d.ts","sourceRoot":"","sources":["../src/uiflow.tsx"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC"}

package/dist/uiflow.js

@@ -0,0 +1,2 @@
+export * from "./flow";
+//# sourceMappingURL=uiflow.js.map

package/dist/uiflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uiflow.js","sourceRoot":"","sources":["../src/uiflow.tsx"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@myriadcodelabs/uiflow",
+  "version": "0.1.0",
+  "description": "Explicit, code-first UI flow orchestration for React.",
+  "keywords": [],
+  "author": "Muhammad Ismail Khan",
+  "license": "MIT",
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.10",
+    "typescript": "^5.9.3"
+  },
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/uiflow.js",
+  "types": "./dist/uiflow.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/uiflow.d.ts",
+      "default": "./dist/uiflow.js"
+    }
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "clean": "rimraf dist",
+    "build": "pnpm run clean && tsc"
+  }
+}