minerva-design 1.2.0 → 1.4.0

package/dist/charts/react/orderbook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orderbook.js","names":["size","value","fallback","sameValue","a","b","v","i","ka","k","sameOptions","kb","localeOf","resolveLocale","options","useWidget","containerRef","useRef","instanceRef","optionsRef","localeRef","handlersRef","handlers","useEffect","container","instance","factory","offs","connect","off","locale","useBook","book","useTrades","previousRef","targetRef","addRef","add","replaceRef","replace","target","previous","trades","n","Frame","width","height","fallbackHeight","style","connectDepth","chart","h","r","DepthChart","createDepthChart","useImperativeHandle","ref","snapshot","deltas","range","connectLadder","OrderBook","createOrderBook","lastPrice","price","connectHeatmap","heatmap","f","OrderBookHeatmap","createOrderBookHeatmap","list","connectTape","tape","p","TimeAndSales","createTimeAndSales"],"sources":["../../../../charts/src/react/orderbook.tsx"],"sourcesContent":["// React components of the order book module (depth chart, order book\n// ladder, liquidity heatmap, time and sales), re-exported by index.ts. Each\n// one mounts its engine once; options are forwarded when they change and\n// streams go through the ref handle (`applyDeltas`, `addTrades`) without\n// re-rendering React.\n\nimport {\n  useEffect,\n  useImperativeHandle,\n  useRef,\n  type CSSProperties,\n  type Ref,\n  type RefObject,\n} from \"react\";\nimport { resolveLocale } from \"../engine/locale\";\nimport { createDepthChart } from \"../engine/orderbook/depth\";\nimport { createOrderBookHeatmap } from \"../engine/orderbook/heatmap\";\nimport { createOrderBook } from \"../engine/orderbook/ladder\";\nimport { createTimeAndSales } from \"../engine/orderbook/tape\";\nimport type {\n  DepthChartHoverEvent,\n  DepthChartInstance,\n  DepthChartOptions,\n  MarketTrade,\n  OrderBookDelta,\n  OrderBookHeatmapHoverEvent,\n  OrderBookHeatmapInstance,\n  OrderBookHeatmapOptions,\n  OrderBookInstance,\n  OrderBookLevelEvent,\n  OrderBookOptions,\n  OrderBookSnapshot,\n  TimeAndSalesInstance,\n  TimeAndSalesOptions,\n  TimeAndSalesRowEvent,\n} from \"../engine/orderbook/types\";\nimport type { ChartRendererKind } from \"../engine/types\";\n\n/** Container props shared by the order book components */\nexport interface OrderBookWidgetProps {\n  /** Height of the widget; numbers are pixels */\n  height?: number | string;\n  /**\n   * Width of the widget; numbers are pixels\n   * @default \"100%\"\n   */\n  width?: number | string;\n  /** Class of the container */\n  className?: string;\n  /** Style of the container */\n  style?: CSSProperties;\n}\n\n/** Imperative handle of `DepthChart` */\nexport interface DepthChartHandle {\n  /** Replaces the book */\n  setBook(snapshot: OrderBookSnapshot): void;\n  /** Applies updates (size 0 removes a level); drawn once at the next frame */\n  applyDeltas(deltas: OrderBookDelta | readonly OrderBookDelta[]): void;\n  /** Sets the visible range (fraction of the mid); `null` fits the book */\n  setRange(range: number | null): void;\n  /** The underlying engine instance (minerva-design/charts/core) */\n  getInstance(): DepthChartInstance | null;\n}\n\n/** Props of `DepthChart` */\nexport interface DepthChartProps\n  extends DepthChartOptions, OrderBookWidgetProps {\n  /** Book to draw, applied when the object changes (stream updates through the ref) */\n  book?: OrderBookSnapshot;\n  /** Pointer over the curves (`null` when it leaves) */\n  onHover?: (event: DepthChartHoverEvent | null) => void;\n  /** Click / tap on the curves */\n  onClick?: (event: DepthChartHoverEvent) => void;\n  /** The visible range changed by zooming (fraction of the mid) */\n  onRangeChange?: (range: number) => void;\n  /** Imperative handle: `setBook`, `applyDeltas`, `setRange` */\n  ref?: Ref<DepthChartHandle>;\n}\n\n/** Imperative handle of `OrderBook` */\nexport interface OrderBookHandle {\n  /** Replaces the book */\n  setBook(snapshot: OrderBookSnapshot): void;\n  /** Applies updates (size 0 removes a level); drawn once at the next frame */\n  applyDeltas(deltas: OrderBookDelta | readonly OrderBookDelta[]): void;\n  /** Price of the spread row (the mid price when `null`) */\n  setLastPrice(price: number | null): void;\n  /** The underlying engine instance (minerva-design/charts/core) */\n  getInstance(): OrderBookInstance | null;\n}\n\n/** Props of `OrderBook` */\nexport interface OrderBookProps extends OrderBookOptions, OrderBookWidgetProps {\n  /** Book to draw, applied when the object changes (stream updates through the ref) */\n  book?: OrderBookSnapshot;\n  /** Price of the spread row, colored by its last move; the mid price when omitted */\n  lastPrice?: number | null;\n  /** Hovered row (`null` when the pointer leaves) */\n  onHover?: (level: OrderBookLevelEvent | null) => void;\n  /** Click / tap / Enter on a row (e.g. to fill a price in an order form) */\n  onLevelClick?: (level: OrderBookLevelEvent) => void;\n  /** Imperative handle: `setBook`, `applyDeltas`, `setLastPrice` */\n  ref?: Ref<OrderBookHandle>;\n}\n\n/** Imperative handle of `OrderBookHeatmap` */\nexport interface OrderBookHeatmapHandle {\n  /** Replaces the book (closes the columns up to its time) */\n  setBook(snapshot: OrderBookSnapshot): void;\n  /** Applies updates (closes the columns up to their time) */\n  applyDeltas(deltas: OrderBookDelta | readonly OrderBookDelta[]): void;\n  /** Adds trades (bubbles) */\n  addTrades(trades: MarketTrade | readonly MarketTrade[]): void;\n  /** Follows the market again */\n  resetView(): void;\n  /** The underlying engine instance (minerva-design/charts/core) */\n  getInstance(): OrderBookHeatmapInstance | null;\n}\n\n/** Props of `OrderBookHeatmap` */\nexport interface OrderBookHeatmapProps\n  extends OrderBookHeatmapOptions, OrderBookWidgetProps {\n  /** Book, applied when the object changes (stream updates through the ref) */\n  book?: OrderBookSnapshot;\n  /** Trades; when the array grows, only the appended ones are added */\n  trades?: readonly MarketTrade[];\n  /** Hovered cell (`null` when the pointer leaves) */\n  onHover?: (event: OrderBookHeatmapHoverEvent | null) => void;\n  /** Backend in use (also after a GPU loss) */\n  onRendererChange?: (renderer: ChartRendererKind) => void;\n  /** `true` while the view follows the market, `false` after a zoom / pan */\n  onFollowChange?: (follow: boolean) => void;\n  /** Imperative handle: `setBook`, `applyDeltas`, `addTrades`, `resetView` */\n  ref?: Ref<OrderBookHeatmapHandle>;\n}\n\n/** Imperative handle of `TimeAndSales` */\nexport interface TimeAndSalesHandle {\n  /** Appends trades (oldest first) */\n  addTrades(trades: MarketTrade | readonly MarketTrade[]): void;\n  /** Replaces every trade */\n  setTrades(trades: readonly MarketTrade[]): void;\n  /** Removes every trade */\n  clear(): void;\n  /** Scrolls back to the newest trade and resumes */\n  scrollToLatest(): void;\n  /** The underlying engine instance (minerva-design/charts/core) */\n  getInstance(): TimeAndSalesInstance | null;\n}\n\n/** Props of `TimeAndSales` */\nexport interface TimeAndSalesProps\n  extends TimeAndSalesOptions, OrderBookWidgetProps {\n  /**\n   * Trades, oldest first; when the array grows, only the appended ones are\n   * added (other changes replace the tape)\n   */\n  trades?: readonly MarketTrade[];\n  /** Hovered row (`null` when the pointer leaves) */\n  onHover?: (row: TimeAndSalesRowEvent | null) => void;\n  /** Click / tap / Enter on a row */\n  onTradeClick?: (row: TimeAndSalesRowEvent) => void;\n  /** The tape paused (pointer over it, scrolled down) or resumed */\n  onPause?: (paused: boolean) => void;\n  /** Imperative handle: `addTrades`, `setTrades`, `clear`, `scrollToLatest` */\n  ref?: Ref<TimeAndSalesHandle>;\n}\n\n// ------------------------------------------------------------------ shared\n\nconst size = (value: number | string | undefined, fallback: string) =>\n  value === undefined\n    ? fallback\n    : typeof value === \"number\"\n      ? `${value}px`\n      : value;\n\n/** Identical values, or inline arrays / objects with identical items */\nconst sameValue = (a: unknown, b: unknown): boolean => {\n  if (a === b) return true;\n  if (Array.isArray(a) && Array.isArray(b))\n    return a.length === b.length && a.every((v, i) => v === b[i]);\n  if (\n    typeof a !== \"object\" ||\n    typeof b !== \"object\" ||\n    a === null ||\n    b === null ||\n    Object.getPrototypeOf(a) !== Object.prototype ||\n    Object.getPrototypeOf(b) !== Object.prototype\n  )\n    return false;\n  const ka = Object.keys(a);\n  return (\n    ka.length === Object.keys(b).length &&\n    ka.every(\n      (k) =>\n        (a as Record<string, unknown>)[k] === (b as Record<string, unknown>)[k],\n    )\n  );\n};\n\n/** Same options, one level deep (inline `labels={{ … }}` stays equal) */\nconst sameOptions = (a: object, b: object): boolean => {\n  const ka = Object.keys(a).filter(\n    (k) => (a as Record<string, unknown>)[k] !== undefined,\n  );\n  const kb = Object.keys(b).filter(\n    (k) => (b as Record<string, unknown>)[k] !== undefined,\n  );\n  return (\n    ka.length === kb.length &&\n    ka.every((k) =>\n      sameValue(\n        (a as Record<string, unknown>)[k],\n        (b as Record<string, unknown>)[k],\n      ),\n    )\n  );\n};\n\ninterface Widget<O> {\n  setOptions(options: O): void;\n  destroy(): void;\n}\n\n/** Locale the engine resolves for `options` (the page language by default) */\nconst localeOf = (options: object): string =>\n  resolveLocale((options as { locale?: string }).locale);\n\n/**\n * Mounts an engine widget once, forwards option changes and subscribes the\n * handlers (read through a ref: inline callbacks never re-subscribe). The\n * options are applied again when the page language (`<html lang>`) changed,\n * so the built-in texts follow a language switch.\n */\nfunction useWidget<O extends object, I extends Widget<O>, H>(\n  factory: (container: HTMLElement, options: O) => I,\n  options: O,\n  handlers: H,\n  connect: (instance: I, handlers: () => H) => (() => void)[],\n): {\n  containerRef: RefObject<HTMLDivElement | null>;\n  instanceRef: RefObject<I | null>;\n} {\n  const containerRef = useRef<HTMLDivElement>(null);\n  const instanceRef = useRef<I | null>(null);\n  const optionsRef = useRef(options);\n  const localeRef = useRef(\"\");\n  const handlersRef = useRef(handlers);\n\n  useEffect(() => {\n    handlersRef.current = handlers;\n  });\n\n  useEffect(() => {\n    const container = containerRef.current;\n    if (!container) return;\n    localeRef.current = localeOf(optionsRef.current);\n    const instance = factory(container, optionsRef.current);\n    instanceRef.current = instance;\n    const offs = connect(instance, () => handlersRef.current);\n    return () => {\n      offs.forEach((off) => off());\n      instance.destroy();\n      instanceRef.current = null;\n    };\n  }, [factory, connect]);\n\n  useEffect(() => {\n    const locale = localeOf(options);\n    if (\n      sameOptions(optionsRef.current, options) &&\n      locale === localeRef.current\n    )\n      return;\n    optionsRef.current = options;\n    localeRef.current = locale;\n    instanceRef.current?.setOptions(options);\n  });\n\n  return { containerRef, instanceRef };\n}\n\n/** Applies `book` when the object changes */\nfunction useBook(\n  instanceRef: RefObject<{ setBook(s: OrderBookSnapshot): void } | null>,\n  book: OrderBookSnapshot | undefined,\n) {\n  useEffect(() => {\n    if (book) instanceRef.current?.setBook(book);\n  }, [instanceRef, book]);\n}\n\n/** Adds the trades appended to `trades`; `replace` gets any other change */\nfunction useTrades(\n  instanceRef: RefObject<object | null>,\n  trades: readonly MarketTrade[] | undefined,\n  add: (trades: readonly MarketTrade[]) => void,\n  replace: (trades: readonly MarketTrade[]) => void,\n) {\n  const previousRef = useRef<readonly MarketTrade[] | undefined>(undefined);\n  /** Instance that received `previousRef` (a remount starts over) */\n  const targetRef = useRef<object | null>(null);\n  const addRef = useRef(add);\n  const replaceRef = useRef(replace);\n  useEffect(() => {\n    addRef.current = add;\n    replaceRef.current = replace;\n  });\n  useEffect(() => {\n    const target = instanceRef.current;\n    const previous =\n      targetRef.current === target ? previousRef.current : undefined;\n    previousRef.current = trades;\n    targetRef.current = target;\n    if (!trades || trades === previous) return;\n    const n = previous?.length ?? 0;\n    // a grown array (same items in front): only the new ones\n    if (\n      previous &&\n      n > 0 &&\n      trades.length >= n &&\n      trades[n - 1] === previous[n - 1] &&\n      trades[0] === previous[0]\n    ) {\n      if (trades.length > n) addRef.current(trades.slice(n));\n      return;\n    }\n    replaceRef.current(trades);\n  }, [instanceRef, trades]);\n}\n\nfunction Frame({\n  containerRef,\n  height,\n  width,\n  className,\n  style,\n  fallbackHeight,\n}: OrderBookWidgetProps & {\n  containerRef: RefObject<HTMLDivElement | null>;\n  fallbackHeight: string;\n}) {\n  return (\n    <div\n      className={className}\n      style={{\n        position: \"relative\",\n        width: size(width, \"100%\"),\n        height: size(height, fallbackHeight),\n        ...style,\n      }}\n    >\n      <div ref={containerRef} style={{ position: \"absolute\", inset: 0 }} />\n    </div>\n  );\n}\n\n// -------------------------------------------------------------- depth chart\n\ninterface DepthHandlers {\n  onHover?: DepthChartProps[\"onHover\"];\n  onClick?: DepthChartProps[\"onClick\"];\n  onRangeChange?: DepthChartProps[\"onRangeChange\"];\n}\n\nconst connectDepth = (chart: DepthChartInstance, h: () => DepthHandlers) => [\n  chart.on(\"hover\", (e) => h().onHover?.(e)),\n  chart.on(\"click\", (e) => h().onClick?.(e)),\n  chart.on(\"range\", (r) => h().onRangeChange?.(r)),\n];\n\n/**\n * Cumulative depth of an order book: stepped bid / ask areas around the mid\n * price, mirrored hover readout, zoom around the mid, eased updates.\n */\nexport function DepthChart({\n  height,\n  width,\n  className,\n  style,\n  book,\n  onHover,\n  onClick,\n  onRangeChange,\n  ref,\n  ...options\n}: DepthChartProps) {\n  const { containerRef, instanceRef } = useWidget(\n    createDepthChart,\n    options,\n    { onHover, onClick, onRangeChange },\n    connectDepth,\n  );\n  useBook(instanceRef, book);\n  useImperativeHandle(\n    ref,\n    () => ({\n      setBook: (snapshot) => instanceRef.current?.setBook(snapshot),\n      applyDeltas: (deltas) => instanceRef.current?.applyDeltas(deltas),\n      setRange: (range) => instanceRef.current?.setRange(range),\n      getInstance: () => instanceRef.current,\n    }),\n    [instanceRef],\n  );\n  return (\n    <Frame\n      containerRef={containerRef}\n      height={height}\n      width={width}\n      className={className}\n      style={style}\n      fallbackHeight=\"320px\"\n    />\n  );\n}\n\n// --------------------------------------------------------------- order book\n\ninterface LadderHandlers {\n  onHover?: OrderBookProps[\"onHover\"];\n  onLevelClick?: OrderBookProps[\"onLevelClick\"];\n}\n\nconst connectLadder = (book: OrderBookInstance, h: () => LadderHandlers) => [\n  book.on(\"hover\", (e) => h().onHover?.(e)),\n  book.on(\"levelClick\", (e) => h().onLevelClick?.(e)),\n];\n\n/**\n * Order book ladder: asks above the spread row, bids below, with depth\n * bars, price grouping, change flashes and large order highlight.\n */\nexport function OrderBook({\n  height,\n  width,\n  className,\n  style,\n  book,\n  lastPrice,\n  onHover,\n  onLevelClick,\n  ref,\n  ...options\n}: OrderBookProps) {\n  const { containerRef, instanceRef } = useWidget(\n    createOrderBook,\n    options,\n    { onHover, onLevelClick },\n    connectLadder,\n  );\n  useBook(instanceRef, book);\n  useEffect(() => {\n    if (lastPrice !== undefined) instanceRef.current?.setLastPrice(lastPrice);\n  }, [instanceRef, lastPrice]);\n  useImperativeHandle(\n    ref,\n    () => ({\n      setBook: (snapshot) => instanceRef.current?.setBook(snapshot),\n      applyDeltas: (deltas) => instanceRef.current?.applyDeltas(deltas),\n      setLastPrice: (price) => instanceRef.current?.setLastPrice(price),\n      getInstance: () => instanceRef.current,\n    }),\n    [instanceRef],\n  );\n  return (\n    <Frame\n      containerRef={containerRef}\n      height={height}\n      width={width}\n      className={className}\n      style={style}\n      fallbackHeight=\"420px\"\n    />\n  );\n}\n\n// ------------------------------------------------------------------ heatmap\n\ninterface HeatmapHandlers {\n  onHover?: OrderBookHeatmapProps[\"onHover\"];\n  onRendererChange?: OrderBookHeatmapProps[\"onRendererChange\"];\n  onFollowChange?: OrderBookHeatmapProps[\"onFollowChange\"];\n}\n\nconst connectHeatmap = (\n  heatmap: OrderBookHeatmapInstance,\n  h: () => HeatmapHandlers,\n) => [\n  heatmap.on(\"hover\", (e) => h().onHover?.(e)),\n  heatmap.on(\"renderer\", (r) => h().onRendererChange?.(r)),\n  heatmap.on(\"follow\", (f) => h().onFollowChange?.(f)),\n];\n\n/**\n * Liquidity heatmap: resting size over time and price drawn by the GPU,\n * best bid / ask lines and trades as bubbles sized by volume.\n */\nexport function OrderBookHeatmap({\n  height,\n  width,\n  className,\n  style,\n  book,\n  trades,\n  onHover,\n  onRendererChange,\n  onFollowChange,\n  ref,\n  ...options\n}: OrderBookHeatmapProps) {\n  const { containerRef, instanceRef } = useWidget(\n    createOrderBookHeatmap,\n    options,\n    { onHover, onRendererChange, onFollowChange },\n    connectHeatmap,\n  );\n  useBook(instanceRef, book);\n  useTrades(\n    instanceRef,\n    trades,\n    (list) => instanceRef.current?.addTrades(list),\n    (list) => instanceRef.current?.addTrades(list),\n  );\n  useImperativeHandle(\n    ref,\n    () => ({\n      setBook: (snapshot) => instanceRef.current?.setBook(snapshot),\n      applyDeltas: (deltas) => instanceRef.current?.applyDeltas(deltas),\n      addTrades: (list) => instanceRef.current?.addTrades(list),\n      resetView: () => instanceRef.current?.resetView(),\n      getInstance: () => instanceRef.current,\n    }),\n    [instanceRef],\n  );\n  return (\n    <Frame\n      containerRef={containerRef}\n      height={height}\n      width={width}\n      className={className}\n      style={style}\n      fallbackHeight=\"360px\"\n    />\n  );\n}\n\n// ----------------------------------------------------------- time and sales\n\ninterface TapeHandlers {\n  onHover?: TimeAndSalesProps[\"onHover\"];\n  onTradeClick?: TimeAndSalesProps[\"onTradeClick\"];\n  onPause?: TimeAndSalesProps[\"onPause\"];\n}\n\nconst connectTape = (tape: TimeAndSalesInstance, h: () => TapeHandlers) => [\n  tape.on(\"hover\", (e) => h().onHover?.(e)),\n  tape.on(\"tradeClick\", (e) => h().onTradeClick?.(e)),\n  tape.on(\"pause\", (p) => h().onPause?.(p)),\n];\n\n/**\n * Time and sales tape: newest trades on top, virtualized (hundreds of\n * thousands of rows), large trades highlighted, paused while hovered.\n */\nexport function TimeAndSales({\n  height,\n  width,\n  className,\n  style,\n  trades,\n  onHover,\n  onTradeClick,\n  onPause,\n  ref,\n  ...options\n}: TimeAndSalesProps) {\n  const { containerRef, instanceRef } = useWidget(\n    createTimeAndSales,\n    options,\n    { onHover, onTradeClick, onPause },\n    connectTape,\n  );\n  useTrades(\n    instanceRef,\n    trades,\n    (list) => instanceRef.current?.addTrades(list),\n    (list) => instanceRef.current?.setTrades(list),\n  );\n  useImperativeHandle(\n    ref,\n    () => ({\n      addTrades: (list) => instanceRef.current?.addTrades(list),\n      setTrades: (list) => instanceRef.current?.setTrades(list),\n      clear: () => instanceRef.current?.clear(),\n      scrollToLatest: () => instanceRef.current?.scrollToLatest(),\n      getInstance: () => instanceRef.current,\n    }),\n    [instanceRef],\n  );\n  return (\n    <Frame\n      containerRef={containerRef}\n      height={height}\n      width={width}\n      className={className}\n      style={style}\n      fallbackHeight=\"360px\"\n    />\n  );\n}\n"],"mappings":"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"}

