prism_kit 2.0.0

One dependency, 51 adaptive Flutter components on a shared design system: data tables, calendar, tabs, toasts, forms, controls, loading and empty states, markdown, an AI chat client, and more.

Changelog

2.0.0

Breaking

• PaletteExtractor.fromImage(ui.Image) is replaced by PaletteExtractor.fromRgbaBytes(Uint8List rgba, {required int width, required int height}). The palette subsystem now works on pure byte inputs, which keeps it functional on web and lets callers decode images however they like. Migration: decode your image to raw RGBA bytes once and pass them with the dimensions.

Fixed

• The three palette tests that were skipped pending on-device rasterization now run against the byte path and pass (881 total).

Updated

• The example gallery now covers every shipped component (42 demos).
• README install version and docs refreshed.

1.7.0

Added

• Five components (57 -> 62), covering analytics and attachment UX:
  • PrismBarChart — token-styled bars, max-bar highlight, value labels, screen-reader sentence
  • PrismLineChart — gradient fill, points, gridlines, auto-thinned x-axis labels, semantic role colouring
  • PrismDonutChart — gap-separated arcs, centre label, percentage legend
  • PrismFilePickerTile — attachment chips with extension/size/count validation and removal. Prism brings the UX, you bring the picker (file_picker) — no new transitive dependencies
  • PrismImagePickerTile — byte-backed thumbnails, remove buttons, count cap; pairs with image_picker
• Gallery demos for all five (31 -> 36)

1.6.0

Added

• Six components, completing the AI conversation stack and closing input gaps:
  • PrismAiMessageBubble — streaming markdown chat bubble with tool-call chips, copy and regenerate actions, thinking state, and screen-reader announcements
  • PrismAiThinkingIndicator — pulsing reasoning dots that go static and announce themselves under reduced motion
  • PrismPromptComposer — prompt input with suggestion chips, a streaming-aware send button, and self-clearing behaviour
  • PrismColorPicker — HSV saturation/value box, hue bar and hex input, with zero new dependencies
  • PrismOverlayStack — onboarding spotlight tour with anchored tooltip cards, step dots, and a skip button
  • PrismSparkline — inline trend line with gradient fill and semantic colouring for lists and tables
• Gallery demos for all six new components

Fixed

• Analyzer cleaned to a single unavoidable deprecation info (see 1.5.1)

1.5.1

Fixed

• Removed a write-only variable and dead code flagged by the analyzer
• Braced single-statement conditionals in PrismGuard for lint consistency

Documented

• README now documents the AI-era toolkit (PrismRateLimiter, PrismGuard, StreamingJsonParser, PrismMessageMemory, PrismPromptChain, PrismResponseCache, PrismAgentRunner) with usage examples
• Component count, test count and install version corrected throughout

1.5.0

Added

• Nine components covering the controls, states and media every app needs:
  • PrismSlider, PrismSwitch, PrismCheckbox — controls with Prism tokens and semantics labels
  • PrismDropdown — dropdown field with a label, icon, validation and semantics
  • PrismRefreshIndicator — pull-to-refresh with a configurable colour
  • PrismFabMenu — expanding floating action button menu
  • PrismLoadingOverlay — full-screen scrim with a spinner and message
  • PrismEmptyState — friendly empty state with icon, title, subtitle and action
  • PrismLinearProgress, PrismCircularProgress — progress bars with labels
  • PrismCard, PrismTile, PrismDivider — card and tile with tokens
  • PrismZoomableImage — pinch-to-zoom with placeholder and error handling
  • PrismCarousel — horizontally scrolling slides with a dot indicator
  • PrismDividerWithLabel — divider with a centred label
  • PrismLottie — Lottie metadata reader (dimensions, frame rate, duration) and a preload cache. Prism does not include a Lottie renderer; use lottie or flutter_lottie for that.

1.4.2

No library changes. This release corrects one thing the 1.4.1 release claimed but did not contain.

Fixed

• The documentation link was never actually added. The 1.4.1 commit message said it was, and the version was published from that commit, but the field is absent from pubspec.yaml and pub.dev therefore shows no Documentation link. It is present now and verified, pointing at the landing page with the live gallery and API reference behind it.

