Icod.TermInfo 1.14.0

Icod.TermInfo

Icod.TermInfo is a managed, cross-platform .NET implementation of the low-level terminal-capability model traditionally supplied by libtinfo. The runtime package is dependency-free; optional sibling packages add terminfo source parsing, compilation, termcap interoperability, inspection, comparison, planning, and automation without enlarging the core runtime contract.

Status

Current release line: Icod.TermInfo 1.14.0.

Version 1.14.0 adds raster-backend availability evidence, deterministic candidate evaluation, and explicit caller-preference-aware backend selection in Icod.TermInfo.Inspection, while preserving the Runtime, Source, Compiler, Termcap, command, package, and archive contracts.

The 1.14 release contract passed the complete Staging qualification matrix on Windows, Linux, and macOS, including package verification, isolated consumers, installed-tool smoke, and all six standalone archive RIDs.

Support the Project

Icod.TermInfo and its ecosystem packages (Icod.Terminal and Icod.DCurses) are built and maintained by a solo developer. If these packages save you or your team time, please consider supporting their continued development and maintenance.

Architecture

Icod.TermInfo is the capability-data foundation of the Icod terminal stack. Higher layers may stop at whichever abstraction they need:

higher-level terminal applications
             |
        Icod.DCurses
             |
        Icod.Terminal
             |
     Icod.TermInfo family
             |
 terminal capability databases

• Icod.TermInfo owns immutable terminal descriptions, capability metadata, compiled terminfo acquisition, expansion, color semantics, padding-aware output, and built-in terminal profiles.
• Icod.Terminal owns the live terminal conversation: input, lifecycle, active queries, semantic protocols, terminal state, raster execution, and reversible session ownership.
• Icod.DCurses owns higher-level cells, windows, pads, retained panels, layout, composition, refresh/damage policy, and curses-style interaction abstractions.

The reusable TermInfo package family is deliberately layered:

Icod.TermInfo                    runtime / capability authority
├── Icod.TermInfo.Source         .ti parsing and resolution
├── Icod.TermInfo.Termcap        termcap interoperability
├── Icod.TermInfo.Compiler       compilation / database writing
└── Icod.TermInfo.Inspection     inspection / comparison / planning

Icod.TermInfo.Tools              command distribution / routing

Dependency boundaries are explicit: Runtime has no production package dependencies; Source and Termcap each depend on Runtime; Compiler and Inspection each depend on Runtime and Source. Inspection does not depend on Compiler, Termcap, Icod.Terminal, or Icod.DCurses.

Quick Start

Install the runtime package:

dotnet add package Icod.TermInfo --version 1.14.0

Resolve the current terminal through conventional system discovery with immutable built-in fallback:

using Icod.TermInfo;

TerminalDatabase database = new(
	new ITerminalDescriptionProvider[] {
		new SystemTerminalDescriptionProvider(),
		TerminalDatabase.BuiltIn,
	}
);

TerminalDescription terminal = TerminalEnvironment.Resolve(
	database,
	TerminalProfiles.Dumb
);

Console.WriteLine( $"Terminal: {terminal.Name}" );

string? clear = terminal.GetString( StringCapability.ClearScreen );
if ( clear is not null ) {
	TermInfoOutput.PutP( clear, Console.Out );
}

Applications that only need compiled terminfo acquisition, immutable TerminalDescription values, capability lookup, expansion, or output continue to reference Icod.TermInfo alone. Add the optional packages only for the higher-level source, compiler, termcap, or planning workflows described below.

Feature Inventory

The root README describes the current product by capability rather than by the release in which each feature first appeared.

• Terminal capability model — immutable terminal descriptions; standard and extended Boolean, numeric, and string capabilities; canonical capability metadata; aliases and descriptions; built-in dumb, ANSI, DEC VT100/VT102/VT220, xterm, Windows Console, and Windows Terminal profiles.
• Compiled terminfo acquisition — bounded parsing of conventional compiled entries, explicit directory providers, deterministic system discovery, provider composition, successful-entry caching, and built-in fallback.
• Expansion and output — reusable parsed parameter programs, bounded parameter evaluation, extended-string expansion, reversible 8-bit capability-string semantics, and padding-aware tputs/putp-style output.
• Color and environment semantics — monochrome, indexed-color, and direct-RGB inspection and selector expansion; terminal-size queries; explicit Windows virtual-terminal output enablement kept separate from profile selection.
• Terminfo source language — Icod.TermInfo.Source provides .ti lexing, parsing, diagnostics, capability classification, cancellation semantics, use= inheritance resolution, and materialization into ordinary TerminalDescription values.
• Compilation and publication — Icod.TermInfo.Compiler writes deterministic legacy and wide compiled entries, validates representability, compiles resolved descriptions or .ti source, and publishes explicit conventional terminfo directory layouts.
• Termcap interoperability — Icod.TermInfo.Termcap provides bounded termcap parsing, capability classification, tc= resolution, semantic conversion, reverse representability/rendering, and explicit historical TERMCAP / TERMPATH acquisition.
• Inspection, comparison, and planning — Icod.TermInfo.Inspection provides canonical effective-source rendering, semantic comparison, database catalogs and ordered database-set analysis, relative-source synthesis and parent planning, machine-readable JSON automation, persistent-raster lifecycle/placement/runtime-evidence planning, and raster-backend availability and selection.
• Managed command toolchain — tic, infocmp, toe, captoinfo, and infotocap expose the reusable engines as traditional command-line workflows; Icod.TermInfo.Tools provides the non-colliding icod-terminfo router.

