@you-agent-factory/factory-visualizers 0.0.2 → 0.0.6

package/README.md

@@ -1,7 +1,7 @@
 # `@you-agent-factory/factory-visualizers`
 
-Controlled React components for rendering caller-prepared Factory replay
-projections. The package exports `FactoryTopologyReplay`,
+Controlled React components for rendering a caller-prepared `FactoryGraphSource`
+through the original Factory semantic graph. The package exports `FactoryTopologyReplay`,
 `FactoryRecordingTopologyReplay`, `FactoryTimelineScrubber`, and
 `WorkProgressVisualizer`, and `FactoryEmulatorControls` together with their
 message, formatting, status, callback, and structured error contracts.
@@ -10,11 +10,9 @@ See the [public package family guide](https://github.com/portpowered/you-agent-f
 for clean-install commands, static and interactive package examples, dependency
 direction, and the precise hosted-runtime versus emulator support boundary.
 
-`FactoryTopologyReplay` accepts a presentation-only `chrome` configuration.
-Choose the `full`, `minimal`, or `none` preset, then override `legend`,
-`background`, `viewportControls`, or `visibilityControls` individually. The
-resolver starts from the selected preset and applies supplied overrides without
-changing the caller-provided topology, activity, or Work-progress projection.
+`FactoryTopologyReplay` has one ready input: a `FactoryGraphSource` containing
+the complete Factory, its authored layout, and one selected-tick runtime
+projection. It deliberately has no topology-only rendering fallback.
 
 `FactoryEmulatorControls` composes the lower-level controlled playback toolbar
 with `FactoryTimelineScrubber`. Hosts provide the current/history selection and
@@ -40,11 +38,11 @@ local failure message. A failure may include `recoveryAction` with a host-owned
 callback; the visualizers render that action but never assume a retry,
 transport, timer, or global error-state implementation.
 
-The host always owns transport, persistence, and canonical Factory data. It can
-either prepare controlled projections with `@you-agent-factory/factory-replay`
-or pass an unknown recording directly to `FactoryRecordingTopologyReplay`,
-which validates it through `@you-agent-factory/client` before deriving the
-selected-tick projections. Import the package styles once:
+The host always owns transport, persistence, and canonical Factory data. It
+prepares selected-tick runtime data with `@you-agent-factory/factory-replay`
+and passes it with the complete Factory through `@you-agent-factory/factory-graph`.
+`FactoryRecordingTopologyReplay` validates an unknown recording and renders it
+only when the recording includes that complete Factory. Import the package styles once:
 
 ```tsx
 import {
@@ -93,9 +91,9 @@ keeps fixed history stable as later evidence arrives, and can return to current
 mode with its follow-latest action. Current mode also incorporates newly
 accepted same-tick events in canonical sequence order.
 
-The installed-consumer verification uses the public client parser and public
-replay projection functions before passing the prepared topology to
-`FactoryTopologyReplay`. It imports the client recording fixture and both
+The installed-consumer verification uses the public client parser, replay
+projection functions, and Factory graph source before passing the canonical
+graph to `FactoryTopologyReplay`. It imports the client recording fixture and both
 package style entry points only through public package exports.
 
 Run `make storybook` in this directory for package-local development. Use

package/dist/factory-emulator-controls.d.ts

@@ -1,4 +1,4 @@
-import { type FactoryEmulatorControlsProps as PlaybackControlsProps } from "@you-agent-factory/components";
+import { type FactoryEmulatorControlsProps as PlaybackControlsProps } from "@you-agent-factory/components/factory-emulator";
 import type { HTMLAttributes } from "react";
 import { type FactoryEmulatorFailure } from "./factory-emulator-error-boundary";
 import { type FactoryTimelineScrubberMessages, type FactoryTimelineScrubberState } from "./factory-timeline-scrubber";
@@ -23,4 +23,4 @@ export interface FactoryEmulatorControlsTimeline {
     state: FactoryTimelineScrubberState;
 }
 /** Controlled controls that make the distinction between current and historical replay explicit. */
-export declare function FactoryEmulatorControls({ className, failure, formatTick, onFollowLatest, onError, onPause, onPlay, onRestart, onSelectTick, onStep, showPlaybackControls, showTimelineScrubber, timeline, ...playbackProps }: FactoryEmulatorControlsProps): import("react").JSX.Element;
+export declare function FactoryEmulatorControls({ className, failure, formatTick, onFollowLatest, onError, onPause, onPlay, onRestart, onSelectTick, onStep, showPlaybackControls, showTimelineScrubber, timeline, ...playbackProps }: FactoryEmulatorControlsProps): import("react/jsx-runtime").JSX.Element;

package/dist/factory-emulator-error-boundary.d.ts

@@ -21,6 +21,6 @@ export declare class FactoryEmulatorErrorBoundary extends Component<FactoryEmula
     state: FactoryEmulatorErrorBoundaryState;
     static getDerivedStateFromError(): FactoryEmulatorErrorBoundaryState;
     componentDidCatch(error: unknown, _errorInfo: ErrorInfo): void;
-    render(): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react").JSX.Element | null | undefined;
+    render(): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react/jsx-runtime").JSX.Element | null | undefined;
 }
 export {};

package/dist/factory-emulator-view.d.ts

@@ -24,4 +24,4 @@ export interface FactoryEmulatorViewProps extends Omit<HTMLAttributes<HTMLElemen
     workProgress: WorkProgressVisualizerProps;
 }
 /** A controlled Factory emulator layout. Presets select regions; hosts retain all state and behavior. */
-export declare function FactoryEmulatorView({ className, controls, failure, onError, preset, submission, topology, visibility, workProgress, ...sectionProps }: FactoryEmulatorViewProps): import("react").JSX.Element;
+export declare function FactoryEmulatorView({ className, controls, failure, onError, preset, submission, topology, visibility, workProgress, ...sectionProps }: FactoryEmulatorViewProps): import("react/jsx-runtime").JSX.Element;

package/dist/factory-recording-topology-replay.d.ts

@@ -15,7 +15,7 @@ export interface FactoryRecordingValidationDiagnostic {
     message: string;
     recoverable: false;
 }
-export type FactoryRecordingTopologyReplayError = FactoryRecordingValidationDiagnostic | FactoryVisualizerError | import("./visualizer-error").FactoryVisualizationLayoutDiagnostic;
+export type FactoryRecordingTopologyReplayError = FactoryRecordingValidationDiagnostic | FactoryVisualizerError;
 export interface FactoryRecordingTopologyReplayMessages {
     progress: WorkProgressVisualizerMessages;
     regionLabel: string;
@@ -27,8 +27,6 @@ export interface FactoryRecordingTopologyReplayMessages {
 export interface FactoryRecordingTopologyReplayProps {
     defaultSelectedTick?: number;
     formatNumber: (value: number) => string;
-    /** Presentation-only content validated by the controlled topology renderer. */
-    layout?: unknown;
     messages: FactoryRecordingTopologyReplayMessages;
     onError?: (error: FactoryRecordingTopologyReplayError) => void;
     onSelectNode?: (node: FactoryTopologyNode) => void;
@@ -58,6 +56,6 @@ export interface RecordingProjectionCache {
 export declare const MAX_CACHED_RECORDING_PROJECTIONS = 32;
 export declare function createRecordingProjectionCache(): RecordingProjectionCache;
 /** Validate and replay one caller-owned recording through the controlled visualizers. */
-export declare function FactoryRecordingTopologyReplay({ defaultSelectedTick, formatNumber, layout, messages, onError, onSelectNode, recording, selectedNodeId, state, }: FactoryRecordingTopologyReplayProps): import("react").JSX.Element;
+export declare function FactoryRecordingTopologyReplay({ defaultSelectedTick, formatNumber, messages, onError, onSelectNode, recording, selectedNodeId, state, }: FactoryRecordingTopologyReplayProps): import("react/jsx-runtime").JSX.Element;
 export declare function projectRecordingAtTick(events: FactoryRecording["events"], tick: number, cache: RecordingProjectionCache): RecordingProjection;
 export {};

package/dist/factory-timeline-scrubber.d.ts

@@ -29,4 +29,4 @@ export interface FactoryTimelineScrubberProps extends Omit<HTMLAttributes<HTMLEl
     onSelectTick: (tick: number) => void;
     state: FactoryTimelineScrubberState;
 }
-export declare function FactoryTimelineScrubber({ className, disabled, formatTick, messages, onFollowLatest, onSelectTick, state, ...sectionProps }: FactoryTimelineScrubberProps): import("react").JSX.Element;
+export declare function FactoryTimelineScrubber({ className, disabled, formatTick, messages, onFollowLatest, onSelectTick, state, ...sectionProps }: FactoryTimelineScrubberProps): import("react/jsx-runtime").JSX.Element;

package/dist/factory-topology-replay.d.ts

@@ -1,13 +1,10 @@
-import type { FactoryActivityProjection, FactoryLoadProjection, FactoryTopologyNode, FactoryTopologyProjection } from "@you-agent-factory/factory-replay";
-import { type FactoryTopologyChromeConfiguration } from "./factory-topology-chrome";
-export type { FactoryTopologyFlowProjection } from "./factory-topology-flow-projection";
-export { projectFactoryTopologyFlow } from "./factory-topology-flow-projection";
+import { type FactoryGraphSource } from "@you-agent-factory/factory-graph";
+import type { FactoryTopologyNode } from "@you-agent-factory/factory-replay";
 import type { FactoryTopologyReplayError } from "./visualizer-error";
-export interface FactoryTopologyReplayProjection {
-    activity: FactoryActivityProjection;
-    load: FactoryLoadProjection;
-    topology: FactoryTopologyProjection;
-}
+/**
+ * Controlled state for the canonical Factory graph. A ready graph always has
+ * the complete Factory definition and the selected-tick runtime projection.
+ */
 export type FactoryTopologyReplayState = {
     status: "empty";
 } | {
@@ -15,12 +12,11 @@ export type FactoryTopologyReplayState = {
 } | {
     status: "loading";
 } | {
-    projection: FactoryTopologyReplayProjection;
+    source: FactoryGraphSource;
     status: "ready";
 };
 export interface FactoryTopologyReplayMessages {
     activeDispatches: (count: number) => string;
-    /** Optional fields retain compatibility for existing controlled consumers. */
     activeWorkDuration?: (durationTicks: number) => string;
     activeWorkOverflow?: (count: number) => string;
     activeWorkRegionLabel?: string;
@@ -31,7 +27,6 @@ export interface FactoryTopologyReplayMessages {
     inactiveDispatches: string;
     imageFailed: string;
     imageLoading: string;
-    /** Optional labels retain compatibility for existing controlled consumers. */
     legendActiveRoute?: string;
     legendInactiveRoute?: string;
     legendLabel?: string;
@@ -47,10 +42,6 @@ export interface FactoryTopologyReplayMessages {
     workStateCountUnavailable: string;
 }
 export interface FactoryTopologyReplayProps {
-    /** Presentation-only optional chrome; it never changes the prepared projection. */
-    chrome?: FactoryTopologyChromeConfiguration;
-    /** Presentation-only input validated against the prepared canonical topology. */
-    layout?: unknown;
     messages: FactoryTopologyReplayMessages;
     onError?: (error: FactoryTopologyReplayError) => void;
     onRetry?: () => void;
@@ -58,4 +49,9 @@ export interface FactoryTopologyReplayProps {
     selectedNodeId?: string;
     state: FactoryTopologyReplayState;
 }
-export declare function FactoryTopologyReplay(props: FactoryTopologyReplayProps): import("react").JSX.Element;
+/**
+ * Public read-only Factory graph. Rendering is delegated to the same semantic
+ * renderer registry used by the embedded Factory graph; there is no
+ * topology-only renderer or visual fallback.
+ */
+export declare function FactoryTopologyReplay(props: FactoryTopologyReplayProps): import("react/jsx-runtime").JSX.Element;

package/dist/factory-topology-state.d.ts

@@ -1,11 +1,11 @@
 import { Component, type ErrorInfo, type ReactNode } from "react";
-import type { FactoryTopologyReplayMessages, FactoryTopologyReplayProps } from "./factory-topology-replay";
-import { type FactoryTopologyReplayError, type FactoryVisualizerError, type FactoryVisualizerErrorKind } from "./visualizer-error";
+import type { FactoryTopologyReplayMessages } from "./factory-topology-replay";
+import { type FactoryVisualizerError, type FactoryVisualizerErrorKind } from "./visualizer-error";
 export declare function FactoryTopologyStateRegion({ messages, onRetry, state, }: {
     messages: FactoryTopologyReplayMessages;
     onRetry?: () => void;
     state: "empty" | "failed" | "loading";
-}): import("react").JSX.Element;
+}): import("react/jsx-runtime").JSX.Element;
 interface FactoryTopologyErrorBoundaryProps {
     children: ReactNode;
     errorKind: Extract<FactoryVisualizerErrorKind, "react-flow" | "render">;
@@ -24,8 +24,7 @@ export declare class FactoryTopologyErrorBoundary extends Component<FactoryTopol
     static getDerivedStateFromError(): FactoryTopologyErrorBoundaryState;
     componentDidCatch(error: unknown, _errorInfo: ErrorInfo): void;
     componentDidUpdate(previousProps: FactoryTopologyErrorBoundaryProps): void;
-    render(): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react").JSX.Element | null | undefined;
+    render(): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react/jsx-runtime").JSX.Element | null | undefined;
     private report;
 }
-export declare function useDistinctTopologyErrorReport(error: FactoryTopologyReplayError | undefined, onError: FactoryTopologyReplayProps["onError"]): void;
 export {};

package/dist/index.d.ts

@@ -3,7 +3,6 @@ export type { FactoryEmulatorFailure } from "./factory-emulator-error-boundary.j
 export { FactoryEmulatorView, type FactoryEmulatorViewPreset, type FactoryEmulatorViewProps, type FactoryEmulatorViewVisibility, } from "./factory-emulator-view.js";
 export { FactoryRecordingTopologyReplay, type FactoryRecordingTopologyReplayError, type FactoryRecordingTopologyReplayMessages, type FactoryRecordingTopologyReplayProps, type FactoryRecordingTopologyReplayState, type FactoryRecordingValidationDiagnostic, type FactoryRecordingValidationDiagnosticIssue, } from "./factory-recording-topology-replay.js";
 export { type FactoryTimelineMode, FactoryTimelineScrubber, type FactoryTimelineScrubberMessages, type FactoryTimelineScrubberProps, type FactoryTimelineScrubberState, } from "./factory-timeline-scrubber.js";
-export { DEFAULT_FACTORY_TOPOLOGY_CHROME_PRESET, type FactoryTopologyChromeConfiguration, type FactoryTopologyChromePreset, type FactoryTopologyChromeRegion, type ResolvedFactoryTopologyChrome, resolveFactoryTopologyChrome, } from "./factory-topology-chrome.js";
-export { type FactoryTopologyFlowProjection, FactoryTopologyReplay, type FactoryTopologyReplayMessages, type FactoryTopologyReplayProjection, type FactoryTopologyReplayProps, type FactoryTopologyReplayState, projectFactoryTopologyFlow, } from "./factory-topology-replay.js";
-export type { FactoryTopologyReplayError, FactoryVisualizationLayoutDiagnostic, FactoryVisualizerError, FactoryVisualizerErrorCause, FactoryVisualizerErrorKind, } from "./visualizer-error.js";
+export { FactoryTopologyReplay, type FactoryTopologyReplayMessages, type FactoryTopologyReplayProps, type FactoryTopologyReplayState, } from "./factory-topology-replay.js";
+export type { FactoryTopologyReplayError, FactoryVisualizerError, FactoryVisualizerErrorCause, FactoryVisualizerErrorKind, } from "./visualizer-error.js";
 export { type WorkProgressCategoryMessage, WorkProgressVisualizer, type WorkProgressVisualizerMessages, type WorkProgressVisualizerProps, } from "./work-progress-visualizer.js";