{"version":3,"file":"use-on-elements-measured.cjs","sources":["../../../src/hooks/use-on-elements-measured.ts"],"sourcesContent":["import { useLayoutEffect, useRef } from 'react';\nimport type { dia } from '@joint/core';\nimport { usePaperStore, useResolvePaperId } from './use-paper';\nimport type { PaperTarget } from '../types';\nimport { useGraphStore } from './use-graph-store';\nimport { useLatestRef } from './use-latest-ref';\n\n/**\n * Payload passed to the {@link useOnElementsMeasured} callback after a\n * measurement pass.\n * @group Types\n * @expand\n */\nexport interface ElementsMeasuredParams {\n  /** True on the first measurement pass (at least one element has been sized). */\n  readonly isInitial: boolean;\n  /** The paper this hook is bound to (the surrounding `<Paper>` context, or the paper passed via `paperTarget`). */\n  readonly paper: dia.Paper;\n  /** The graph model associated with the paper. */\n  readonly graph: dia.Graph;\n}\n\n/**\n * Callback invoked by {@link useOnElementsMeasured} after each measurement pass;\n * receives the {@link ElementsMeasuredParams} payload.\n * @group Types\n */\nexport type OnElementsMeasured = (params: ElementsMeasuredParams) => void;\n\n/**\n * Calls a callback when element sizes are measured or re-measured.\n *\n * Fires on the first measurement pass (at least one element has been sized)\n * and again whenever an element is resized.\n *\n * The callback receives {@link ElementsMeasuredParams}; check `isInitial` to\n * distinguish the first measurement from later ones.\n * @title On the current paper\n * @param callback - Called each time element sizes are measured.\n * @group Hooks\n * @example\n * ```tsx\n * import { useOnElementsMeasured } from '@joint/react';\n *\n * // Mount inside a <Paper>: fit the surrounding paper once everything is sized.\n * function FitOnMeasure() {\n *   useOnElementsMeasured(({ paper, isInitial }) => {\n *     if (isInitial) {\n *       paper.transformToFitContent({ padding: 20 });\n *     }\n *   });\n *   return null;\n * }\n * ```\n */\nexport function useOnElementsMeasured(callback: OnElementsMeasured): void;\n/**\n * Calls a callback when element sizes are measured, targeting a specific paper\n * instead of the surrounding context. Useful when several papers share one graph.\n * @title On a specific paper\n * @param paperTarget - Which paper to watch: a registered paper id, a\n *   `dia.Paper` instance, or a React ref to one.\n * @param callback - Called each time element sizes are measured.\n * @group Hooks\n * @example\n * ```tsx\n * import { useOnElementsMeasured } from '@joint/react';\n * import { useRef } from 'react';\n * import type { dia } from '@joint/core';\n *\n * function FitSpecificPaper() {\n *   const paperRef = useRef<dia.Paper>(null);\n *   useOnElementsMeasured(paperRef, ({ paper }) => {\n *     paper.transformToFitContent({ padding: 20 });\n *   });\n *   return null;\n * }\n * ```\n */\nexport function useOnElementsMeasured(paperTarget: PaperTarget, callback: OnElementsMeasured): void;\nexport function useOnElementsMeasured(\n  paperTargetOrCallback: PaperTarget | OnElementsMeasured,\n  callbackArgument?: OnElementsMeasured\n): void {\n  const isContextForm = typeof paperTargetOrCallback === 'function';\n\n  const paperTarget = isContextForm ? undefined : (paperTargetOrCallback as PaperTarget);\n  const callback = isContextForm ? (paperTargetOrCallback as OnElementsMeasured) : (callbackArgument as OnElementsMeasured);\n\n  const paperId = useResolvePaperId(paperTarget);\n  const paperStore = usePaperStore(paperId);\n\n  const callbackRef = useLatestRef(callback);\n\n  const { measureState, graph } = useGraphStore();\n  const wasMeasuredRef = useRef(false);\n  useLayoutEffect(() => {\n    if (!paperStore) return;\n    const { paper } = paperStore;\n\n    function handleChanges() {\n      const value = measureState.get();\n      const isMeasured = value > 0;\n      const isInitial = isMeasured && !wasMeasuredRef.current;\n      if (isInitial) {\n        wasMeasuredRef.current = true;\n      }\n      callbackRef.current({ isInitial, paper, graph });\n      // The user callback may have moved cells via cell.position()/cell.size().\n      // PaperView runs in async mode, so those updates would be queued for the\n      // next rAF — producing a one-frame flash where the element is visible at its\n      // pre-layout position. Flush them synchronously so the next paint already\n      // reflects the post-layout state.\n      paper.updateViews();\n    }\n    // Flush any measurement that happened before subscription (e.g. initial\n    // data sync ran before this paperStore was available).\n    if (measureState.get() > 0) {\n      handleChanges();\n    }\n    const unsubscribe = measureState.subscribe(handleChanges);\n    return () => {\n      unsubscribe();\n    };\n  }, [paperStore, measureState, graph, callbackRef]);\n}\n"],"names":["useResolvePaperId","usePaperStore","useLatestRef","useGraphStore","useRef","useLayoutEffect"],"mappings":";;;;;;;;;;;;;;AAgFO,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAS,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CACd,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,GACA,gBAAA,CAAA,CACM,CAAA;AACN,CAAA,CAAA,MAAM,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAgB,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAO,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,KAA0B,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA;AAEvD,CAAA,CAAA,MAAM,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAc,gBAAgB,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,GAAa,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA;AACjD,CAAA,CAAA,MAAM,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAW,gBAAiB,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,GAAgD,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA;AAElF,CAAA,CAAA,MAAM,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAUA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,EAAkB,WAAW,CAAA,CAAA;AAC7C,CAAA,CAAA,MAAM,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAaC,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,EAAc,OAAO,CAAA,CAAA;AAExC,CAAA,CAAA,MAAM,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAcC,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,EAAa,QAAQ,CAAA,CAAA;AAEzC,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAM,EAAE,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAc,KAAA,CAAA,CAAM,CAAA,CAAA,CAAIC,2BAAA,CAAA,CAAc,CAAA;AAC9C,CAAA,CAAA,MAAM,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAiBC,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,EAAO,KAAK,CAAA,CAAA;AACnC,CAAA,CAAAC,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,CAAA,CAAgB,CAAA,CAAA,CAAA,CAAA,CAAA,CAAM,CAAA;AACpB,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAI,CAAC,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAY,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA;AACjB,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAM,CAAA,CAAE,CAAA,CAAA,CAAA,CAAA,GAAM,GAAI,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA;AAElB,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAS,aAAA,CAAA,CAAA,CAAgB,CAAA;AACvB,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,MAAM,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAQ,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAa,GAAA,CAAA,CAAI,CAAA;AAC/B,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAM,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,IAAa,CAAA,CAAA,CAAA,CAAA,CAAA,GAAQ,CAAA,CAAA;AAC3B,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAM,SAAA,CAAA,CAAA,CAAY,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,IAAc,CAAC,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAe,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA;AAChD,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAI,SAAA,CAAA,CAAW,CAAA;AACb,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAe,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAU,CAAA,CAAA,CAAA,CAAA,CAAA;AAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAC3B,CAAA;AACA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAY,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAQ,CAAA,CAAE,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAW,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAO,CAAA,CAAA,CAAA,CAAA,GAAO,CAAA,CAAA;AAM/C,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAM,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAY,CAAA;AAAA,CAAA,CAAA,CAAA,CACpB,CAAA;AAGA,CAAA,CAAA,CAAA,CAAA,IAAI,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAa,GAAA,CAAA,CAAI,CAAA,CAAA,CAAI,CAAA,CAAA,CAAG,CAAA;AAC1B,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,aAAA,CAAA,CAAc,CAAA;AAAA,CAAA,CAAA,CAAA,CAChB,CAAA;AACA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAM,WAAA,CAAA,CAAA,CAAc,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAa,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAU,aAAa,CAAA,CAAA;AACxD,CAAA,CAAA,CAAA,CAAA,OAAO,CAAA,CAAA,CAAA,CAAA,CAAA,CAAM,CAAA;AACX,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,WAAA,CAAA,CAAY,CAAA;AAAA,CAAA,CAAA,CAAA,CACd,CAAA,CAAA;AAAA,CAAA,CACF,GAAG,CAAC,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAY,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAc,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAO,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAW,CAAC,CAAA,CAAA;AACnD,CAAA;;"}