studio/dev.gmitch215.drift.studio.ui

Package-level declarations

Types

data class AtlasState(val dataset: Dataset, val version: String = dataset.versions.first(), val divergentOnly: Boolean = false, val level: DetailLevel = DetailLevel.SUMMARY, val device: Device? = null, val selected: String? = null, val progress: Progress? = null)

AtlasView

data class AtlasView(val version: String, val versions: List<String>, val groups: List<TargetGroup>, val deviceLabel: String?, val total: Int, val divergent: Int, val rows: List<RowView>, val deviceSummary: List<String>)

BisectStory

object BisectStory

BisectView

class BisectView(val plan: BisectPlan, val headline: String, val settings: List<SettingRow>, val first: TestWords?)

CandidateRow

data class CandidateRow(val path: String, val text: String, val tier: String, val change: String, val refs: List<String>)

CaseLine

class CaseLine(val text: String, val failed: Boolean)

CasePicker

fun interface CasePicker

Lets the app ask the platform for a case file; onOpened gets the result, good or not.

CaseStory

class CaseStory(val headline: String, val sureness: String, val next: String, val differences: List<Difference>, val experiments: List<String>, val notes: List<String>)

A solved case in words. headline says what Drift found, sureness how it knows, next what to try; experiments and notes are the details behind them.

CaseView

class CaseView(val name: String, val lines: List<CaseLine>, val verdict: String?, val story: CaseStory? = null)

A .driftcase as Studio shows it: what drift verify finds, or why the file cannot be read.

CellView

data class CellView(val target: String, val short: String, val lines: List<String>)

ChoiceView

data class ChoiceView(val label: String, val targets: List<String>, val lines: List<String>)

CiDiagnosis

object CiDiagnosis

Reads saved job logs the way drift import does, then ranks the two environments.

CiFormat

enum CiFormat : Enum<CiFormat>

CiResult

sealed interface CiResult

CiSample

class CiSample(val passing: String, val failing: String, val job: String)

ContractStory

object ContractStory

DetailLevel

enum DetailLevel : Enum<DetailLevel>

Device

class Device(val label: String, val transcript: String, val comparison: Comparison)

One device transcript and its comparison with the dataset; Device.transcript feeds atlas build.

DeviceMeasure

fun interface DeviceMeasure

Runs the Kotlin probes where Studio is; progress gets the probes done and the total.

Devices

object Devices

Difference

class Difference(val path: String, val before: String?, val after: String?, val cause: Boolean)

FilePicker

fun interface FilePicker

The platform file chooser for files that end in an extension; onPicked gets the result.

FileSaver

fun interface FileSaver

Hands text to the user as a file called name; returns why it could not, else null.

Glossary

object Glossary

One-sentence definitions, shown where a term first matters on a screen.

GroupWords

class GroupWords(val title: String, val about: String, val none: String)

What a group means, in fixed words; the groups are the engine's, not Studio's.

Load

sealed interface Load<out T>

A file read into a value Studio shows, or the sentence that says why it could not be.

Loads

object Loads

Palette

@Immutable

class Palette(val canvas: Color, val surface: Color, val hairline: Color, val control: Color, val text: Color, val muted: Color, val accent: Color, val accentText: Color, val accentTint: Color, val warn: Color, val warnText: Color, val danger: Color)

Colors of one theme; every text color is checked against its backgrounds in a test.

PickedFile

class PickedFile(val name: String, val bytes: ByteArray?, val problem: String? = null)

A chosen file: its bytes, or problem when they could not be read.

Plain

object Plain

PredictState

data class PredictState(val dataset: Dataset, val version: String = dataset.versions.first(), val seed: Int = 1, val position: Int = 0, val guess: Int? = null, val score: Score = Score())

Session state; PredictState.guess is a choice index or DONT_KNOW, null until answered.

PredictView

