@mwillbanks/tuil-story

Portable tuil stories, browser bridges, snapshots, documentation, and Storybook adapters.

Overview

Portable tuil stories, browser bridges, snapshots, documentation, and Storybook adapters.

@mwillbanks/tuil-story is independently installable and also participates in the umbrella @mwillbanks/tuil runtime where applicable.

Installation

npm install @mwillbanks/tuil-story

Portable stories combine component args with terminal capabilities, themes, semantic nodes, focus state, events, ANSI output, and an action history. Adapters expose the same story to tests, browsers, static docs, and Storybook. Dynamic and static HTTP adapters stream untrusted bodies through a byte limit, validate their complete schema, bound recursive args, controls, dimensions, and simulated input, and apply a server-side timeout before render-lock acquisition.

Documentation flow diagram. register story; open session; render; interact/update; close; S0 leads to S1; S1 leads to S2; S2 leads to S3 — **Documentation flow diagram.** register story; open session; render; interact/update; close; S0 leads to S1; S1 leads to S2; S2 leads to S3

API

API	Signature	Description
`ansiFrameToHtml`	`function ansiFrameToHtml`	Public function ansiFrameToHtml.
`browserStories`	`function browserStories`	Public function browserStories.
`BrowserStorySet`	`interface BrowserStorySet`	Public interface BrowserStorySet.
`componentArgsFromAdapterArgs`	`function componentArgsFromAdapterArgs`	Public function componentArgsFromAdapterArgs.
`createFumadocsStoryAdapter`	`function createFumadocsStoryAdapter`	Public function createFumadocsStoryAdapter.
`createStaticStoryHttpHandler`	`function createStaticStoryHttpHandler`	Public function createStaticStoryHttpHandler.
`createStorybookAdapter`	`function createStorybookAdapter`	Public function createStorybookAdapter.
`createStoryHttpHandler`	`function createStoryHttpHandler`	Public function createStoryHttpHandler.
`createTerminalStoryFrameEffect`	`function createTerminalStoryFrameEffect`	Public function createTerminalStoryFrameEffect.
`defaultTerminalStoryControls`	`export defaultTerminalStoryControls`	Public export defaultTerminalStoryControls.
`defineTuilStories`	`export defineTuilStories`	Public export defineTuilStories.
`FumadocsStoryConfig`	`interface FumadocsStoryConfig`	Public interface FumadocsStoryConfig.
`FumadocsStoryProps`	`type FumadocsStoryProps`	Public type FumadocsStoryProps.
`generateStoryCatalogDocumentation`	`function generateStoryCatalogDocumentation`	Public function generateStoryCatalogDocumentation.
`generateStoryCatalogSnapshots`	`function generateStoryCatalogSnapshots`	Public function generateStoryCatalogSnapshots.
`handleStoryHttpRequest`	`function handleStoryHttpRequest`	Public function handleStoryHttpRequest.
`OpenStoryOptions`	`interface OpenStoryOptions`	Public interface OpenStoryOptions.
`renderStaticStoryRequest`	`function renderStaticStoryRequest`	Public function renderStaticStoryRequest.
`renderStoryRequest`	`function renderStoryRequest`	Public function renderStoryRequest.
`StaticStoryCatalog`	`class StaticStoryCatalog`	Public class StaticStoryCatalog.
`StaticStoryFrame`	`type StaticStoryFrame`	Public type StaticStoryFrame.
`StaticStoryRequest`	`interface StaticStoryRequest`	Public interface StaticStoryRequest.
`StoryAction`	`interface StoryAction`	Public interface StoryAction.
`StorybookAdapter`	`interface StorybookAdapter`	Public interface StorybookAdapter.
`StoryBridgeRequest`	`interface StoryBridgeRequest`	Public interface StoryBridgeRequest.
`StoryCatalogSnapshots`	`type StoryCatalogSnapshots`	Public type StoryCatalogSnapshots.
`StoryFrame`	`interface StoryFrame`	Public interface StoryFrame.
`storyFrameToMarkdown`	`function storyFrameToMarkdown`	Public function storyFrameToMarkdown.
`StoryHttpHandlerOptions`	`interface StoryHttpHandlerOptions`	Public interface StoryHttpHandlerOptions.
`storyHttpLimits`	`constant storyHttpLimits`	Public constant storyHttpLimits.
`StorySnapshot`	`interface StorySnapshot`	Public interface StorySnapshot.
`terminalControlArgNames`	`constant terminalControlArgNames`	Public constant terminalControlArgNames.
`terminalControlsFromArgs`	`function terminalControlsFromArgs`	Public function terminalControlsFromArgs.
`terminalControlsToArgs`	`function terminalControlsToArgs`	Public function terminalControlsToArgs.
`TerminalStoryControls`	`export TerminalStoryControls`	Public export TerminalStoryControls.
`TerminalStoryFrame`	`function TerminalStoryFrame`	Public function TerminalStoryFrame.
`TerminalStoryFrameEffectOptions`	`interface TerminalStoryFrameEffectOptions`	Public interface TerminalStoryFrameEffectOptions.
`TerminalStoryFrameProps`	`interface TerminalStoryFrameProps`	Public interface TerminalStoryFrameProps.
`TerminalStoryFrameView`	`function TerminalStoryFrameView`	Public function TerminalStoryFrameView.
`TerminalStoryFrameViewProps`	`interface TerminalStoryFrameViewProps`	Public interface TerminalStoryFrameViewProps.
`TuilStory`	`export TuilStory`	Public export TuilStory.
`TuilStoryCatalog`	`class TuilStoryCatalog`	Public class TuilStoryCatalog.
`TuilStoryDefinition`	`export TuilStoryDefinition`	Public export TuilStoryDefinition.
`TuilStorySession`	`class TuilStorySession`	Public class TuilStorySession.
`TuilStorySet`	`interface TuilStorySet`	Public interface TuilStorySet.
`validateStoryBridgeRequest`	`function validateStoryBridgeRequest`	Public function validateStoryBridgeRequest.

Events and lifecycle

Every rendered frame captures the runtime's observed event history and story action timeline. HTTP request failures return 400, client disconnects return 499, and render timeouts return 504.

All subscriptions and registrations return a disposer or belong to an owning runtime that disposes them in reverse order.

Example

import { defineTuilStories } from "@mwillbanks/tuil-story";

export const stories = defineTuilStories({ component: Button, stories: { Default: { args: { children: "Run" } } } });

@mwillbanks/tuil-story

Overview

Installation

How it operates

API

Events and lifecycle

Example

On this page

@mwillbanks/tuil-story

Overview

Installation

How it operates

API

Events and lifecycle

Example

Related

On this page