jaml-ui 4.3.1 → 4.6.0

package/dist/ui/orbitalLayout.d.ts

@@ -0,0 +1,149 @@
+export declare const FULL_CIRCLE_RAD: number;
+/** Angle reserved for the pinned back/start button. Positive Y is down. */
+export declare const SOUTH_ANGLE_RAD: number;
+/** ~half height of an orbital pill (px) — paired with width for mascot clearance. */
+export declare const PILL_HALF_H = 16;
+/** Gap (px) between the mascot bitmap edge and the nearest pill corner. */
+export declare const MASCOT_CLEARANCE_GAP = 10;
+/** Floor width for the south button so it always reads as the primary action. */
+export declare const MIN_SOUTH_WIDTH = 148;
+/**
+ * Inset (px) from the container edge for the bottom-pinned south button.
+ *
+ * Small on purpose: Balatro's exit button is full-bleed against its modal's
+ * inner edge, so this is a hairline breathing gap, not a margin.
+ */
+export declare const SOUTH_EDGE_INSET = 4;
+/** Vertical breathing gap (px) between stacked pills. */
+export declare const ARC_STACK_GAP = 6;
+/** How far (px) the page-control centers sit above the south button's center. */
+export declare const PAGE_CONTROL_LIFT = 22;
+/** Distance below orbit center at which a boxless south pill is drawn. */
+export declare const SOUTH_PILL_OFFSET = 8;
+export interface OrbitSlot<T> {
+    item: T;
+    /** Offset from orbit center, px. */
+    x: number;
+    /** Offset from orbit center, px. Positive is down (screen coords). */
+    y: number;
+}
+/** What the layout needs to know about a pill it has not measured. */
+export interface OrbitMeasure {
+    label: string;
+    hasToggleDot: boolean;
+}
+/**
+ * Estimated pill width for clamp math.
+ *
+ * Tuned for the pixel font at the `sm` button size plus its padding and the
+ * optional toggle dot. Deliberately an estimate — measuring every pill would
+ * force a layout pass per frame, and clearance only needs to be close.
+ */
+export declare function estimatePillWidth(label: string, hasToggleDot: boolean): number;
+/**
+ * Minimum distance from orbit center to pill center so the pill's *corner*
+ * clears the round mascot bitmap. Uses diagonal reach, not half-width, so pills
+ * at 45° don't clip.
+ */
+export declare function minDistanceFromMascotCenter(mascotHalfPx: number, pillHalfW: number): number;
+/**
+ * Place items on an ellipse at even angle steps, pushing outward-only when a
+ * slot would collide with the mascot.
+ *
+ * @param items        Orbital items — the south-pinned one must already be removed.
+ * @param rx           Horizontal orbit radius, px.
+ * @param ry           Vertical orbit radius, px.
+ * @param startAngle   Angle of the first slot, radians.
+ * @param stepRad      Angle between slots, radians.
+ * @param mascotSizePx Mascot hit-target diameter, px.
+ * @param measure      Label + toggle-dot presence, for width estimation.
+ */
+export declare function layoutOrbitalEllipse<T>(items: T[], rx: number, ry: number, startAngle: number, stepRad: number, mascotSizePx: number, measure: (item: T) => OrbitMeasure): Array<OrbitSlot<T>>;
+/**
+ * THE ORBIT LAW (pifreak, 2026-08-17). Read this before touching the geometry.
+ *
+ * The ring is NOT a circle, and treating it as one is what made it overflow on
+ * a short viewport. The real shape:
+ *
+ *   1. Every pill has the SAME HEIGHT. Only width varies, and it varies with
+ *      content. So **height is the only parameter that governs overlap** —
+ *      stack slots vertically with at least one pill-height between them and
+ *      two pills can never collide, whatever their labels say.
+ *   2. Then X FLIES OUT: each pill travels away from center along its own side
+ *      until its outer edge hits the container wall. Nothing is ever pulled
+ *      inward toward the mascot.
+ *   3. The arc is bounded by the TIPS of the extra-wide south button, which
+ *      spans nearly the full width along the bottom — so the arc runs from its
+ *      left tip, up the left wall, across the top, and down to its right tip.
+ *      Roughly 300°, not 360°.
+ *
+ * Why this beats the ellipse-with-clamp it replaces: an ellipse sized by
+ * min(boxW, boxH) wastes the width of a short-and-wide box and still needs a
+ * mascot-clearance push that can exceed any radius bound (measured: a 103px
+ * pill shoved 23px out of a 275x185 box). Height-spacing plus wall-flyout fills
+ * the box exactly and cannot overflow it, because the wall IS the stop
+ * condition — so the mascot never has to shrink to make the math work.
+ *
+ * The wall is HARD. There is deliberately no mascot-clearance push here: pills
+ * render above the mascot, so wall-flush X can graze the character's silhouette
+ * — measured up to ~25px for the widest toggle pill at his equator in the
+ * tightest 275px-wide phone box, ~1px for ordinary pills. That is a cosmetic
+ * cost paid knowingly: the character stays full-size and visible behind the
+ * pill, while the alternative — pushing past the wall to clear him — clips the
+ * pill out of the container, which is a functional bug. Never shrink the mascot
+ * to buy clearance; that trade was made once already and rejected.
+ *
+ * @param southTopY Y of the topmost south chrome edge (the south button, or the
+ *                  page controls when shown), relative to center, positive down.
+ *                  The arc must not descend past it.
+ */
+export declare function layoutOrbitalArc<T>(items: T[], boxW: number, boxH: number, southTopY: number, measure: (item: T) => OrbitMeasure): Array<OrbitSlot<T>>;
+/**
+ * How many pills a box holds on the arc without breaking the height law.
+ *
+ * The band conservatively reserves room for the page controls, so flipping from
+ * "fits" to "paginates" can never itself shrink the band it was measured
+ * against. This is the number a pager should respect: past it, show fewer items
+ * per page — never smaller pills, and never a smaller mascot.
+ */
+export declare function arcPageCapacity(boxH: number): number;
+/**
+ * Width of the south-pinned button when it rides the orbit (no box height).
+ *
+ * Sized to fill the angular gap it occupies so it reads as one wide primary
+ * action rather than "another pill that happens to be at the bottom", then
+ * clamped to the container and floored at {@link MIN_SOUTH_WIDTH}.
+ */
+export declare function southButtonWidth(totalSlots: number, orbitRadiusX: number, containerW: number): number;
+/**
+ * Orbit radius for a given mascot size and item count.
+ *
+ * Grows 3px per orbital item so a crowded ring breathes outward instead of
+ * cramming, and is floored so pills always clear the mascot.
+ */
+export declare function orbitRadiusForCount(mascotSizePx: number, orbitalCount: number, baseRadius: number): number;
+/**
+ * Largest orbit radius that still fits inside a boxW x boxH container.
+ *
+ * The ring is centered in its box, so only half of each dimension is available,
+ * and the outermost thing on the ring is not a pill *center* — it is the south
+ * pill's bottom edge, which sits SOUTH_PILL_OFFSET + PILL_HALF_H past the
+ * radius. Subtract both and the ring is guaranteed to stay inside.
+ *
+ * Why this exists: orbitRadiusForCount grows the radius with item count from a
+ * base derived from viewport WIDTH alone — height is never consulted. On a
+ * short viewport that combination puts the south pill below the bottom edge
+ * with no upper bound. Clamping to the box makes overflow structurally
+ * impossible instead of something every host has to notice and hand-tune.
+ */
+export declare function maxOrbitRadiusForBox(boxW: number, boxH: number): number;
+/**
+ * Clamp a desired radius to its box.
+ *
+ * The floor keeps the ring clear of the mascot: squeezing below the mascot's
+ * own half-size drops pills on top of the character, which reads as broken
+ * rather than as tight. Below that point the box is simply too small for a
+ * ring, and the caller should show fewer items rather than a smaller circle —
+ * pagination already exists for exactly that.
+ */
+export declare function clampOrbitRadius(radius: number, mascotSizePx: number, maxRadius?: number): number;