data class PredictView(val probeId: String, val index: Int, val count: Int, val question: String, val source: List<String>, val target: String, val choices: List<ChoiceView>, val reveal: RevealView?, val score: Score)

Preset

class Preset(val label: String, val text: String)

A move people often check; it is offered only when the capsule holds every setting it names.

Progress

data class Progress(val done: Int, val total: Int)

Probes finished and the total of a run on this device.

RangeBar

data class RangeBar(val start: Float, val end: Float, val median: Float)

One bar on a shared axis that starts at 0; each position is a fraction of the axis.

RangeBars

object RangeBars

Reading

data class Reading(val headline: String, val evidence: String?, val caution: String)

RequirementWords

class RequirementWords(val ask: String, val found: String, val why: String)

One requirement as a person reads it: what it asks, what the capsule has, why it is there.

RevealView

data class RevealView(val verdict: String, val results: List<String>, val badge: String, val notes: List<String>)

RowView

data class RowView(val id: String, val area: String, val name: String, val divergent: Boolean, val badge: String, val cells: List<CellView>, val device: CellView?, val deviceVerdict: String?, val notes: List<String>, val agrees: List<String> = emptyList(), val differs: List<String> = emptyList())

Sample

class Sample(val name: String, val green: Capsule, val red: Capsule)

Score

data class Score(val correct: Int = 0, val wrong: Int = 0, val skipped: Int = 0)

SetEntry

class SetEntry(val name: String, val failing: Boolean, val capsule: Capsule)

A capsule added to the set, with whether its run failed.

SetSample

class SetSample(val name: String, val entries: List<SetEntry>)

SetStory

object SetStory

SettingRow

class SettingRow(val title: String, val change: String)

One setting that differs: what it is, and its value in the passing and the failing capsule.

SetView

class SetView(val result: SetResult, val headline: String, val rows: List<SplitRow>)

SplitRow

class SplitRow(val title: String, val value: String, val counts: String, val separates: Boolean)

One setting value: what it is, where it is held and whether it alone splits the set.

Stage

data class Stage(val label: String, val count: Int)

StudioView

data class StudioView(val funnel: List<Stage>, val verdict: String, val candidates: List<CandidateRow>, val hidden: Int, val extras: List<String>)

TargetGroup

data class TargetGroup(val name: String, val targets: List<String>)

Targets of one family, in the order the matrix shows them.

TestWords

class TestWords(val sentence: String, val settings: List<SettingRow>, val commands: List<String>)

The first test of the plan: what to change and the commands that record how it went.

TierWords

data class TierWords(val level: Int, val label: String, val phrase: String)

A tier as a newcomer reads it: its place among the four and what it rests on.

UpgradeCheckResult

sealed interface UpgradeCheckResult

UpgradeStory

object UpgradeStory

UpgradeView

class UpgradeView(val report: UpgradeReport, val headline: String)

The result of one check: the engine's report and the sentence that leads it.

Properties

ATLAS_ABOUT

const val ATLAS_ABOUT: String

ATLAS_FOOTER

const val ATLAS_FOOTER: String

BISECT_ABOUT

const val BISECT_ABOUT: String

BISECT_ABOUT_HOME

const val BISECT_ABOUT_HOME: String

CASE_ABOUT

const val CASE_ABOUT: String

CI_ABOUT

const val CI_ABOUT: String

CI_ABOUT_HOME

const val CI_ABOUT_HOME: String

CI_FOOTER

const val CI_FOOTER: String

CI_LIMIT

const val CI_LIMIT: String

CI_SAMPLE_ABOUT

const val CI_SAMPLE_ABOUT: String

CONTRACT_ABOUT

const val CONTRACT_ABOUT: String

CONTRACT_ABOUT_HOME

const val CONTRACT_ABOUT_HOME: String

DarkPalette

val DarkPalette: Palette

DONT_KNOW

const val DONT_KNOW: Int

fileDialogFilePicker