package/dist/charts/react/shapes.cjs

@@ -0,0 +1,2 @@
+"use client";const e=require("../engine/shapes/calendar.cjs"),t=require("../engine/shapes/chart.cjs");let n=require("react"),r=require("react-dom"),i=require("react/jsx-runtime");var a=(e,t)=>e===void 0?t:typeof e==`number`?`${e}px`:e,o=e=>{if(typeof document>`u`||typeof MutationObserver!=`function`)return()=>{};let t=new MutationObserver(e);return t.observe(document.documentElement,{attributes:!0,attributeFilter:[`lang`]}),()=>t.disconnect()},s=()=>typeof document>`u`?``:document.documentElement.lang,c=()=>``,l=({palette:e,legend:t,tooltip:r,format:i,percentFormat:a,locale:l,texts:u,hidden:d,animation:f,padding:p,ariaLabel:m})=>{let h=(0,n.useSyncExternalStore)(o,s,c),g=l??(h||void 0),_=d?d.join(`,`):null,v=(0,n.useMemo)(()=>_===null?void 0:_?_.split(`,`).map(Number):[],[_]);return(0,n.useMemo)(()=>({palette:e,legend:t,tooltip:r,format:i,percentFormat:a,locale:g,texts:u,hidden:v,animation:f,padding:p,ariaLabel:m}),[e,t,r,i,a,g,u,v,f,p,m])};function u({options:e,height:o,width:s,className:c,style:l,handleRef:u,renderTooltip:d,...f}){let p=(0,n.useRef)(null),m=(0,n.useRef)(null),h=(0,n.useRef)(f),g=(0,n.useRef)(d),[_,v]=(0,n.useState)(null),y=(0,n.useMemo)(()=>typeof document>`u`?null:document.createElement(`div`),[]),b=!!d,x=(0,n.useMemo)(()=>{if(!b||!y||e.tooltip===!1)return e;let t=typeof e.tooltip==`object`?e.tooltip:{};return{...e,tooltip:{...t,render:e=>g.current?((0,r.flushSync)(()=>v(e)),y):null}}},[e,b,y]),S=(0,n.useRef)(x);return(0,n.useEffect)(()=>{h.current=f,g.current=d}),(0,n.useEffect)(()=>{let e=p.current;if(!e)return;let n=t.createShapeChart(e,S.current);m.current=n;let r=[n.on(`hover`,e=>h.current.onHover?.(e)),n.on(`click`,e=>h.current.onClick?.(e)),n.on(`toggle`,e=>h.current.onToggle?.(e)),n.on(`drill`,e=>h.current.onDrill?.(e))];return()=>{r.forEach(e=>e()),n.destroy(),m.current=null}},[]),(0,n.useEffect)(()=>{S.current!==x&&(S.current=x,m.current?.setOptions(x))},[x]),(0,n.useImperativeHandle)(u,()=>({getInstance:()=>m.current}),[]),(0,i.jsxs)(`div`,{className:c,style:{position:`relative`,width:a(s,`100%`),height:a(o,`320px`),...l},children:[(0,i.jsx)(`div`,{ref:p,style:{position:`absolute`,inset:0}}),y&&_&&d&&(0,r.createPortal)(d(_),y)]})}function d(e){return(0,i.jsx)(p,{...e,defaultInner:0})}function f(e){return(0,i.jsx)(p,{...e,defaultInner:.62})}function p(e){let{data:t,innerRadius:r,startAngle:a,padAngle:o,cornerRadius:s,rose:c,labels:u,labelContent:d,centerValue:f,centerLabel:p,defaultInner:m}=e,h=l(e),g=(0,n.useMemo)(()=>({...h,type:`pie`,data:t,innerRadius:r??m,startAngle:a,padAngle:o,cornerRadius:s,rose:c,labels:u,labelContent:d,centerValue:f,centerLabel:p}),[h,t,r,m,a,o,s,c,u,d,f,p]);return(0,i.jsx)(C,{props:e,options:g,defaultHeight:320})}function m(e){let{indicators:t,series:r,shape:a,levels:o,dots:s}=e,c=l(e),u=(0,n.useMemo)(()=>({...c,type:`radar`,indicators:t,series:r,shape:a,levels:o,dots:s}),[c,t,r,a,o,s]);return(0,i.jsx)(C,{props:e,options:u,defaultHeight:320})}function h(e){let{value:t,min:r,max:a,label:o,sweep:s,thickness:c,bands:u,color:d,needle:f,ticks:p}=e,m=l(e),h=(0,n.useMemo)(()=>({...m,type:`gauge`,value:t,min:r,max:a,label:o,sweep:s,thickness:c,bands:u,color:d,needle:f,ticks:p}),[m,t,r,a,o,s,c,u,d,f,p]);return(0,i.jsx)(C,{props:e,options:h,defaultHeight:240})}function g(e){let{data:t,sort:r,gap:a,conversion:o,shape:s}=e,c=l(e),u=(0,n.useMemo)(()=>({...c,type:`funnel`,data:t,sort:r,gap:a,conversion:o,shape:s}),[c,t,r,a,o,s]);return(0,i.jsx)(C,{props:e,options:u,defaultHeight:320})}function _(e){let{data:t,gap:r,headers:a}=e,o=l(e),s=(0,n.useMemo)(()=>({...o,type:`treemap`,data:t,gap:r,headers:a}),[o,t,r,a]);return(0,i.jsx)(C,{props:e,options:s,defaultHeight:320})}function v(e){let{nodes:t,links:r,nodeWidth:a,nodePadding:o,align:s,iterations:c,linkColor:u,linkOpacity:d,labels:f,labelValues:p}=e,m=l(e),h=(0,n.useMemo)(()=>({...m,type:`sankey`,nodes:t,links:r,nodeWidth:a,nodePadding:o,align:s,iterations:c,linkColor:u,linkOpacity:d,labels:f,labelValues:p}),[m,t,r,a,o,s,c,u,d,f,p]);return(0,i.jsx)(C,{props:e,options:h,defaultHeight:360})}function y(e){let{data:t,innerRadius:r,levels:a,startAngle:o,padAngle:s,cornerRadius:c,labels:u,drill:d,drillPath:f,onDrill:p}=e,m=l(e),h=f?JSON.stringify(f):null,g=(0,n.useMemo)(()=>h===null?void 0:JSON.parse(h),[h]),_=(0,n.useMemo)(()=>({...m,type:`sunburst`,data:t,innerRadius:r,levels:a,startAngle:o,padAngle:s,cornerRadius:c,labels:u,drill:d,drillPath:g}),[m,t,r,a,o,s,c,u,d,g]);return(0,i.jsx)(C,{props:e,options:_,defaultHeight:360,onDrill:p})}function b(e){let{data:t,max:r,innerRadius:a,startAngle:o,sweep:s,gap:c,track:u,rounded:d,labels:f,labelContent:p,centerValue:m,centerLabel:h}=e,g=l(e),_=(0,n.useMemo)(()=>({...g,type:`radialBar`,data:t,max:r,innerRadius:a,startAngle:o,sweep:s,gap:c,track:u,rounded:d,labels:f,labelContent:p,centerValue:m,centerLabel:h}),[g,t,r,a,o,s,c,u,d,f,p,m,h]);return(0,i.jsx)(C,{props:e,options:_,defaultHeight:300})}function x(t){let{data:r,range:a,layout:o,weekStart:s,color:c,colors:u,levels:d,thresholds:f,gap:p,radius:m,maxCellSize:h,monthLabels:g,weekdayLabels:_}=t,v=l(t),y=(0,n.useMemo)(()=>({...v,type:`calendarHeatmap`,data:r,range:a,layout:o,weekStart:s,color:c,colors:u,levels:d,thresholds:f,gap:p,radius:m,maxCellSize:h,monthLabels:g,weekdayLabels:_}),[v,r,a,o,s,c,u,d,f,p,m,h,g,_]),b=(0,n.useMemo)(()=>{let t=y.legend===!1?0:34;return o===`months`?560:e.calendarStrips(y)*120+t+16},[y,o]);return(0,i.jsx)(C,{props:t,options:y,defaultHeight:b})}function S(e){let{data:t,orientation:r,ranges:a,rangeLabels:o,rangeColors:s,barSize:c,targetColor:u,ticks:d}=e,f=l(e),p=(0,n.useMemo)(()=>({...f,type:`bullet`,data:t,orientation:r,ranges:a,rangeLabels:o,rangeColors:s,barSize:c,targetColor:u,ticks:d}),[f,t,r,a,o,s,c,u,d]),m=p.legend?34:0,h=r===`vertical`?320:Math.max(96,t.length*64+16)+m;return(0,i.jsx)(C,{props:e,options:p,defaultHeight:h})}function C({props:e,options:t,defaultHeight:n,onDrill:r}){return(0,i.jsx)(u,{options:t,height:e.height??n,width:e.width,className:e.className,style:e.style,handleRef:e.ref,onHover:e.onHover,onClick:e.onClick,onToggle:e.onToggle,onDrill:r,renderTooltip:e.renderTooltip})}exports.BulletChart=S,exports.CalendarHeatmap=x,exports.DonutChart=f,exports.FunnelChart=g,exports.GaugeChart=h,exports.PieChart=d,exports.RadarChart=m,exports.RadialBarChart=b,exports.SankeyChart=v,exports.SunburstChart=y,exports.TreemapChart=_;
+//# sourceMappingURL=shapes.cjs.map

