Project

ChartForgeX

Render deterministic charts, dashboards, topology, hierarchy, and report visuals directly from .NET.

Stars 47
Forks 2
NuGet downloads 75,067
Release ChartForgeX-v2.0.0
Language: HTML Updated: 2026-10-12

API Reference

Class

StoryReplay

Namespace ChartForgeX.Stories
Assembly ChartForgeX.Stories
Modifiers sealed

Bounded, resolved terminal events supplied by a capture host or an author.

Inheritance

  • Object
  • StoryReplay

Remarks

Commands are submitted observations rather than simulated keystrokes. ANSI controls are stripped; hosts resolve screen operations into explicit events.

Usage

Explore 14 API references to this type

This type appears in these public API surfaces even when no hand-authored example is attached directly to the page.

Accepted by parameters 1

Methods

public StoryReplay ChangeDirectory(TimeSpan at, String directory) #
Returns: StoryReplay

Changes the active tab's prompt directory.

Parameters

at System.TimeSpan requiredposition: 0
directory System.String requiredposition: 1
public StoryReplay Clear(TimeSpan at) #
Returns: StoryReplay

Clears displayed lines in the active tab without discarding recorded transcript events.

Parameters

at System.TimeSpan requiredposition: 0
public StoryReplay Command(TimeSpan at, String command) #
Returns: StoryReplay

Adds a submitted command at its recorded timestamp.

Parameters

at System.TimeSpan requiredposition: 0
command System.String requiredposition: 1
public StoryReplay CompressPauses(TimeSpan maximumGap) #
Returns: StoryReplay

Returns a detached presentation with every idle gap, including leading and trailing gaps, capped explicitly.

Parameters

maximumGap System.TimeSpan requiredposition: 0
public static StoryReplay Create(TimeSpan duration, TerminalDialect dialect = PowerShell, String workingDirectory = ".", String title = "PowerShell", String? customPrompt = null) #
Returns: StoryReplay

Creates a recording with an explicit endpoint and initial session.

Parameters

duration System.TimeSpan requiredposition: 0
dialect ChartForgeX.Terminal.TerminalDialect = PowerShell optionalposition: 1
workingDirectory System.String = "." optionalposition: 2
title System.String = "PowerShell" optionalposition: 3
customPrompt System.String? = null optionalposition: 4
public StoryReplay Explain(TimeSpan at, String label) #
Returns: StoryReplay

Returns a detached replay with an explanation inserted on the presentation clock, without inventing a recorded timestamp.

Parameters

at System.TimeSpan requiredposition: 0
label System.String requiredposition: 1
public StoryReplay Marker(TimeSpan at, String label) #
Returns: StoryReplay

Adds an explanation or chapter marker at a recorded timestamp.

Parameters

at System.TimeSpan requiredposition: 0
label System.String requiredposition: 1
public StoryReplay OpenTab(TimeSpan at, String id, String title, TerminalDialect dialect = PowerShell, String workingDirectory = ".", String? customPrompt = null) #
Returns: StoryReplay

Opens and activates a persistent session.

Parameters

at System.TimeSpan requiredposition: 0
id System.String requiredposition: 1
title System.String requiredposition: 2
dialect ChartForgeX.Terminal.TerminalDialect = PowerShell optionalposition: 3
workingDirectory System.String = "." optionalposition: 4
customPrompt System.String? = null optionalposition: 5
public StoryReplay Output(TimeSpan at, String text, TerminalTextTone tone = Default) #
Returns: StoryReplay

Adds completed, newline-separated output. Use ReplaceLine for a carriage-return update.

Parameters

at System.TimeSpan requiredposition: 0
text System.String requiredposition: 1
tone ChartForgeX.Terminal.TerminalTextTone = Default optionalposition: 2
public StoryReplay ReplaceLine(TimeSpan at, String text, TerminalTextTone tone = Default) #
Returns: StoryReplay

Replaces the active tab's last line with resolved progress text.

Parameters

at System.TimeSpan requiredposition: 0
text System.String requiredposition: 1
tone ChartForgeX.Terminal.TerminalTextTone = Default optionalposition: 2
public StoryReplay SelectTab(TimeSpan at, String id) #
Returns: StoryReplay

Activates a previously opened session.

Parameters

at System.TimeSpan requiredposition: 0
id System.String requiredposition: 1
public String ToTranscript() #
Returns: String

Gets sanitized chronological output, including cleared lines and both timestamps.

Exceptions

  • InvalidOperationException – The expanded transcript exceeds 16 Mi UTF-16 characters.
public StoryReplay Trim(TimeSpan start, TimeSpan end) #
Returns: StoryReplay

Returns a detached presentation interval. Earlier events are retained at zero to reconstruct tab and screen state.

Parameters

start System.TimeSpan requiredposition: 0
end System.TimeSpan requiredposition: 1

Properties

public TimeSpan Duration { get; private set; } #

Gets the presentation duration, including recorded idle time.

public TimeSpan OriginalDuration { get; private set; } #

Gets the original duration before trimming or pause compression.

public TerminalDialect Dialect { get; } #

Gets the initial recording dialect.

public String Title { get; } #

Gets the initial tab title.

public String WorkingDirectory { get; } #

Gets the initial prompt directory.

public String CustomPrompt { get; } #

Gets the initial custom prompt.

public IReadOnlyList<StoryReplayEvent> Events { get; } #

Gets immutable events in stable timestamp order.