package/dist/ui/orbitalMenuStore.d.ts

@@ -0,0 +1,70 @@
+/** Submenu push/pop: pills sink to center, the stack swaps, they rise again. */
+export declare const ORBITAL_SINK_MS = 200;
+/** Full close. Must match the `.j-orbital-pill` transition in jimbo.css. */
+export declare const ORBITAL_CLOSE_MS = 320;
+export interface JimboOrbitalState {
+    /** Menu path. Empty = closed. `["main"]` = root open. */
+    stack: string[];
+    /** Zero-based page within the current menu, for menus past the page size. */
+    page: number;
+    /** Submenu labels pushed so far, for a breadcrumb. */
+    breadcrumb: string[];
+    /** Mid-animation: pills are collapsing to center. */
+    closing: boolean;
+}
+export interface JimboOrbitalStore {
+    subscribe: (listener: () => void) => () => void;
+    getState: () => JimboOrbitalState;
+    open: (root?: string) => void;
+    close: () => void;
+    back: () => void;
+    navigateTo: (submenuLabel: string) => void;
+    nextPage: (totalPages: number) => void;
+    prevPage: (totalPages: number) => void;
+    reset: () => void;
+    /**
+     * "Get out of the way — something arrived."
+     *
+     * Auto-closes the menu when background work produces a result worth looking
+     * at, so the user isn't left staring at a submenu over fresh content. In
+     * JAMMY this was seed-search results and `topScore` was the seed score; any
+     * monotonically-improving quality metric works, and it is optional.
+     *
+     * Two independent triggers:
+     *  - a new *best* score closes a submenu (depth > 1) but leaves root open
+     *  - simply *more* results than last time closes any open menu
+     */
+    signalIncomingResults: (results: {
+        count: number;
+        topScore?: number;
+    }) => void;
+}
+export declare function createJimboOrbitalStore(): JimboOrbitalStore;
+/** Shared store — the common case, one mascot per app. */
+export declare const jimboOrbitalStore: JimboOrbitalStore;
+export interface JimboOrbitalMenuController extends JimboOrbitalState {
+    /** Top of the stack, or `root` when closed. */
+    currentMenu: string;
+    /** The ring should be mounted. */
+    isOpen: boolean;
+    /** Pills should be animating toward center. */
+    isClosing: boolean;
+    /** The stack is deep enough that the south button means "back", not "exit". */
+    canGoBack: boolean;
+    open: () => void;
+    close: () => void;
+    back: () => void;
+    navigateTo: (submenuLabel: string) => void;
+    nextPage: (totalPages: number) => void;
+    prevPage: (totalPages: number) => void;
+    /** The single tap target: closed → open, open → close. */
+    toggle: () => void;
+}
+export interface UseJimboOrbitalMenuProps {
+    /** Root menu name. A welcome screen might open to `"welcome"` instead. */
+    root?: string;
+    /** Use a private store instead of the shared one. */
+    store?: JimboOrbitalStore;
+}
+/** Controller for {@link JimboOrbitalMenu} — stack, pagination, close animation. */
+export declare function useJimboOrbitalMenu({ root, store, }?: UseJimboOrbitalMenuProps): JimboOrbitalMenuController;

