@aiquants/resize-panels 1.8.1 → 2.0.0

package/dist/src/types.d.ts

@@ -0,0 +1,481 @@
+import { CSSProperties, HTMLAttributes, ReactNode } from 'react';
+/**
+ * Pixel threshold under which a panel is treated as visually closed.
+ * パネルが見た目上閉じていると扱われるピクセル閾値。
+ */
+export declare const PANEL_SNAP_THRESHOLD = 12;
+/**
+ * Numeric tolerance for layout arithmetic, in pixels.
+ * レイアウト演算の許容誤差 (px)。
+ *
+ * Sizes are IEEE-754 doubles produced by divisions, so exact comparisons would freeze drags on a 1 ulp
+ * difference. Everything below this tolerance is treated as equality.
+ * サイズは除算由来の倍精度値であり、厳密比較では 1 ulp の差でドラッグが凍結する。この許容値未満は同値とみなす。
+ */
+export declare const PANEL_ALLOCATION_EPSILON = 0.000001;
+/**
+ * Default thickness in pixels for the resize handle interactive area.
+ * リサイズハンドルのインタラクティブ領域のデフォルト厚み (px)。
+ */
+export declare const PANEL_HANDLE_THICKNESS = 8;
+/**
+ * Default thickness in pixels for the visual indicator wrapper.
+ * 視覚インジケーター外枠のデフォルト厚み (px)。
+ */
+export declare const PANEL_INDICATOR_THICKNESS = 6;
+/**
+ * Default length in pixels for the visual indicator wrapper in horizontal layout.
+ * 水平レイアウトにおける視覚インジケーター外枠のデフォルト長さ (px)。
+ */
+export declare const PANEL_INDICATOR_LENGTH_HORIZONTAL = 48;
+/**
+ * Default length in pixels for the visual indicator wrapper in vertical layout.
+ * 垂直レイアウトにおける視覚インジケーター外枠のデフォルト長さ (px)。
+ */
+export declare const PANEL_INDICATOR_LENGTH_VERTICAL = 80;
+/**
+ * Default thickness in pixels for the inner bar inside the visual indicator.
+ * 視覚インジケーター内部バーのデフォルト厚み (px)。
+ */
+export declare const PANEL_INDICATOR_BAR_THICKNESS = 2;
+/**
+ * Default length in pixels for the inner bar inside the visual indicator in horizontal layout.
+ * 水平レイアウトにおける視覚インジケーター内部バーのデフォルト長さ (px)。
+ */
+export declare const PANEL_INDICATOR_BAR_LENGTH_HORIZONTAL = 32;
+/**
+ * Default length in pixels for the inner bar inside the visual indicator in vertical layout.
+ * 垂直レイアウトにおける視覚インジケーター内部バーのデフォルト長さ (px)。
+ */
+export declare const PANEL_INDICATOR_BAR_LENGTH_VERTICAL = 64;
+/**
+ * Spacing in pixels between visual indicators of handles that share a boundary.
+ * 境界を共有するハンドルの視覚インジケーター同士のピクセル間隔。
+ */
+export declare const PANEL_VISIBLE_INDICATOR_SPACING = 8;
+/**
+ * Pointer move throttling interval in milliseconds during dragging.
+ * ドラッグ中のポインタ移動を間引くミリ秒単位の間隔。
+ */
+export declare const PANEL_HANDLE_DRAG_THROTTLE_MS = 8;
+/**
+ * Pixel step applied per arrow-key press when resizing with the keyboard.
+ * キーボード (矢印キー) リサイズで 1 押下ごとに適用するピクセル量。
+ */
+export declare const PANEL_KEYBOARD_RESIZE_STEP = 10;
+/**
+ * Ratio of container size used when determining collapse thresholds.
+ * 折りたたみ閾値を決定する際に使用するコンテナサイズ比率。
+ */
+export declare const PANEL_COLLAPSE_THRESHOLD_RATIO = 0.05;
+/**
+ * Maximum pixel value considered when collapsing panels.
+ * パネルを折りたたむ際に考慮するピクセル上限値。
+ */
+export declare const PANEL_COLLAPSE_THRESHOLD_MAX = 10;
+/**
+ * Ratio of container size required to expand a collapsed panel.
+ * 折りたたまれたパネルを展開するために必要なコンテナサイズ比率。
+ */
+export declare const PANEL_EXPAND_THRESHOLD_RATIO = 0.05;
+/**
+ * Maximum pixel threshold used when expanding panels.
+ * パネルを展開する際に用いるピクセル閾値の上限。
+ */
+export declare const PANEL_EXPAND_THRESHOLD_MAX = 20;
+/**
+ * Minimum thickness required for a handle to be treated as visible.
+ * ハンドルが可視と判断されるために必要な最小厚み。
+ */
+export declare const PANEL_HANDLE_VISIBILITY_THRESHOLD = 0.05;
+/**
+ * Layout direction of panels
+ * パネルのレイアウト方向
+ */
+export type PanelDirection = "horizontal" | "vertical";
+/**
+ * Size unit types for panels
+ * パネルのサイズ単位タイプ
+ */
+export type SizeUnit = "percentage" | "pixels";
+/**
+ * Size configuration with value and unit
+ * 値と単位を持つサイズ設定
+ */
+export type SizeConfig = {
+    value: number;
+    unit: SizeUnit;
+};
+/**
+ * Flexible size that can be defined in pixels or as a percentage
+ * ピクセルまたはパーセンテージで定義できる柔軟なサイズ
+ */
+export type FlexibleSize = SizeConfig | number;
+/**
+ * Container size dimensions
+ * コンテナサイズの寸法
+ */
+export type ContainerSize = {
+    width: number;
+    height: number;
+};
+/**
+ * Direction from which collapsible panels may close.
+ * パネルを折りたためる方向を表す列挙値。
+ */
+export type PanelCollapseDirection = "start" | "end";
+/**
+ * Directional options accepted by the collapsible configuration.
+ * 折りたたみ設定が受け付ける方向指定値。
+ */
+export type CollapsibleDirection = PanelCollapseDirection | "both";
+/**
+ * Configuration object describing how a panel collapses.
+ * パネルの折りたたみ方を表す設定オブジェクト。
+ */
+export type CollapsibleConfig = {
+    from: CollapsibleDirection;
+};
+/**
+ * Axis-aligned container measurement.
+ * 軸方向のコンテナ計測値。
+ *
+ * `content` is what every layout number is relative to: percentage sizes resolve against it and the
+ * allocator fills exactly this length. `border` is the same box plus padding and borders, used only when a
+ * caller needs the element's outer footprint.
+ * すべてのレイアウト数値の基準は `content`: パーセンテージ指定はこの長さに解決され、配分器はこの長さを満たす。
+ * `border` は同じ軸のパディング・枠線を含む外形で、要素の外寸が必要な場合にのみ使う。
+ */
+export type ContainerAxisMeasurement = {
+    content: number;
+    border: number;
+};
+/**
+ * Reason code for layout constraint violations.
+ * レイアウト制約違反の理由コード。
+ */
+export type LayoutConstraintViolationReason = "minimum-exceeded" | "maximum-insufficient";
+/**
+ * Snapshot describing when panel constraints conflict with the container size.
+ * パネル制約とコンテナサイズが矛盾した際のスナップショット。
+ */
+export type LayoutConstraintViolation = {
+    reason: LayoutConstraintViolationReason;
+    totalMinimumSize: number;
+    totalMaximumSize: number;
+    availableContainerSize: number;
+};
+/**
+ * Canonical layout state of a single panel.
+ * 単一パネルの正準レイアウト状態。
+ *
+ * The state separates three roles and never stores the same quantity twice: configuration comes from the
+ * component's props, the preference is what the user asked for (a share of the container for flexible
+ * panels, an absolute length for pixel panels), and `size` is the allocator's answer for the current
+ * container. Everything else — the rendered flex basis, the handle position, the percentage shown in the
+ * debug overlay — is derived from those.
+ * 状態は 3 つの役割に分かれ、同じ量を二重に持たない: 構成はコンポーネントの props 由来、希望値は利用者の要求
+ * (柔軟パネルはコンテナ比、ピクセルパネルは絶対長)、`size` は現在のコンテナに対する配分器の答え。描画される
+ * flex basis・ハンドル位置・デバッグ表示の割合は、すべてここから導出される。
+ */
+export interface PanelLayoutData {
+    id: string;
+    /** Which preference field drives this panel. どちらの希望値でサイズが決まるか。 */
+    sizeUnit: SizeUnit;
+    /** Allocated length in pixels for the current container. 現在のコンテナに対する配分結果 (px)。 */
+    size: number;
+    /**
+     * Ratio weight of a flexible panel, expressed as a share of the container in percent.
+     * 柔軟パネルの重み (コンテナ比 %)。
+     *
+     * Only the ratio between panels matters — unless the panel declares `flexAdjustPriority`, which turns the
+     * same number into an absolute claim on that share of the container.
+     * 意味を持つのはパネル間の比だけ。ただし `flexAdjustPriority` を宣言したパネルでは、同じ数値が
+     * 「コンテナのその割合」という絶対的な要求になる。
+     */
+    preferredPercentageSize: number;
+    /** Requested absolute length of a pixel panel. ピクセルパネルの希望絶対長 (px)。 */
+    preferredPixelSize: number;
+    minSize?: FlexibleSize;
+    maxSize?: FlexibleSize;
+    collapseFromStart: boolean;
+    collapseFromEnd: boolean;
+    collapsed: boolean;
+    collapsedByDirection: PanelCollapseDirection | null;
+    /**
+     * Preference captured when the panel collapsed, restored verbatim on expand.
+     * 折りたたみ時に退避し、展開時にそのまま復元する希望値。
+     */
+    preferenceBeforeCollapse: number;
+    /**
+     * Preference the component last authored through its props, used to tell a prop change from a re-registration.
+     * コンポーネントが props で最後に宣言した希望値。prop 変更と単なる再登録を区別するために保持。
+     */
+    authoredPreference: number;
+    /** Serving order among pixel panels, higher first. ピクセルパネル間の充当順位 (大きいほど先)。 */
+    pixelAdjustPriority?: number;
+    /**
+     * Serving order among flexible panels, higher first; absent means pure ratio sharing.
+     * 柔軟パネル間の充当順位 (大きいほど先)。未指定なら純粋な比例配分。
+     *
+     * Declaring it changes how `preferredPercentageSize` is read: the panel claims that share of the container
+     * before the ratio panels divide what is left.
+     * 宣言すると `preferredPercentageSize` の読み方が変わり、比例配分のパネルが残りを分ける前に
+     * コンテナのその割合を確保する。
+     */
+    flexAdjustPriority?: number;
+}
+/**
+ * Layout state of one panel group: the container it was measured against, its panels in DOM order, and
+ * whether the panels' constraints can be satisfied at that size.
+ * パネルグループのレイアウト状態: 計測対象のコンテナ長・DOM 順のパネル一覧・制約充足可否。
+ */
+export interface PanelGroupLayoutState {
+    /** Content-box length of the group along its axis; 0 until the first measurement. 軸方向の内容領域長 (未計測は 0)。 */
+    containerSize: number;
+    panels: PanelLayoutData[];
+    violation: LayoutConstraintViolation | null;
+}
+/**
+ * Configuration and preference a panel publishes when it registers with its group.
+ * パネルがグループへ登録する際に公開する構成と希望値。
+ */
+export type PanelRegistration = Omit<PanelLayoutData, "size" | "collapsedByDirection" | "preferenceBeforeCollapse" | "authoredPreference">;
+/**
+ * One panel's persisted length, kept with its identifier so a stored layout can never be applied to a
+ * different set of panels.
+ * 保存されたパネル 1 枚分の長さ。別構成のパネルへ誤って適用されないよう識別子を伴う。
+ */
+export type PersistedPanelSize = {
+    id: string;
+    size: number;
+    /** Whether the panel was collapsed when the layout was written. 保存時に折りたたまれていたか。 */
+    collapsed: boolean;
+};
+/**
+ * Actions accepted by the panel group reducer.
+ * パネルグループのリデューサーが受け付けるアクション。
+ */
+export type PanelAction = {
+    type: "SET_CONTAINER_SIZE";
+    containerSize: number;
+} | {
+    type: "REGISTER_PANEL";
+    panel: PanelRegistration;
+} | {
+    type: "UNREGISTER_PANEL";
+    id: string;
+} | {
+    type: "REORDER_PANELS";
+    ids: string[];
+} | {
+    type: "RESIZE_PANELS";
+    startId: string;
+    endId: string;
+    startSize: number;
+} | {
+    type: "COLLAPSE_PANEL";
+    id: string;
+    from: PanelCollapseDirection;
+} | {
+    type: "EXPAND_PANEL";
+    id: string;
+    from: PanelCollapseDirection;
+    targetSize?: number;
+} | {
+    type: "RESTORE_LAYOUT";
+    entries: PersistedPanelSize[];
+};
+/**
+ * Props for the Panel component
+ * Panel コンポーネントのプロパティ
+ */
+export interface PanelProps extends Omit<HTMLAttributes<HTMLDivElement>, "id" | "children" | "className" | "style" | "aria-hidden"> {
+    id?: string;
+    /**
+     * Initial size. A percentage (or bare number) makes the panel flexible, pixels make it fixed.
+     * 初期サイズ。パーセンテージ (数値のみの指定を含む) なら柔軟パネル、ピクセルなら固定パネル。
+     * @default { value: 50, unit: "percentage" }
+     */
+    defaultSize?: FlexibleSize;
+    minSize?: FlexibleSize;
+    maxSize?: FlexibleSize;
+    className?: string;
+    style?: CSSProperties;
+    children?: ReactNode;
+    collapsible?: CollapsibleConfig;
+    defaultCollapsed?: boolean;
+    pixelAdjustPriority?: number;
+    flexAdjustPriority?: number;
+    contentOverflow?: CSSProperties["overflow"];
+}
+/**
+ * Props for the PanelGroup component
+ * PanelGroup コンポーネントのプロパティ
+ */
+export interface PanelGroupProps extends Omit<HTMLAttributes<HTMLDivElement>, "id" | "children" | "className" | "style"> {
+    id?: string;
+    direction: PanelDirection;
+    className?: string;
+    style?: CSSProperties;
+    children?: ReactNode;
+    showDebugInfo?: boolean;
+    onLayout?: (panelSizes: number[]) => void;
+    autoSaveId?: string;
+}
+/**
+ * Value provided by the PanelGroupContext
+ * PanelGroupContext によって提供される値
+ */
+export interface PanelGroupContextValue {
+    direction: PanelDirection;
+    registerPanel: (panel: PanelRegistration) => void;
+    unregisterPanel: (id: string) => void;
+    getPanel: (id: string) => PanelLayoutData | undefined;
+    panels: PanelLayoutData[];
+    /** Content-box length of the group along its axis. グループ軸方向の内容領域長。 */
+    containerSize: number;
+    /**
+     * Key that changes whenever the document order of the group's panels and handle anchors changes.
+     * グループのパネルとハンドルのアンカーの文書順が変わるたびに変化する鍵。
+     *
+     * A handle that moves to another boundary leaves the panel id sequence untouched, so the panels alone
+     * cannot tell a handle that its neighbours changed.
+     * ハンドルが別の境界へ移ってもパネルの id 列は変わらないため、パネルだけではハンドルへ隣の変化を伝えられない。
+     */
+    layoutOrderKey: string;
+    showDebugInfo: boolean;
+    resizePanels: (startId: string, endId: string, startSize: number) => void;
+    collapsePanel: (id: string, from: PanelCollapseDirection) => void;
+    expandPanel: (id: string, from: PanelCollapseDirection, targetSize?: number) => void;
+    reportPanelMeasurement: (id: string, measurement: PanelMeasurement | null) => void;
+    panelMeasurements: Record<string, PanelMeasurement>;
+    reportHandleMeasurement: (id: string, measurement: ResizeHandleLayoutData | null) => void;
+    handleMeasurements: Record<string, ResizeHandleLayoutData>;
+    layoutConstraintViolation: LayoutConstraintViolation | null;
+}
+/**
+ * Visual indicator configuration options for PanelResizeHandle.
+ * PanelResizeHandle の視覚インジケーターに関する設定オプション。
+ */
+export interface PanelResizeHandleIndicatorConfig {
+    /**
+     * Primary axis thickness of the indicator pill in pixels.
+     * (Horizontal: width, Vertical: height)
+     * インジケーター外枠の主軸方向の厚み (px)。(水平: 幅, 垂直: 高さ)
+     * @default 6
+     */
+    thickness?: number;
+    /**
+     * Cross axis length of the indicator pill in pixels.
+     * (Horizontal: height, Vertical: width)
+     * インジケーター外枠の交差軸方向の長さ (px)。(水平: 高さ, 垂直: 幅)
+     * @default horizontal ? 48 : 80
+     */
+    length?: number;
+    /**
+     * Primary axis thickness of the inner bar in pixels.
+     * インジケーター内部バーの主軸方向の厚み (px)。
+     * @default 2
+     */
+    barThickness?: number;
+    /**
+     * Cross axis length of the inner bar in pixels.
+     * インジケーター内部バーの交差軸方向の長さ (px)。
+     * @default horizontal ? 32 : 64
+     */
+    barLength?: number;
+    /**
+     * Whether the indicator is visible.
+     * インジケーターを表示するかどうかの指定。
+     * @default true
+     */
+    visible?: boolean;
+    /**
+     * Additional CSS class name for the indicator wrapper.
+     * インジケーター外枠に付与する追加 CSS クラス名。
+     */
+    className?: string;
+    /**
+     * Additional CSS class name for the inner bar.
+     * インジケーター内部バーに付与する追加 CSS クラス名。
+     */
+    barClassName?: string;
+}
+/**
+ * Props for the PanelResizeHandle component
+ * PanelResizeHandle コンポーネントのプロパティ
+ */
+/**
+ * ARIA attributes the handle computes from the layout; a consumer value would be silently discarded.
+ * ハンドルがレイアウトから算出する ARIA 属性 (利用者の指定は黙って捨てられるため受け付けない)。
+ */
+type OwnedSeparatorAria = "role" | "aria-orientation" | "aria-valuenow" | "aria-valuemin" | "aria-valuemax" | "aria-disabled" | "aria-hidden";
+export interface PanelResizeHandleProps extends Omit<HTMLAttributes<HTMLButtonElement>, "id" | "children" | "className" | "style" | "title" | OwnedSeparatorAria> {
+    id?: string;
+    disabled?: boolean;
+    onDragging?: (isDragging: boolean) => void;
+    className?: string;
+    style?: CSSProperties;
+    children?: ReactNode;
+    /**
+     * Primary axis thickness of the handle's interactive area in pixels.
+     * (Horizontal: width, Vertical: height)
+     * リサイズハンドルの操作領域 (ヒットエリア) の厚み (px)。(水平: 幅, 垂直: 高さ)
+     * @default PANEL_HANDLE_THICKNESS (8)
+     */
+    thickness?: number;
+    /**
+     * Configuration for the visual indicator, or boolean to toggle visibility.
+     * 視覚インジケーターの設定オブジェクト、または表示/非表示の真偽値。
+     * @default true
+     */
+    indicator?: boolean | PanelResizeHandleIndicatorConfig;
+    /**
+     * Shorthand for indicator wrapper thickness in pixels.
+     * インジケーター外枠厚み (px) のショートハンド。
+     */
+    indicatorThickness?: number;
+    /**
+     * Shorthand for indicator wrapper length in pixels.
+     * インジケーター外枠長さ (px) のショートハンド。
+     */
+    indicatorLength?: number;
+    /**
+     * Shorthand for indicator inner bar thickness in pixels.
+     * インジケーター内部バー厚み (px) のショートハンド。
+     */
+    indicatorBarThickness?: number;
+    /**
+     * Shorthand for indicator inner bar length in pixels.
+     * インジケーター内部バー長さ (px) のショートハンド。
+     */
+    indicatorBarLength?: number;
+    /**
+     * Custom tooltip text for the handle element.
+     * ハンドル要素のカスタムツールチップテキスト。
+     */
+    title?: string;
+}
+/**
+ * Observed pixel and percentage measurements for a registered panel.
+ * 登録済みパネルの実測ピクセル寸法およびパーセンテージ寸法。
+ */
+export interface PanelMeasurement {
+    pixelSize: number;
+    percentageSize: number;
+}
+/**
+ * Layout data for a resize handle (divider) within a panel group.
+ * パネルグループ内のリサイズハンドル(ディバイダー)に関するレイアウトデータ。
+ */
+export interface ResizeHandleLayoutData {
+    id: string;
+    thickness: number;
+    direction: PanelDirection;
+    visible: boolean;
+    startPanelId: string | null;
+    endPanelId: string | null;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/dist/src/utils/simple-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-logger.d.ts","sourceRoot":"","sources":["../../../src/utils/simple-logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,oBAAY,QAAQ;IAChB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;IACT,IAAI,IAAI;CACX;AAED;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACpB,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC5D,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC3D,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC3D,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;CAC/D;AAED;;;;GAIG;AACH,qBAAa,MAAO,YAAW,OAAO;IAClC,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,IAAI,CAAS;IAErB;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAErD;;;;;OAKG;gBACS,KAAK,GAAE,QAAwB,EAAE,MAAM,GAAE,MAA0B,EAAE,IAAI,GAAE,OAAiB;IAOxG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAuD;IAE9E;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAMtC;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B;;;;;OAKG;IACH,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAM7C;;;;;OAKG;IACH,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAItC;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAMtC;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B;;;;;;OAMG;IACH,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO;IAIpC,OAAO,CAAC,aAAa;IAOrB,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,GAAG,IAAI;IAInE,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,GAAG,IAAI;IAM5D,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,GAAG,IAAI;IAIlE,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,GAAG,IAAI;IAM3D,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,GAAG,IAAI;IAIlE,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,GAAG,IAAI;IAM3D,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,GAAG,IAAI;IAInE,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,GAAG,IAAI;CAK/D"}

package/dist/src/utils.d.ts

@@ -0,0 +1,164 @@
+import { ContainerAxisMeasurement, FlexibleSize, PanelDirection, PersistedPanelSize, SizeConfig, SizeUnit } from './types';
+/**
+ * Number of significant fractional digits to preserve when rounding percentage-based sizes.
+ * パーセンテージサイズの丸めで保持する有効小数桁数。
+ */
+export declare const PERCENTAGE_DIGITS = 6;
+/**
+ * Convert a pixel measurement to a percentage of the container using banker's rounding.
+ * ピクセル寸法をバンカーズラウンディングでコンテナ比率のパーセンテージへ変換する。
+ *
+ * @param size - Length in pixels / 長さ (px)
+ * @param base - Container length the percentage is relative to / 基準となるコンテナ長
+ * @returns Percentage of the container, 0 when the base is not positive / コンテナ比 (%)、基準が非正なら 0
+ */
+export declare const toRoundedPercentage: (size: number, base: number) => number;
+/**
+ * Translate a percentage-based size back into pixels relative to the container.
+ * パーセンテージ指定のサイズをコンテナ基準のピクセル値へ変換する。
+ *
+ * @param percentage - Share of the container in percent / コンテナ比 (%)
+ * @param base - Container length the percentage is relative to / 基準となるコンテナ長
+ * @returns Length in pixels / 長さ (px)
+ */
+export declare const percentageToPixels: (percentage: number, base: number) => number;
+/**
+ * Normalize a flexible size into a size configuration object.
+ * 柔軟なサイズ指定をサイズ設定オブジェクトへ正規化する。
+ *
+ * @param size - Author-provided size / 利用者が指定したサイズ
+ * @param defaultUnit - Unit applied to bare numbers / 数値のみの指定に適用する単位
+ * @returns Normalized configuration, or undefined when nothing was provided / 正規化後の設定、未指定なら undefined
+ */
+export declare const normalizeSizeConfig: (size: FlexibleSize | undefined, defaultUnit?: SizeUnit) => SizeConfig | undefined;
+/**
+ * Convert flexible size constraints into pixel values based on container size.
+ * 柔軟サイズ制約をコンテナサイズ基準のピクセル値へ変換する。
+ *
+ * @param size - Constraint to resolve; bare numbers are percentages / 解決する制約 (数値のみの指定はパーセンテージ)
+ * @param defaultValue - Value used when the constraint is absent / 制約が無い場合の値
+ * @param containerSize - Container content-box length / コンテナ内容領域長
+ * @returns Constraint in pixels / ピクセル換算した制約
+ */
+export declare const getConstraintInPixels: (size: FlexibleSize | undefined, defaultValue: number, containerSize: number) => number;
+/**
+ * Clamp a numeric value between the provided bounds.
+ * 数値を指定した範囲に収めるためのクリッピング処理。
+ *
+ * @param value - Value to clamp / 収める値
+ * @param min - Lower bound / 下限
+ * @param max - Upper bound / 上限
+ * @returns Clamped value / 範囲内へ収めた値
+ */
+export declare const clamp: (value: number, min: number, max: number) => number;
+/**
+ * Derive a snap-to-zero threshold from the container axis length using shared heuristics.
+ * 共通ヒューリスティクスに基づきコンテナ軸長からゼロスナップ閾値を算出する。
+ *
+ * @param axisSize - Container content-box length along the axis / 軸方向のコンテナ内容領域長
+ * @returns Threshold in pixels below which a panel snaps closed / 閉じたとみなすピクセル閾値
+ */
+export declare const calculateSnapThreshold: (axisSize: number) => number;
+/**
+ * Measure a container along one axis, returning its content-box and border-box lengths.
+ * 指定軸でコンテナを計測し、内容領域長と境界領域長を返す処理。
+ *
+ * The content box is the authority for every layout number in this package: a panel's `flex-basis` resolves
+ * against it, so the allocator must fill exactly this length for the rendered geometry and the reducer state
+ * to agree. The measurement is therefore taken in LAYOUT pixels — `getBoundingClientRect` reports the visual
+ * rect, so a scaled ancestor would otherwise make the group allocate a container it does not have.
+ * このパッケージのレイアウト数値の基準は内容領域である。パネルの `flex-basis` はこの領域に解決されるため、
+ * 描画結果とリデューサー状態を一致させるには配分器がこの長さを満たす必要がある。計測は**レイアウトピクセル**で
+ * 行う: `getBoundingClientRect` は視覚上の矩形を返すため、拡大縮小された祖先の下では存在しない長さを配ってしまう。
+ *
+ * @param element - Element to measure / 計測対象の要素
+ * @param direction - Axis to measure along / 計測する軸
+ * @param entry - Observation that triggered the measurement, when it came from a ResizeObserver / 計測契機となった観測結果
+ * @returns Content-box and border-box lengths in pixels / 内容領域長と境界領域長 (px)
+ */
+export declare const getContainerSize: (element: HTMLElement, direction: PanelDirection, entry?: ResizeObserverEntry) => ContainerAxisMeasurement;
+/**
+ * Selector that matches the elements a group lays out: its panels and its handle anchors.
+ * グループが配置する要素 (パネルとハンドルのアンカー) に一致するセレクタ。
+ */
+export declare const LAYOUT_ELEMENT_SELECTOR = "[data-panel-id], [data-resize-handle-anchor]";
+/**
+ * Resolve the innermost panel group that owns an element.
+ * ある要素を所有する最も内側のパネルグループを解決する処理。
+ *
+ * The owner is never simply the parent: a wrapper element (including `display: contents`, which flex layout
+ * flattens away) sits between the group and its panels without changing the geometry, and nested groups make
+ * "the closest group" the only answer that is right in both directions.
+ * 所有者は単なる親要素ではない。中間要素 (フレックスレイアウトが畳む `display: contents` を含む) は幾何を
+ * 変えずにグループとパネルの間へ入り込み、入れ子グループもあるため「最も近いグループ」だけが正解となる。
+ *
+ * @param element - Element to resolve the owner for / 所有者を解決する対象の要素
+ * @returns Owning group element, or null when the element is outside every group / 所有するグループ要素、どのグループにも属さないなら null
+ */
+export declare const findOwningGroup: (element: HTMLElement | null | undefined) => HTMLElement | null;
+/**
+ * Collect the panels and handle anchors a group owns, in document order.
+ * グループが所有するパネルとハンドルのアンカーを、文書順で収集する処理。
+ *
+ * Direct children are not enough: a wrapper (including `display: contents`, which flex layout flattens away)
+ * leaves the geometry intact while hiding the panels from a sibling scan, and the handle would silently lose
+ * its neighbours.
+ * 直下の子だけでは足りない。中間要素 (フレックスレイアウトが畳む `display: contents` を含む) があると幾何は
+ * 保たれたままパネルが兄弟走査から消え、ハンドルが隣接パネルを見失う。
+ *
+ * @param group - Group element / グループ要素
+ * @returns Owned panel and anchor elements in document order / 所有するパネル・アンカー要素 (文書順)
+ */
+export declare const getGroupLayoutElements: (group: HTMLElement) => HTMLElement[];
+/**
+ * Report whether a DOM mutation touched an element the group lays out.
+ * DOM の変更がグループの配置要素に触れたかどうかを判定する処理。
+ *
+ * Content inside a panel changes constantly (a virtualised list recycles rows every frame), so a group-wide
+ * rescan on every mutation costs time proportional to the whole subtree for changes that can never move a
+ * panel. Only additions and removals that carry a layout element can.
+ * パネルの内容は絶え間なく変わる (仮想化リストは毎フレーム行を入れ替える) ため、変更のたびにグループ全体を
+ * 走査すると、パネルを動かしようのない変更に対して部分木全体に比例した時間を払う。配置要素を含む
+ * 追加・削除だけがパネルを動かしうる。
+ *
+ * @param records - Mutation records delivered by the observer / オブザーバーが届けた変更記録
+ * @returns True when at least one record added or removed a layout element / 配置要素の追加・削除が 1 件でもあれば true
+ */
+export declare const touchesLayoutElements: (records: ReadonlyArray<MutationRecord>) => boolean;
+/**
+ * Ratio between visual pixels (pointer coordinates) and layout pixels (the lengths the allocator hands out).
+ * 視覚ピクセル (ポインタ座標) とレイアウトピクセル (配分器が配る長さ) の比。
+ *
+ * A transformed ancestor scales pointer coordinates but not the lengths the layout is computed in, so a drag
+ * delta read straight from the pointer moves the boundary by `travel × scale` instead of `travel` — the grab
+ * point slides out from under the cursor, and the error grows without bound as the gesture continues.
+ * 変形された祖先の下ではポインタ座標だけが拡大縮小され、レイアウトが計算される長さは変わらない。
+ * ポインタの変位をそのまま使うと境界は `移動量 × 倍率` しか動かず、掴んだ点がカーソルから滑り出し、
+ * その誤差はジェスチャーが続く限り増え続ける。
+ *
+ * @param element - Element whose box is compared in both spaces / 双方の空間で矩形を比べる要素
+ * @param direction - Axis to measure along / 計測する軸
+ * @returns Visual length divided by layout length, 1 when either is unavailable / 視覚長 ÷ レイアウト長 (いずれか不明なら 1)
+ */
+export declare const getVisualScale: (element: HTMLElement, direction: PanelDirection) => number;
+/**
+ * Persist a panel layout to local storage.
+ * パネルレイアウトをローカルストレージへ保存する。
+ *
+ * @param id - Auto-save identifier / 自動保存の識別子
+ * @param entries - Panel lengths with their identifiers, in DOM order / DOM 順の識別子つきパネル長
+ */
+export declare const saveLayout: (id: string, entries: PersistedPanelSize[]) => void;
+/**
+ * Restore a panel layout from local storage.
+ * パネルレイアウトをローカルストレージから復元する。
+ *
+ * A stored layout is only usable when every entry names the panel it belongs to, so a payload written by a
+ * different panel set is rejected instead of being applied by position.
+ * 保存レイアウトは各項目が所属パネルを名指ししている場合にだけ利用できる。別構成が書いた内容は位置で当てはめず拒否する。
+ *
+ * @param id - Auto-save identifier / 自動保存の識別子
+ * @returns Stored layout, or null when nothing usable is stored / 保存済みレイアウト、利用できなければ null
+ */
+export declare const loadLayout: (id: string) => PersistedPanelSize[] | null;
+//# sourceMappingURL=utils.d.ts.map

package/dist/src/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,KAAK,wBAAwB,EAAE,KAAK,YAAY,EAAsF,KAAK,cAAc,EAAE,KAAK,kBAAkB,EAAE,KAAK,UAAU,EAAE,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAA;AAE5O;;;GAGG;AACH,eAAO,MAAM,iBAAiB,IAAI,CAAA;AAElC;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,EAAE,MAAM,MAAM,KAAG,MAKhE,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAAI,YAAY,MAAM,EAAE,MAAM,MAAM,KAAG,MAKrE,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAAI,MAAM,YAAY,GAAG,SAAS,EAAE,cAAa,QAAuB,KAAG,UAAU,GAAG,SAQvH,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,GAAI,MAAM,YAAY,GAAG,SAAS,EAAE,cAAc,MAAM,EAAE,eAAe,MAAM,KAAG,MAWnH,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,KAAK,GAAI,OAAO,MAAM,EAAE,KAAK,MAAM,EAAE,KAAK,MAAM,KAAG,MAE/D,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GAAI,UAAU,MAAM,KAAG,MAKzD,CAAA;AAcD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,gBAAgB,GAAI,SAAS,WAAW,EAAE,WAAW,cAAc,EAAE,QAAQ,mBAAmB,KAAG,wBAgB/G,CAAA;AAQD;;;GAGG;AACH,eAAO,MAAM,uBAAuB,iDAAiD,CAAA;AAQrF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,WAAW,GAAG,IAAI,GAAG,SAAS,KAAG,WAAW,GAAG,IAA6D,CAAA;AAErJ;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,WAAW,KAAG,WAAW,EASjE,CAAA;AAEN;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,qBAAqB,GAAI,SAAS,aAAa,CAAC,cAAc,CAAC,KAAG,OAa9E,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,WAAW,EAAE,WAAW,cAAc,KAAG,MAgBhF,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GAAI,IAAI,MAAM,EAAE,SAAS,kBAAkB,EAAE,KAAG,IAMtE,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,GAAI,IAAI,MAAM,KAAG,kBAAkB,EAAE,GAAG,IAgB9D,CAAA"}