Skip to main content Link Search Menu Expand Document (external link)
effect

HelpDoc.ts overview

Since v1.0.0

Exports Grouped by Category

combinators

orElse

Signature

declare const orElse: { (that: HelpDoc): (self: HelpDoc) => HelpDoc; (self: HelpDoc, that: HelpDoc): HelpDoc }

Source

Since v1.0.0

sequence

Signature

declare const sequence: { (that: HelpDoc): (self: HelpDoc) => HelpDoc; (self: HelpDoc, that: HelpDoc): HelpDoc }

Source

Since v1.0.0

constructors

blocks

Signature

declare const blocks: (helpDocs: Iterable<HelpDoc>) => HelpDoc

Source

Since v1.0.0

descriptionList

Signature

declare const descriptionList: (definitions: NonEmptyReadonlyArray<[Span, HelpDoc]>) => HelpDoc

Source

Since v1.0.0

empty

Signature

declare const empty: HelpDoc

Source

Since v1.0.0

enumeration

Signature

declare const enumeration: (elements: NonEmptyReadonlyArray<HelpDoc>) => HelpDoc

Source

Since v1.0.0

h1

Signature

declare const h1: (value: string | Span) => HelpDoc

Source

Since v1.0.0

h2

Signature

declare const h2: (value: string | Span) => HelpDoc

Source

Since v1.0.0

h3

Signature

declare const h3: (value: string | Span) => HelpDoc

Source

Since v1.0.0

p

Signature

declare const p: (value: string | Span) => HelpDoc

Source

Since v1.0.0

getters

getSpan

Signature

declare const getSpan: (self: HelpDoc) => Span

Source

Since v1.0.0

mapping

mapDescriptionList

Signature

declare const mapDescriptionList: {
  (f: (span: Span, helpDoc: HelpDoc) => [Span, HelpDoc]): (self: HelpDoc) => HelpDoc
  (self: HelpDoc, f: (span: Span, helpDoc: HelpDoc) => [Span, HelpDoc]): HelpDoc
}

Source

Since v1.0.0

models

DescriptionList (interface)

Signature

export interface DescriptionList {
  readonly _tag: "DescriptionList"
  readonly definitions: NonEmptyReadonlyArray<readonly [Span, HelpDoc]>
}

Source

Since v1.0.0

Empty (interface)

Signature

export interface Empty {
  readonly _tag: "Empty"
}

Source

Since v1.0.0

Enumeration (interface)

Signature

export interface Enumeration {
  readonly _tag: "Enumeration"
  readonly elements: NonEmptyReadonlyArray<HelpDoc>
}

Source

Since v1.0.0

Header (interface)

Signature

export interface Header {
  readonly _tag: "Header"
  readonly value: Span
  readonly level: number
}

Source

Since v1.0.0

HelpDoc (type alias)

A HelpDoc models the full documentation for a command-line application.

HelpDoc is composed of optional header and footers, and in-between, a list of HelpDoc-level content items.

HelpDoc-level content items, in turn, can be headers, paragraphs, description lists, and enumerations.

A HelpDoc can be converted into plaintext, JSON, and HTML.

Signature

type HelpDoc = Empty | Header | Paragraph | DescriptionList | Enumeration | Sequence

Source

Since v1.0.0

Paragraph (interface)

Signature

export interface Paragraph {
  readonly _tag: "Paragraph"
  readonly value: Span
}

Source

Since v1.0.0

Sequence (interface)

Signature

export interface Sequence {
  readonly _tag: "Sequence"
  readonly left: HelpDoc
  readonly right: HelpDoc
}

Source

Since v1.0.0

refinements

isDescriptionList

Signature

declare const isDescriptionList: (helpDoc: HelpDoc) => helpDoc is DescriptionList

Source

Since v1.0.0

isEmpty

Signature

declare const isEmpty: (helpDoc: HelpDoc) => helpDoc is Empty

Source

Since v1.0.0

isEnumeration

Signature

declare const isEnumeration: (helpDoc: HelpDoc) => helpDoc is Enumeration

Source

Since v1.0.0

isHeader

Signature

declare const isHeader: (helpDoc: HelpDoc) => helpDoc is Header

Source

Since v1.0.0

isParagraph

Signature

declare const isParagraph: (helpDoc: HelpDoc) => helpDoc is Paragraph

Source

Since v1.0.0

isSequence

Signature

declare const isSequence: (helpDoc: HelpDoc) => helpDoc is Sequence

Source

Since v1.0.0

rendering

toAnsiDoc

Signature

declare const toAnsiDoc: (self: HelpDoc) => AnsiDoc

Source

Since v1.0.0

toAnsiText

Signature

declare const toAnsiText: (self: HelpDoc) => string

Source

Since v1.0.0