package/dist/ui/tokens.d.ts

@@ -1,12 +1,7 @@
 /**
- * Balatro design tokens — JS mirror of src/ui/jimbo-tokens.css :root.
- *
- * CSS custom properties (--j-*) are the source of truth for DOM.
- * Keep every hex here in lockstep with jimbo-tokens.css.
- * Do NOT replace with Lua HEX values; the game's shader pipeline transforms them.
- *
- * Use these JS constants only where CSS vars cannot apply — Canvas, SVG fills,
- * CodeMirror themes, or imperative animation APIs.
+ * JS mirror of jimbo-tokens.css :root hex.
+ * CSS vars win on DOM. Use these for Canvas, SVG, CodeMirror.
+ * Post-shader eyedrops — not Lua G.C.
  */
 export declare const JimboColorOption: {
     readonly RED: "#fe5148";
@@ -15,6 +10,8 @@ export declare const JimboColorOption: {
     readonly ORANGE: "#ff9800";
     readonly GOLD: "#e4b643";
     readonly PURPLE: "#9e74ce";
+    readonly PLANET: "#00a7ca";
+    readonly SPECTRAL: "#2e76fd";
     readonly DARK_RED: "#a02721";
     readonly DARK_BLUE: "#0057a1";
     readonly DARK_ORANGE: "#a05b00";
@@ -29,42 +26,18 @@ export declare const JimboColorOption: {
     readonly INNER_BORDER: "#334461";
     readonly BORDER_SILVER: "#b9c2d2";
     readonly BORDER_SOUTH: "#777e89";
-    readonly GOLD_TEXT: "#e4b643";
     readonly GREEN_TEXT: "#35bd86";
-    readonly ORANGE_TEXT: "#ff8f00";
     readonly WHITE: "#ffffff";
     readonly BLACK: "#000000";
-    readonly TAROT_BUTTON: "#9e74ce";
-    readonly PLANET_BUTTON: "#00a7ca";
-    readonly SPECTRAL_BUTTON: "#2e76fd";
-    readonly TAROT_BUTTON_DARK: "#5e437e";
-    readonly PLANET_BUTTON_DARK: "#00657c";
-    readonly SPECTRAL_BUTTON_DARK: "#14449e";
+    /** Same decision as GOLD — kept so CodeMirror / old callers don't grow a second gold. */
+    readonly GOLD_TEXT: "#e4b643";
 };
 export type JimboPaletteColor = keyof typeof JimboColorOption;
-/** Convert hex to rgba for inline styles in Canvas/SVG/R3F contexts. */
 export declare function withAlpha(hex: string, alpha: number): string;
-/**
- * Motion mirrors engine/moveable.lua juice_up defaults (amount 0.4, ~0.4s)
- * and press lip on UI buttons — solid south edge, not soft elevation blur.
- */
+/** Juice / sway used by JS motion. Press lip lives in CSS (--j-press-y). */
 export declare const JIMBO_ANIMATIONS: {
     readonly JUICE_UP_SCALE: 1.05;
-    readonly JUICE_DOWN_SCALE: 1;
-    /** Lua juice_up end_time ≈ start + 0.4s */
-    readonly JUICE_DURATION: 400;
-    readonly JUICE_AMOUNT: 0.4;
-    readonly JUICE_EASING: "cubic-bezier(0.34, 1.56, 0.64, 1)";
-    /** Lua zoom hover bonus */
-    readonly HOVER_SCALE: 1.05;
+    readonly JUICE_EASING: "cubic-bezier(0.16, 1, 0.3, 1)";
     readonly SWAY_AMOUNT: 1.5;
     readonly SWAY_DURATION: 4000;
-    readonly PRESS_TRANSLATE_Y: 2;
-    readonly PRESS_DURATION: 55;
-    readonly CARD_TILT_MAX: 6;
-    readonly MENU_SINK_DURATION: 200;
-    readonly MENU_RISE_DURATION: 300;
-    readonly MENU_ORBIT_DURATION: 320;
-    readonly LETTER_POP_RATE: 3;
-    readonly LETTER_BUMP_RATE: 2.666;
 };

package/dist/ui/useMotionPreference.d.ts

@@ -0,0 +1,19 @@
+export type JimboMotionSetting = 'auto' | 'full' | 'reduced';
+/**
+ * A real, user-settable motion preference — not a silent one-way OS override.
+ *
+ * `setting` starts as `'auto'` (follows the OS prefers-reduced-motion signal, same
+ * as before) but a user's explicit `'full'` or `'reduced'` choice always wins over
+ * the OS, in both directions: someone can ask for full tactile motion even with the
+ * OS set to reduce, or ask for reduced motion even when the OS says nothing. The
+ * choice persists across visits via localStorage.
+ *
+ * Writes the `data-j-motion` attribute on <html>, which jimbo-tokens.css and
+ * jimbo.css both key off — see the motion-setting block in jimbo-tokens.css.
+ */
+export declare function useMotionPreference(): {
+    setting: JimboMotionSetting;
+    setSetting: (next: JimboMotionSetting) => void;
+    osPrefersReduced: boolean;
+    effectiveReducedMotion: boolean;
+};

package/dist/ui.d.ts

@@ -1,8 +1,9 @@
 export * from './ui/tokens.js';
+export { useMotionPreference, type JimboMotionSetting } from './ui/useMotionPreference.js';
 export { JimboButton, type JimboButtonProps } from './ui/JimboButton.js';
 export { JimboTextArea, type JimboTextAreaProps } from './ui/JimboTextArea.js';
 export { JimboPanel, type JimboPanelProps } from './ui/JimboPanel.js';
-export { JimboBackground } from './ui/JimboBackground.js';
+export { JimboBackground, type JimboBackgroundConfig } from './ui/JimboBackground.js';
 export { JimboApp, type JimboAppProps, type JimboAppVariant } from './ui/JimboApp.js';
 export { JimboInset, type JimboInsetProps } from './ui/JimboInset.js';
 export { JimboWordmark, type JimboWordmarkProps } from './ui/JimboWordmark.js';
@@ -17,10 +18,27 @@ export { JimboDivider, type JimboDividerProps } from './ui/JimboDivider.js';
 export { JimboStatusPill, type JimboStatusPillProps, type JimboStatus } from './ui/JimboStatusPill.js';
 export { JimboErrorBlock, type JimboErrorBlockProps } from './ui/JimboErrorBlock.js';
 export { JimboMascot, type JimboMascotProps } from './ui/JimboMascot.js';
-export { JimboOrbitalMenu, type JimboOrbitalMenuProps, type JimboOrbitalMenuItem, } from './ui/JimboOrbitalMenu.js';
+export { JimboOrbitalMenu, type JimboOrbitalMenuProps, type JimboOrbitalMenuItem, type JimboOrbitalTone, } from './ui/JimboOrbitalMenu.js';
+export { useJimboOrbitalMenu, createJimboOrbitalStore, jimboOrbitalStore, ORBITAL_CLOSE_MS, ORBITAL_SINK_MS, type JimboOrbitalState, type JimboOrbitalStore, type JimboOrbitalMenuController, type UseJimboOrbitalMenuProps, } from './ui/orbitalMenuStore.js';
+export { layoutOrbitalArc, layoutOrbitalEllipse, arcPageCapacity, clampOrbitRadius, estimatePillWidth, maxOrbitRadiusForBox, minDistanceFromMascotCenter, orbitRadiusForCount, southButtonWidth, ARC_STACK_GAP, FULL_CIRCLE_RAD, MASCOT_CLEARANCE_GAP, MIN_SOUTH_WIDTH, PAGE_CONTROL_LIFT, PILL_HALF_H, SOUTH_ANGLE_RAD, SOUTH_EDGE_INSET, SOUTH_PILL_OFFSET, type OrbitSlot, type OrbitMeasure, } from './ui/orbitalLayout.js';
 export { JimboSeedCopyChip, type JimboSeedCopyChipProps } from './ui/JimboSeedCopyChip.js';
 export { JimboSpinner, type JimboSpinnerProps } from './ui/JimboSpinner.js';
+export { JimboPanelSpinner, type JimboPanelSpinnerProps } from './ui/JimboPanelSpinner.js';
 export { JimboTextInput, type JimboTextInputProps } from './ui/JimboTextInput.js';
 export { JimboInnerPanel, type JimboInnerPanelProps, JimboModal, type JimboModalProps } from './ui/panel.js';
 export { JimboOuterTab, type JimboOuterTabProps, type JimboOuterTabTone } from './ui/JimboOuterTab.js';
+export { JimboDock, type JimboDockProps, type JimboDockPane, defaultPyramidDock, dockActivate, type DockNode, } from './ui/JimboDock.js';
+export { JimboBox, type JimboBoxProps } from './ui/JimboBox.js';
+export { JimboInline, type JimboInlineProps } from './ui/JimboInline.js';
+export { JimboCanvas, type JimboCanvasProps } from './ui/JimboCanvas.js';
+export { JimboLink, type JimboLinkProps } from './ui/JimboLink.js';
+export { JimboListItem, type JimboListItemProps } from './ui/JimboListItem.js';
+export { JimboInlineEdit, type JimboInlineEditProps, type JimboInlineEditSize, type JimboInlineEditTone, } from './ui/JimboInlineEdit.js';
+export { JimboPicker, JimboPickerSection, JimboPickerSearch, JimboPickerHint, JimboPickerGrid, type JimboPickerGridProps, JimboPickerItem, type JimboPickerItemProps, JimboPickerPair, JimboPickerEmpty, } from './ui/JimboPicker.js';
+export { JimboCodeSurface, type JimboCodeSurfaceProps } from './ui/JimboCodeSurface.js';
+export { JimboFlankNav, type JimboFlankNavProps } from './ui/jimboFlankNav.js';
+export { JimboTabs, type JimboTabsProps, type JimboTabDef } from './ui/jimboTabs.js';
+export { JimboSprite, type JimboSpriteProps } from './ui/sprites.js';
 export { JimboSwipeDeck, type JimboSwipeDeckProps } from './ui/JimboSwipeDeck.js';
+export { JimboShopBelt, type JimboShopBeltProps } from './ui/JimboShopBelt.js';
+export { type JimboTone } from './ui/panel.js';

package/dist/ui.js

@@ -1,35 +1,82 @@
 "use client";
-import { J as i, a as s, b, c as m, d as J, e, f as t, g as r, h as n, i as p, j as l, k as c, l as d, m as u, n as S, o as B, p as I, q as k, r as A, s as x, t as M, u as O, v as T, w as h, x as w, y as C, z as g, A as P, B as f, C as v } from "./chunks/JimboSwipeDeck-D2AVuZep.js";
+import { A as s, F as o, J as e, a as b, b as m, c as t, d as r, e as J, f as n, g as c, h as l, i as S, j as O, k as _, l as P, m as u, n as A, o as I, p as d, q as k, r as T, s as p, t as C, u as L, v as E, w as B, x as M, y as R, z as h, B as D, C as F, D as H, E as N, G as x, H as G, I as y, K as f, L as U, M as g, N as v, O as W, P as w, Q as j, R as K, S as q, T as z, U as Q, V, W as X, X as Y, Y as Z, Z as $, _ as aa, $ as ia, a0 as sa, a1 as oa, a2 as ea, a3 as ba, a4 as ma, a5 as ta, a6 as ra, a7 as Ja, a8 as na, a9 as ca, aa as la, ab as Sa, ac as Oa, ad as _a, ae as Pa, af as ua, ag as Aa, ah as Ia, ai as da, aj as ka, ak as Ta, al as pa, am as Ca } from "./chunks/JimboSwipeDeck-DbzWak3V.js";
 export {
-  i as JIMBO_ANIMATIONS,
-  s as JimboApp,
-  b as JimboBackground,
-  m as JimboBadge,
+  s as ARC_STACK_GAP,
+  o as FULL_CIRCLE_RAD,
+  e as JIMBO_ANIMATIONS,
+  b as JimboApp,
+  m as JimboBackground,
+  t as JimboBadge,
+  r as JimboBox,
   J as JimboButton,
-  e as JimboColorOption,
-  t as JimboDivider,
-  r as JimboErrorBlock,
-  n as JimboGrid,
-  p as JimboIconButton,
-  l as JimboInnerPanel,
-  c as JimboInset,
-  d as JimboMascot,
-  u as JimboModal,
-  S as JimboOrbitalMenu,
-  B as JimboOuterTab,
-  I as JimboPanel,
-  k as JimboRow,
-  A as JimboSectionHeader,
-  x as JimboSeedCopyChip,
-  M as JimboSpacer,
-  O as JimboSpinner,
-  T as JimboStack,
-  h as JimboStatusPill,
-  w as JimboSwipeDeck,
-  C as JimboText,
-  g as JimboTextArea,
-  P as JimboTextInput,
-  f as JimboWordmark,
-  v as withAlpha
+  n as JimboCanvas,
+  c as JimboCodeSurface,
+  l as JimboColorOption,
+  S as JimboDivider,
+  O as JimboDock,
+  _ as JimboErrorBlock,
+  P as JimboFlankNav,
+  u as JimboGrid,
+  A as JimboIconButton,
+  I as JimboInline,
+  d as JimboInlineEdit,
+  k as JimboInnerPanel,
+  T as JimboInset,
+  p as JimboLink,
+  C as JimboListItem,
+  L as JimboMascot,
+  E as JimboModal,
+  B as JimboOrbitalMenu,
+  M as JimboOuterTab,
+  R as JimboPanel,
+  h as JimboPanelSpinner,
+  D as JimboPicker,
+  F as JimboPickerEmpty,
+  H as JimboPickerGrid,
+  N as JimboPickerHint,
+  x as JimboPickerItem,
+  G as JimboPickerPair,
+  y as JimboPickerSearch,
+  f as JimboPickerSection,
+  U as JimboRow,
+  g as JimboSectionHeader,
+  v as JimboSeedCopyChip,
+  W as JimboShopBelt,
+  w as JimboSpacer,
+  j as JimboSpinner,
+  K as JimboSprite,
+  q as JimboStack,
+  z as JimboStatusPill,
+  Q as JimboSwipeDeck,
+  V as JimboTabs,
+  X as JimboText,
+  Y as JimboTextArea,
+  Z as JimboTextInput,
+  $ as JimboWordmark,
+  aa as MASCOT_CLEARANCE_GAP,
+  ia as MIN_SOUTH_WIDTH,
+  sa as ORBITAL_CLOSE_MS,
+  oa as ORBITAL_SINK_MS,
+  ea as PAGE_CONTROL_LIFT,
+  ba as PILL_HALF_H,
+  ma as SOUTH_ANGLE_RAD,
+  ta as SOUTH_EDGE_INSET,
+  ra as SOUTH_PILL_OFFSET,
+  Ja as arcPageCapacity,
+  na as clampOrbitRadius,
+  ca as createJimboOrbitalStore,
+  la as defaultPyramidDock,
+  Sa as dockActivate,
+  Oa as estimatePillWidth,
+  _a as jimboOrbitalStore,
+  Pa as layoutOrbitalArc,
+  ua as layoutOrbitalEllipse,
+  Aa as maxOrbitRadiusForBox,
+  Ia as minDistanceFromMascotCenter,
+  da as orbitRadiusForCount,
+  ka as southButtonWidth,
+  Ta as useJimboOrbitalMenu,
+  pa as useMotionPreference,
+  Ca as withAlpha
 };
 //# sourceMappingURL=ui.js.map

package/dist/vocab.d.ts

@@ -0,0 +1,26 @@
+/** Joker rarity as the engine models it. */
+export type JokerRarityName = "Common" | "Uncommon" | "Rare" | "Legendary";
+/**
+ * Engine keys are PascalCase ids ("GreedyJoker"); sprite sheets use spaced
+ * display names ("Greedy Joker"). Both collapse to lowercase-alphanumeric so
+ * they can be compared.
+ */
+export declare const normalizeItemName: (name: string) => string;
+/** Normalize a display name into its engine-comparable key. */
+export declare const engineKey: (name: string) => string;
+export declare const COMMON_JOKER_KEYS: ReadonlySet<string>;
+export declare const UNCOMMON_JOKER_KEYS: ReadonlySet<string>;
+export declare const RARE_JOKER_KEYS: ReadonlySet<string>;
+/**
+ * Legendaries are the full joker set minus the three named tiers — the engine
+ * ships no legendary-name enum. If a future engine adds a fifth rarity, those
+ * jokers would silently land here; `check-vocab-drift.mjs` asserts the tier
+ * counts still partition the full list so that shows up as a CI failure.
+ */
+export declare const LEGENDARY_JOKER_KEYS: ReadonlySet<string>;
+/** Rarity tier for a joker, by engine key or sprite display name. */
+export declare function jokerRarityOf(name: string): JokerRarityName;
+/** True when the name is one of the engine's legendary jokers. */
+export declare const isLegendaryJokerName: (name: string) => boolean;
+/** The JAML clause discriminator that scopes a search to this rarity. */
+export declare function rarityClauseKey(rarity: JokerRarityName): string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jaml-ui",
-  "version": "4.3.1",
-  "description": "Zero-dependency json-render engine + Balatro card sprites for MCP Apps.",
+  "version": "4.6.0",
+  "description": "Balatro card sprites and the Jimbo design system for MCP Apps, with a @json-render (Vercel Labs) catalog.",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -18,10 +18,6 @@
       "types": "./dist/core.d.ts",
       "default": "./dist/core.js"
     },
-    "./motely": {
-      "types": "./dist/motely.d.ts",
-      "default": "./dist/motely.js"
-    },
     "./jimbo.css": "./dist/ui/jimbo.css",
     "./fonts.css": "./fonts.css",
     "./assets/*": "./assets/*"
@@ -39,26 +35,9 @@
     "README.md",
     "LICENSE"
   ],
