lark 0.1.1

A light, elegant Dart web framework with file-based routing, reactive state, and SSR/SSG support.

Changelog

All notable changes to this package are documented here.

0.1.1 21 Feb 2026

Added

• Unified Web Platform: Merged lark_web functionality seamlessly into the lark core framework for simplified web and Tauri workflows. This consolidation reduces dependency complexity and ensures identical behavior across all web-based targets.
• Multi-Platform DOM & Theme bindings: Added use_dom, use_dom_vm, use_dom_web, and theme_dom_vm/theme_dom_web to abstract DOM and theme manipulations across web and VM environments. These abstractions provide a stable foundation for writing cross-platform components without relying on environment-specific APIs.
• Advanced VNode Capabilities: Introduced scrollController, overlayConfig, inputFormatters, TextInputAction, and portal support (portalContainer) to virtual DOM nodes. These additions bring Flutter-like control to web elements, enabling complex interactions like formatted inputs and robust overlays.
• Dev Server Enhancements: The development server now natively manages the Tailwind CSS compilation process and provides granular build event tracking and prioritization. This results in a significantly faster and more reliable hot-reload experience during local development.

Changed

• UI Components Extracted: Extracted higher-level UI components (e.g., card, dialogs, disclosure, form, icons, scaffold, button, etc.) out of the core frame into a dedicated lark_ui package. This enforces a strict boundary between the core reactive framework and the opinionated UI toolkit, keeping the core lightweight.
• Reactivity Engine Optimization: Refactored the core runtime for better dependency tracking (subscriber.trackDependency), advanced component caching (componentSignal, onContextUpdate), and more efficient DOM granular updates. The engine now avoids unnecessary re-renders and memory leaks, significantly boosting performance in complex component trees.

Fixed

• Google Fonts Injection: Fixed fonts not loading properly in the development server. Fonts configured in LarkConfig are now accurately injected into the local index.html during the dart run lark dev process.
• Improved CSS Scoping: Tighter CSS token matching and proper :host selector targeting for better component isolation. This prevents encapsulated component styles from bleeding out into the global scope or affecting unrelated components.
• Component Reactivity Fixes: Resolved state synchrony issues in DomPatcher and ComponentVNode ensuring UI instantly updates on state mutations. Data flows are now completely reliable, eliminating bugs where visual states would lag behind internal reactive values.

0.1.0 18 Feb 2026

Initial public release of the unified lark package.

Added

• Core component model with lifecycle hooks (build, onMount, onUnmount)
• Fine-grained reactivity:
  • ref, computed, effect, batch, untrack
• Store system:
  • defineStore, clearStore, clearAllStores
• Router system:
  • RouteCollection, route(...), dynamic params (:id), wildcards (*)
  • useRouter, useRoute, useParams, useQueryParams
  • RouterLink, RouterOutlet, RouterComponent
• File-based route/content code generation via CLI helpers
• UI primitives/components including layout, forms, media, feedback, dialogs, cards, and icons
• Composables:
  • fetch/mutation (useFetch, useLazyFetch, usePost)
  • pagination/async (usePagination, useInfiniteScroll, useAsync, usePolling)
  • state/storage (useToggle, useDebounce, useThrottle, usePrevious, useLocalStorage, useSessionStorage, useCookie, useDarkMode)
  • query cache (useQuery, useMutation, useLazyQuery, queryClient)
• SEO/head APIs:
  • useMeta, useSeo, useHead, typed head entries
• SSR runtime:
  • renderToHtml, request-scoped router/head/data collection, state serialization
• Rendering helpers:
  • renderToString, renderPage, hydration APIs
• CLI commands:
  • create, dev, build, start, serve, generate, codegen, doctor, clean, tailwind setup
• Build pipeline support for:
  • static output + route pre-rendering
  • SSR server template + binary compilation
  • JS/WASM web compilation modes