val fileDialogFilePicker: FilePicker

fileDialogPicker

val fileDialogPicker: CasePicker

fileDialogSaver

val fileDialogSaver: FileSaver

FOOTER

const val FOOTER: String

GREEN_RUN

const val GREEN_RUN: String

HOME_ABOUT

const val HOME_ABOUT: String

INVESTIGATION_ABOUT

const val INVESTIGATION_ABOUT: String

LightPalette

val LightPalette: Palette

NO_FILES

const val NO_FILES: String

NO_PICKER

const val NO_PICKER: String

OPEN_ABOUT

const val OPEN_ABOUT: String

RANGE_NOTE

const val RANGE_NOTE: String

RED_RUNS

val RED_RUNS: List<String>

SAMPLE_ABOUT

const val SAMPLE_ABOUT: String

SET_ABOUT

const val SET_ABOUT: String

SET_ABOUT_HOME

const val SET_ABOUT_HOME: String

UPGRADE_ABOUT

const val UPGRADE_ABOUT: String

UPGRADE_ABOUT_HOME

const val UPGRADE_ABOUT_HOME: String

UPGRADE_CAVEAT

const val UPGRADE_CAVEAT: String

Functions

AtlasScreen

@Composable

fun AtlasScreen(dataset: Dataset = AtlasData.dataset, measure: DeviceMeasure = Devices.measurer(), saver: FileSaver? = null)

BisectScreen

@Composable

fun BisectScreen(files: FilePicker? = null, samples: List<Sample> = samples())

caseFromArgs

fun caseFromArgs(args: Array<String>): CaseView?

CaseScreen

@Composable

fun CaseScreen(case: CaseView)

ciSample

fun ciSample(): CiSample

CiScreen

@Composable

fun CiScreen(files: FilePicker? = null, sample: () -> CiSample = ::ciSample)

ContractScreen

@Composable

fun ContractScreen(files: FilePicker? = null, samples: List<Sample> = samples())

family

fun family(target: String): String

The family a column belongs to, read from its label (jvm-17 is JVM, wasm-webkit Wasm).

FunnelPlot

@Composable

fun FunnelPlot(view: StudioView)

groupTargets

fun groupTargets(targets: List<String>): List<TargetGroup>

HomeScreen

@Composable

fun HomeScreen(canOpen: Boolean, problem: String?, onOpen: () -> Unit, onCi: () -> Unit, onSample: () -> Unit, onAtlas: () -> Unit, onUpgrade: () -> Unit, onContract: () -> Unit, onBisect: () -> Unit, onSet: () -> Unit)

The first screen: each way in has one line on what it does.

loadCase

fun loadCase(path: String): CaseView

main

fun main(args: Array<String>)

fun main()

readPicked

fun readPicked(file: File): PickedFile

samples

fun samples(): List<Sample>

sampleState

fun sampleState(): StudioState

setSamples

fun setSamples(): List<SetSample>

SetScreen

@Composable

fun SetScreen(files: FilePicker? = null, samples: List<SetSample> = setSamples())

StudioApp

@Composable

fun StudioApp(dataset: Dataset = AtlasData.dataset, samples: List<Sample> = samples(), measure: DeviceMeasure = Devices.measurer(), dark: Boolean = isSystemInDarkTheme(), case: CaseView? = null, picker: CasePicker? = null, files: FilePicker? = null, saver: FileSaver? = null, startOnAtlas: Boolean = false)

StudioScreen

@Composable

fun StudioScreen(samples: List<Sample> = samples())

StudioTheme

@Composable

fun StudioTheme(dark: Boolean = isSystemInDarkTheme(), content: @Composable () -> Unit)

upgradeSamples

fun upgradeSamples(): List<Load.Ok<Capsule>>

UpgradeScreen

@Composable

fun UpgradeScreen(files: FilePicker? = null, samples: List<Load.Ok<Capsule>> = upgradeSamples())