pub.dev · #4713 most downloaded on pub.dev

artisanal_widgets

0.4.23.4K downloads/mokingwill101/artisanal ↗New releases in your daily digest, changelog included.

Widget system for composable TUI components, built on top of the artisanal terminal toolkit.

Last release 24 days ago
14 Sep 2026
Ships fairly regularly
a new release about every 5 weeks
Nearly every release is documented
notes for 7 of 7 stable releases
Nothing withdrawn
no release was ever pulled
7 months old
7 releases · first in 2026

Release timeline

7 releases since 2026

2026

20262026

One column per month.

Releases

0.4.214 Sept 20262 sources agree
Require Dart SDK 3.13.0 or newer.
Require Dart SDK 3.13.0 or newer.

Added

Added BoxConstraints.enforce to compose child size requests within
authoritative parent bounds without inverted constraint intervals.

Added opt-in production UV renderer capture to WidgetTester via
enableRenderer: true, exposing raw ANSI output through rendererOutput.
Use altScreen: true for full-viewport capture instead of inline rendering.
The default renderer-disabled test behavior is unchanged.

Added opt-in enableNativeFrameCapture and latestNativeFrame for structured
final UV cell snapshots. artisanal_capture uses this through
WidgetCaptureMode.renderedFrame; drawable payloads are not represented.

Added a model-backed interactive TreeView.model surface for Artisanal's
shared TreeModel, including focus-aware keyboard navigation, pointer
expansion and activation, custom row builders, bounded scrolling, and
scrollbars. The original TreeView(nodes: ...) API remains compatible.

Added ResizableSplitView, a reusable horizontal or vertical split with a
pointer-draggable separator and minimum pane extents.

Added controlled extents and zero-width/zero-height hidden separators to
ResizableSplitView, allowing panes such as integrated terminals to retain
mounted state while being resized or collapsed.

Changed

Stack now reuses clean child layout and paint output during subtree-only
repaints, reducing work for scrollbars and other frequently updated overlays.

Stream eligible full-size styled container content directly into its target
canvas, avoiding a temporary cell grid and copy. Reusable background and
gradient fill templates now update destination cells without cloning.

Added idempotent WidgetApp.dispose() teardown for mounted element trees.
WidgetTester and runWidgetApp now explicitly release widget state and
inherited dependencies without coupling the core Program model contract
to arbitrary model disposal.

LayoutBuilder now builds from incoming parent layout constraints rather than
MediaQuery viewport dimensions. Use MediaQuery directly for viewport-based
decisions; unbounded parent axes remain unbounded.

Stack now rejects unsupported Overflow.visible instead of silently clipping.
Use an ancestor Overlay for content outside a component's bounds.

Explicit Container, SizedBox, and flex extents now respect parent minimum
and maximum constraints before laying out children. A small application-root
widget should use an Align/Center host to loosen the viewport's minimums.

ConstrainedBox maximum bounds now limit a child's natural size rather than
forcing it to fill the maximum. Use minimum or tight constraints for expansion.

Added showChrome to TextEditor and CodeEditor so workbenches that
already provide tabs and status bars can use an unboxed editor surface.

Added showDiagnosticBanner so unchromed editors retain reusable diagnostic
feedback by default while application workbenches can provide their own.

Updated OpenCode theme selected-row colors to retain readable text contrast
instead of using the active border color as a row background.

Fixed

Reuse document layout and the allocated scrollbar gutter during offset-only
scrolling, avoiding repeated width reflow while preserving paint-wrapper
updates, resize handling, and content invalidation.

Prevent layout-example failures on unbounded constraints, provide a narrow-pane
hint for effect scenes, and bound the vertical split-view showcase inside its
scrollable page. Add startup, keyboard, and resize smoke coverage for examples.

Preserve layout-built child state across inherited-data updates and initialize
children mounted during a frame through the normal runtime command loop.

Align offsets and painting with measured child allocations, resolve explicit
bounds before child layout, and retain mounted geometry in legacy view().

Resolve Stack sizes before positioned stretches, preserve signed negative
insets, and implement StackFit.passthrough constraint forwarding.

Allocate all available integer cells among tight flex children deterministically,
reserving loose children's share caps. Reuse measured child sizes for offsets
and paint instead of independently redistributing space in each phase.

Resolve container dimensions before deflating padding, borders, and margins;
clamp excessive margin painting to the allocated outer box.

Keep offstage navigator entries invisible and excluded from pointer hit testing
even under tight viewport constraints, while preserving their mounted state.

Count list separators by additional rendered rows: a single newline joins
items without adding a phantom row to content extents and hit-test offsets.

Dispose the previous WidgetTester program before remounting and reset
terminal capture offsets for the new mount.

Preserve the caller's ThemeScope when opening dialogs through
NavigatorState.showDialog, and keep the default modal barrier transparent
as documented instead of painting over the application.

