ai-elements-ui/dev.ai.elements.ui.code

Package-level declarations

Types

@Immutable

data class CommitFile(val path: String, val change: FileChange = FileChange.MODIFIED, val additions: Int = 0, val deletions: Int = 0)

A changed file in a Commit with its line counts.

EnvironmentVariable

@Immutable

data class EnvironmentVariable(val name: String, val value: String, val secret: Boolean = true)

A variable in EnvironmentVariables; secret values stay masked until revealed.

FileChange

enum FileChange : Enum<FileChange>

How a file changed in a Commit.

FileNode

@Immutable

data class FileNode(val name: String, val path: String = name, val children: List<FileNode>? = null, val badge: String? = null)

A file or folder. path identifies it (selection, expansion); badge is a short status such as M, A, +12.

PackageChange

enum PackageChange : Enum<PackageChange>

The size of a dependency change in PackageInfo.

SandboxTab

@Immutable

data class SandboxTab(val label: String, val content: @Composable () -> Unit)

One tab of a Sandbox.

SchemaParameter

@Immutable

data class SchemaParameter(val name: String, val type: String, val required: Boolean = false, val description: String? = null, val location: String? = null)

A parameter of an endpoint in SchemaDisplay; location is where it goes (path, query, header, body).

TerminalStatus

enum TerminalStatus : Enum<TerminalStatus>

Where a command is in its life.

TestCaseResult

@Immutable

data class TestCaseResult(val name: String, val status: TestStatus, val durationMs: Long? = null, val error: String? = null)

One test; error is shown under failed tests.

TestStatus

enum TestStatus : Enum<TestStatus>

Outcome of a test in TestResults.

TestSuiteResult

@Immutable

data class TestSuiteResult(val name: String, val tests: List<TestCaseResult>)

A group of tests in TestResults.

Functions

Artifact

@Composable

fun Artifact(title: String, modifier: Modifier = Modifier, description: String? = null, actions: @Composable RowScope.() -> Unit = {}, content: @Composable () -> Unit)

A generated artifact — a document, code file, chart… (AI Elements <Artifact>): a titled card with header actions and free-form content.

Commit

@Composable

fun Commit(hash: String, message: String, modifier: Modifier = Modifier, author: String? = null, timestampMs: Long? = null, files: List<CommitFile> = emptyList())

A git commit (AI Elements <Commit>): short hash (copyable), subject and body, author and time, then changed files with +/- counts.

EnvironmentVariables

@Composable

fun EnvironmentVariables(variables: List<EnvironmentVariable>, modifier: Modifier = Modifier, title: String = stringResource(R.string.ai_environment_variables))

Environment variables (AI Elements <EnvironmentVariables>): secret values stay masked until revealed one by one; each can be copied.

FileTree

@Composable

fun FileTree(nodes: List<FileNode>, modifier: Modifier = Modifier, selectedPath: String? = null, expanded: Set<String> = nodes.filter { it.isFolder }.map { it.path }.toSet(), onSelect: (FileNode) -> Unit? = null)

A project tree (AI Elements <FileTree>): folders expand in place, files get type icons, the selectedPath is highlighted. expanded paths start open (default: top-level folders).

PackageInfo

@Composable

fun PackageInfo(name: String, modifier: Modifier = Modifier, fromVersion: String? = null, toVersion: String? = null, change: PackageChange? = null, description: String? = null)

A dependency change (AI Elements <PackageInfo>): name, old → new version, how big the change is, and optionally what it does.

Sandbox

@Composable

fun Sandbox(title: String, tabs: List<SandboxTab>, modifier: Modifier = Modifier, subtitle: String? = null)

A run environment with tabs (AI Elements <Sandbox>) — e.g. Code, Preview, Console — sharing one card.

SchemaDisplay

@Composable

fun SchemaDisplay(method: String, path: String, modifier: Modifier = Modifier, description: String? = null, parameters: List<SchemaParameter> = emptyList(), requestBody: String? = null, responseBody: String? = null)

An API endpoint (AI Elements <SchemaDisplay>): method and path, what it does, its parameters, and example request / response bodies.

Snippet

@Composable

fun Snippet(text: String, modifier: Modifier = Modifier, prefix: String? = null)

A one-line command or value to copy (AI Elements <Snippet>), e.g. npm i ai. prefix (like $) is shown but not copied.

StackTrace

@Composable

fun StackTrace(trace: String, modifier: Modifier = Modifier, collapsedFrames: Int = 6)

A readable exception (AI Elements <StackTrace>): type and message up front, the app's own frames emphasised, library frames collapsed until asked for, with copy of the raw trace.

Terminal

@Composable

fun Terminal(output: String, modifier: Modifier = Modifier, title: String = stringResource(R.string.ai_terminal), status: TerminalStatus? = null, exitCode: Int? = null, maxHeight: Dp = 320.dp, onClear: () -> Unit? = null, scrollback: Int)

Command output (AI Elements <Terminal>): a dark console that renders ANSI colors and bold, follows new output while status is running, with copy and an optional clear action.

TestResults

@Composable

fun TestResults(suites: List<TestSuiteResult>, modifier: Modifier = Modifier, durationMs: Long? = null)

A test run (AI Elements <TestResults>): pass / fail / skip counts and a proportional bar, then suites that expand to their cases. Failed suites start open and show each failure's message.

WebPreview

@Composable

fun WebPreview(url: String, modifier: Modifier = Modifier, html: String? = null, height: Dp = 360.dp)

A live preview of a generated web page or URL (AI Elements <WebPreview>): navigation bar with back / reload / open-in-browser and a sandboxed WebView. Pass html to preview generated markup instead of loading url.