A published version cannot be edited, so correcting it needs a release.

1.4.1

No library changes. This release updates the package metadata so the pub.dev listing describes what the package actually contains.

Changed

• The description now leads with the component count and the premise instead of a long enumeration: "One dependency, 34 adaptive Flutter components on a shared design system". The previous text listed 17 components and had drifted as the library grew.
• A documentation link is now set in pubspec.yaml, so pub.dev shows a Documentation link pointing at the live gallery and the API reference.
• The README links the live gallery.

Infrastructure

• The Pages workflow now provisions GitHub Pages on its first run rather than failing with a 404 when the repository setting has not been enabled yet.

1.4.0

Added

• Six components: PrismCalendar (month grid with single, range and multiple selection, event markers, and parameterised month and weekday names for localisation), PrismTabs, PrismSegmentedControl, PrismAccordion, PrismRating and PrismBadge. All six adapt to the window rather than overflowing, and all announce their state to assistive tech.
• prismTheme(...) — builds a fully configured ThemeData in one call: seeded scheme, brightness, and a token preset, extending any base theme rather than replacing it.
• Token presets — PrismTokenPresets.preset(density:, shape:, motion:) plus technical, friendly and editorial. Three orthogonal choices rather than deriving spacing from a colour, because a brand colour says nothing about how much padding a table row wants.
• PrismDebugOverlay — a live design-system inspector showing the active tokens, window class, brightness and reduced-motion state. Defaults to disabled, so enabled: kDebugMode makes it release-safe.
• PrismStructuredOutput — extracts JSON from a model reply that is fenced, prefixed with prose, or trailed by a closing remark, with a balanced-brace scanner that ignores delimiters inside string literals. Never throws.
• PrismContextBudget — estimates conversation cost, trims the oldest turns first, always keeps the system message and the newest turns, and reports a usage ratio for a context meter.
• context.prismReduceMotion.

Fixed

• PrismDebugOverlay used a default Stack, which sizes to its largest non-positioned child; wrapping a small widget left the panel outside the stack's bounds and untappable. Now StackFit.expand.
• The PrismMotion extension was renamed PrismMotionContext to free the name for the motion-preset enum.

1.3.0

Added

• PrismSyncStatus — a compact sync indicator with six phases (idle, pushing, pulling, offline, failed, paused), progress, a retry action that only appears on failure, and a live region so a failed sync is announced. Prism takes no sync dependency: PrismSyncSnapshot is a plain value type and the adapter from flutter_local_first is a compiler-checked switch.
• package:prism_kit/testing.dart — pumpPrism, expectNoOverflow and pumpPrismWithSemantics, the same helpers Prism's own suite uses. pumpPrism installs a real viewport (a bare MediaQueryData() reports size zero, which silently makes adaptive components take their compact path), the design system, brightness, text direction and reduced-motion setting.
• context.prismMotion(...) and context.prismReduceMotion for honouring the platform's reduce-motion setting.
• docs/VERSIONING.md — semantic versioning and deprecation policy, noting that visual defaults and accessibility semantics are both API.
• CI, publish and docs workflows. Publish runs on a v* tag, verifies the tag matches pubspec.yaml, and skips cleanly when no credentials are present. Docs builds the API reference plus the web gallery and deploys both to Pages.
• theme_contrast_test.dart — the semantic palette is verified against WCAG AA (4.5:1 text, 3:1 accents) across ten brand seeds in both brightnesses.
• component_matrix_test.dart — 184 cases pumping every component at 320 px and 1600 px, in light and dark, in LTR and RTL.
• accessibility_test.dart — 15 tests covering live regions, hidden decorative content, touch targets, sortable-header semantics, reduce motion and RTL rendering.

Changed

• Every animated component now honours reduce motion, routing its duration through context.prismMotion(...). Previously one of 28 areas respected it.
• PrismSkeleton is wrapped in ExcludeSemantics: announcing placeholders is noise for a screen reader user.
• PrismToast and PrismStateView are live regions, so state the user did not trigger is actually announced.
• PrismDataTable sortable headers announce sortability, the current direction and the next action.
• PrismPaginatedList announces loading and end-of-list.
• The chip remove affordance meets the 32 dp minimum touch target; it was roughly 19 px.