Catch render failures in the diagnostic error screen, preserving Copy and
Dismiss/retry behavior. If recovery fails too, report both errors in a bounded
fallback with a handled Ctrl+C quit path.

Unregister inherited-widget dependents on unmount, preventing providers from
retaining removed modal/input subtrees or re-dirtying them on later updates.

Dispose temporary container, stack, and scrollbar composition canvases,
releasing owned cell references without waiting for garbage collection.

From the same repository

kingwill101/artisanal

artisanalpub.devA full-stack terminal toolkit for Dart featuring Lip Gloss styling, Bubble Tea TUI architecture, and Ultraviolet rendering.

0.4.07 Sept 20262 sources agree

Added example/text_style , a runnable catalog covering immutable updates, Style composition, span inheritance and resets, selectable text, decorations

Added

Added example/text_style, a runnable catalog covering immutable updates,
Style composition, span inheritance and resets, selectable text,
decorations, and the separate ASCII-art font model.

Changed

Moved command-palette item and scored-match primitives plus deterministic
matching, selection, and visible-window calculation into artisanal; the
widget keeps compatibility aliases, mouse/focus/theme chrome, and
delegates ranking plus scrolling to the shared controller.
Forwarded RenderMetricsInjector custom entries to Artisanal's universal
program developer tools overlay while preserving the existing widget-local
metrics stream.
Removed WidgetApp's separate built-in metrics overlay and F12 handler.
Widget hosts now enable program diagnostics by default; configure visibility,
position, and shortcuts with ProgramDiagnosticsOptions.
Routed framework internals through Artisanal's narrow runtime entrypoint so
widget app imports do not load unrelated native Markdown dependencies.
Kept both app.dart and the complete widgets.dart public surface
JavaScript-compilable, including Markdown text rendering with browser image
placeholders.
Reduced the published package archive by excluding repository-hosted demo
media and generated GitHub CLI web artifacts.
Moved runWidgetApp, serveWidgetApp, Transport, and widget-oriented
program defaults into the package-owned app.dart entrypoint.
Moved the lower-level chart-painter grid demo into this package because its
application shell uses the widget framework.
Switched the observer primitives (Listenable, ValueListenable,
ChangeNotifier, ValueNotifier, VoidCallback) to package:listen
(listen: ^1.0.1). src/widgets/animation/listenable.dart is now a
scoped compatibility re-export of those types; new code should import
package:listen/listen.dart directly. Public API via
package:artisanal_widgets/widgets.dart keeps the same names.
Aligned ChangeNotifier semantics with package:listen/Flutter: hasListeners
and notifyListeners are @protected (notifyListeners remains
@visibleForTesting). Subclasses calling them internally are unaffected;
only direct external callers must route through a subclass wrapper.
Listener exceptions route through Listenable.onError, and dispose()
during notification is rejected by package:listen (asserts in debug).

Removed

Removed the unused slot registry, plugin mounting, mixed slot region, and
remote plugin surface widget APIs and examples.

Fixed

Fixed a startup panic (Unsupported operation: Infinity or NaN toInt)
when a scroll viewport had unbounded height: RenderSingleChildViewport
now shrink-wraps to its content height instead of reporting an infinite
size, and the scrollbar example bounds its Scrollbar with an explicit
height like the scroll example does.
Fixed a reentrant-publish crash (Bad state: Cannot fire new event) in
RenderMetricsInjector: publishes made from inside dispatch (e.g. the
metrics listener synchronously triggering another render) are deferred
one microtask instead of throwing.
Ensured ReloadFileWatcher.watch waits for native watcher installation before
returning, so immediate file changes are not missed.
Preserved TextStyle decoration colors through text rendering copies.
Preserved TextStyle presentation across soft-wrapped continuation lines
and made plain and rich Text wrap content before resizing Style borders
and padding.
Made the text-style ASCII-font comparison compact and responsive.
Kept dividers as single-row structural elements when their requested width
exceeds the available layout width.

Open source →

0.2.027 Mar 2026

artisanal_widgets v0.2.0

Open source →

Additional notes

Added

Added a stable package:artisanal_widgets/widgets.dart entrypoint for the high-level widget framework surface.
Added stable package:artisanal_widgets/charting.dart and package:artisanal_widgets/selection.dart entrypoints for the supported charting and text-selection surfaces.
Added ImageAutoMode.sessionCapabilities so Image(renderMode: auto) can follow terminal version and device-attribute reports from the active session instead of only using the local process environment.
Added a dedicated example/tooltip_trace demo with TuiTrace instrumentation and built-in replay/trace conversion flags so tooltip hover behavior can be recorded, converted, and replayed during debugging.
Added external diagnostics sources and listenable diagnostics bindings for editor widgets, so demos and downstream apps can drive diagnostics without custom text-pattern glue.
Added per-widget selection highlight overrides for the shared read-only selection surfaces, so mixed documents can use different selection palettes within one SelectionArea.
Added span-level selection highlight overrides for SelectableRichText, so one shared rich-text selection can mix palettes within a single widget.