Packages and Tools

Install an optional package only when its capability is needed:

dotnet add package Icod.TermInfo.Source --version 1.14.0
dotnet add package Icod.TermInfo.Termcap --version 1.14.0
dotnet add package Icod.TermInfo.Compiler --version 1.14.0
dotnet add package Icod.TermInfo.Inspection --version 1.14.0

Install the command router with:

dotnet tool install --global Icod.TermInfo.Tools --version 1.14.0

icod-terminfo tic -V
icod-terminfo infocmp -V
icod-terminfo toe -V
icod-terminfo captoinfo -V
icod-terminfo infotocap -V

The standalone release archives expose the traditional command names directly for win-x64, win-arm64, linux-x64, linux-arm64, osx-x64, and osx-arm64. They are framework-dependent .NET 10 distributions; the user supplies the .NET 10 runtime and controls installation and PATH placement.

Platforms and Targets

The reusable package family targets:

net8.0
net9.0
net10.0

The repository uses C# 13. The command projects and router target .NET 10. Release validation covers Windows, Linux, and macOS, with x64 and ARM64 standalone tool archives for each operating-system family.

The managed packages contain no native ncurses or system terminfo payload. Runtime discovery consumes caller-selected or conventional host databases and can fall back to immutable built-in profiles.

Design Boundaries and Guarantees

• Runtime capability data is immutable and reusable; live terminal-session ownership is intentionally outside TermInfo.
• TermInfo does not install a competing terminal input reader, own application event loops, or perform general live terminal probing.
• Persistent-raster planning is protocol-neutral. TermInfo does not allocate terminal-side image/resource/placement identities, execute Sixel or Kitty Graphics, process acknowledgements, or own terminal cleanup; those responsibilities belong to live-session layers such as Icod.Terminal.
• Backend planning does not use terminal-brand heuristics or hidden backend ranking. Caller preference is explicit, and ambiguity remains visible rather than being resolved by enum value or input order.
• Curses-style cells, windows, layout, retained presentation state, refresh/damage policy, and interaction routing belong to Icod.DCurses.
• PTY/process hosting and terminal emulation are separate concerns.
• Parsing, compilation, comparison, synthesis, planning, and machine-readable output are designed to be deterministic and bounded for equivalent caller input.
• TermInfoOutput can emit resolved capability strings and honor terminfo padding semantics without turning the library into the owner of a live terminal conversation.

Samples and Documentation

The samples directory contains focused examples for runtime acquisition, reusable Termcap parsing/conversion/acquisition, the source/compiler toolchain, database-set analysis, persistent-raster lifecycle and placement planning, runtime-evidence integration, raster-backend selection, and command-tool workflows.

Recommended documentation entry points:

• CHANGELOG.md — release-by-release feature history;
• docs/VERSIONING.md — versioning and compatibility policy;
• docs/COMPATIBILITY.md — public and binary compatibility commitments;
• docs/1.14.0-RASTER-BACKEND-SELECTION-GUIDE.md — current raster-backend evidence and selection model;
• docs/1.14.0-RELEASE-AUDIT.md — exact 1.14 qualification and release evidence;
• Icod.TermInfo-Post-1.0-Development-Roadmap.md — longer-range development direction.

Release audits, public-API baselines, schema freezes, tranche records, and historical roadmaps remain in the repository as engineering evidence. They are intentionally not repeated in this README.

Compatibility and Versioning

The 1.x line keeps reusable assembly identity at version 1.0.0.0; the assemblies remain unsigned. The current reusable packages support net8.0, net9.0, and net10.0.

The runtime 1.0 public API remains frozen. Later reusable capabilities were added through sibling packages or compatible additive surfaces rather than by turning the dependency-free Runtime package into a monolith. Public API, binary/package compatibility, deprecation, and target-framework policy are maintained in docs/VERSIONING.md and docs/COMPATIBILITY.md.

This README is maintained as a current product and contributor entry point. Release-by-release chronology belongs in CHANGELOG.md, release notes, versioned roadmaps, API/schema baselines, and release audits rather than accumulating here.

Authors

Inspired by original work from Bill Joy, author of the original termcap; Mary Ann (born Mark) Horton, author of terminfo; Pavel Curtis, author of pcurses; and Zeyd Ben-Halim, Eric S. Raymond, and Thomas Dickey, whose work developed and maintained libtinfo and ncurses.

Managed .NET implementation by Timothy J. Bruce uniblab@hotmail.com.

Copyright

Copyright (c) 2026 Timothy J. Bruce

License

The reusable Icod.TermInfo, Icod.TermInfo.Source, Icod.TermInfo.Termcap, Icod.TermInfo.Compiler, and Icod.TermInfo.Inspection library projects are licensed under the GNU Lesser General Public License, version 3 or later.

Executable command, sample, and repository tooling projects are licensed under the GNU General Public License, version 3 or later, as stated in their project and source declarations.

See LICENSE and the per-project/source declarations for the applicable terms.