Fixed

• PrismChipInput overflowed by 48 px when a tag was wider than the field, because the chip label was a bare Text that could not shrink. It is now Flexible with ellipsis, and the untruncated value still reaches assistive tech. Found by the new component matrix.

1.2.0

A consistency release: the design system introduced in 1.1.0 now actually governs the whole library.

Changed

• Every component reads PrismTokens and PrismColors. Previously the original 17 components ignored the design system, so overriding tokens had no effect on toasts, banners, forms, search, settings, pagination, changelogs, code views, scaffolds, master-detail, dialogs or state views. A single ThemeData.extensions override now restyles the entire app.
• Style classes (PrismStateViewStyle, PrismBannerStyle, ChangelogStyle, PrismCodeViewStyle, PrismSearch) gained a resolve(BuildContext) method that fills unset fields from tokens, and their visual fields became nullable so "unset" is distinguishable from "deliberately zero".
• PrismStateViewStyle gained iconSize, padding, gap and retryLabel.
• PrismBannerStyle, ChangelogStyle and PrismCodeViewStyle field defaults are now token-derived rather than literal.
• PrismAdaptiveScaffold and PrismMasterDetail transition durations default to PrismTokens.durationMedium; PrismAdaptiveScaffold accepts token-driven breakpoints.
• PrismSearch.debounce defaults to PrismTokens.durationMedium.
• PrismBreakpoint.resolve accepts custom thresholds; the previous behaviour is available as resolveStandard.

Added

• 15 design-system tests that install deliberately unusual tokens and assert components read them, including light/dark colour divergence, semantic-role distinctness, token-driven breakpoints, and graceful behaviour when no tokens are registered at all. A hard-coded radius, duration or colour now fails CI.
• CONTRIBUTING.md documenting the two rules that matter and how to add a component.
• GitHub Actions workflow running formatting, strict analysis, the full test suite and an example build.
• Issue templates (bug, feature) and a pull request checklist.

Improved

• The example gallery is now searched-indexed with keywords, has a theme-mode toggle, and has a live token override so you can watch every component adopt a non-default token set at once. It also builds for the web.

Fixed

• PrismColours.resolve now derives error and onError from the theme rather than leaving them transparent.
• Attachment progress no longer emits 100% twice.

1.1.0

Added

• Design system: PrismTokens (spacing scale, corner radii, motion durations, breakpoints, control height) installable via ThemeData.extensions, and PrismColors (semantic success/warning/error/ info roles plus raised and sunken surfaces) derived from any ColorScheme.
• PrismSkeleton — shimmering placeholders (text, card, tile list, circle) that honour the platform's reduced-motion setting.
• PrismAvatar — image avatars with deterministic initials fallback, presence dots, badges, borders and accessibility labels.
• PrismChipInput — tag entry with delimiter/paste splitting, duplicate rejection, max limits, validators and a suggestion overlay.
• PrismOtpField — OTP/PIN entry with paste, auto-submit, digit grouping, obscuring and native oneTimeCode autofill.
• PrismTimeline — vertical event timeline with connectors, semantic roles, rich per-entry content and optional mirrored layout.
• PrismStepper — wizard progress that is horizontal on wide windows and a compact "Step X of Y" header with a progress bar on phones.
• PrismDataTable — sortable table on desktop that becomes labelled cards on narrow windows.
• PrismCommandPalette — ⌘K launcher with fuzzy search, grouping and full keyboard navigation.
• PrismAdaptiveSheet — bottom sheet on phones, centred dialog on desktop, from one call, with typed action results.
• PrismConnectionBanner — offline/online banner with settle delay, reconnected flash, retry action and live-region announcements.

Changed

• README rewritten with copy-pasteable usage documentation for all 27 components, a platform support matrix and a design-system section.
• Example gallery expanded to 26 interactive demos.
• Test suite grown from 252 to 385 tests.

1.0.0

• Initial consolidated release: merges prism_adaptive_dialog, prism_adaptive_scaffold, prism_ai, prism_banner, prism_changelog, prism_code_view, prism_form, prism_image, prism_markdown, prism_master_detail, prism_pagination, prism_palette, prism_search, prism_settings, prism_state_views, prism_toast and prism_updater into a single package.