Changed

Fixed FadeModalBarrier so content-backed barriers dim the child in place instead of painting an opaque black layer over the full view, while keeping the standalone overlay fallback for empty-child route barriers.
Improved Tint blending so FadeTint and content-backed FadeModalBarrier widgets fade proportionally toward the target color instead of snapping between no effect and a full tint.
Updated AnimatedTint to use the shared blendColor() helper so animated widget tinting follows the same color interpolation path as the rest of the style system.
Fixed Drawer backdrops so open drawers dim the background content in place instead of blacking out the full terminal view.
Made Modal and Drawer honor backdropColor through the shared tint path instead of ignoring the configured color while dimming the background.
Clarified the package guidance so artisanal_widgets remains the primary widget dependency, while the package:artisanal/... widget entrypoints are documented as optional umbrella convenience re-exports.
Hosted browser/socket runner helpers now default Image(renderMode: auto) to ImageAutoMode.sessionCapabilities instead of forcing the portable fallback, so remote terminals can upgrade image rendering from live session capability reports.
Added hosted-runner regression coverage for session-capability image probing by default and for portable-fallback mode suppressing those extra image capability requests.
Improved shared read-only selection in scrollable mixed views, including upward and downward edge auto-scroll, mouse-wheel scrolling during drag selection, and row-wide drag starts from surrounding whitespace.
Kept package:artisanal_widgets/artisanal_widgets.dart as the broader experimental compatibility surface while stabilizing the primary widget/app/layout/input/navigation APIs.
Updated the widget docs to prefer the stable package:artisanal_widgets/widgets.dart import path.
Updated the package README and focused examples to prefer the stable top-level entrypoints over the broad compatibility import.
Updated the remaining widget examples and tooling to import the stable package:artisanal_widgets/widgets.dart entrypoint instead of the broad compatibility surface.
Made Tooltip float from an Overlay ancestor instead of reflowing surrounding layout, and updated the gallery example to host its overlay demos through a root overlay so hover tooltips behave like anchored popups.
Made floating Tooltip fall back to the latest hover pointer position when anchor geometry is not ready yet, avoiding delayed tooltip popups in live sessions.
Made floating Tooltip request an immediate repaint on hover enter and exit so overlay tooltips appear and disappear without waiting for a later event.
Made floating Tooltip hit-test transparent so it no longer blocks later mouse hover and click interaction underneath.
Fixed GestureDetector hover handling so commands returned from onEnter and onExit are dispatched through the widget pipeline, allowing overlay-backed hover widgets like Tooltip to repaint immediately in live sessions.
Fixed Stack hit-testing so positioned children use their painted offsets during hit testing, which restores immediate hover interaction for anchored overlays like Tooltip.
Updated the flagship widget app examples to use the stable umbrella imports from package:artisanal/app.dart and package:artisanal/widgets.dart.
Updated the editor showcase examples to use the stable umbrella imports from package:artisanal/app.dart, package:artisanal/editors.dart, and package:artisanal/widgets.dart.
Updated the shared text input test suites to use the stable package:artisanal/widgets.dart and package:artisanal/testing.dart entrypoints.
Updated the flagship component and showcase tests to use the stable package:artisanal/widgets.dart, package:artisanal/testing.dart, and package:artisanal/app.dart entrypoints.
Updated the editor showcase and HelpView regression tests to use the stable package:artisanal/testing.dart and package:artisanal/widgets.dart entrypoints.
Updated the app-shell, reload, and core HelpView tests to use the stable package:artisanal/app.dart, package:artisanal/widgets.dart, and package:artisanal/testing.dart entrypoints.
Updated the status, progress, metric, and key-hint component tests to use the stable package:artisanal/widgets.dart and package:artisanal/testing.dart entrypoints.
Updated the button, toggle, slider, dropdown, and popup-menu component tests to use the stable package:artisanal/widgets.dart and package:artisanal/testing.dart entrypoints.
Updated the tree, tab, split-view, scroll-area, and list-navigation component tests to use the stable package:artisanal/widgets.dart and package:artisanal/testing.dart entrypoints.
Updated the accent-panel, chip, tooltip, accordion, expansion-tile, and hyperlink component tests to use the stable package:artisanal/widgets.dart and package:artisanal/testing.dart entrypoints.
Updated the data-table, list-tile control, and select/pagination component tests to use the stable package:artisanal/widgets.dart and package:artisanal/testing.dart entrypoints.
Updated the command palette, modal/drawer, and git-diff component tests to use the stable package:artisanal/widgets.dart and package:artisanal/testing.dart entrypoints.
Updated the frame border regressions and the OpenCode home layout showcase test to use the stable package:artisanal/widgets.dart and package:artisanal/testing.dart entrypoints.
Updated the remaining card/panel/frame regression test to use the stable package:artisanal/widgets.dart and package:artisanal/testing.dart entrypoints, and to accept stabilized truecolor card-surface rendering.
Updated the foundational widget and basic layout tests to use the stable package:artisanal/widgets.dart and package:artisanal/testing.dart entrypoints.
Updated the main widget gallery example to enable passive all-motion mouse tracking so hover-driven overlays like the tooltip preview work in real terminals.
Clarified the widget docs and tooltip API docs so passive hover behavior explicitly points callers to MouseMode.allMotion and the widget runners that already default to it.
Updated the widget-friendly runner defaults to disable core startup probes so early hover-driven UI feedback, such as tooltips in the gallery example, is not delayed behind terminal capability probing.
Added shared Tooltip lifecycle trace events for hover transitions, overlay insert/remove, and overlay visible/hidden timing so tooltip traces can measure when the popup is actually requested and rendered.
Fixed hit-test motion bubbling so nested hover handlers all see the first in-bounds mouse move, which restores immediate Tooltip show timing when the tooltip target contains its own MouseRegion.
Stopped floating Tooltip from invalidating its overlay entry during every build while hovered, which eliminates repaint churn that could delay later mouse motion and hide updates.
Stopped Tooltip.didUpdateWidget() from resyncing the floating overlay on unrelated parent rebuilds, so hovered tooltips no longer trigger periodic overlay rebuilds from app-shell updates.

