Repository navigation
The stable release of everything shipped in 1.1.1-preview.1 to 1.1.1-preview.5, plus one change that ships here
for the first time: Markdown and code highlighting leave the main package
(#132, ADR 0050). TKCode.Arc no longer depends on StreamMark,
Markdig, TextMateSharp, its grammars or the native Oniguruma library, which made up about 8.5 MiB of a trimmed app that
used none of them. This is a breaking change inside 1.x, made on purpose (see Upgrading from 1.1.0); apart from it
nothing is removed, and the members that no longer apply stay as [Obsolete] (see Deprecated). The previews also bring
MonthCalendar, SlideToConfirm, WindowRange and CursorTrailDraw, left-hand field labels, a long-press edit menu
for Arc Mobile text fields, TerminalView on iOS and Android, and rebuilt KeycapKeyboard, PrizeWheel,
BranchGraph, SandText, SplitBar and TocProgress. Install it without --prerelease. The notes of each preview,
with every detail and issue link, follow below.
Upgrading from 1.1.0
-
Markdown and highlighting (breaking):
Markdown,MarkdownHighlightPlugin,ChatThreadandChatComposer(and
their tokens) moved to the newTKCode.Arc.Markdownassembly. Their names, theTKCode.Arcnamespace, thearc:XAML
namespace, properties, events and token names are unchanged, but code built against an earlierTKCode.Archas to be
rebuilt. WithoutUseArcHighlighting(),CodeBlock, theRichTextEditorcode blocks and Markdown's fenced code show
plain text.- An app that uses
Markdown,ChatThreadorChatComposer: addTKCode.Arc.Markdownand callUseArcMarkdown(). - An app that wants colored code in
CodeBlock, the rich text editor or Markdown: addTKCode.Arc.Highlightingand
callUseArcHighlighting(). - An app that uses
TKCode.Arc.Blocks,TKCode.Arc.SpecialorTKCode.Arc.A2UIneeds no change: these packages
depend on both new packages, andUseArcBlocks(),UseArcSpecial()andUseArcA2UI()enable them.
AppBuilder.Configure<App>() .UsePlatformDetect() .UseArc(arc => arc.UseArcControls() .UseArcMarkdown() // Markdown, ChatThread, ChatComposer .UseArcHighlighting()); // colored code
- An app that uses
-
Packages:
TKCode.Arc.MarkdownandTKCode.Arc.Highlightingare new on NuGet. All packages
are still released on one version; keep them on the same one. -
Blocks catalog: the groups follow uiarc.dev's. There is a new Agents group, and the whole-page blocks moved to the
Screens groups (BlockCatalog.ScreenGroups), so code that filtersBlockCatalog.Blocksby a group code may need the
new codes. Class names, namespaces and packages are unchanged. -
Look and behavior changes you may notice:
KeycapKeyboardis a typing board with a text area (ShowsText="False"
hides it);PrizeWheelshows a reward panel (IsPanelVisible="False"for the wheel alone) and spins by flick or hold
instead of a click on its face;BranchGraphis a merge strategy preview;SandTextis a falling-sand headline that
fills its width;SplitBarandTocProgressfollow their Arc designs (TocProgressshows the minutes left;
ShowsTimeLeft="False"brings the percentage back). -
Arc Mobile languages:
TKCode.Arc.Mobilenow has a language catalog (TextEditMenuLangResourceKind, en-US, zh-CN,
zh-TW). An app that enablesUseArcMobile()and lists another language inUseLanguagesgets the startup error that
lists missing text; keep to those three languages until the package ships that language. -
Deprecated members keep working; move to the new names when convenient (see Deprecated).
Added
TKCode.Arc.Markdown(new package):Markdown,MarkdownHighlightPlugin,ChatThreadandChatComposer, moved
here fromTKCode.Arcwith their tokens and themes. Register withUseArcMarkdown(). It depends on StreamMark, not
on TextMate.TKCode.Arc.Highlighting(new package): the TextMate highlighting ofCodeBlock, theRichTextEditorcode
blocks and Markdown's fenced code, in Arc's role palette as before. Register withUseArcHighlighting(). The MSBuild
propertyArcHighlightLanguageskeeps only the grammars a trimmed publish lists, for example
<ArcHighlightLanguages>csharp;json;xml</ArcHighlightLanguages>; an unknown name warns (ARCH001). Withcsharp;json
the grammars assembly goes from 6.7 MB to 0.7 MB. It applies wherever ILLink trims (PublishTrimmed, WebAssembly), not
to Native AOT.TKCode.Arc:LabelPlacementandLabelWidthon the standalone fields, and the inherited attached properties
Field.LabelPlacement/Field.LabelWidth, put the label in a column left of the frame
(#131);UnavailableCaptionButtons="Hide"onArcWindow,
TitleBarandWindowCaptionButtonshides the caption buttons a window cannot use
(#130), andTitleBargainsShowMinimizeButton,
ShowMaximizeButtonandShowCloseButton;UserMenu.StatusLabel,ThemeLabel,SignOutLabelandSigningOutLabel;
ColorPicker.TriggerChipPart,TriggerNamePartandTriggerHexPart.TKCode.Arc.Blocks:MonthCalendar(Screens › Calendars), a calendar app screen around a month;
BlockCatalog.ScreenGroupsand theAgentsgroup.TKCode.Arc.Special:SlideToConfirm(Loaders), a slider you drag to the end to confirm an action;WindowRange
(Sliders), a movable window over a live area chart;CursorTrailDraw(Cursor), a sketching whiteboard; the new members
of the rebuiltKeycapKeyboard,PrizeWheel,BranchGraph,SandText,SplitBarandTocProgress.TKCode.Arc.Mobile:TextEditMenu, the long-press edit menu (Cut, Copy, Paste, Select All) ofTextField,
Searchbarand anyTextBox(#137).TKCode.Arc.Terminal: libghostty-vt for Android (arm64, x64, arm; API 29 and later) and iOS, soTerminalView
runs on phones, with or without NativeAOT (#136).- Gallery (AIDotNet/ArcGallery): docs and demos for every new component in
English, 简体中文 and 繁體中文.
Changed
- Breaking:
Markdown,MarkdownToken,MarkdownHighlightPlugin,ChatThread,ChatThreadToken,
ChatComposerandChatComposerTokenare in theTKCode.Arc.Markdownassembly, and highlighting needs
TKCode.Arc.Highlighting(see Upgrading from 1.1.0). A highlighter that is enabled after aCodeBlockwas created
colors it on its next change. TKCode.Arc.Blocks,TKCode.Arc.SpecialandTKCode.Arc.A2UIdepend on both new packages, so they look and behave
as before.KeycapKeyboard,PrizeWheel,BranchGraph,SandText,SplitBarandTocProgresswere rebuilt after their Arc
designs; the Blocks catalog groups and source folders follow uiarc.dev's sidebar (details in1.1.1-preview.1).
Fixed
TextFieldandSearchbar(TKCode.Arc.Mobile) had no long-press menu, so on a phone there was no way to paste
into them (#137).TerminalViewon Android: the default font list falls through to monospace, and the cell metrics follow the screen's
scaling (#136).DataGrid: the filter row's gutter follows a light/dark switch at run time
(#135).ExpandableCardno longer cuts its shadow off at the card's edge
(#129).UserMenufollows the app's language (#123).ColorPicker: an empty label no longer reserves a blank line, and the morphing header folds back onto the actual
trigger.- Video on Android (
TKCode.Arc.Video.Native): a Java exception from the platform puts the player inFailedinstead of
closing the app. - Charts: a
LineChartnarrower than its tooltip no longer throws;DonutChartandBarChartin aCardno longer
clip their large numbers.
Deprecated
Nothing is removed. Each of these keeps working, is marked [Obsolete] and stays for at least two stable releases; it can
only be deleted in a new major version.
SandText.Trigger: useIsDigEnabled.SandText.Drift,Duration,DistanceandMaxGrains: no longer change anything; useDigRadiusand
GrainSize.BranchGraph.IsNewestFirst: no longer has an effect, the newest commit is always on top. Remove it.BranchGraphLabels.Ready,Drawing,Paused,Done,Speed,ReadyCaption,FirstCaption,CommitCaption,
BranchCaption,MergeCaption,TagCaptionandDoneCaption: no longer shown; useBeforeSummary,
MergeSummary,RebaseSummaryandSquashSummary.
Known limitations
TKCode.Arc.Mobile.iOS(the iOS edit actions for Avalonia text boxes) is not on NuGet yet, because CI does not pack
iOS projects; reference the project for now.