@aiquants/resize-panels 1.9.0 → 2.0.1

package/src/utils.ts

@@ -1,279 +0,0 @@
-/**
- * @file Utility functions for custom resizable panels
- * カスタムリサイズ可能パネルのためのユーティリティ関数
- */
-
-import { roundHalfToEven } from "./roundHalfToEven"
-import { type ContainerAxisMeasurement, type FlexibleSize, PANEL_COLLAPSE_THRESHOLD_MAX, PANEL_COLLAPSE_THRESHOLD_RATIO, PANEL_MIN_SNAP_THRESHOLD, PANEL_SNAP_THRESHOLD, type PanelDirection, type PanelLayoutData, type SizeConfig, type SizeUnit } from "./types"
-
-/**
- * Number of significant fractional digits to preserve when rounding percentage-based sizes.
- * パーセンテージサイズの丸めで保持する有効小数桁数。
- */
-export const PERCENTAGE_DIGITS = 6
-
-/**
- * Convert a pixel measurement to a percentage of the container using banker’s rounding.
- * ピクセル寸法をバンカーズラウンディングでコンテナ比率のパーセンテージへ変換する。
- */
-export const toRoundedPercentage = (size: number, base: number): number => {
-    if (base <= 0) {
-        return 0
-    }
-    const percentage = roundHalfToEven((size / base) * 100, PERCENTAGE_DIGITS)
-    return percentage
-}
-
-/**
- * Translate a percentage-based size back into pixels relative to the container.
- * パーセンテージ指定のサイズをコンテナ基準のピクセル値へ変換する。
- */
-export const percentageToPixels = (percentage: number | undefined, base: number): number => {
-    if (!percentage || base <= 0) {
-        return 0
-    }
-    return (percentage / 100) * base
-}
-
-/**
- * Normalize a flexible size into a size configuration object.
- * 柔軟なサイズ指定をサイズ設定オブジェクトへ正規化する。
- */
-export const normalizeSizeConfig = (size: FlexibleSize | undefined, defaultUnit: SizeUnit = "percentage"): SizeConfig | undefined => {
-    if (size === undefined) return undefined
-    if (typeof size === "number") {
-        return { value: size, unit: defaultUnit }
-    }
-    return size
-}
-
-/**
- * Convert flexible size constraints into pixel values based on container size.
- * 柔軟サイズ制約をコンテナサイズ基準のピクセル値へ変換する。
- */
-export const getConstraintInPixels = (size: FlexibleSize | undefined, defaultValue: number, containerSize: number): number => {
-    if (!size) return defaultValue
-    if (typeof size === "number") {
-        return (size / 100) * containerSize
-    }
-    if (size.unit === "pixels") {
-        return size.value
-    }
-    return (size.value / 100) * containerSize
-}
-
-/**
- * Clamp a numeric value between the provided bounds.
- * 数値を指定した範囲に収めるためのクリッピング処理。
- */
-export const clamp = (value: number, min: number, max: number): number => {
-    return Math.min(Math.max(value, min), max)
-}
-
-/**
- * Derive a snap-to-zero threshold from the container axis length using shared heuristics.
- * 共通ヒューリスティクスに基づきコンテナ軸長からゼロスナップ閾値を算出する。
- */
-export const calculateSnapThreshold = (axisSize: number): number => {
-    if (!Number.isFinite(axisSize) || axisSize <= 0) {
-        return PANEL_MIN_SNAP_THRESHOLD
-    }
-    const thresholdFromRatio = axisSize * PANEL_COLLAPSE_THRESHOLD_RATIO
-    const cappedThreshold = Math.min(PANEL_SNAP_THRESHOLD, PANEL_COLLAPSE_THRESHOLD_MAX, thresholdFromRatio)
-    return Math.max(PANEL_MIN_SNAP_THRESHOLD, cappedThreshold)
-}
-
-/**
- * Adjust pixel-based panels in priority order to absorb remaining space.
- * 残余スペースを吸収するためにピクセル基準パネルを優先度順に調整する。
- */
-type AdjustPixelOptions = {
-    enforceAutoMinSize?: boolean
-}
-
-export const adjustPixelPanelsByPriority = (panels: PanelLayoutData[], sizeDiff: number, containerSize: number, options: AdjustPixelOptions = {}): number => {
-    if (Math.abs(sizeDiff) <= 0) {
-        return sizeDiff
-    }
-
-    const enforceAutoMinSize = options.enforceAutoMinSize ?? false
-
-    // ピクセル指定パネルを抽出してインデックスを保持
-    const pixelPanels = panels.map((panel, index) => ({ panel, index })).filter(({ panel }) => !panel.collapsed && (panel.sizeUnit === "pixels" || panel.originalPixelSize !== undefined))
-
-    if (pixelPanels.length === 0) {
-        return sizeDiff
-    }
-
-    // 優先度順にソート (優先度が同じ場合はインデックス順)
-    const isGrowing = sizeDiff > 0
-    const sortedPanels = [...pixelPanels].sort((a, b) => {
-        const priorityA = a.panel.pixelAdjustPriority ?? a.index + 1
-        const priorityB = b.panel.pixelAdjustPriority ?? b.index + 1
-        if (priorityA === priorityB) {
-            return isGrowing ? b.index - a.index : a.index - b.index
-        }
-        return isGrowing ? priorityB - priorityA : priorityA - priorityB
-    })
-
-    let remaining = sizeDiff
-
-    /**
-     * Execute a single adjustment pass for pixel panels.
-     * ピクセルパネル調整処理
-     */
-    const adjustPass = (respectPreferred: boolean) => {
-        for (const { index } of sortedPanels) {
-            if (Math.abs(remaining) <= 0) {
-                break
-            }
-
-            const panel = panels[index]
-            if (!panel || panel.collapsed) {
-                continue
-            }
-
-            // パネルの最小・最大サイズをピクセル値へ変換
-            // bare number は他の全経路 (getConstraintInPixels) と同じくパーセンテージとして解釈する
-            const minSizeFromConstraint = getConstraintInPixels(panel.minSize, 0, containerSize)
-            const maxSize = getConstraintInPixels(panel.maxSize, containerSize, containerSize)
-            const autoMinSize = enforceAutoMinSize ? getConstraintInPixels(panel.autoMinSize, 0, containerSize) : 0
-            const minSize = Math.max(minSizeFromConstraint, autoMinSize)
-            const preferredPixel = panel.preferredPixelSize !== undefined ? clamp(panel.preferredPixelSize, minSize, maxSize) : panel.size
-
-            const panelIsCollapsible = panel.collapseFromStart || panel.collapseFromEnd
-            if (remaining > 0) {
-                // パネルサイズがゼロかどうかを判定
-                const isZero = Math.abs(panel.size) <= 0 && (panel.percentageSize ?? 0) <= 0
-                // ゼロのパネルはスキップ
-                if (isZero) {
-                    continue
-                }
-
-                const targetSize = Math.max(panel.size, preferredPixel)
-                const effectiveMax = respectPreferred ? Math.min(maxSize, targetSize) : maxSize
-                const expansionCapacity = Math.max(0, effectiveMax - panel.size)
-                if (expansionCapacity <= 0) {
-                    continue
-                }
-                const applied = Math.min(expansionCapacity, remaining)
-                if (applied <= 0) {
-                    continue
-                }
-                const nextSize = panel.size + applied
-                const nextPercentage = toRoundedPercentage(nextSize, containerSize)
-                const nextSizeBeforeCollapse = panelIsCollapsible ? nextSize : panel.sizeBeforeCollapse
-                const nextMeasuredPixelBeforeCollapse = panelIsCollapsible ? (panel.measuredPixelSizeBeforeCollapse ?? panel.measuredPixelSize ?? nextSize) : panel.measuredPixelSizeBeforeCollapse
-                panels[index] = {
-                    ...panel,
-                    size: nextSize,
-                    percentageSize: nextPercentage,
-                    sizeBeforeCollapse: nextSizeBeforeCollapse,
-                    measuredPixelSizeBeforeCollapse: nextMeasuredPixelBeforeCollapse,
-                    measuredPixelSize: undefined,
-                    measuredPercentageSize: undefined,
-                }
-                remaining -= applied
-            } else {
-                const shrinkFloor = respectPreferred ? preferredPixel : minSize
-                const reductionCapacity = Math.max(0, panel.size - shrinkFloor)
-                if (reductionCapacity <= 0) {
-                    continue
-                }
-                const applied = Math.min(reductionCapacity, Math.abs(remaining))
-                if (applied <= 0) {
-                    continue
-                }
-                const nextSize = panel.size - applied
-                const nextPercentage = toRoundedPercentage(nextSize, containerSize)
-                const nextSizeBeforeCollapse = panelIsCollapsible ? nextSize : panel.sizeBeforeCollapse
-                const nextMeasuredPixelBeforeCollapse = panelIsCollapsible ? (panel.measuredPixelSizeBeforeCollapse ?? panel.measuredPixelSize ?? nextSize) : panel.measuredPixelSizeBeforeCollapse
-                panels[index] = {
-                    ...panel,
-                    size: nextSize,
-                    percentageSize: nextPercentage,
-                    sizeBeforeCollapse: nextSizeBeforeCollapse,
-                    measuredPixelSizeBeforeCollapse: nextMeasuredPixelBeforeCollapse,
-                    measuredPixelSize: undefined,
-                    measuredPercentageSize: undefined,
-                }
-                remaining += applied
-            }
-        }
-    }
-
-    adjustPass(true)
-
-    if ((isGrowing && remaining > 0) || (!isGrowing && remaining < 0)) {
-        adjustPass(false)
-    }
-
-    return remaining
-}
-
-/**
- * Parse a CSS pixel string and return the numeric portion.
- * CSS ピクセル表現から数値を抽出する処理。
- */
-const parsePixelValue = (value: string | null): number => {
-    if (!value) {
-        return 0
-    }
-    const parsed = parseFloat(value)
-    return Number.isFinite(parsed) ? parsed : 0
-}
-
-/**
- * Measure container size in a given direction, returning inner (borderless) and outer dimensions.
- * 指定方向で枠線控除後と控除前の両方の寸法を測定して返す。
- */
-export const getContainerSize = (element: HTMLElement, direction: PanelDirection): ContainerAxisMeasurement => {
-    const rect = element.getBoundingClientRect()
-    const styles = typeof window !== "undefined" ? window.getComputedStyle(element) : null
-    const horizontalBorder = styles ? parsePixelValue(styles.borderLeftWidth) + parsePixelValue(styles.borderRightWidth) : 0
-    const verticalBorder = styles ? parsePixelValue(styles.borderTopWidth) + parsePixelValue(styles.borderBottomWidth) : 0
-    if (direction === "horizontal") {
-        const rectWidth = rect.width > 0 ? rect.width : element.offsetWidth
-        const innerWidth = rect.width > 0 ? Math.max(0, rect.width - horizontalBorder) : element.clientWidth
-        const outerWidthFallback = element.offsetWidth > 0 ? element.offsetWidth : element.clientWidth + horizontalBorder
-        // 枠線の厚みを控除した実効幅と控除前の幅をそれぞれ算出
-        return {
-            inner: innerWidth > 0 ? innerWidth : Math.max(0, element.clientWidth),
-            outer: rectWidth > 0 ? rectWidth : Math.max(0, outerWidthFallback),
-        }
-    }
-    const rectHeight = rect.height > 0 ? rect.height : element.offsetHeight
-    const innerHeight = rect.height > 0 ? Math.max(0, rect.height - verticalBorder) : element.clientHeight
-    const outerHeightFallback = element.offsetHeight > 0 ? element.offsetHeight : element.clientHeight + verticalBorder
-    // 枠線控除後の高さと控除前の高さを併せて返却
-    return {
-        inner: innerHeight > 0 ? innerHeight : Math.max(0, element.clientHeight),
-        outer: rectHeight > 0 ? rectHeight : Math.max(0, outerHeightFallback),
-    }
-}
-
-/**
- * Persist panel layout sizes to local storage.
- * パネルレイアウトのサイズをローカルストレージへ保存する。
- */
-export const saveLayout = (id: string, sizes: number[]): void => {
-    try {
-        localStorage.setItem(`panel-layout-${id}`, JSON.stringify(sizes))
-    } catch (error) {
-        console.warn("Failed to save panel layout:", error)
-    }
-}
-
-/**
- * Restore panel layout sizes from local storage.
- * パネルレイアウトのサイズをローカルストレージから復元する。
- */
-export const loadLayout = (id: string): number[] | null => {
-    try {
-        const saved = localStorage.getItem(`panel-layout-${id}`)
-        return saved ? JSON.parse(saved) : null
-    } catch (error) {
-        console.warn("Failed to load panel layout:", error)
-        return null
-    }
-}