VyUI alpha

Changelog

What's shipping across @vyui/core and @vyui/kit — one rolling timeline, newest first.

  • @vyui/kitv0.3.7

    @vyui/kit v0.3.7

    Patch Changes

    • Drive every gesture surface from mouse events on Lynx web, and fix Sortable's (#161) drop.
      Lynx web dispatches raw mouse events and never synthesizes touch from them, so touch-only worklets left every drag surface inert in a desktop browser. Each gesture core now takes plain coordinates, with thin touch and mouse wrappers over it: Draggable, Slider, Swiper, SwipeAction, Sheet, Toast swipe, Sortable, FeedList pull-to-refresh, and ScrollView's custom bounce. Release is explicit-buttons-only, a 500ms guard swallows the compatibility mousedown a touch browser replays after a tap, and no mouseleave is bound (it doesn't bubble, so per-element delivery is unreliable on the Lynx dispatch path). The pull and the bounce only engage at an edge, so binding mouse on those two doesn't disturb ordinary wheel scrolling.
      ScrollView's bounce also moved off lynx.querySelector('#id') onto main-thread-ref handles. That selector exists only on the native main thread — web-core's main-thread lynx object has no querySelector — so on web every call threw and took the whole bounce worklet down with it.
      Sortable fixes on top of that:
      • The lifted row gets zIndex from its background-side dragging state instead of painting in DOM order, so dragging down no longer slides it under the rows it passes — where they swallowed the pointer and the gesture's own move/up worklets stopped arriving.
      • Release settles the row into its target slot and re-runs the sibling shift for the final velocity-adjusted target; the transforms are cleared from the background once the reorder has rendered. Clearing them on the main thread at release repainted the pre-drag order for the frames the commit took to round-trip, which read as the list snapping back.
      • longPressMs defaults to 150 (was 250).
    • Repo-wide over-engineering cleanup. Migrate all 38 @vyui/kit components off the internal defineThemeBuilder helper onto the existing useStyledComponent composable and delete the helper. Remove dead code from @vyui/core (the useWarning no-op, and the unused areEqual/findValuesBetween/mtsLog/get/noop utils) and simplify handleAndDispatchCustomEvent. In @vyui/cli, drop the fuzzy "did you mean" suggestion from the unknown-component error (which already lists every available component) and simplify dependency resolution. No public component API changes. (#158)
    • Make Slider's main-thread drag the only drag implementation, and fix it so it (#159) works. It previously filled its thumb registry and every *MT mirror with background-thread writes to MainThreadRef.current, which vue-lynx silently no-ops — the main thread saw an empty handle list and bailed out of _paintActiveThumb on every frame, while the commit read a stale array and landed as next[0] ?? 0.
      • SliderRoot's min/max/step/disabled/values mirrors hop through runOnMainThread setter worklets, the shape Sheet uses.
      • SliderImplMTS resolves the thumb and range elements itself from the track via querySelectorAll, removing the BG→MT registration and its mount-time race. SliderThumbImpl no longer touches a MainThreadRef at all.
      • update:modelValue now fires per frame during the drag, so a value rendered next to the slider tracks the gesture instead of jumping on release. valueCommit stays once per gesture, compared against the value the gesture started from.
      • The thumb and the filled range are painted from the worklets by writing the same anchor offsets the background style computes, so neither thread's write can double-count the other's.
      • Values are re-sorted and the active thumb re-tracked every frame, and minStepsBetweenThumbs is enforced per frame rather than at commit time — a thumb stops at the limit instead of springing back on release.
      • Touch offsets are read from touches[0].x/.y, which are already relative to the bound element. Rebuilding them from pageY - layoutchange.top mixed viewport and page coordinates and drifted by the scroll offset.
      • Fixes the thumb sitting half its own width off-centre on right-anchored (inverted / RTL) sliders: the centring transform flips with the anchoring edge on the vertical axis but did not on the horizontal one.
      • Fixes the md thumb rendering 0×0 — size-4.5 is not a Tailwind v3 utility, so it compiled to no CSS at all.

      Removed: the background drag implementation (SliderImpl), the mainThreadDrag prop, and keyboard stepping. The keyboard handlers never fired on Lynx native, which has no key events to bind.
    • Fix the default (md) Slider thumb rendering 0×0. Its size was size-4.5, and (#159) Tailwind v3's spacing scale has no 4.5 step, so the class compiled to no CSS — safelisted, no build warning. It is now size-[18px], and the preset test suite fails on any theme class using a fractional spacing step v3 cannot generate.
    • Updated dependencies [949edd3, 949edd3, f9f0946, 949edd3, 949edd3, 01415de, 949edd3, 949edd3]:
      • @vyui/core@0.2.7
  • @vyui/corev0.2.7

    @vyui/core v0.2.7

    Patch Changes

    • Drive every gesture surface from mouse events on Lynx web, and fix Sortable's (#161) drop.
      Lynx web dispatches raw mouse events and never synthesizes touch from them, so touch-only worklets left every drag surface inert in a desktop browser. Each gesture core now takes plain coordinates, with thin touch and mouse wrappers over it: Draggable, Slider, Swiper, SwipeAction, Sheet, Toast swipe, Sortable, FeedList pull-to-refresh, and ScrollView's custom bounce. Release is explicit-buttons-only, a 500ms guard swallows the compatibility mousedown a touch browser replays after a tap, and no mouseleave is bound (it doesn't bubble, so per-element delivery is unreliable on the Lynx dispatch path). The pull and the bounce only engage at an edge, so binding mouse on those two doesn't disturb ordinary wheel scrolling.
      ScrollView's bounce also moved off lynx.querySelector('#id') onto main-thread-ref handles. That selector exists only on the native main thread — web-core's main-thread lynx object has no querySelector — so on web every call threw and took the whole bounce worklet down with it.
      Sortable fixes on top of that:
      • The lifted row gets zIndex from its background-side dragging state instead of painting in DOM order, so dragging down no longer slides it under the rows it passes — where they swallowed the pointer and the gesture's own move/up worklets stopped arriving.
      • Release settles the row into its target slot and re-runs the sibling shift for the final velocity-adjusted target; the transforms are cleared from the background once the reorder has rendered. Clearing them on the main thread at release repainted the pre-drag order for the frames the commit took to round-trip, which read as the list snapping back.
      • longPressMs defaults to 150 (was 250).
    • Fix List.scrollIntoId throwing on Lynx web, and restore its bottom/middle (#161) alignment everywhere.
      The worklet reached for lynx.querySelector('#id') three times. That global selector API exists only on the native main thread — web-core's MT lynx object has no querySelector — so the first call raised a TypeError and took the whole worklet with it, and the list scrolled nowhere.
      Two of those lookups were for the <list> itself, which the component owns, so they now go through a main-thread-ref instead. That works on both platforms: web-elements' <x-list> implements scrollToPosition as a real DOM method, which is what __InvokeUIMethod dispatches to. The third targets an arbitrary consumer-owned child, where the global selector is the only route, so it is feature-checked. When it is absent the scroll keeps its step-1 landing and still honours offset — identical to what alignTo: 'none' already produces — rather than aborting. Web's boundingClientRect ignores relativeTo anyway, so there is nothing meaningful to measure against there.
      Separately, the list's layoutchange worklet was bound as :main-thread:bindlayoutchange. vue-lynx only recognises the main-thread- prefix, so the colon form parsed as an ordinary prop and the handler never attached — listHeightMT / listWidthMT sat at 0 on every platform, which silently broke alignTo: 'bottom' and alignTo: 'middle'. Now bound with the hyphen form, with a test that fails on any main-thread: binding in core.
    • Repo-wide over-engineering cleanup. Migrate all 38 @vyui/kit components off the internal defineThemeBuilder helper onto the existing useStyledComponent composable and delete the helper. Remove dead code from @vyui/core (the useWarning no-op, and the unused areEqual/findValuesBetween/mtsLog/get/noop utils) and simplify handleAndDispatchCustomEvent. In @vyui/cli, drop the fuzzy "did you mean" suggestion from the unknown-component error (which already lists every available component) and simplify dependency resolution. No public component API changes. (#158)
    • Fix <Presence> wedging permanently on web when an animation end/cancel event (#161) is lost, and restore parity with upstream lynx-family/lynx-ui on the reopen-during-close path.
      • handleKFStart/handleTransitionStart no longer bump the entering/leaving loop ids. Bumping killed the frame watchdog the instant any animation started, leaving the machine trusting an end event that web does not reliably deliver — a child unmounted mid-transition never fires one, and DOM bubbling feeds child animation events into these handlers to begin with. A stuck Leaving kept the invisible backdrop mounted, swallowing every tap under it.
      • Both watchdogs now poll through in-flight animations and force-resolve past a MAX_STUCK_MS (3s) wall-clock ceiling. Wall-clock rather than frames because rAF cadence varies across environments.
      • show flipping back to true during Leaving now remounts via restartShow() instead of tearing down. Previously a reopen racing Leaving → Left stranded show=true with nothing mounted and the trigger went permanently dead.
      • onOpen/onClose are deduped through hasNotifiedOpen, so a reopen-during-close that routes back through Entered doesn't double-fire.
      • A close that races the enter animation no longer cuts straight to Leaving. The exit keyframe starts from the element's underlying (fully-open) value, so swapping mid-enter snapped the element open and played the exit from there — the action sheet flashing up before sliding back out. The dismiss is deferred until the enter resolves, which the existing handleAnimationEnd safeguard and entering watchdog already route to Leaving.
    • Fix the sheet replaying its exit animation after a drag-dismiss. (#161)
      Releasing a drag past the dismiss threshold drove the close twice: the MT release transition slid the panel off from where the finger left it, and Presence's .ui-leaving keyframe then ran the same close again — starting from the fully-open underlying value, so the panel snapped back up and played the exit a second time. The scrim did the same through vyui-fade-out, which keeps an explicit from { opacity: 1 }.
      The inline animation: 'none' the release worklet paints was meant to suppress that keyframe, but a class-driven animation outranks it on the Lynx style path. SheetRoot now carries a dragClosing flag, set by the release worklet before it emits the close, that drops ui-leaving from the panel and backdrop for that path — the MT transition owns the close and @transitionend still advances Presence to Left. Non-drag closes keep the keyframe unchanged.
    • Make Slider's main-thread drag the only drag implementation, and fix it so it (#159) works. It previously filled its thumb registry and every *MT mirror with background-thread writes to MainThreadRef.current, which vue-lynx silently no-ops — the main thread saw an empty handle list and bailed out of _paintActiveThumb on every frame, while the commit read a stale array and landed as next[0] ?? 0.
      • SliderRoot's min/max/step/disabled/values mirrors hop through runOnMainThread setter worklets, the shape Sheet uses.
      • SliderImplMTS resolves the thumb and range elements itself from the track via querySelectorAll, removing the BG→MT registration and its mount-time race. SliderThumbImpl no longer touches a MainThreadRef at all.
      • update:modelValue now fires per frame during the drag, so a value rendered next to the slider tracks the gesture instead of jumping on release. valueCommit stays once per gesture, compared against the value the gesture started from.
      • The thumb and the filled range are painted from the worklets by writing the same anchor offsets the background style computes, so neither thread's write can double-count the other's.
      • Values are re-sorted and the active thumb re-tracked every frame, and minStepsBetweenThumbs is enforced per frame rather than at commit time — a thumb stops at the limit instead of springing back on release.
      • Touch offsets are read from touches[0].x/.y, which are already relative to the bound element. Rebuilding them from pageY - layoutchange.top mixed viewport and page coordinates and drifted by the scroll offset.
      • Fixes the thumb sitting half its own width off-centre on right-anchored (inverted / RTL) sliders: the centring transform flips with the anchoring edge on the vertical axis but did not on the horizontal one.
      • Fixes the md thumb rendering 0×0 — size-4.5 is not a Tailwind v3 utility, so it compiled to no CSS at all.

      Removed: the background drag implementation (SliderImpl), the mainThreadDrag prop, and keyboard stepping. The keyboard handlers never fired on Lynx native, which has no key events to bind.
    • Fix the slider never moving on Lynx web. (#161)
      Two independent bails, both before the gesture emitted anything, which is why the value sat frozen at whatever it mounted with while native felt fine.
      The one that actually stranded it: _dragStart aborted when it could not resolve the thumb elements to paint. That lookup goes through the main-thread querySelectorAll wrapper, which calls a __QuerySelectorAll PAPI that Lynx web does not expose to the main-thread realm — invoke resolves there, this throws ReferenceError, and a typeof check on the wrapper method cannot see it coming. The query is now guarded, and no longer gates the drag: those elements only drive the main-thread paint, which is a latency optimisation over the background's own render, so losing them costs smoothness rather than correctness. The background still receives every value and renders the thumb from its own style.
      The second: the track's extent was the last piece of geometry sourced from a background @layoutchange pushed across with runOnMainThread. _beginAt already fetches invoke('boundingClientRect') once per gesture for the origin, and that response carries width/height too, so the extent comes from it as well. One measurement, one frame, no thread hop — and re-read per gesture, which also fixes a track that resized while its tab was hidden.
      draggingMT is wired up while here: SliderImplMTS was setting a local ref of its own, so the root's gate against echoing a live update:modelValue back into the main thread's values was never armed.
    • Map Slider's touch and mouse gestures through one pointer coordinate frame. (#161)
      The touch path read touches[0].x/.y, which Lynx reports element-relative on native but does not provide on web at all — createCrossThreadEvent builds web touches from raw DOM Touch objects, which carry no x/y, so every offset came through as NaN and the thumb never moved on a touchscreen browser.
      Both paths now read clientX/clientY, the only pointer field Lynx reports on native and web alike, and share a single _beginAt that captures the track's origin from invoke('boundingClientRect') once per gesture and subtracts it. The origin still never comes from layoutchange, which reports page-relative coordinates that drift from the pointer's viewport frame by the scroll offset.
  • @vyui/kitv0.3.6

    @vyui/kit v0.3.6

    Patch Changes

    • Animate Collapsible/Accordion height on open/close by tweening a measured px height (Tray recipe); kept-mounted content morphs both directions. (#156)
    • Updated dependencies [c9f8287, c9f8287, c9f8287]:
      • @vyui/core@0.2.6
  • @vyui/corev0.2.6

    @vyui/core v0.2.6

    Patch Changes

    • Animate Collapsible/Accordion height on open/close by tweening a measured px height (Tray recipe); kept-mounted content morphs both directions. (#156)
    • Scale the Sheet settle/dismiss duration by release velocity so a hard flick settles quicker while a slow release keeps the current feel. (#156)
    • Cache the TabsIndicator list rect and re-measure it only on layout/orientation/dir changes, so a tab switch costs one boundingClientRect round-trip instead of two. (#156)
  • @vyui/kitv0.3.5

    @vyui/kit v0.3.5

    Patch Changes

    • Fix every Sheet-backed surface rendering white in dark mode. @vyui/core was shipping color it can't ship. (#154)
      .vyui-sheet__content hardcoded background-color: #fff, which beat the consumer's bg-default on source order and pinned drawer, tray, action sheet, select, combobox and popover to white in both color modes. SheetBackdropImpl and SwipeAction set backgroundColor inline, which no class can outrank at all — so a theme's dim or row color on those elements was dead on arrival. It only read as a dark-mode bug because white-on-white is invisible.
      All three now ship no color, matching the "No defaults — pass backgroundColor here" contract every sibling overlay already documents.
      Breaking for bare @vyui/core consumers: SheetContent, SheetBackdrop and SwipeAction no longer paint a background. Supply one (@vyui/kit already does on every slot). The SwipeAction row in particular must stay opaque or the actions behind it show through.
      Also in @vyui/kit: actionSheet's content slot gains bg-default. It was the one Sheet theme silently relying on core's white.
      The reason it stayed hidden: SheetContent and SheetBackdrop were dropping the consumer's class entirely. OverlayPortal renders nothing in place — it registers its slot for OverlayRoot to paint elsewhere — so there is no root element for class / style to fall through to, and Vue discards them without a warning. Every kit theme class on a sheet panel (bg-default, borders, radius) was being thrown away, and core's hardcoded #fff / position: fixed / z-index stood in for them. Both now forward useAttrs() onto the impl with inheritAttrs: false, matching DialogContentModal.
      Guarded by components/headless-color.test.ts (fails if any core component declares a literal background color — var() is allowed, story/ is exempt) and a case in OverlayRoot.test.ts pinning the attr-forwarding contract for OverlayPortal consumers.
      SheetHandle also stops hardcoding the bg-accented class — a @vyui/kit token utility, meaningless in a headless package without kit's Tailwind preset, and redundant since all three kit themes already put it on their handle slot. The guard now covers that direction too.
    • Add the lunaris registry style, and fix four token-layer bugs the audit turned up. (#154)
      • lunaris — the LUNA design system (from lynx-ui, Apache-2.0) ported to the token layer: pure-grey canvas/paper/content chrome, rose accent, and the five .luna-gradient-* classes. A token-only overlay, so every base .vue and theme/*.ts is reused unchanged. LUNA's neutral variant shares this chrome byte-for-byte and differs only in accent, so it is documented as a delta in the file header rather than shipped as a second style.
      • Fix: shadcn and rounded held nested var(--ui-color-*) refs on the mode tier, which collapse on Lynx native (one level of var() only), so consumer-written bg-primary / text-error painted nothing on device.
      • Fix: shadcn's primary now follows --base-color like neutral does. It was pinned to zinc while surfaces tracked the chosen gray, producing combinations shadcn/ui can't express (zinc accent on stone surfaces).
      • Fix: resolveColorHex now resolves shade-less colors (black, white). They are single strings in tailwindcss/colors, so indexing them by shade fell through to the slate-500 fallback — a monochrome accent painted black surfaces with slate-blue baked SVG icons on them.
      • Fix: init warns when a chosen --base-color can't apply because the style ships its own palette, instead of silently ignoring it.
      • Guards: registry tests now assert every shipped style declares the full 120-token surface, declares no nested var() value, and that rounded differs from the base in --ui-radius alone.

      Install with vyui init --style lunaris.
    • Fix the overlay dim: modal, drawer, tray and actionSheet all painted no scrim at all. (#154)
      Their overlay slot used an alpha modifier on a semantic color (bg-neutral-900/50, bg-neutral-900/40). The Tailwind preset maps semantic colors to raw var() strings with no <alpha-value> placeholder, so Tailwind 3 skips generating those utilities entirely — the class resolved to no CSS and the element painted nothing. All four now use bg-black/50, which parses to rgb so the modifier applies.
      Most visible in dark mode, where a bg-default panel over an undimmed bg-default page had nothing separating it.
      Guarded by theme/alpha-modifier.test.ts, which fails if any theme file reintroduces an alpha modifier on a semantic color.
    • Updated dependencies [3298de9, 9d82f23]:
      • @vyui/core@0.2.5
  • @vyui/corev0.2.5

    @vyui/core v0.2.5

    Patch Changes

    • Fix every Sheet-backed surface rendering white in dark mode. @vyui/core was shipping color it can't ship. (#154)
      .vyui-sheet__content hardcoded background-color: #fff, which beat the consumer's bg-default on source order and pinned drawer, tray, action sheet, select, combobox and popover to white in both color modes. SheetBackdropImpl and SwipeAction set backgroundColor inline, which no class can outrank at all — so a theme's dim or row color on those elements was dead on arrival. It only read as a dark-mode bug because white-on-white is invisible.
      All three now ship no color, matching the "No defaults — pass backgroundColor here" contract every sibling overlay already documents.
      Breaking for bare @vyui/core consumers: SheetContent, SheetBackdrop and SwipeAction no longer paint a background. Supply one (@vyui/kit already does on every slot). The SwipeAction row in particular must stay opaque or the actions behind it show through.
      Also in @vyui/kit: actionSheet's content slot gains bg-default. It was the one Sheet theme silently relying on core's white.
      The reason it stayed hidden: SheetContent and SheetBackdrop were dropping the consumer's class entirely. OverlayPortal renders nothing in place — it registers its slot for OverlayRoot to paint elsewhere — so there is no root element for class / style to fall through to, and Vue discards them without a warning. Every kit theme class on a sheet panel (bg-default, borders, radius) was being thrown away, and core's hardcoded #fff / position: fixed / z-index stood in for them. Both now forward useAttrs() onto the impl with inheritAttrs: false, matching DialogContentModal.
      Guarded by components/headless-color.test.ts (fails if any core component declares a literal background color — var() is allowed, story/ is exempt) and a case in OverlayRoot.test.ts pinning the attr-forwarding contract for OverlayPortal consumers.
      SheetHandle also stops hardcoding the bg-accented class — a @vyui/kit token utility, meaningless in a headless package without kit's Tailwind preset, and redundant since all three kit themes already put it on their handle slot. The guard now covers that direction too.
    • Sheet now paints through the app-root <OverlayRoot> so it escapes ancestor overflow: hidden on Lynx native (#12). (#152)
      SheetContent and SheetBackdrop wrap their impls in a new <OverlayPortal> (exported from @vyui/core), matching how Dialog, DropdownMenu, Combobox and Toast already portal. Presence is unchanged — the portal mounts inside it, so enter/leave animations still run to completion before unmount.
      Consumers must have an <OverlayRoot /> at the app root; <VyApp> mounts one by default.
  • @vyui/kitv0.3.4

    @vyui/kit v0.3.4

    Patch Changes

    • KeyboardAware lift fixes: measure the margin against the LynxView viewport via selectRoot() instead of the screen (Explorer chrome no longer shortens the lift), flip offset to its documented extra-clearance meaning (it was pushing fields INTO the keyboard), let a wrapping Trigger's registration win over the input's self-registration, and register kit VyInput/VyTextarea's styled field (via an internal as-child Trigger) so the field's bottom chrome clears too. Also adds a library-level useSafeArea / provideSafeAreaInsets (elk-style normalization of Sparkling/Explorer global props with OS gating); Sheet panels now pad their docked edges by the container's safe-area insets, and VyApp provides these insets app-wide with a safeArea prop to tune them (false opts the whole app out with zeros; a partial { top, bottom } overrides specific edges). Input/Textarea (core and kit) gain avoidKeyboard / avoidKeyboardSpacing passthroughs to Lynx's native avoid-keyboard root-view shift — a zero-JS alternative for simple forms. (#148)
    • Select/Combobox selection tick now bakes its fill via the Icon color prop (accent ramp) instead of a class the rasterized svg can't receive — it rendered black and vanished in dark mode. Combobox's "No results" text also carries text-muted on the <text> itself so it flips with the theme. (#148)
    • Separator label now uses text-highlighted on the <text> itself, so its color flips with the theme (Lynx doesn't inherit the container's color into the text — the label rendered black in dark mode). (#148)
    • Bump vue-lynx to 0.5.1 (widens peer range to ^0.4.2 || ^0.5.1), with a local patch making the worklet-loader-mt registration scan comment-aware until upstream #287 ships (#148)
    • Updated dependencies [73ed402, 73ed402, 73ed402, 73ed402, 73ed402]:
      • @vyui/core@0.2.4
  • @vyui/corev0.2.4

    @vyui/core v0.2.4

    Patch Changes

    • KeyboardAware lift fixes: measure the margin against the LynxView viewport via selectRoot() instead of the screen (Explorer chrome no longer shortens the lift), flip offset to its documented extra-clearance meaning (it was pushing fields INTO the keyboard), let a wrapping Trigger's registration win over the input's self-registration, and register kit VyInput/VyTextarea's styled field (via an internal as-child Trigger) so the field's bottom chrome clears too. Also adds a library-level useSafeArea / provideSafeAreaInsets (elk-style normalization of Sparkling/Explorer global props with OS gating); Sheet panels now pad their docked edges by the container's safe-area insets, and VyApp provides these insets app-wide with a safeArea prop to tune them (false opts the whole app out with zeros; a partial { top, bottom } overrides specific edges). Input/Textarea (core and kit) gain avoidKeyboard / avoidKeyboardSpacing passthroughs to Lynx's native avoid-keyboard root-view shift — a zero-JS alternative for simple forms. (#148)
    • Sheet handle now uses the mode-aware bg-accented token instead of a hardcoded translucent black, so the drag pill stays visible in dark mode. (#148)
    • Tabs indicator no longer animates growing in from zero width on mount / CSS reload — the transition now arms one tick after the first measurement, so only genuine tab switches slide. (#148)
    • Toast viewport now pads its docked edge by the container safe-area insets (via useSafeArea), so bottom toasts clear the iPhone home indicator and top toasts clear the notch — the same insets the Sheet panels already honor. (#148)
    • Bump vue-lynx to 0.5.1 (widens peer range to ^0.4.2 || ^0.5.1), with a local patch making the worklet-loader-mt registration scan comment-aware until upstream #287 ships (#148)
  • @vyui/kitv0.3.3

    @vyui/kit v0.3.3

    Patch Changes

    • Overlay cleanup ahead of the shared-core refactor. (#143)
      Breaking (pre-1.0 patch by repo policy): removes the dead velocityThreshold prop from SheetRoot (documented as unused/reserved — release logic uses the coast projection) and the consumerless useSheetBehavior() reactive wrapper, progressFor, pickSnap/PickSnapOpts (never adopted by Sheet; pickRelease is the one release spec), and their types from @vyui/core. The pure spec helpers (pickRelease, directionAxis, viewportSnapsToPositions, …) remain.
      • kit VyModal: wire the declared-but-dead dismissible prop — backdrop taps are now blocked when false and emit close:prevent (mirrors VyPopover)
      • sheet enter/exit keyframes now take their duration from the duration prop (inline animation-duration longhand) instead of a hardcoded 280ms, fixing the enter/settle desync for consumers like VyTray that pass duration: 300
    • Require vue-lynx@^0.4.2 and drop the local worklet-loader patch: upstream #190 now follows aliased and package worklet imports, with includeWorkletPackages for node_modules consumers. NPM consumers must set pluginVueLynx({ includeWorkletPackages: ['@vyui/core', '@vyui/kit'] }) — documented in the installation guide. (#142)
    • Updated dependencies [53c027b, 2e98112, df383f5, 758a231, 251b586, 21ec23a]:
      • @vyui/core@0.2.3
  • @vyui/corev0.2.3

    @vyui/core v0.2.3

    Patch Changes

    • Button forwards the Lynx tap event through its tap emit (tap: [event: TouchEvent]). Previously it emitted bare, so modifier-wrapped listeners merged in via asChild — like ToastClose's @tap.stop over a button — crashed with undefined.stopPropagation on tap, leaving the toast close button broken. (#137)
    • Dead-code audit: remove modules with zero consumers across core, kit, and every example app. (#138)
      Breaking (pre-1.0 patch by repo policy): removes never-used public exports — withDefault, useScrollTo, and the components/originals/utilities registry — from @vyui/core.
      • remove the unexported shared/color/ module (channel/convert/gradient/parse/utils) — ported for ColorArea/ColorSlider primitives that were never built
      • remove unused lynx-ui-common ports: selector.ts, version.ts, getEventDetail, mainThreadify, popoverUtils, convertToPx
      • remove unused reka-ui ports: useKbd, useGraceArea, useSelectionBehavior, useFormControl, isValidVNodeElement, withDefault, useScrollTo, Arrow.vue, countryList
      • remove the hand-maintained constants.ts export registry (components/originals/utilities exports)
      • remove the 31 *.story.vue files (no story runner exists; story/_*.vue test fixtures are untouched)
      • drop the vue-component-type-helpers runtime dependency (only importer was withDefault)
      • useId: drop the Vue <3.5 fallback branch — every workspace pins Vue 3.5+
    • Overlay cleanup ahead of the shared-core refactor. (#143)
      Breaking (pre-1.0 patch by repo policy): removes the dead velocityThreshold prop from SheetRoot (documented as unused/reserved — release logic uses the coast projection) and the consumerless useSheetBehavior() reactive wrapper, progressFor, pickSnap/PickSnapOpts (never adopted by Sheet; pickRelease is the one release spec), and their types from @vyui/core. The pure spec helpers (pickRelease, directionAxis, viewportSnapsToPositions, …) remain.
      • kit VyModal: wire the declared-but-dead dismissible prop — backdrop taps are now blocked when false and emit close:prevent (mirrors VyPopover)
      • sheet enter/exit keyframes now take their duration from the duration prop (inline animation-duration longhand) instead of a hardcoded 280ms, fixing the enter/settle desync for consumers like VyTray that pass duration: 300
    • Export combineGroupState from Presence and use it in DialogContent, deleting the inlined copy that noted "(not exported)". (#144)
    • Remove two unused shared exports that had no consumers. useStateMachine (<Presence> ships its own 1:1-ported state machine and never used it) is dropped from the public @vyui/core entry; useForwardRef (superseded by useForwardExpose) is dropped from the @vyui/core/shared entry. (#140)
    • Require vue-lynx@^0.4.2 and drop the local worklet-loader patch: upstream #190 now follows aliased and package worklet imports, with includeWorkletPackages for node_modules consumers. NPM consumers must set pluginVueLynx({ includeWorkletPackages: ['@vyui/core', '@vyui/kit'] }) — documented in the installation guide. (#142)
  • @vyui/kitv0.3.2

    @vyui/kit v0.3.2

    Patch Changes

    • Cleanup pass: dead code removal, export gaps, and a color-parsing bug fix. (#133)
      • @vyui/core: export ConfigProvider from the public API — useLocale/useDirection depend on its context but had no supported way to provide it
      • @vyui/core: remove the disposable useMtSmoke diagnostic and unused pick/omit utils
      • @vyui/core: type Radio.vue's click handler with @lynx-js/types' MouseEvent, not the DOM global
      • @vyui/core: fix parseColor()/isValidColor() — hsv() strings always threw despite being documented as a supported alias of hsb()
      • @vyui/kit: export tray from @vyui/kit/theme (missing, unlike every other component)
      • @vyui/kit: add exported SelectEmits/ComboboxEmits/FeedListEmits interfaces; Combobox's update:modelValue is now typed instead of any
    • Performance pass around tab switching and theme resolution. (#134)
      • @vyui/core: Tabs unmountOnHide: false now works — a panel mounts on first visit and stays mounted (hidden via display: none + accessibility-elements-hidden) after; previously the flag was threaded into context but never read, so panels always unmounted
      • @vyui/core: new Tabs deferContent prop — commits the content swap one macrotask after the trigger/indicator update so the tab bar responds instantly while a heavy panel mounts
      • @vyui/core: TabsContent accepts a per-panel unmountOnHide override (kit: TabsItem.unmountOnHide) — panels whose subtrees write styles from main-thread worklets (setStyleProperty / animate(fill: 'forwards')) can keep painting through the kept-alive display: none on device and should opt back into unmounting; kept-hidden panels also set visibility: hidden as defence
      • @vyui/kit: theme tv factories are memoized per app config (defineThemeBuilder, also inside useStyledComponent) instead of rebuilt per component instance — visible on Lynx's interpreter whenever a screenful of components mounts
      • @vyui/kit: Tabs forwards deferContent, resolves slot classes once per variant change instead of per trigger per render, and its triggers regain press feedback (active:opacity-60 on the trigger itself — element opacity needs no CSS inheritance)
      • @vyui/kit: the Tailwind preset safelist now emits the EXACT classes the packaged themes generate for the configured color set (collected by walking the tv configs) instead of every utility × color × shade × variant combination — ~90% less generated CSS (857 KB → 84 KB in kit-demo), and the dead data-[…]/ring-* entries are gone
    • Fix tailwind preset failing to load from source under jiti (Cannot find module './theme/index.js') — import the theme barrel with an explicit .ts extension; Vite still emits ./theme/index.js in dist. (#135)
    • Updated dependencies [0e34d18, ce424a7]:
      • @vyui/core@0.2.2
  • @vyui/kitv0.3.1

    @vyui/kit v0.3.1

    Patch Changes

    • 62d9f13: Dark mode via semantic design tokens.
      • New role-based token layer (the nuxt/ui + shadcn convention, Lynx-adapted): text (text-highlighted / text-default / text-toned / text-muted / text-dimmed / text-inverted), background (bg-default / bg-muted / bg-elevated / bg-accented / bg-inverted) and border (border-default / border-muted / border-accented / border-inverted). Each is a single-hop var(--ui-*) → concrete theme() literal, so it resolves on Lynx and flips between modes on its own.
      • Every theme migrated off raw text-neutral-* / bg-neutral-* / border-neutral-* onto these tokens, so a component flips in dark with zero dark: variants. Consumers get the same for their own chrome — write text-muted, not text-neutral-500 dark:text-neutral-400.
      • A single .dark class on an app-root ancestor (useColorMode()) redefines the tokens to their dark values; the neutral RAMP stays fixed (raw neutral-* is a literal shade in both modes — least surprise), and only the accent mode tier shifts -500 → -400.
      • useColorMode() composable ('light' | 'dark' | 'system', plus isDark / setMode / toggle) folds 'system' to the OS appearance and follows it live on web. App-root contract: bind :class="{ dark: colorMode.isDark }" + :key="colorMode.mode" — the :key remount re-skins an already-mounted tree on Lynx native.
      • Mode-tier tokens hold theme() literals (not var(--ui-color-*) refs), fixing a latent two-level var() collapse on device. rounded / shadcn style overlays (which redeclare :root) gain the full token set for light AND dark.
    • 3c08b29: VyInput now paints its colored border plus a shadow-ring while focused (tracked in JS — Lynx has no :focus-within), instead of only via the static highlight prop. The ring is a flat arbitrary box-shadow (0 0 0 2px var(--ui-color-{color}-200)) because the Lynx preset has no ring*/boxShadowColor plugins; the per-color classes are safelisted in the Tailwind preset. highlight still forces the same treatment on permanently.
    • 4ee6a7d: Make KeyboardAware work under vue-lynx: the root now receives keyboard height from the input's per-element @keyboard event (the global keyboardstatuschanged event never reaches the vue-lynx background runtime), inputs self-register with a surrounding KeyboardAwareRoot without needing a KeyboardAwareTrigger wrap, and VyTray's keyboardAware now also covers the body (new 'lift' | 'scroll' modes plus bodyScroll ui slot) instead of silently doing nothing without a footer slot.
    • d4f9b1a: Update public package and documentation copy to describe Vy UI as Lynx-native UI primitives for Vue.
    • 1637c40: Sortable rows no longer drag list chrome along with the finger. The kit theme now renders each row as a transparent shell (the element core transforms) around a new itemContent pill slot, so only the pill visibly moves — the old border-b divider look is gone. SortableItem flips a ui-dragging class (+ data-state="dragging") on the lifted row, and VYUI_UI_STATES gains dragging so themes can restyle the lifted pill (default: stronger pill border via group-ui-dragging:).
    • 93c9827: Add VyApp, the app-root shell: owns the dark class + :key remount from useColorMode, mounts OverlayRoot (opt-out via :overlays="false"), sets --ui-radius via the radius prop, and emits viewport-change with the root layout size.
      Also export resolveColorHex (from the barrel and the ./provide entry) so consumers can bake semantic colors into VyIcon's color prop — Lynx rasterizes <svg>, so text-* classes never color an icon.
      Fix icon-only (square) buttons rendering off-center: vue-lynx realizes empty slot/v-if anchors as real zero-size nodes, so the base gap-* added phantom width after the icon. square now applies justify-center gap-0.
    • Updated dependencies 4ee6a7d
    • Updated dependencies d4f9b1a
    • Updated dependencies 1637c40
      • @vyui/core@0.2.1
  • @vyui/corev0.2.2

    @vyui/core v0.2.2

    Patch Changes

    • Cleanup pass: dead code removal, export gaps, and a color-parsing bug fix. (#133)
      • @vyui/core: export ConfigProvider from the public API — useLocale/useDirection depend on its context but had no supported way to provide it
      • @vyui/core: remove the disposable useMtSmoke diagnostic and unused pick/omit utils
      • @vyui/core: type Radio.vue's click handler with @lynx-js/types' MouseEvent, not the DOM global
      • @vyui/core: fix parseColor()/isValidColor() — hsv() strings always threw despite being documented as a supported alias of hsb()
      • @vyui/kit: export tray from @vyui/kit/theme (missing, unlike every other component)
      • @vyui/kit: add exported SelectEmits/ComboboxEmits/FeedListEmits interfaces; Combobox's update:modelValue is now typed instead of any
    • Performance pass around tab switching and theme resolution. (#134)
      • @vyui/core: Tabs unmountOnHide: false now works — a panel mounts on first visit and stays mounted (hidden via display: none + accessibility-elements-hidden) after; previously the flag was threaded into context but never read, so panels always unmounted
      • @vyui/core: new Tabs deferContent prop — commits the content swap one macrotask after the trigger/indicator update so the tab bar responds instantly while a heavy panel mounts
      • @vyui/core: TabsContent accepts a per-panel unmountOnHide override (kit: TabsItem.unmountOnHide) — panels whose subtrees write styles from main-thread worklets (setStyleProperty / animate(fill: 'forwards')) can keep painting through the kept-alive display: none on device and should opt back into unmounting; kept-hidden panels also set visibility: hidden as defence
      • @vyui/kit: theme tv factories are memoized per app config (defineThemeBuilder, also inside useStyledComponent) instead of rebuilt per component instance — visible on Lynx's interpreter whenever a screenful of components mounts
      • @vyui/kit: Tabs forwards deferContent, resolves slot classes once per variant change instead of per trigger per render, and its triggers regain press feedback (active:opacity-60 on the trigger itself — element opacity needs no CSS inheritance)
      • @vyui/kit: the Tailwind preset safelist now emits the EXACT classes the packaged themes generate for the configured color set (collected by walking the tv configs) instead of every utility × color × shade × variant combination — ~90% less generated CSS (857 KB → 84 KB in kit-demo), and the dead data-[…]/ring-* entries are gone
  • @vyui/corev0.2.1

    @vyui/core v0.2.1

    Patch Changes

    • 4ee6a7d: Make KeyboardAware work under vue-lynx: the root now receives keyboard height from the input's per-element @keyboard event (the global keyboardstatuschanged event never reaches the vue-lynx background runtime), inputs self-register with a surrounding KeyboardAwareRoot without needing a KeyboardAwareTrigger wrap, and VyTray's keyboardAware now also covers the body (new 'lift' | 'scroll' modes plus bodyScroll ui slot) instead of silently doing nothing without a footer slot.
    • d4f9b1a: Update public package and documentation copy to describe Vy UI as Lynx-native UI primitives for Vue.
    • 1637c40: Sortable rows no longer drag list chrome along with the finger. The kit theme now renders each row as a transparent shell (the element core transforms) around a new itemContent pill slot, so only the pill visibly moves — the old border-b divider look is gone. SortableItem flips a ui-dragging class (+ data-state="dragging") on the lifted row, and VYUI_UI_STATES gains dragging so themes can restyle the lifted pill (default: stronger pill border via group-ui-dragging:).
  • @vyui/kitv0.3.0

    @vyui/kit v0.3.0

    Minor Changes

    • c344b72: Per-component subpath entries for tree-shakeable consumption. @vyui/kit now exposes every component as its own entry point (@vyui/kit/button, @vyui/kit/tray, …) with the same canonical Vy* bindings as the barrel, so migrating is a specifier swap. Because the vue-lynx main-thread worklet pipeline prunes by sideEffects globs over whatever is reached (bare side-effect imports erase export usage), deep entries are the only way to ship less: importing @vyui/kit/button now reaches ~37 modules / 26 worklet registrations instead of the barrel's ~294 / 118.
      To make this work end-to-end, kit's build rewrites its own @vyui/core barrel imports to per-file deep specifiers (@vyui/core/dist/components/….vue.js), and @vyui/core exposes a ./dist/*.js wildcard export to resolve them. Barrel imports (import { VyButton } from '@vyui/kit') keep working unchanged — they just keep the everything-ships behavior.
      Also fixes @vyui/kit's sideEffects: false, which let bundlers drop the package entirely from the vue-lynx main-thread worklet slice (entered via a bare side-effect import that uses no exports), so every transitively-imported @vyui/core worklet went unregistered and consumers crashed with bind of undefined. Kit now declares the same sideEffects globs as core.
    • c344b72: Ship per-file, source-shaped ESM dist (Vite lib + Rollup preserveModules) instead of an rslib bundle.
      • Fixes the __WEBPACK_EXTERNAL_MODULE_vue_lynx_* is not defined main-thread crash for npm consumers of worklet-driven components (VyTray, VyDrawer, Slider, …): worklet modules now keep direct named vue-lynx imports the consumer's MT toolchain can follow.
      • Fixes the follow-on cannot read property 'bind' of undefined main-thread crash: each pre-compiled worklet module retains a "main thread" marker so the consumer's worklet-loader-mt extracts its registerWorkletInternal calls (with _wkltIds matching the background bundle) instead of dropping them. @vyui/kit's sideEffects is widened to keep the transitive-core-worklet MT imports from being tree-shaken.
      • SFC <style> CSS is now published and auto-imported per module — the old bundle stubbed it, so consumers silently lost component styles.
      • Each SFC ships as a single X.vue.js; a check-dist-shape guard fails the build on any bundle fingerprint or a worklet module missing its marker.

    Patch Changes

    • a2696c9: Add an experimental VyCalendar component with ISO-string date selection and a built-in Lynx date-runtime caveat.
    • a2696c9: Breaking: components are now exported under a single canonical Vy* name only. The bare aliases (Button, Card, Icon, AspectRatio, …) have been removed so there is one name per component — the same one the VyUI plugin registers globally. Update imports from import { Button } from '@vyui/kit' to import { VyButton } from '@vyui/kit'. The unprefixed Icon/AspectRatio primitives remain available from @vyui/core.
    • Updated dependencies c344b72
    • Updated dependencies c344b72
      • @vyui/core@0.2.0
  • @vyui/corev0.2.0

    @vyui/core v0.2.0

    Minor Changes

    • c344b72: Per-component subpath entries for tree-shakeable consumption. @vyui/kit now exposes every component as its own entry point (@vyui/kit/button, @vyui/kit/tray, …) with the same canonical Vy* bindings as the barrel, so migrating is a specifier swap. Because the vue-lynx main-thread worklet pipeline prunes by sideEffects globs over whatever is reached (bare side-effect imports erase export usage), deep entries are the only way to ship less: importing @vyui/kit/button now reaches ~37 modules / 26 worklet registrations instead of the barrel's ~294 / 118.
      To make this work end-to-end, kit's build rewrites its own @vyui/core barrel imports to per-file deep specifiers (@vyui/core/dist/components/….vue.js), and @vyui/core exposes a ./dist/*.js wildcard export to resolve them. Barrel imports (import { VyButton } from '@vyui/kit') keep working unchanged — they just keep the everything-ships behavior.
      Also fixes @vyui/kit's sideEffects: false, which let bundlers drop the package entirely from the vue-lynx main-thread worklet slice (entered via a bare side-effect import that uses no exports), so every transitively-imported @vyui/core worklet went unregistered and consumers crashed with bind of undefined. Kit now declares the same sideEffects globs as core.
    • c344b72: Ship per-file, source-shaped ESM dist (Vite lib + Rollup preserveModules) instead of an rslib bundle.
      • Fixes the __WEBPACK_EXTERNAL_MODULE_vue_lynx_* is not defined main-thread crash for npm consumers of worklet-driven components (VyTray, VyDrawer, Slider, …): worklet modules now keep direct named vue-lynx imports the consumer's MT toolchain can follow.
      • Fixes the follow-on cannot read property 'bind' of undefined main-thread crash: each pre-compiled worklet module retains a "main thread" marker so the consumer's worklet-loader-mt extracts its registerWorkletInternal calls (with _wkltIds matching the background bundle) instead of dropping them. @vyui/kit's sideEffects is widened to keep the transitive-core-worklet MT imports from being tree-shaken.
      • SFC <style> CSS is now published and auto-imported per module — the old bundle stubbed it, so consumers silently lost component styles.
      • Each SFC ships as a single X.vue.js; a check-dist-shape guard fails the build on any bundle fingerprint or a worklet module missing its marker.
  • @vyui/kitv0.2.0

    @vyui/kit v0.2.0

    Minor Changes

    • 5109043: Add defineVyuiConfig (new @vyui/kit/config entry) so a project's theme is authored once and fed to both the Tailwind preset (build) and provideVyUI/app.use(VyUI) (runtime), removing the hand-synced colors duplication between the two planes.
      • createVyuiPreset now accepts a defineVyuiConfig result ({ ui: { colors } }) alongside the flat { colors, neutral, shades } form
      • createVyuiPreset dev-warns when a semantic color can't be backed by a --ui-color-* var (no more silent "class resolves to nothing")
      • @vyui/kit/config is a light, jiti-safe entry — importing it in tailwind.config.ts never pulls component code into the build path
  • @vyui/corev0.1.2

    @vyui/core v0.1.2

    Patch Changes

    • cbbbcbf: Ensure tray, drawer, and action sheet content renders above the sheet backdrop by default, and disable automatic capitalization and correction for kit email and password inputs.
  • @vyui/kitv0.1.2

    @vyui/kit v0.1.2

    Patch Changes

    • cbbbcbf: Ensure tray, drawer, and action sheet content renders above the sheet backdrop by default, and disable automatic capitalization and correction for kit email and password inputs.
    • Updated dependencies cbbbcbf
      • @vyui/core@0.1.2
  • @vyui/corev0.1.1

    @vyui/core v0.1.1

    Patch Changes

    • bb4d208: Add VyTray — a morphing, multi-view bottom sheet built on the core Sheet primitives. Views (VyTrayView) are measured per screen and the panel animates its height to fit whichever is showing ("grows into place"), with a back stack (useTray().goBack / canGoBack), a persistent #footer slot, and floating (detached card) vs flush (edge-anchored) variants.
      @vyui/core SheetContent gains a fitContent prop that sizes the panel to its natural content height instead of a snapPoints × viewport fraction — the drag/slide/backdrop physics reuse the measured height, so nothing else changes. This is the mode VyTray builds on.
    • 31c2202: Add side-aware sheet and drawer motion. SheetRoot now accepts side for top, right, bottom, and left edge placement with matching slide animations and drag-to-dismiss physics. VyDrawer forwards its side to the core sheet, and sheet-backed kit components can opt into alternate edges.
      Edge placement and the enter/leave slide keyframes key off a vyui-sheet__content--{side} class rather than a [data-side] attribute selector, so they apply on Lynx native (which does not match attribute selectors in CSS) — restoring the open/close animation on device.
  • @vyui/kitv0.1.1

    @vyui/kit v0.1.1

    Patch Changes

    • bb4d208: Add VyTray — a morphing, multi-view bottom sheet built on the core Sheet primitives. Views (VyTrayView) are measured per screen and the panel animates its height to fit whichever is showing ("grows into place"), with a back stack (useTray().goBack / canGoBack), a persistent #footer slot, and floating (detached card) vs flush (edge-anchored) variants.
      @vyui/core SheetContent gains a fitContent prop that sizes the panel to its natural content height instead of a snapPoints × viewport fraction — the drag/slide/backdrop physics reuse the measured height, so nothing else changes. This is the mode VyTray builds on.
    • 31c2202: Add side-aware sheet and drawer motion. SheetRoot now accepts side for top, right, bottom, and left edge placement with matching slide animations and drag-to-dismiss physics. VyDrawer forwards its side to the core sheet, and sheet-backed kit components can opt into alternate edges.
      Edge placement and the enter/leave slide keyframes key off a vyui-sheet__content--{side} class rather than a [data-side] attribute selector, so they apply on Lynx native (which does not match attribute selectors in CSS) — restoring the open/close animation on device.
    • Updated dependencies bb4d208
    • Updated dependencies 31c2202
      • @vyui/core@0.1.1
  • @vyui/corev0.1.0

    @vyui/core v0.1.0

    Minor Changes

    • 0610d70: Input/Textarea: surface the on-screen keyboard via a normalized keyboard event.
      • Input and Textarea (core) and VyInput/VyTextarea (kit) now emit keyboard with { visible: boolean, height: number, safeAreaBottom: number }, normalized from Lynx's raw element payload { show, keyBoardHeight, safeAreaBottom } (note the capital B in keyBoardHeight).
      • This is the reliable keyboard signal under vue-lynx: the global GlobalEventEmitter keyboardstatuschanged event is emitted natively but is not delivered to the vue-lynx background runtime, so the per-element event is what consumers (and keyboard-aware lifts) should use. See docs/upstream/vue-lynx-keyboard.md.
      • VyTextarea also now forwards confirm/focus/blur (previously only update:modelValue), matching VyInput.

    Patch Changes

    • 0610d70: FeedList: honour a noMoreData prop so the end-of-list footer no longer shows while more pages remain.
      Previously the core FeedList rendered the noMoreDataFooter slot whenever loadingMore was false, so "no more items" appeared immediately even with pages still loadable (the kit VyFeedList already forwarded noMoreData, but core ignored it). The footer row now only renders while loadingMore (load-more spinner) or once noMoreData is true (end-of-list); otherwise no footer renders.
    • baf0692: Fix drawer/sheet not opening fully: Lynx native drops the dvh unit, collapsing the panel to its content height. Size the sheet panel with vh and switch all viewport-height classes in the kit themes (drawer, modal, select, combobox, popover, dropdownMenu, island, actionSheet) from dvh to vh.
    • 0610d70: Fix Sortable drag-to-reorder doing nothing on device/web:
      • Registry was empty on the main thread. Items registered their handle via a background-thread write to the itemHandlesMT MainThreadRef, which vue-lynx 0.4.0 silently drops. The lifted row never moved, siblings never shifted, and the drop saw count === 0 so no reorder committed. Registration (element + index) now runs on the main thread, bound to main-thread-binduiappear, with MT teardown on unmount and runOnMainThread setter worklets for index/disabled sync.
      • Long-press used MT setTimeout. The main-thread worklet runtime does not expose setTimeout/clearTimeout (internal in @lynx-js/types), so the long-press timer threw and the row never lifted for any longPressMs > 0. The hold is now timed by polling requestAnimationFrame on the main thread.

      Public props/emits/slots unchanged.
    • 300e34f: Keep sheet snap and drag geometry synchronized with dynamic viewport changes, and make kit swipers fill their measured container when no explicit item width is provided.
  • @vyui/kitv0.1.0

    @vyui/kit v0.1.0

    Minor Changes

    • 0610d70: Input/Textarea: surface the on-screen keyboard via a normalized keyboard event.
      • Input and Textarea (core) and VyInput/VyTextarea (kit) now emit keyboard with { visible: boolean, height: number, safeAreaBottom: number }, normalized from Lynx's raw element payload { show, keyBoardHeight, safeAreaBottom } (note the capital B in keyBoardHeight).
      • This is the reliable keyboard signal under vue-lynx: the global GlobalEventEmitter keyboardstatuschanged event is emitted natively but is not delivered to the vue-lynx background runtime, so the per-element event is what consumers (and keyboard-aware lifts) should use. See docs/upstream/vue-lynx-keyboard.md.
      • VyTextarea also now forwards confirm/focus/blur (previously only update:modelValue), matching VyInput.

    Patch Changes

    • 300e34f: Add small horizontal (landscape) mode support — the work that gets the kit-demo running on mobile in landscape. Compact, viewport-safe layouts for overlays, sheets, menus, tabs, steppers, islands, cards, alerts, and toasts. Select and Combobox sheet structure is now fully themeable for responsive overrides.
    • 0610d70: Input: forward @focus and @blur events.
      • The core Input emits focus/blur (with the current value), but the VyInput wrapper only re-emitted update:modelValue and confirm, so consumers couldn't react to focus changes (e.g. to drive a keyboard-aware lift). It now forwards both.
    • 0610d70: IslandButton: bake the icon color so the theme's foreground actually applies.
      • IslandButton rendered its glyph through Lynx's <svg>, which rasterizes the XML and can't inherit currentColor — so the text-slate-* utility on the leadingIcon slot (and the darker text-slate-900 active shade) never reached the icon, leaving it stuck on its default fill (invisible on dark/active pills).
      • It now resolves the foreground utility off the merged leadingIcon class — honoring the active state and any consumer ui.leadingIcon override — and passes it to <VyIcon :color>, matching the pattern already used by Button, Input, Alert, and Combobox. Non-palette colors (e.g. arbitrary text-[#abc]) fall back to the icon's currentColor default.
    • 491db6a: Default input chrome to neutral: form controls no longer paint a primary border or icon by default.
      • Resting border on Input, Textarea, Select, Combobox, NumberField and PinInput is now neutral (border-neutral-200) regardless of color — matching the no-focus-state reality on Lynx. The colored border stays available as opt-in via the highlight prop.
      • Leading/trailing icons (and NumberField steppers) now default to neutral (dimmed) instead of the color palette; override per-icon with your own :color via the leading / trailing slots.
      • RadioGroup: space the control from its label with gap-2 on the item instead of ms-2 on the wrapper — Lynx ignores logical inline margins, which collapsed the dot and text together.
    • baf0692: Fix drawer/sheet not opening fully: Lynx native drops the dvh unit, collapsing the panel to its content height. Size the sheet panel with vh and switch all viewport-height classes in the kit themes (drawer, modal, select, combobox, popover, dropdownMenu, island, actionSheet) from dvh to vh.
    • 300e34f: Keep sheet snap and drag geometry synchronized with dynamic viewport changes, and make kit swipers fill their measured container when no explicit item width is provided.
    • 14e0722: Add @vyui/cli, a shadcn-style CLI that copies @vyui/kit components (and their dependencies) into a project from a style-namespaced registry, rewriting imports to the consumer's aliases.
      • init / add / styles commands; tsconfig/jsconfig alias + package-manager detection.
      • Shadcn-style project preflight and automatic, idempotent app-entry/Tailwind wiring.
      • list, view, info, interactive add, and --dry-run discovery/preview workflows.
      • Safe upgrades: explicit components may be overwritten while shared files and transitive dependencies remain user-owned.
      • Registry targets are contained to the project root (rejects ../ / absolute / null-byte paths).
      • Cyclic registry dependency graphs resolve instead of deadlocking.

      kit: drive the switch thumb with flex justification instead of translate-x-* (Lynx drops transform painting), and reset the native <textarea> user-agent border.
    • 300e34f: Make vertical tabs reserve a navigation rail and let their content fill the remaining width. Vertical triggers no longer inherit the horizontal pill variant's flex-1 stretch — they keep their natural height and left-align their icon/label so the rail reads as a sidebar list.
    • Updated dependencies 0610d70
    • Updated dependencies 0610d70
    • Updated dependencies baf0692
    • Updated dependencies 0610d70
    • Updated dependencies 300e34f
      • @vyui/core@0.1.0
  • @vyui/corev0.0.6

    Gesture & scroll motion overhaul

    A motion-focused release: the scroll and gesture primitives gain the physics they were missing on native Lynx.

    FeedList gets a full pull-to-refresh + paging surface. Pull-to-refresh is a custom rubber-band driven by :main-thread-bindtouch* worklets on a bare <list> — it only engages at the top edge, so normal scrolling and load-more are untouched. New: enableRefresh + v-model:refreshing, refreshThreshold, refresh / refreshStateChange emits and a refreshHeader slot ({ state, progress }); enableBounce rubber-band overscroll at both edges; itemSnap native item-snap paging with a snap emit; and debounced load-more on scrolltolower with loadMoreFooter / noMoreDataFooter slots. The legacy native <refresh> path (unregistered in the OSS Lynx runtime) is removed.

    ScrollView adds a main-thread custom bounce/overscroll system mirroring lynx-ui: enableBounces, singleSidedBounce, alwaysBouncing, trigger-distance and estimated-size props, enableRTL, upperBounceItem / lowerBounceItem slots, and an onScrollToBounces event — driven by the new useBounce composable.

    Swiper loop is now truly seamless — edge slides are cloned and the transform rebases invisibly across the first↔last seam under both drag-release and autoplay. Adds loop/circular, axisLock, autoplay + interval, plus lynx-ui prop parity: spaceBetween, mode, align + containerWidth, offsetLimit, and rtl.

    Sortable, Draggable & SwipeAction tighten on-device gesture fidelity: velocity-aware release (fling/momentum), axis locking, autoscroll near Sortable list edges, and bounds clamping, via shared helpers in shared/gesture/physics.ts. Fixes two regressions — Sortable long-press now arms entirely on the main thread (the BG round-trip was being dropped on-device), and SwipeAction cancels its in-flight fill: 'forwards' snap on touchstart so a follow-up slow drag isn't masked.

    Toast internals are prepped for stacking: ToastRoot binds its own @layoutchange to feed fan-out geometry, exposes duration and progress slot values, and ships a new ToastSwipe main-thread swipe-to-dismiss layer (exporting the unit-tested decideDismiss policy).

  • @vyui/kitv0.0.4

    Stacked toasts & FeedList gestures

    @vyui/kit@0.0.4 brings the new core gesture surface to the styled components.

    Toast gains Sonner-style behaviour, all off by default:

    • stacked — collapses toasts into an overlapping pile (front toast fully visible, the rest peeking scaled-down behind it) and fans them out when expanded; tap to toggle. Pair stackFrom (top | bottom) with the ToastViewport position.
    • swipe (+ swipeDirection) — fling a toast sideways to dismiss. The card rides an inner ToastSwipe layer so the swipe transform never collides with the stacking transform.
    • progress — a thin countdown bar that drains with the auto-dismiss timer (pauses while expanded, hidden when duration: 0).

    A plain VyToast still renders as a single gapped-column card.

    FeedList wrapper now forwards the full pull-to-refresh surface to core — enableRefresh, v-model:refreshing, refreshThreshold, enableBounce, the refresh / refreshStateChange emits, and the refreshHeader slot ({ state, progress }) — plus the new itemSnap prop and snap emit. The loadMoreFooter slot is aligned with core's new no-arg signature (the footer renders only while loading).

  • @vyui/corev0.0.5

    @vyui/core v0.0.5

    Patch Changes

    • Add AspectRatio — headless @vyui/core primitive (AspectRatioRoot, exported as both AspectRatio and AspectRatioRoot) that constrains its default slot to a given ratio (number, default 1). (#46)
      Built for the Lynx render layer: it renders a single <view> using the native CSS aspect-ratio property (supported by Lynx's Starlight layout engine), with no absolutely-positioned padding wrapper.
    • Add Avatar — Lynx-native @vyui/core primitives (AvatarRoot / AvatarImage / AvatarFallback). AvatarRoot provides image load-status context; AvatarImage renders a Lynx <image> and downgrades to the error state on binderror (@error); AvatarFallback shows when no image is loaded, with a delayMs flash-avoidance delay. (#46)
      Refactor @vyui/kit's VyAvatar to compose the new core primitives for behaviour (load-status + fallback) while keeping its public AvatarProps API, initials derivation, chip overlay, theming, and AvatarGroup size/color inheritance unchanged.
    • Fixes from #67, #68 and #70. (#71)
      @vyui/core:
      • Icon: reject color values that could inject SVG markup when resolving icon sources (#67).
      • Sheet: multi-snap drag now settles to the nearest snap point, with main-thread usage fixes across SheetContentImpl, Draggable and useDragGesture (#68).
      • Primitive: treat image as a self-closing leaf — Vue's empty-slot fragment/comment anchors were materialized as real children by vue-lynx, and a native <image> with any child fails to render (native-only breakage; lynx-web tolerated it) (#70).

      @vyui/kit:
      • Forward icon classes/props through ActionSheet, Alert, Button, Tabs, Toast, ToggleGroup and DropdownMenu items, and fix Drawer/theme slot classes so drawer animations work again (#70).
  • @vyui/kitv0.0.3

    @vyui/kit v0.0.3

    Patch Changes

    • Add Avatar — Lynx-native @vyui/core primitives (AvatarRoot / AvatarImage / AvatarFallback). AvatarRoot provides image load-status context; AvatarImage renders a Lynx <image> and downgrades to the error state on binderror (@error); AvatarFallback shows when no image is loaded, with a delayMs flash-avoidance delay. (#46)
      Refactor @vyui/kit's VyAvatar to compose the new core primitives for behaviour (load-status + fallback) while keeping its public AvatarProps API, initials derivation, chip overlay, theming, and AvatarGroup size/color inheritance unchanged.
    • Configurable semantic colors (nuxt/ui-style), defined once and extensible. (#48)
      • Single source of truth theme/color-constants.js (shared by themes + Tailwind preset); neutral split out of the configurable COLORS list and appended automatically (nuxt/ui parity).
      • Theme files are now builder functions (colors) => themeObject; useStyledComponent invokes them with the resolved list so appConfig.ui.colors configures the set at runtime.
      • @vyui/kit/tailwind adds a createVyuiPreset({ colors }) factory; the default export is unchanged.
      • True type parity via the augmentable VyuiColorRegistry interface — declare module '@vyui/kit' { interface VyuiColorRegistry { tertiary: true } } makes custom colors autocomplete + typo-check on every component color prop, no build plugin needed. scripts/gen-colors.mjs generates the registry augmentation + CSS-var block.
      • Fixes a latent ThemeTV widening that typed color (and other variants) as PropertyKey on useStyledComponent-based components.

      Breaking: theme default exports changed from objects to builder functions; COLORS no longer includes neutral (use ALL_COLORS).
    • Fixes from #67, #68 and #70. (#71)
      @vyui/core:
      • Icon: reject color values that could inject SVG markup when resolving icon sources (#67).
      • Sheet: multi-snap drag now settles to the nearest snap point, with main-thread usage fixes across SheetContentImpl, Draggable and useDragGesture (#68).
      • Primitive: treat image as a self-closing leaf — Vue's empty-slot fragment/comment anchors were materialized as real children by vue-lynx, and a native <image> with any child fails to render (native-only breakage; lynx-web tolerated it) (#70).

      @vyui/kit:
      • Forward icon classes/props through ActionSheet, Alert, Button, Tabs, Toast, ToggleGroup and DropdownMenu items, and fix Drawer/theme slot classes so drawer animations work again (#70).
    • Fix stranded foreground colors on Lynx (enableCSSInheritance: false). Color set on a wrapping <view> slot never reached the nested text/icon, so it rendered in the default color — invisible on dark/colored surfaces (e.g. a neutral-solid button or solid card). (#52)
      Foreground text-* now lands on the text-bearing slots (label / title / description / icon / input value) across input, textarea, numberField, select, combobox, toggle, toggleGroup, chip, islandButton, card, accordion, dropdownMenu, tabs, stepper. State-driven colors on child elements use the group-data-[state=…] form, and the Tailwind preset safelist is widened to cover those variants so they aren't purged.
    • Updated dependencies [1b0d3bc, 1b0d3bc, 9a0241c]:
      • @vyui/core@0.0.5
  • @vyui/corev0.0.4

    @vyui/core v0.0.4

    Patch Changes

    • Add NumberField — headless @vyui/core primitive (NumberFieldRoot / NumberFieldInput / NumberFieldIncrement / NumberFieldDecrement) with min/max/step, clamp/snap and decimal-precision handling, plus a styled VyNumberField in @vyui/kit. (#44)
      Fix Input not reflecting programmatic value changes on native Lynx — controlled updates that don't originate from typing are now pushed through the imperative setValue path (the reactive value binding is initial-only on a native <input>). This makes NumberField's increment/decrement buttons update the field on iOS/Android, not just web.
      Avatar now falls back to initials/icon when its image fails to load (wires the Lynx <image> binderror event).
      Document VyCombobox as the autocomplete pattern — searchable filtering over a fixed set covers the use case, so there is no separate Autocomplete component.
      Widen @vyui/kit's @vyui/core peer-dependency range from ^ to ~ so it tracks 0.0.x core patches without forcing a major bump.
  • @vyui/kitv0.0.2

    NumberField, Island DX & polish

    @vyui/kit@0.0.2 adds a component, sharpens an existing one, and fixes a handful of native-Lynx rough edges.

    NumberField — a new headless @vyui/core primitive (NumberFieldRoot / NumberFieldInput / NumberFieldIncrement / NumberFieldDecrement) with min/max/step, clamp/snap and decimal-precision handling, plus a styled VyNumberField in @vyui/kit.

    Island gets a clearer API and better defaults. A new layer prop (overlay / base / inline) splits stacking from placement: position now only picks the viewport edge (top / bottom), while layer decides whether the island floats over content, sits on a low layer beneath modals and drawers, or drops into normal flow for a parent to place. Floating is applied via an inline style, so a lone <VyIsland> hovers with no wrapper on Lynx. Out of the box Island defaults to overlay and IslandGroup to bottom, so both float sensibly with zero config.

    Fixes & docs

    • Input now reflects programmatic value changes on native Lynx — controlled updates that don't come from typing are pushed through the imperative setValue path, so NumberField's increment/decrement work on iOS and Android, not just web.
    • Avatar falls back to initials/icon when its image fails to load, wiring the Lynx <image> binderror event.
    • VyCombobox is documented as the autocomplete pattern — searchable filtering covers the use case, so there's no separate Autocomplete component.
    • The @vyui/core peer-dependency range widens from ^ to ~, so kit tracks 0.0.x core patches without forcing a major bump.
  • @vyui/corev0.0.3

    Lynx-native a11y & shared gestures

    Accessibility is wired through Lynx-native APIs instead of DOM assumptions, and the Swiper's gesture physics is extracted into a shared engine behind useDragGesture with a generic pickSnap helper — ready to power any swipe-driven primitive.

  • @vyui/kitv0.0.1

    Styled Button, Switch & Tabs

    @vyui/kit publishes its first styled components — Button, Switch, and Tabs — composed on top of @vyui/core primitives. Available now on npm as @vyui/kit@0.0.1.

  • @vyui/corev0.0.2

    Performance & packaging

    Icon resolution is memoized across instances to cut repeated work, with dependency pruning and packaging hardening to keep @vyui/core lean and safe to install.

  • @vyui/corev0.0.1

    First release

    @vyui/core publishes its first primitives: behavioural, accessible building blocks that run natively on Lynx and on the web from a single Vue codebase. Zero styling — compose them yourself or reach for @vyui/kit.

  • @vyui/kitInitial

    Kit scaffolded

    @vyui/kit is scaffolded as part of the monorepo, sitting alongside @vyui/core and the documentation site — the home for opinionated, themed components.