Open source →

0.1.019 Feb 2026

Added a transport-independent VirtualTerminal screen model with incremental ANSI/CSI parsing, cursor movement, erasure, scrolling, resizing, SGR styli

Added

Added a transport-independent VirtualTerminal screen model with
incremental ANSI/CSI parsing, cursor movement, erasure, scrolling, resizing,
SGR styling, UTF-8 decoding, and grapheme-aware output.
Added TerminalInputEncoder for translating Artisanal key events into
conventional xterm input sequences.
Added the core package:artisanal_pty/artisanal_pty.dart entrypoint for
plain Artisanal and TEA applications.
Added the package:artisanal_pty/widgets.dart entrypoint with TerminalView
and the pty2-backed PseudoTerminalView for artisanal_widgets
applications.
Added conditional platform support so non-IO targets receive an informative
placeholder instead of importing pty2.
Added Linux, macOS, Windows, and web package platform declarations.
Added an interactive example that embeds the user's default shell.

Fixed

Quit the widget application when its child PTY exits, with an opt-out through
PseudoTerminalView.quitOnExit.
Ignore queued output from a previous PTY after PseudoTerminalView switches
to a replacement process.

Open source →

Additional notes

Require Dart SDK 3.13.0 or newer.
Bound CLI reads before decoding and reject nonregular inputs and output aliases
of the source, including symlinks and hardlinks.
Index gallery end markers once per scenario while preserving substring
matching, with bounded index sizes and deduplicated markers.
Release temporary cells and buffers throughout capture conversion and export,
including partial failures.
Add an attributed, checksum-pinned snapshot of Dart SDK issue 64170 as a
real-world Markdown bench, including exact status-cell preservation and
hidden-comment checks at 32/64/80/96/120 columns.
Add detached, versioned terminal cell captures with validated JSON round trips.
Capture UV buffers, ANSI-styled views, and widgets at deterministic dimensions.
Export PNGs using Ultraviolet's native software raster backend and
package:image, with explicit TrueType font faces and fidelity diagnostics.
Add an Artisanal-based CLI for Markdown, styled ANSI, and saved captures.
Export script-free HTML previews containing the exact rendered PNG.
Add a multi-width gallery command with an HTML index, render manifest,
source/ANSI/cell evidence, overflow diagnostics, and end-marker checks.
Add 18 focused Markdown scenarios alongside the original nested quote case.
Accept both standard BEL and ST OSC 8 terminators; wrapped hyperlinks no
longer fail capture validation. Raw BEL and unsafe hyperlink payloads remain
rejected.
Consolidate widget and runtime capture on detached UV cell buffers:
captureWidget supports WidgetCaptureMode.renderedFrame, and
captureProgramFrame requires a recorded nativeFrame instead of treating
diagnostic snapshot JSON as lossless.
Reject native-frame captures containing drawable payloads rather than
silently replacing terminal graphics with text.

Open source →

Additional notes

Added

Initial release of artisanal_widgets.
Flutter-style terminal widget system built on top of artisanal.
Core widget framework, layout primitives, focus/gesture/input systems, and component library.
Charting widgets, scroll/selection support, and testing harnesses for TUI widget behavior.

Open source →