package/dist/charts/react/shapes.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"shapes.cjs","names":["useSyncExternalStore","useMemo","useRef","useState","createShapeChart","createPortal","calendarStrips","require_calendar","require_chart","react","react_dom","react_jsx_runtime","size","value","fallback","subscribePageLanguage","observer","onChange","pageLanguage","noPageLanguage","useCommonOptions","language","resolvedLocale","locale","hiddenKey","hidden","stableHidden","palette","legend","tooltip","format","percentFormat","texts","animation","padding","ariaLabel","ShapeChartBase","handlers","containerRef","chartRef","handlersRef","tooltipRef","renderTooltip","tipEvent","setTipEvent","tipHost","customTooltip","resolved","options","base","event","optionsRef","container","chart","offs","off","handleRef","width","height","style","PieChart","PieBase","props","DonutChart","common","innerRadius","defaultInner","data","startAngle","padAngle","cornerRadius","rose","labels","labelContent","centerValue","centerLabel","ShapeHost","RadarChart","indicators","series","shape","levels","dots","GaugeChart","min","max","label","sweep","thickness","bands","color","needle","ticks","FunnelChart","sort","gap","conversion","TreemapChart","headers","SankeyChart","nodes","links","nodeWidth","nodePadding","align","iterations","linkColor","linkOpacity","labelValues","SunburstChart","drillKey","drillPath","stablePath","drill","RadialBarChart","track","rounded","CalendarHeatmap","range","layout","weekStart","colors","thresholds","radius","maxCellSize","monthLabels","weekdayLabels","defaultHeight","BulletChart","orientation","ranges","rangeLabels","rangeColors","barSize","targetColor"],"sources":["../../../../charts/src/react/shapes.tsx"],"sourcesContent":["import {\n  useEffect,\n  useImperativeHandle,\n  useMemo,\n  useRef,\n  useState,\n  useSyncExternalStore,\n  type CSSProperties,\n  type ReactNode,\n  type Ref,\n} from \"react\";\nimport { createPortal, flushSync } from \"react-dom\";\nimport type { ChartPadding } from \"../engine/types\";\nimport { calendarStrips } from \"../engine/shapes/calendar\";\nimport { createShapeChart } from \"../engine/shapes/chart\";\nimport type {\n  BulletChartOptions,\n  BulletDatum,\n  CalendarDate,\n  CalendarDatum,\n  CalendarHeatmapOptions,\n  FunnelChartOptions,\n  GaugeBand,\n  GaugeChartOptions,\n  PieChartOptions,\n  RadarChartOptions,\n  RadarIndicator,\n  RadarSeries,\n  RadialBarChartOptions,\n  RadialBarDatum,\n  SankeyChartOptions,\n  SankeyLink,\n  SankeyNode,\n  ShapeChartCommonOptions,\n  ShapeChartInstance,\n  ShapeChartLabels,\n  ShapeChartOptions,\n  ShapeDatum,\n  ShapeDrillEvent,\n  ShapeHoverEvent,\n  ShapeLegendOptions,\n  ShapeToggleEvent,\n  ShapeTooltipOptions,\n  SunburstChartOptions,\n  TreemapChartOptions,\n  TreemapNode,\n} from \"../engine/shapes/types\";\n\n/** Imperative handle of the shape chart components (`ref`) */\nexport interface ShapeChartHandle {\n  /** The underlying engine instance (minerva-design/charts/core) */\n  getInstance(): ShapeChartInstance | null;\n}\n\n/**\n * Props shared by PieChart, DonutChart, RadarChart, GaugeChart, FunnelChart,\n * TreemapChart, SankeyChart, SunburstChart, RadialBarChart, CalendarHeatmap\n * and BulletChart\n */\nexport interface ShapeChartCommonProps {\n  /**\n   * Height of the chart (the legend included); numbers are pixels\n   * @default 320 (GaugeChart: 240, RadialBarChart: 300, CalendarHeatmap and BulletChart: from the data)\n   */\n  height?: number | string;\n  /**\n   * Width of the chart; numbers are pixels\n   * @default \"100%\"\n   */\n  width?: number | string;\n  /** Colors of the marks without `color` (defaults to the `--chart-series-1..8` CSS variables, then the theme colors) */\n  palette?: readonly string[];\n  /**\n   * Legend; clicking an item hides / shows its slice, stage, series, node, bar, row or level\n   * @default shown for pie, donut, funnel, multi-series radar charts, calendar heatmaps and radial bar charts without labels\n   */\n  legend?: boolean | ShapeLegendOptions;\n  /**\n   * Tooltip; `false` disables it\n   * @default true\n   */\n  tooltip?: boolean | ShapeTooltipOptions;\n  /**\n   * Formats the values of the labels and the tooltip\n   * @default compact numbers of the `locale` (1.2k, 3.4M; 1.2万 in Chinese and Japanese)\n   */\n  format?: (value: number) => string;\n  /**\n   * Formats the shares (labels, conversion rates, tooltip); `share` is 0-1\n   * @default a percent of the `locale` with one decimal, e.g. \"40.0%\", \"40,0 %\"\n   */\n  percentFormat?: (share: number) => string;\n  /**\n   * BCP 47 locale of the texts and numbers the chart writes (tooltip rows,\n   * accessible names, number and percent formats, calendar dates); built-in\n   * texts in English, Chinese, Japanese and French (English otherwise)\n   * @default the page language (`<html lang>`, followed when it changes), else the browser language\n   */\n  locale?: string;\n  /** Replaces built-in texts of the `locale` (tooltip rows, accessible names, \"No data\") */\n  texts?: Partial<ShapeChartLabels>;\n  /**\n   * Hidden slices / stages / radar series / top-level treemap or sunburst\n   * nodes / sankey nodes / radial bars / bullet rows / calendar levels, by\n   * index. Makes the visibility controlled: legend clicks then only call\n   * `onToggle`, whose `hiddenIndexes` should be stored and passed back.\n   * Leave undefined to let the legend hide / show entries by itself.\n   */\n  hidden?: readonly number[];\n  /**\n   * Called when a legend item is clicked (or the instance's `toggle()` is\n   * called), with the toggled index and every hidden index after the toggle\n   */\n  onToggle?: (event: ShapeToggleEvent) => void;\n  /**\n   * Entry and update animations (skipped when the user prefers reduced motion)\n   * @default true\n   */\n  animation?: boolean;\n  /**\n   * Space around the drawing, in pixels\n   * @default 8 on every side\n   */\n  padding?: ChartPadding;\n  /**\n   * Accessible name of the chart\n   * @default the chart type in the `locale`, e.g. \"Donut chart\"\n   */\n  ariaLabel?: string;\n  /** Called when the hovered (or keyboard-focused) mark changes */\n  onHover?: (event: ShapeHoverEvent | null) => void;\n  /** Called when a mark is clicked, tapped or activated with Enter */\n  onClick?: (event: ShapeHoverEvent) => void;\n  /** React content of the tooltip (replaces the default content) */\n  renderTooltip?: (event: ShapeHoverEvent) => ReactNode;\n  /** Additional class name of the root element */\n  className?: string;\n  /** Inline styles of the root element */\n  style?: CSSProperties;\n  /** Imperative handle */\n  ref?: Ref<ShapeChartHandle>;\n}\n\n/** Props of PieChart */\nexport interface PieChartProps extends ShapeChartCommonProps {\n  /** Slices: a name, a value (negative values count as 0) and an optional color */\n  data: readonly ShapeDatum[];\n  /**\n   * Inner radius as a fraction of the outer radius: 0 = pie, 0.6 = donut\n   * @default 0\n   */\n  innerRadius?: number;\n  /**\n   * Angle of the first slice, degrees clockwise from 12 o'clock\n   * @default 0\n   */\n  startAngle?: number;\n  /**\n   * Gap between the slices, in pixels\n   * @default 1 (pie), 2 (donut)\n   */\n  padAngle?: number;\n  /**\n   * Corner radius of the slices, in pixels\n   * @default 0 (pie), 4 (donut)\n   */\n  cornerRadius?: number;\n  /**\n   * Nightingale rose: the radius (instead of the angle) shows the value\n   * @default false\n   */\n  rose?: boolean;\n  /**\n   * Slice labels: `outside` with leader lines, `inside` the slices, or none\n   * @default \"outside\" (up to 12 slices), \"none\" otherwise\n   */\n  labels?: \"outside\" | \"inside\" | \"none\";\n  /**\n   * What a label shows: name, value, percent (combinable)\n   * @default [\"name\", \"percent\"]\n   */\n  labelContent?: readonly (\"name\" | \"value\" | \"percent\")[];\n  /** Big text in the hole of a donut (e.g. the total) */\n  centerValue?: string;\n  /** Small text under `centerValue` */\n  centerLabel?: string;\n}\n\n/** Props of DonutChart: a PieChart with a hole */\nexport interface DonutChartProps extends PieChartProps {\n  /**\n   * Inner radius as a fraction of the outer radius\n   * @default 0.62\n   */\n  innerRadius?: number;\n}\n\n/** Props of RadarChart */\nexport interface RadarChartProps extends ShapeChartCommonProps {\n  /** Axes of the chart, clockwise from 12 o'clock */\n  indicators: readonly RadarIndicator[];\n  /** Polygons: one value per indicator */\n  series: readonly RadarSeries[];\n  /**\n   * Grid shape\n   * @default \"polygon\"\n   */\n  shape?: \"polygon\" | \"circle\";\n  /**\n   * Number of grid rings\n   * @default 4\n   */\n  levels?: number;\n  /**\n   * Dots on the vertices\n   * @default true\n   */\n  dots?: boolean;\n}\n\n/** Props of GaugeChart */\nexport interface GaugeChartProps extends ShapeChartCommonProps {\n  /** Value shown by the arc (clamped to `min` - `max` for the drawing) */\n  value: number;\n  /**\n   * Value at the start of the arc\n   * @default 0\n   */\n  min?: number;\n  /**\n   * Value at the end of the arc\n   * @default 100\n   */\n  max?: number;\n  /** Caption under the value */\n  label?: string;\n  /**\n   * Total angle of the arc, degrees\n   * @default 240\n   */\n  sweep?: number;\n  /**\n   * Thickness of the arc as a fraction of the radius\n   * @default 0.16\n   */\n  thickness?: number;\n  /** Colored ranges of the track; the value arc takes the color of its band */\n  bands?: readonly GaugeBand[];\n  /**\n   * Color of the value arc (when there are no bands)\n   * @default the first palette color\n   */\n  color?: string;\n  /**\n   * Draws a needle in addition to the value arc\n   * @default false\n   */\n  needle?: boolean;\n  /**\n   * Tick labels at the ends (and at the band bounds)\n   * @default true\n   */\n  ticks?: boolean;\n}\n\n/** Props of FunnelChart */\nexport interface FunnelChartProps extends ShapeChartCommonProps {\n  /** Stages: a name, a value and an optional color */\n  data: readonly ShapeDatum[];\n  /**\n   * Order of the stages\n   * @default \"none\" (data order)\n   */\n  sort?: \"descending\" | \"ascending\" | \"none\";\n  /**\n   * Vertical gap between the stages, in pixels\n   * @default 4\n   */\n  gap?: number;\n  /**\n   * Shows the conversion rate from the previous stage\n   * @default true\n   */\n  conversion?: boolean;\n  /**\n   * Shape of the stages: trapezoids that narrow to the next stage, or centered bars\n   * @default \"trapezoid\"\n   */\n  shape?: \"trapezoid\" | \"bar\";\n}\n\n/** Props of TreemapChart */\nexport interface TreemapChartProps extends ShapeChartCommonProps {\n  /** Nodes: leaves carry a value, parents sum their children */\n  data: readonly TreemapNode[];\n  /**\n   * Gap between the cells, in pixels\n   * @default 2\n   */\n  gap?: number;\n  /**\n   * Draws the names of the parents above their children\n   * @default true\n   */\n  headers?: boolean;\n}\n\n/** Props of SankeyChart */\nexport interface SankeyChartProps extends ShapeChartCommonProps {\n  /** Nodes, in their initial order; nodes only named by a link are appended */\n  nodes?: readonly SankeyNode[];\n  /** Flows between the nodes (by name or index); links closing a cycle are ignored */\n  links: readonly SankeyLink[];\n  /**\n   * Width of the node bars, in pixels\n   * @default 12\n   */\n  nodeWidth?: number;\n  /**\n   * Vertical gap between the nodes of a column, in pixels (reduced when space is short)\n   * @default 12\n   */\n  nodePadding?: number;\n  /**\n   * Column of the nodes without a `column`: `justify` puts the sinks in the\n   * last column, `left` / `right` align on the sources / sinks, `center`\n   * puts the sources next to their first target\n   * @default \"justify\"\n   */\n  align?: \"justify\" | \"left\" | \"right\" | \"center\";\n  /**\n   * Relaxation passes that straighten the flows and reduce crossings\n   * @default 32\n   */\n  iterations?: number;\n  /**\n   * Color of the links without `color`: a gradient from the source to the\n   * target color, one of the two, or a neutral gray\n   * @default \"gradient\"\n   */\n  linkColor?: \"gradient\" | \"source\" | \"target\" | \"neutral\";\n  /**\n   * Opacity of the links, 0-1 (hovered flows are more opaque)\n   * @default 0.4\n   */\n  linkOpacity?: number;\n  /**\n   * Node labels (name and value); overlapping labels are skipped\n   * @default true\n   */\n  labels?: boolean;\n  /**\n   * Shows the value after the name in the labels\n   * @default true\n   */\n  labelValues?: boolean;\n}\n\n/** Props of SunburstChart */\nexport interface SunburstChartProps extends ShapeChartCommonProps {\n  /** Nodes: leaves carry a value, parents sum their children */\n  data: readonly TreemapNode[];\n  /**\n   * Radius of the center circle as a fraction of the outer radius\n   * @default 0.26\n   */\n  innerRadius?: number;\n  /**\n   * Rings shown at once below the focused node (fewer when they would be thinner than 18 px)\n   * @default every level\n   */\n  levels?: number;\n  /**\n   * Angle of the first node, degrees clockwise from 12 o'clock\n   * @default 0\n   */\n  startAngle?: number;\n  /**\n   * Gap between the sectors, in pixels\n   * @default 1\n   */\n  padAngle?: number;\n  /**\n   * Corner radius of the sectors, in pixels\n   * @default 2\n   */\n  cornerRadius?: number;\n  /**\n   * Sector labels: `auto` writes each name along the arc or along the\n   * radius, whichever fits best; labels that do not fit are shortened or skipped\n   * @default \"auto\"\n   */\n  labels?: \"auto\" | \"tangential\" | \"radial\" | \"none\";\n  /**\n   * Clicking (or Enter on) a parent zooms into it; clicking the center (or Backspace) goes back up\n   * @default true\n   */\n  drill?: boolean;\n  /**\n   * Names from the root to the focused node (`[]` = the root). Makes the\n   * drill-down controlled: clicks then only call `onDrill`, whose `path`\n   * should be stored and passed back.\n   */\n  drillPath?: readonly string[];\n  /** Called when a parent or the center is clicked (or the instance's `drill()` is called) */\n  onDrill?: (event: ShapeDrillEvent) => void;\n}\n\n/** Props of RadialBarChart */\nexport interface RadialBarChartProps extends ShapeChartCommonProps {\n  /** Bars, from the outermost ring inward: a name, a value, an optional `max` and color */\n  data: readonly RadialBarDatum[];\n  /**\n   * Value of a full bar for the data without `max`\n   * @default the largest value\n   */\n  max?: number;\n  /**\n   * Radius of the innermost ring's inner edge, as a fraction of the outer radius\n   * @default 0.3\n   */\n  innerRadius?: number;\n  /**\n   * Angle where the bars start, degrees clockwise from 12 o'clock\n   * @default 0\n   */\n  startAngle?: number;\n  /**\n   * Angle of a full bar, degrees (360 = full rings)\n   * @default 270\n   */\n  sweep?: number;\n  /**\n   * Gap between the rings, as a fraction of a ring's slot (0-0.9)\n   * @default 0.28\n   */\n  gap?: number;\n  /**\n   * Background tracks behind the bars\n   * @default true\n   */\n  track?: boolean;\n  /**\n   * Rounded bar ends\n   * @default true\n   */\n  rounded?: boolean;\n  /**\n   * Labels before the start of the bars (in the empty part of the circle)\n   * @default true when `sweep` leaves room for them (up to 300°)\n   */\n  labels?: boolean;\n  /**\n   * What a label shows: name, value, percent of the bar's max (combinable)\n   * @default [\"name\", \"value\"]\n   */\n  labelContent?: readonly (\"name\" | \"value\" | \"percent\")[];\n  /** Big text in the center (e.g. the overall completion) */\n  centerValue?: string;\n  /** Small text under `centerValue` */\n  centerLabel?: string;\n}\n\n/** Props of CalendarHeatmap */\nexport interface CalendarHeatmapProps extends ShapeChartCommonProps {\n  /** Daily values (several entries of the same day add up) */\n  data: readonly CalendarDatum[];\n  /**\n   * Days shown: a year (`2026`) or an inclusive `[start, end]` range\n   * @default the 53 weeks ending on the last day of the data\n   */\n  range?: number | readonly [CalendarDate, CalendarDate];\n  /**\n   * `weeks`: a column per week and a row per weekday (one strip per year\n   * when the range spans several years); `months`: a small calendar per month\n   * @default \"weeks\"\n   */\n  layout?: \"weeks\" | \"months\";\n  /**\n   * First day of the week, 0 = Sunday … 6 = Saturday\n   * @default from `locale`\n   */\n  weekStart?: number;\n  /**\n   * BCP 47 locale of the month and weekday names, of the tooltip dates, of the default `weekStart` and of the built-in texts\n   * @default the page language (`<html lang>`), else the browser language\n   */\n  locale?: string;\n  /**\n   * Color of the highest level (lower levels are lighter)\n   * @default the first palette color\n   */\n  color?: string;\n  /** Colors of the levels, lowest first (replaces `color` and sets the number of levels) */\n  colors?: readonly string[];\n  /**\n   * Number of color levels above the empty days\n   * @default 4\n   */\n  levels?: number;\n  /**\n   * Upper bounds of the levels but the last, ascending (`[2, 5, 10]`: 1-2,\n   * 3-5, 6-10, more); an even split of the largest value by default\n   */\n  thresholds?: readonly number[];\n  /**\n   * Gap between the cells, in pixels\n   * @default 3\n   */\n  gap?: number;\n  /**\n   * Corner radius of the cells, in pixels\n   * @default 2\n   */\n  radius?: number;\n  /**\n   * Largest cell size, in pixels (cells shrink to fit the width)\n   * @default 16 (weeks), 28 (months)\n   */\n  maxCellSize?: number;\n  /**\n   * Month names (and years) around the cells\n   * @default true\n   */\n  monthLabels?: boolean;\n  /**\n   * Weekday names beside (weeks) or above (months) the cells\n   * @default true\n   */\n  weekdayLabels?: boolean;\n}\n\n/** Props of BulletChart */\nexport interface BulletChartProps extends ShapeChartCommonProps {\n  /** Rows (columns when vertical): name, value, target, ranges and scale */\n  data: readonly BulletDatum[];\n  /**\n   * Horizontal rows or vertical columns\n   * @default \"horizontal\"\n   */\n  orientation?: \"horizontal\" | \"vertical\";\n  /** Qualitative ranges of the rows without `ranges`: upper bounds, ascending */\n  ranges?: readonly number[];\n  /** Names of the qualitative ranges, lowest first (tooltip) */\n  rangeLabels?: readonly string[];\n  /** Colors of the qualitative ranges, lowest first; shades of gray by default */\n  rangeColors?: readonly string[];\n  /**\n   * Thickness of the value bar as a fraction of the ranges' thickness\n   * @default 0.4\n   */\n  barSize?: number;\n  /**\n   * Color of the target markers\n   * @default the text color\n   */\n  targetColor?: string;\n  /**\n   * Tick labels of the scales (when there is room)\n   * @default true\n   */\n  ticks?: boolean;\n}\n\ninterface Handlers {\n  onHover?: (event: ShapeHoverEvent | null) => void;\n  onClick?: (event: ShapeHoverEvent) => void;\n  onToggle?: (event: ShapeToggleEvent) => void;\n  onDrill?: (event: ShapeDrillEvent) => void;\n}\n\ninterface ShapeChartBaseProps extends Handlers {\n  options: ShapeChartOptions;\n  height: number | string;\n  width?: number | string;\n  className?: string;\n  style?: CSSProperties;\n  handleRef?: Ref<ShapeChartHandle>;\n  renderTooltip?: (event: ShapeHoverEvent) => ReactNode;\n}\n\nconst size = (value: number | string | undefined, fallback: string) =>\n  value === undefined\n    ? fallback\n    : typeof value === \"number\"\n      ? `${value}px`\n      : value;\n\nconst subscribePageLanguage = (onChange: () => void) => {\n  if (typeof document === \"undefined\" || typeof MutationObserver !== \"function\")\n    return () => {};\n  const observer = new MutationObserver(onChange);\n  observer.observe(document.documentElement, {\n    attributes: true,\n    attributeFilter: [\"lang\"],\n  });\n  return () => observer.disconnect();\n};\n\nconst pageLanguage = () =>\n  typeof document === \"undefined\" ? \"\" : document.documentElement.lang;\n\nconst noPageLanguage = () => \"\";\n\n/** Engine options shared by every type, stable while the props are equal */\nconst useCommonOptions = ({\n  palette,\n  legend,\n  tooltip,\n  format,\n  percentFormat,\n  locale,\n  texts,\n  hidden,\n  animation,\n  padding,\n  ariaLabel,\n}: ShapeChartCommonProps): ShapeChartCommonOptions => {\n  // without `locale`, follow the page language (`<html lang>`) as it changes\n  const language = useSyncExternalStore(\n    subscribePageLanguage,\n    pageLanguage,\n    noPageLanguage,\n  );\n  const resolvedLocale = locale ?? (language || undefined);\n  // a new array with the same indexes keeps the options (and the animation)\n  const hiddenKey = hidden ? hidden.join(\",\") : null;\n  const stableHidden = useMemo(\n    () =>\n      hiddenKey === null\n        ? undefined\n        : hiddenKey\n          ? hiddenKey.split(\",\").map(Number)\n          : [],\n    [hiddenKey],\n  );\n  return useMemo(\n    () => ({\n      palette,\n      legend,\n      tooltip,\n      format,\n      percentFormat,\n      locale: resolvedLocale,\n      texts,\n      hidden: stableHidden,\n      animation,\n      padding,\n      ariaLabel,\n    }),\n    [\n      palette,\n      legend,\n      tooltip,\n      format,\n      percentFormat,\n      resolvedLocale,\n      texts,\n      stableHidden,\n      animation,\n      padding,\n      ariaLabel,\n    ],\n  );\n};\n\n/** Mounts the engine in a sized <div> and forwards option / handler changes */\nfunction ShapeChartBase({\n  options,\n  height,\n  width,\n  className,\n  style,\n  handleRef,\n  renderTooltip,\n  ...handlers\n}: ShapeChartBaseProps) {\n  const containerRef = useRef<HTMLDivElement>(null);\n  const chartRef = useRef<ShapeChartInstance | null>(null);\n  const handlersRef = useRef<Handlers>(handlers);\n  const tooltipRef = useRef(renderTooltip);\n  const [tipEvent, setTipEvent] = useState<ShapeHoverEvent | null>(null);\n  const tipHost = useMemo(\n    () =>\n      typeof document === \"undefined\" ? null : document.createElement(\"div\"),\n    [],\n  );\n  const customTooltip = !!renderTooltip;\n\n  const resolved = useMemo((): ShapeChartOptions => {\n    if (!customTooltip || !tipHost || options.tooltip === false) return options;\n    const base = typeof options.tooltip === \"object\" ? options.tooltip : {};\n    return {\n      ...options,\n      tooltip: {\n        ...base,\n        render: (event) => {\n          if (!tooltipRef.current) return null;\n          // render synchronously so the engine measures the final size\n          flushSync(() => setTipEvent(event));\n          return tipHost;\n        },\n      },\n    };\n  }, [options, customTooltip, tipHost]);\n  const optionsRef = useRef(resolved);\n\n  useEffect(() => {\n    handlersRef.current = handlers;\n    tooltipRef.current = renderTooltip;\n  });\n\n  useEffect(() => {\n    const container = containerRef.current;\n    if (!container) return;\n    const chart = createShapeChart(container, optionsRef.current);\n    chartRef.current = chart;\n    const offs = [\n      chart.on(\"hover\", (e) => handlersRef.current.onHover?.(e)),\n      chart.on(\"click\", (e) => handlersRef.current.onClick?.(e)),\n      chart.on(\"toggle\", (e) => handlersRef.current.onToggle?.(e)),\n      chart.on(\"drill\", (e) => handlersRef.current.onDrill?.(e)),\n    ];\n    return () => {\n      offs.forEach((off) => off());\n      chart.destroy();\n      chartRef.current = null;\n    };\n  }, []);\n\n  useEffect(() => {\n    if (optionsRef.current === resolved) return;\n    optionsRef.current = resolved;\n    chartRef.current?.setOptions(resolved);\n  }, [resolved]);\n\n  useImperativeHandle(\n    handleRef,\n    () => ({ getInstance: () => chartRef.current }),\n    [],\n  );\n\n  return (\n    <div\n      className={className}\n      style={{\n        position: \"relative\",\n        width: size(width, \"100%\"),\n        height: size(height, \"320px\"),\n        ...style,\n      }}\n    >\n      <div ref={containerRef} style={{ position: \"absolute\", inset: 0 }} />\n      {tipHost &&\n        tipEvent &&\n        renderTooltip &&\n        createPortal(renderTooltip(tipEvent), tipHost)}\n    </div>\n  );\n}\n\n/**\n * Pie chart (or a donut with `innerRadius`, or a Nightingale rose with\n * `rose`): slices with gaps, outside labels with leader lines, legend toggles.\n */\nexport function PieChart(props: PieChartProps) {\n  return <PieBase {...props} defaultInner={0} />;\n}\n\n/** Donut chart: a PieChart with a hole and optional center texts */\nexport function DonutChart(props: DonutChartProps) {\n  return <PieBase {...props} defaultInner={0.62} />;\n}\n\nfunction PieBase(props: PieChartProps & { defaultInner: number }) {\n  const {\n    data,\n    innerRadius,\n    startAngle,\n    padAngle,\n    cornerRadius,\n    rose,\n    labels,\n    labelContent,\n    centerValue,\n    centerLabel,\n    defaultInner,\n  } = props;\n  const common = useCommonOptions(props);\n  const options = useMemo(\n    (): PieChartOptions => ({\n      ...common,\n      type: \"pie\",\n      data,\n      innerRadius: innerRadius ?? defaultInner,\n      startAngle,\n      padAngle,\n      cornerRadius,\n      rose,\n      labels,\n      labelContent,\n      centerValue,\n      centerLabel,\n    }),\n    [\n      common,\n      data,\n      innerRadius,\n      defaultInner,\n      startAngle,\n      padAngle,\n      cornerRadius,\n      rose,\n      labels,\n      labelContent,\n      centerValue,\n      centerLabel,\n    ],\n  );\n  return <ShapeHost props={props} options={options} defaultHeight={320} />;\n}\n\n/** Radar (spider) chart comparing series over several indicators */\nexport function RadarChart(props: RadarChartProps) {\n  const { indicators, series, shape, levels, dots } = props;\n  const common = useCommonOptions(props);\n  const options = useMemo(\n    (): RadarChartOptions => ({\n      ...common,\n      type: \"radar\",\n      indicators,\n      series,\n      shape,\n      levels,\n      dots,\n    }),\n    [common, indicators, series, shape, levels, dots],\n  );\n  return <ShapeHost props={props} options={options} defaultHeight={320} />;\n}\n\n/** Gauge (speedometer) showing one value on an arc, with colored bands */\nexport function GaugeChart(props: GaugeChartProps) {\n  const {\n    value,\n    min,\n    max,\n    label,\n    sweep,\n    thickness,\n    bands,\n    color,\n    needle,\n    ticks,\n  } = props;\n  const common = useCommonOptions(props);\n  const options = useMemo(\n    (): GaugeChartOptions => ({\n      ...common,\n      type: \"gauge\",\n      value,\n      min,\n      max,\n      label,\n      sweep,\n      thickness,\n      bands,\n      color,\n      needle,\n      ticks,\n    }),\n    [\n      common,\n      value,\n      min,\n      max,\n      label,\n      sweep,\n      thickness,\n      bands,\n      color,\n      needle,\n      ticks,\n    ],\n  );\n  return <ShapeHost props={props} options={options} defaultHeight={240} />;\n}\n\n/** Funnel chart of the stages of a process, with conversion rates */\nexport function FunnelChart(props: FunnelChartProps) {\n  const { data, sort, gap, conversion, shape } = props;\n  const common = useCommonOptions(props);\n  const options = useMemo(\n    (): FunnelChartOptions => ({\n      ...common,\n      type: \"funnel\",\n      data,\n      sort,\n      gap,\n      conversion,\n      shape,\n    }),\n    [common, data, sort, gap, conversion, shape],\n  );\n  return <ShapeHost props={props} options={options} defaultHeight={320} />;\n}\n\n/** Treemap: nested rectangles of areas proportional to the values */\nexport function TreemapChart(props: TreemapChartProps) {\n  const { data, gap, headers } = props;\n  const common = useCommonOptions(props);\n  const options = useMemo(\n    (): TreemapChartOptions => ({\n      ...common,\n      type: \"treemap\",\n      data,\n      gap,\n      headers,\n    }),\n    [common, data, gap, headers],\n  );\n  return <ShapeHost props={props} options={options} defaultHeight={320} />;\n}\n\n/**\n * Sankey diagram: flows between nodes in columns, link thickness\n * proportional to the flow; hovering a node or a link highlights its flows\n */\nexport function SankeyChart(props: SankeyChartProps) {\n  const {\n    nodes,\n    links,\n    nodeWidth,\n    nodePadding,\n    align,\n    iterations,\n    linkColor,\n    linkOpacity,\n    labels,\n    labelValues,\n  } = props;\n  const common = useCommonOptions(props);\n  const options = useMemo(\n    (): SankeyChartOptions => ({\n      ...common,\n      type: \"sankey\",\n      nodes,\n      links,\n      nodeWidth,\n      nodePadding,\n      align,\n      iterations,\n      linkColor,\n      linkOpacity,\n      labels,\n      labelValues,\n    }),\n    [\n      common,\n      nodes,\n      links,\n      nodeWidth,\n      nodePadding,\n      align,\n      iterations,\n      linkColor,\n      linkOpacity,\n      labels,\n      labelValues,\n    ],\n  );\n  return <ShapeHost props={props} options={options} defaultHeight={360} />;\n}\n\n/**\n * Sunburst chart: a hierarchy as concentric rings; clicking a parent zooms\n * into it, clicking the center goes back up\n */\nexport function SunburstChart(props: SunburstChartProps) {\n  const {\n    data,\n    innerRadius,\n    levels,\n    startAngle,\n    padAngle,\n    cornerRadius,\n    labels,\n    drill,\n    drillPath,\n    onDrill,\n  } = props;\n  const common = useCommonOptions(props);\n  // a new array with the same names keeps the options (and the animation)\n  const drillKey = drillPath ? JSON.stringify(drillPath) : null;\n  const stablePath = useMemo(\n    () => (drillKey === null ? undefined : (JSON.parse(drillKey) as string[])),\n    [drillKey],\n  );\n  const options = useMemo(\n    (): SunburstChartOptions => ({\n      ...common,\n      type: \"sunburst\",\n      data,\n      innerRadius,\n      levels,\n      startAngle,\n      padAngle,\n      cornerRadius,\n      labels,\n      drill,\n      drillPath: stablePath,\n    }),\n    [\n      common,\n      data,\n      innerRadius,\n      levels,\n      startAngle,\n      padAngle,\n      cornerRadius,\n      labels,\n      drill,\n      stablePath,\n    ],\n  );\n  return (\n    <ShapeHost\n      props={props}\n      options={options}\n      defaultHeight={360}\n      onDrill={onDrill}\n    />\n  );\n}\n\n/** Radial bar chart: concentric progress rings (activity rings, KPI completion) */\nexport function RadialBarChart(props: RadialBarChartProps) {\n  const {\n    data,\n    max,\n    innerRadius,\n    startAngle,\n    sweep,\n    gap,\n    track,\n    rounded,\n    labels,\n    labelContent,\n    centerValue,\n    centerLabel,\n  } = props;\n  const common = useCommonOptions(props);\n  const options = useMemo(\n    (): RadialBarChartOptions => ({\n      ...common,\n      type: \"radialBar\",\n      data,\n      max,\n      innerRadius,\n      startAngle,\n      sweep,\n      gap,\n      track,\n      rounded,\n      labels,\n      labelContent,\n      centerValue,\n      centerLabel,\n    }),\n    [\n      common,\n      data,\n      max,\n      innerRadius,\n      startAngle,\n      sweep,\n      gap,\n      track,\n      rounded,\n      labels,\n      labelContent,\n      centerValue,\n      centerLabel,\n    ],\n  );\n  return <ShapeHost props={props} options={options} defaultHeight={300} />;\n}\n\n/** Calendar heatmap: daily values on a calendar, contributions-style */\nexport function CalendarHeatmap(props: CalendarHeatmapProps) {\n  const {\n    data,\n    range,\n    layout,\n    weekStart,\n    color,\n    colors,\n    levels,\n    thresholds,\n    gap,\n    radius,\n    maxCellSize,\n    monthLabels,\n    weekdayLabels,\n  } = props;\n  const common = useCommonOptions(props);\n  const options = useMemo(\n    (): CalendarHeatmapOptions => ({\n      ...common,\n      type: \"calendarHeatmap\",\n      data,\n      range,\n      layout,\n      weekStart,\n      color,\n      colors,\n      levels,\n      thresholds,\n      gap,\n      radius,\n      maxCellSize,\n      monthLabels,\n      weekdayLabels,\n    }),\n    [\n      common,\n      data,\n      range,\n      layout,\n      weekStart,\n      color,\n      colors,\n      levels,\n      thresholds,\n      gap,\n      radius,\n      maxCellSize,\n      monthLabels,\n      weekdayLabels,\n    ],\n  );\n  const defaultHeight = useMemo(() => {\n    const legend = options.legend === false ? 0 : 34;\n    if (layout === \"months\") return 560;\n    return calendarStrips(options) * 120 + legend + 16;\n  }, [options, layout]);\n  return (\n    <ShapeHost props={props} options={options} defaultHeight={defaultHeight} />\n  );\n}\n\n/** Bullet chart: KPI bars against qualitative ranges and a target marker */\nexport function BulletChart(props: BulletChartProps) {\n  const {\n    data,\n    orientation,\n    ranges,\n    rangeLabels,\n    rangeColors,\n    barSize,\n    targetColor,\n    ticks,\n  } = props;\n  const common = useCommonOptions(props);\n  const options = useMemo(\n    (): BulletChartOptions => ({\n      ...common,\n      type: \"bullet\",\n      data,\n      orientation,\n      ranges,\n      rangeLabels,\n      rangeColors,\n      barSize,\n      targetColor,\n      ticks,\n    }),\n    [\n      common,\n      data,\n      orientation,\n      ranges,\n      rangeLabels,\n      rangeColors,\n      barSize,\n      targetColor,\n      ticks,\n    ],\n  );\n  const legend = options.legend ? 34 : 0;\n  const defaultHeight =\n    orientation === \"vertical\"\n      ? 320\n      : Math.max(96, data.length * 64 + 16) + legend;\n  return (\n    <ShapeHost props={props} options={options} defaultHeight={defaultHeight} />\n  );\n}\n\nfunction ShapeHost({\n  props,\n  options,\n  defaultHeight,\n  onDrill,\n}: {\n  props: ShapeChartCommonProps;\n  options: ShapeChartOptions;\n  defaultHeight: number;\n  onDrill?: (event: ShapeDrillEvent) => void;\n}) {\n  return (\n    <ShapeChartBase\n      options={options}\n      height={props.height ?? defaultHeight}\n      width={props.width}\n      className={props.className}\n      style={props.style}\n      handleRef={props.ref}\n      onHover={props.onHover}\n      onClick={props.onClick}\n      onToggle={props.onToggle}\n      onDrill={onDrill}\n      renderTooltip={props.renderTooltip}\n    />\n  );\n}\n"],"mappings":"mLAqkBA,IAAMY,GAAQ,EAAoC,IAChDC,IAAU,IAAA,GACNC,EACA,OAAOD,GAAU,SACf,GAAGA,EAAM,IACTA,EAEFE,EAAyB,GAAyB,CACtD,GAAI,OAAO,SAAa,KAAe,OAAO,kBAAqB,WACjE,UAAa,CAAC,EAChB,IAAMC,EAAW,IAAI,iBAAiBC,CAAQ,EAK9C,OAJAD,EAAS,QAAQ,SAAS,gBAAiB,CACzC,WAAY,GACZ,gBAAiB,CAAC,MAAM,CAC1B,CAAC,MACYA,EAAS,WAAW,CACnC,EAEME,MACJ,OAAO,SAAa,IAAc,GAAK,SAAS,gBAAgB,KAE5DC,MAAuB,GAGvBC,GAAoB,CACxB,UACA,SACA,UACA,SACA,gBACA,SACA,QACA,SACA,YACA,UACA,eACoD,CAEpD,IAAMC,GAAA,EAAWrB,EAAAA,qBAAAA,CACfe,EACAG,EACAC,CACF,EACMG,EAAiBC,IAAWF,GAAY,IAAA,IAExCG,EAAYC,EAASA,EAAO,KAAK,GAAG,EAAI,KACxCC,GAAA,EAAezB,EAAAA,QAAAA,KAEjBuB,IAAc,KACV,IAAA,GACAA,EACEA,EAAU,MAAM,GAAG,CAAC,CAAC,IAAI,MAAM,EAC/B,CAAC,EACT,CAACA,CAAS,CACZ,EACA,OAAA,EAAOvB,EAAAA,QAAAA,MACE,CACL,UACA,SACA,UACA,SACA,gBACA,OAAQqB,EACR,QACA,OAAQI,EACR,YACA,UACA,WACF,GACA,CACEC,EACAC,EACAC,EACAC,EACAC,EACAT,EACAU,EACAN,EACAO,EACAC,EACAC,CACF,CACF,CACF,EAGA,SAASC,EAAe,CACtB,UACA,SACA,QACA,YACA,QACA,YACA,gBACA,GAAGC,GACmB,CACtB,IAAMC,GAAA,EAAepC,EAAAA,OAAAA,CAAuB,IAAI,EAC1CqC,GAAA,EAAWrC,EAAAA,OAAAA,CAAkC,IAAI,EACjDsC,GAAA,EAActC,EAAAA,OAAAA,CAAiBmC,CAAQ,EACvCI,GAAA,EAAavC,EAAAA,OAAAA,CAAOwC,CAAa,EACjC,CAACC,EAAUC,IAAA,EAAezC,EAAAA,SAAAA,CAAiC,IAAI,EAC/D0C,GAAA,EAAU5C,EAAAA,QAAAA,KAEZ,OAAO,SAAa,IAAc,KAAO,SAAS,cAAc,KAAK,EACvE,CAAC,CACH,EACM6C,EAAgB,CAAC,CAACJ,EAElBK,GAAA,EAAW9C,EAAAA,QAAAA,KAAiC,CAChD,GAAI,CAAC6C,GAAiB,CAACD,GAAWG,EAAQ,UAAY,GAAO,OAAOA,EACpE,IAAMC,EAAO,OAAOD,EAAQ,SAAY,SAAWA,EAAQ,QAAU,CAAC,EACtE,MAAO,CACL,GAAGA,EACH,QAAS,CACP,GAAGC,EACH,OAAS,GACFR,EAAW,UAEhB,EAAA/B,EAAA,UAAA,KAAgBkC,EAAYM,CAAK,CAAC,EAC3BL,GAHyB,IAKpC,CACF,CACF,EAAG,CAACG,EAASF,EAAeD,CAAO,CAAC,EAC9BM,GAAA,EAAajD,EAAAA,OAAAA,CAAO6C,CAAQ,EAqClC,OAnCA,EAAAtC,EAAA,UAAA,KAAgB,CACd,EAAY,QAAU4B,EACtB,EAAW,QAAUK,CACvB,CAAC,GAED,EAAAjC,EAAA,UAAA,KAAgB,CACd,IAAM2C,EAAYd,EAAa,QAC/B,GAAI,CAACc,EAAW,OAChB,IAAMC,EAAQjD,EAAAA,iBAAiBgD,EAAWD,EAAW,OAAO,EAC5D,EAAS,QAAUE,EACnB,IAAMC,EAAO,CACXD,EAAM,GAAG,QAAU,GAAMb,EAAY,QAAQ,UAAU,CAAC,CAAC,EACzDa,EAAM,GAAG,QAAU,GAAMb,EAAY,QAAQ,UAAU,CAAC,CAAC,EACzDa,EAAM,GAAG,SAAW,GAAMb,EAAY,QAAQ,WAAW,CAAC,CAAC,EAC3Da,EAAM,GAAG,QAAU,GAAMb,EAAY,QAAQ,UAAU,CAAC,CAAC,CAC3D,EACA,UAAa,CACXc,EAAK,QAAS,GAAQC,EAAI,CAAC,EAC3BF,EAAM,QAAQ,EACd,EAAS,QAAU,IACrB,CACF,EAAG,CAAC,CAAC,GAEL,EAAA5C,EAAA,UAAA,KAAgB,CACV0C,EAAW,UAAYJ,IAC3B,EAAW,QAAUA,EACrBR,EAAS,SAAS,WAAWQ,CAAQ,EACvC,EAAG,CAACA,CAAQ,CAAC,GAEb,EAAAtC,EAAA,oBAAA,CACE+C,OACO,CAAE,gBAAmBjB,EAAS,OAAQ,GAC7C,CAAC,CACH,GAGE,EAAA5B,EAAA,KAAA,CAAC,MAAD,CACa,YACX,MAAO,CACL,SAAU,WACV,MAAOC,EAAK6C,EAAO,MAAM,EACzB,OAAQ7C,EAAK8C,EAAQ,OAAO,EAC5B,GAAGC,CACL,EAPF,SAAA,EASE,EAAAhD,EAAA,IAAA,CAAC,MAAD,CAAK,IAAK2B,EAAc,MAAO,CAAE,SAAU,WAAY,MAAO,CAAE,CAAI,CAAA,EACnEO,GACCF,GACAD,IAAA,EACArC,EAAAA,aAAAA,CAAaqC,EAAcC,CAAQ,EAAGE,CAAO,CAC5C,GAET,CAMA,SAAgBe,EAAS,EAAsB,CAC7C,OAAO,EAAAjD,EAAA,IAAA,CAACkD,EAAD,CAAS,GAAIC,EAAO,aAAc,CAAI,CAAA,CAC/C,CAGA,SAAgBC,EAAW,EAAwB,CACjD,OAAO,EAAApD,EAAA,IAAA,CAACkD,EAAD,CAAS,GAAIC,EAAO,aAAc,GAAO,CAAA,CAClD,CAEA,SAASD,EAAQ,EAAiD,CAChE,GAAM,CACJ,OACA,cACA,aACA,WACA,eACA,OACA,SACA,eACA,cACA,cACA,gBACEC,EACEE,EAAS5C,EAAiB0C,CAAK,EAC/Bd,GAAA,EAAU/C,EAAAA,QAAAA,MACU,CACtB,GAAG+D,EACH,KAAM,MACN,OACA,YAAaC,GAAeC,EAC5B,aACA,WACA,eACA,OACA,SACA,eACA,cACA,aACF,GACA,CACEF,EACAG,EACAF,EACAC,EACAE,EACAC,EACAC,EACAC,EACAC,EACAC,EACAC,EACAC,CACF,CACF,EACA,OAAO,EAAAhE,EAAA,IAAA,CAACiE,EAAD,CAAkB,QAAgB,UAAS,cAAe,GAAM,CAAA,CACzE,CAGA,SAAgBC,EAAW,EAAwB,CACjD,GAAM,CAAE,aAAY,SAAQ,QAAO,SAAQ,QAASf,EAC9CE,EAAS5C,EAAiB0C,CAAK,EAC/Bd,GAAA,EAAU/C,EAAAA,QAAAA,MACY,CACxB,GAAG+D,EACH,KAAM,QACN,aACA,SACA,QACA,SACA,MACF,GACA,CAACA,EAAQc,EAAYC,EAAQC,EAAOC,EAAQC,CAAI,CAClD,EACA,OAAO,EAAAvE,EAAA,IAAA,CAACiE,EAAD,CAAkB,QAAgB,UAAS,cAAe,GAAM,CAAA,CACzE,CAGA,SAAgBO,EAAW,EAAwB,CACjD,GAAM,CACJ,QACA,MACA,MACA,QACA,QACA,YACA,QACA,QACA,SACA,SACErB,EACEE,EAAS5C,EAAiB0C,CAAK,EAC/Bd,GAAA,EAAU/C,EAAAA,QAAAA,MACY,CACxB,GAAG+D,EACH,KAAM,QACN,QACA,MACA,MACA,QACA,QACA,YACA,QACA,QACA,SACA,OACF,GACA,CACEA,EACAnD,EACAuE,EACAC,EACAC,EACAC,EACAC,EACAC,EACAC,EACAC,EACAC,CACF,CACF,EACA,OAAO,EAAAjF,EAAA,IAAA,CAACiE,EAAD,CAAkB,QAAgB,UAAS,cAAe,GAAM,CAAA,CACzE,CAGA,SAAgBiB,EAAY,EAAyB,CACnD,GAAM,CAAE,OAAM,OAAM,MAAK,aAAY,SAAU/B,EACzCE,EAAS5C,EAAiB0C,CAAK,EAC/Bd,GAAA,EAAU/C,EAAAA,QAAAA,MACa,CACzB,GAAG+D,EACH,KAAM,SACN,OACA,OACA,MACA,aACA,OACF,GACA,CAACA,EAAQG,EAAM2B,EAAMC,EAAKC,EAAYhB,CAAK,CAC7C,EACA,OAAO,EAAArE,EAAA,IAAA,CAACiE,EAAD,CAAkB,QAAgB,UAAS,cAAe,GAAM,CAAA,CACzE,CAGA,SAAgBqB,EAAa,EAA0B,CACrD,GAAM,CAAE,OAAM,MAAK,WAAYnC,EACzBE,EAAS5C,EAAiB0C,CAAK,EAC/Bd,GAAA,EAAU/C,EAAAA,QAAAA,MACc,CAC1B,GAAG+D,EACH,KAAM,UACN,OACA,MACA,SACF,GACA,CAACA,EAAQG,EAAM4B,EAAKG,CAAO,CAC7B,EACA,OAAO,EAAAvF,EAAA,IAAA,CAACiE,EAAD,CAAkB,QAAgB,UAAS,cAAe,GAAM,CAAA,CACzE,CAMA,SAAgBuB,EAAY,EAAyB,CACnD,GAAM,CACJ,QACA,QACA,YACA,cACA,QACA,aACA,YACA,cACA,SACA,eACErC,EACEE,EAAS5C,EAAiB0C,CAAK,EAC/Bd,GAAA,EAAU/C,EAAAA,QAAAA,MACa,CACzB,GAAG+D,EACH,KAAM,SACN,QACA,QACA,YACA,cACA,QACA,aACA,YACA,cACA,SACA,aACF,GACA,CACEA,EACAoC,EACAC,EACAC,EACAC,EACAC,EACAC,EACAC,EACAC,EACAnC,EACAoC,CACF,CACF,EACA,OAAO,EAAAjG,EAAA,IAAA,CAACiE,EAAD,CAAkB,QAAgB,UAAS,cAAe,GAAM,CAAA,CACzE,CAMA,SAAgBiC,EAAc,EAA2B,CACvD,GAAM,CACJ,OACA,cACA,SACA,aACA,WACA,eACA,SACA,QACA,YACA,WACE/C,EACEE,EAAS5C,EAAiB0C,CAAK,EAE/BgD,EAAWC,EAAY,KAAK,UAAUA,CAAS,EAAI,KACnDC,GAAA,EAAa/G,EAAAA,QAAAA,KACV6G,IAAa,KAAO,IAAA,GAAa,KAAK,MAAMA,CAAQ,EAC3D,CAACA,CAAQ,CACX,EACM9D,GAAA,EAAU/C,EAAAA,QAAAA,MACe,CAC3B,GAAG+D,EACH,KAAM,WACN,OACA,cACA,SACA,aACA,WACA,eACA,SACA,QACA,UAAWgD,CACb,GACA,CACEhD,EACAG,EACAF,EACAgB,EACAb,EACAC,EACAC,EACAE,EACAyC,EACAD,CACF,CACF,EACA,OACE,EAAArG,EAAA,IAAA,CAACiE,EAAD,CACS,QACE,UACT,cAAe,IACN,SACV,CAAA,CAEL,CAGA,SAAgBsC,EAAe,EAA4B,CACzD,GAAM,CACJ,OACA,MACA,cACA,aACA,QACA,MACA,QACA,UACA,SACA,eACA,cACA,eACEpD,EACEE,EAAS5C,EAAiB0C,CAAK,EAC/Bd,GAAA,EAAU/C,EAAAA,QAAAA,MACgB,CAC5B,GAAG+D,EACH,KAAM,YACN,OACA,MACA,cACA,aACA,QACA,MACA,QACA,UACA,SACA,eACA,cACA,aACF,GACA,CACEA,EACAG,EACAkB,EACApB,EACAG,EACAmB,EACAQ,EACAoB,EACAC,EACA5C,EACAC,EACAC,EACAC,CACF,CACF,EACA,OAAO,EAAAhE,EAAA,IAAA,CAACiE,EAAD,CAAkB,QAAgB,UAAS,cAAe,GAAM,CAAA,CACzE,CAGA,SAAgByC,EAAgB,EAA6B,CAC3D,GAAM,CACJ,OACA,QACA,SACA,YACA,QACA,SACA,SACA,aACA,MACA,SACA,cACA,cACA,iBACEvD,EACEE,EAAS5C,EAAiB0C,CAAK,EAC/Bd,GAAA,EAAU/C,EAAAA,QAAAA,MACiB,CAC7B,GAAG+D,EACH,KAAM,kBACN,OACA,QACA,SACA,YACA,QACA,SACA,SACA,aACA,MACA,SACA,cACA,cACA,eACF,GACA,CACEA,EACAG,EACAmD,EACAC,EACAC,EACA9B,EACA+B,EACAxC,EACAyC,EACA3B,EACA4B,EACAC,EACAC,EACAC,CACF,CACF,EACMC,GAAA,EAAgB9H,EAAAA,QAAAA,KAAc,CAClC,IAAM2B,EAASoB,EAAQ,SAAW,GAAQ,EAAI,GAE9C,OADIuE,IAAW,SAAiB,IACzBjH,EAAAA,eAAe0C,CAAO,EAAI,IAAMpB,EAAS,EAClD,EAAG,CAACoB,EAASuE,CAAM,CAAC,EACpB,OACE,EAAA5G,EAAA,IAAA,CAACiE,EAAD,CAAkB,QAAgB,UAAwB,eAAgB,CAAA,CAE9E,CAGA,SAAgBoD,EAAY,EAAyB,CACnD,GAAM,CACJ,OACA,cACA,SACA,cACA,cACA,UACA,cACA,SACElE,EACEE,EAAS5C,EAAiB0C,CAAK,EAC/Bd,GAAA,EAAU/C,EAAAA,QAAAA,MACa,CACzB,GAAG+D,EACH,KAAM,SACN,OACA,cACA,SACA,cACA,cACA,UACA,cACA,OACF,GACA,CACEA,EACAG,EACA8D,EACAC,EACAC,EACAC,EACAC,EACAC,EACA1C,CACF,CACF,EACMhE,EAASoB,EAAQ,OAAS,GAAK,EAC/B+E,EACJE,IAAgB,WACZ,IACA,KAAK,IAAI,GAAI9D,EAAK,OAAS,GAAK,EAAE,EAAIvC,EAC5C,OACE,EAAAjB,EAAA,IAAA,CAACiE,EAAD,CAAkB,QAAgB,UAAwB,eAAgB,CAAA,CAE9E,CAEA,SAASA,EAAU,CACjB,QACA,UACA,gBACA,WAMC,CACD,OACE,EAAAjE,EAAA,IAAA,CAACyB,EAAD,CACW,UACT,OAAQ0B,EAAM,QAAUiE,EACxB,MAAOjE,EAAM,MACb,UAAWA,EAAM,UACjB,MAAOA,EAAM,MACb,UAAWA,EAAM,IACjB,QAASA,EAAM,QACf,QAASA,EAAM,QACf,SAAUA,EAAM,SACP,UACT,cAAeA,EAAM,aACtB,CAAA,CAEL"}