-  "scripts": {
-    "build": "vite build",
-    "dev": "storybook dev",
-    "dev:watch": "vite build --watch",
-    "jaml:mcp": "node scripts/jaml-mcp-server.mjs",
-    "typecheck": "tsc --noEmit --pretty false",
-    "typecheck:all": "pnpm typecheck && pnpm -r --if-present run typecheck",
-    "prepack": "npm run build",
-    "storybook": "pnpm run build && storybook dev -p 3141",
-    "build-storybook": "pnpm run build && storybook build",
-    "lint": "eslint ."
-  },
   "engines": {
     "node": ">=18"
   },
-  "pnpm": {
-    "onlyBuiltDependencies": [
-      "esbuild"
-    ]
-  },
   "publishConfig": {
     "access": "public"
   },
@@ -84,43 +63,60 @@
   "author": "pifreak",
   "license": "MIT",
   "dependencies": {
+    "@json-render/core": "^0.20.0",
+    "@json-render/react": "^0.20.0",
     "jaml-lang": "^3.14.2",
     "react-icons": "^5.7.0",
-    "yaml": "^2.9.0"
+    "zod": "^4.5.4"
   },
   "peerDependencies": {
-    "motely-wasm": "^25.0.0",
+    "motely-wasm": "^25.1.0",
     "react": "^18.2.0 || ^19.0.0",
     "react-dom": "^18.2.0 || ^19.0.0"
   },
   "devDependencies": {
     "@codemirror/autocomplete": "^6.20.3",
-    "@codemirror/commands": "^6.10.4",
+    "@codemirror/commands": "^6.11.0",
     "@codemirror/language": "^6.12.4",
     "@codemirror/lint": "^6.9.7",
-    "@codemirror/state": "^6.7.1",
-    "@codemirror/view": "^6.43.7",
+    "@codemirror/state": "^6.7.2",
+    "@codemirror/view": "^6.43.10",
     "@eslint/js": "^10.0.1",
     "@lezer/highlight": "^1.2.3",
-    "@storybook/addon-docs": "^10.5.5",
-    "@storybook/react": "^10.5.5",
-    "@storybook/react-vite": "^10.5.5",
+    "@storybook/addon-docs": "^10.5.10",
+    "@storybook/react": "^10.5.10",
+    "@storybook/react-vite": "^10.5.10",
     "@types/node": "^25.9.5",
-    "@types/react": "^19.2.17",
-    "@types/react-dom": "^19.2.3",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.5",
     "@vitejs/plugin-react": "^5.2.0",
-    "eslint": "^10.8.0",
+    "eslint": "^10.9.1",
     "eslint-plugin-react-hooks": "^7.1.1",
-    "eslint-plugin-react-refresh": "^0.5.3",
+    "eslint-plugin-react-refresh": "^0.5.5",
     "eslint-plugin-storybook": "10.4.6",
-    "globals": "^17.8.0",
-    "motely-wasm": "25.0.3",
+    "globals": "^17.11.0",
+    "motely-wasm": "25.1.0",
     "react": "^19.2.8",
     "react-dom": "^19.2.8",
-    "storybook": "^10.5.5",
+    "storybook": "^10.5.10",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.65.0",
+    "typescript-eslint": "^8.69.0",
     "vite": "^6.4.3",
     "vite-plugin-dts": "^5.0.3"
+  },
+  "scripts": {
+    "build": "vite build",
+    "dev": "storybook dev",
+    "dev:watch": "vite build --watch",
+    "jaml:mcp": "node scripts/jaml-mcp-server.mjs",
+    "typecheck": "tsc --noEmit --pretty false",
+    "vocab:check": "node --experimental-strip-types scripts/check-vocab-drift.mjs",
+    "lut:emit": "node scripts/emit-motely-sprite-lut.mjs",
+    "typecheck:all": "pnpm typecheck && pnpm -r --if-present run typecheck",
+    "storybook": "pnpm run build && storybook dev -p 3141",
+    "build-storybook": "pnpm run build && storybook build",
+    "lint": "eslint .",
+    "design:detect": "node .agents/skills/impeccable/scripts/detect.mjs --json src",
+    "design:doctor": "node .agents/skills/impeccable/scripts/doctor.mjs"
   }
-}
+}