@puredesktop/puredesktop-ui-bridge 1.0.0-beta.1 → 1.0.0-beta.2

package/src/components/common/layout/index.ts

@@ -1,31 +1,31 @@
-export {
-  PLATFORM_PANEL_LAYOUT_PREFERENCE_KEY,
-  PLATFORM_PANEL_LAYOUT_STATE_VERSION,
-  PLATFORM_PANEL_LAYOUT_STORAGE_PREFIX,
-} from './panelLayoutConstants.js'
-export type {
-  PanelConfig,
-  PanelGroupDirection,
-  PanelLayoutPersistence,
-  PanelLayoutPreferenceState,
-  PanelLayoutSizes,
-} from './panelLayoutTypes.js'
-export {
-  normalizePanelSizes,
-  evenPanelSizes,
-  resizeAdjacentPanels,
-  serializePanelLayoutPreference,
-  patchPanelLayoutPreference,
-  readPanelLayoutFromAppSettings,
-  parsePanelLayoutPreference,
-} from './panelLayoutState.js'
-export { createLocalStoragePanelPersistence } from './panelLayoutPersistence.js'
-export {
-  Panel,
-  PanelGroup,
-  PanelResizeHandle,
-  usePanelGroupDirection,
-  type PanelGroupProps,
-  type PanelProps,
-  type PanelResizeHandleProps,
-} from './PanelGroup.js'
+export {
+  PLATFORM_PANEL_LAYOUT_PREFERENCE_KEY,
+  PLATFORM_PANEL_LAYOUT_STATE_VERSION,
+  PLATFORM_PANEL_LAYOUT_STORAGE_PREFIX,
+} from './panelLayoutConstants.js'
+export type {
+  PanelConfig,
+  PanelGroupDirection,
+  PanelLayoutPersistence,
+  PanelLayoutPreferenceState,
+  PanelLayoutSizes,
+} from './panelLayoutTypes.js'
+export {
+  normalizePanelSizes,
+  evenPanelSizes,
+  resizeAdjacentPanels,
+  serializePanelLayoutPreference,
+  patchPanelLayoutPreference,
+  readPanelLayoutFromAppSettings,
+  parsePanelLayoutPreference,
+} from './panelLayoutState.js'
+export { createLocalStoragePanelPersistence } from './panelLayoutPersistence.js'
+export {
+  Panel,
+  PanelGroup,
+  PanelResizeHandle,
+  usePanelGroupDirection,
+  type PanelGroupProps,
+  type PanelProps,
+  type PanelResizeHandleProps,
+} from './PanelGroup.js'

package/src/components/common/layout/panelLayoutConstants.ts

@@ -1,7 +1,7 @@
-/** Field name inside `settings.app.*` patch objects for panel size arrays. */
-export const PLATFORM_PANEL_LAYOUT_PREFERENCE_KEY = 'panelLayout'
-
-/** Prefix for optional localStorage fallback keys (append app-specific suffix). */
-export const PLATFORM_PANEL_LAYOUT_STORAGE_PREFIX = 'platform.panelLayout.'
-
-export const PLATFORM_PANEL_LAYOUT_STATE_VERSION = 1
+/** Field name inside `settings.app.*` patch objects for panel size arrays. */
+export const PLATFORM_PANEL_LAYOUT_PREFERENCE_KEY = 'panelLayout'
+
+/** Prefix for optional localStorage fallback keys (append app-specific suffix). */
+export const PLATFORM_PANEL_LAYOUT_STORAGE_PREFIX = 'platform.panelLayout.'
+
+export const PLATFORM_PANEL_LAYOUT_STATE_VERSION = 1

package/src/components/common/layout/panelLayoutPersistence.ts

@@ -1,35 +1,35 @@
-import { PLATFORM_PANEL_LAYOUT_STORAGE_PREFIX } from './panelLayoutConstants.js'
-import {
-  parsePanelLayoutPreference,
-  serializePanelLayoutPreference,
-} from './panelLayoutState.js'
-import type {
-  PanelLayoutPersistence,
-  PanelLayoutSizes,
-} from './panelLayoutTypes.js'
-
-export function createLocalStoragePanelPersistence(
-  storageKey: string,
-): PanelLayoutPersistence {
-  const key = `${PLATFORM_PANEL_LAYOUT_STORAGE_PREFIX}${storageKey}`
-
-  return {
-    load(): PanelLayoutSizes | null {
-      if (typeof window === 'undefined') return null
-      try {
-        const raw = window.localStorage.getItem(key)
-        if (!raw) return null
-        return parsePanelLayoutPreference(JSON.parse(raw))
-      } catch {
-        return null
-      }
-    },
-    save(sizes: PanelLayoutSizes): void {
-      if (typeof window === 'undefined') return
-      window.localStorage.setItem(
-        key,
-        JSON.stringify(serializePanelLayoutPreference(sizes)),
-      )
-    },
-  }
-}
+import { PLATFORM_PANEL_LAYOUT_STORAGE_PREFIX } from './panelLayoutConstants.js'
+import {
+  parsePanelLayoutPreference,
+  serializePanelLayoutPreference,
+} from './panelLayoutState.js'
+import type {
+  PanelLayoutPersistence,
+  PanelLayoutSizes,
+} from './panelLayoutTypes.js'
+
+export function createLocalStoragePanelPersistence(
+  storageKey: string,
+): PanelLayoutPersistence {
+  const key = `${PLATFORM_PANEL_LAYOUT_STORAGE_PREFIX}${storageKey}`
+
+  return {
+    load(): PanelLayoutSizes | null {
+      if (typeof window === 'undefined') return null
+      try {
+        const raw = window.localStorage.getItem(key)
+        if (!raw) return null
+        return parsePanelLayoutPreference(JSON.parse(raw))
+      } catch {
+        return null
+      }
+    },
+    save(sizes: PanelLayoutSizes): void {
+      if (typeof window === 'undefined') return
+      window.localStorage.setItem(
+        key,
+        JSON.stringify(serializePanelLayoutPreference(sizes)),
+      )
+    },
+  }
+}

package/src/components/common/layout/panelLayoutState.test.ts

@@ -1,38 +1,38 @@
-import { describe, expect, it } from 'vitest'
-import {
-  isPanelResizeHandleHidden,
-  panelFlexBasis,
-  visiblePanelLayoutSizes,
-} from './panelLayoutState.js'
-
-describe('panelLayoutState', () => {
-  it('renormalizes sizes across visible panels only', () => {
-    const allVisible = visiblePanelLayoutSizes(
-      [22, 58, 20],
-      [false, false, false],
-    )
-    expect(allVisible[0]).toBeCloseTo(22, 5)
-    expect(allVisible[1]).toBeCloseTo(58, 5)
-    expect(allVisible[2]).toBeCloseTo(20, 5)
-
-    const drawerClosed = visiblePanelLayoutSizes(
-      [22, 58, 20],
-      [false, false, true],
-    )
-    expect(drawerClosed[0]).toBeCloseTo(27.5, 5)
-    expect(drawerClosed[1]).toBeCloseTo(72.5, 5)
-    expect(drawerClosed[2]).toBe(0)
-
-    expect(visiblePanelLayoutSizes([72, 28], [false, true])).toEqual([100, 0])
-  })
-
-  it('hides resize handle when either neighbor is collapsed', () => {
-    expect(isPanelResizeHandleHidden(0, [false, true])).toBe(true)
-    expect(isPanelResizeHandleHidden(0, [false, false, true])).toBe(false)
-    expect(isPanelResizeHandleHidden(1, [false, false, true])).toBe(true)
-  })
-
-  it('builds flex basis from visible percent and divider count', () => {
-    expect(panelFlexBasis(28, 1)).toBe('calc((100% - 2px) * 0.28)')
-  })
-})
+import { describe, expect, it } from 'vitest'
+import {
+  isPanelResizeHandleHidden,
+  panelFlexBasis,
+  visiblePanelLayoutSizes,
+} from './panelLayoutState.js'
+
+describe('panelLayoutState', () => {
+  it('renormalizes sizes across visible panels only', () => {
+    const allVisible = visiblePanelLayoutSizes(
+      [22, 58, 20],
+      [false, false, false],
+    )
+    expect(allVisible[0]).toBeCloseTo(22, 5)
+    expect(allVisible[1]).toBeCloseTo(58, 5)
+    expect(allVisible[2]).toBeCloseTo(20, 5)
+
+    const drawerClosed = visiblePanelLayoutSizes(
+      [22, 58, 20],
+      [false, false, true],
+    )
+    expect(drawerClosed[0]).toBeCloseTo(27.5, 5)
+    expect(drawerClosed[1]).toBeCloseTo(72.5, 5)
+    expect(drawerClosed[2]).toBe(0)
+
+    expect(visiblePanelLayoutSizes([72, 28], [false, true])).toEqual([100, 0])
+  })
+
+  it('hides resize handle when either neighbor is collapsed', () => {
+    expect(isPanelResizeHandleHidden(0, [false, true])).toBe(true)
+    expect(isPanelResizeHandleHidden(0, [false, false, true])).toBe(false)
+    expect(isPanelResizeHandleHidden(1, [false, false, true])).toBe(true)
+  })
+
+  it('builds flex basis from visible percent and divider count', () => {
+    expect(panelFlexBasis(28, 1)).toBe('calc((100% - 2px) * 0.28)')
+  })
+})

package/src/components/common/layout/panelLayoutState.ts

@@ -1,174 +1,174 @@
-import {
-  PLATFORM_PANEL_LAYOUT_PREFERENCE_KEY,
-  PLATFORM_PANEL_LAYOUT_STATE_VERSION,
-} from './panelLayoutConstants.js'
-import type {
-  PanelConfig,
-  PanelLayoutPreferenceState,
-  PanelLayoutSizes,
-} from './panelLayoutTypes.js'
-
-export function normalizePanelSizes(
-  sizes: PanelLayoutSizes,
-  configs: PanelConfig[],
-): PanelLayoutSizes {
-  if (sizes.length !== configs.length || sizes.length === 0) {
-    return sizes
-  }
-
-  const clamped = sizes.map((size, index) => {
-    const minSize = configs[index]?.minSize ?? 5
-    const maxSize = configs[index]?.maxSize ?? 95
-    return clamp(size, minSize, maxSize)
-  })
-
-  const total = clamped.reduce((sum, value) => sum + value, 0)
-  if (total <= 0) {
-    return evenPanelSizes(configs.length)
-  }
-
-  return clamped.map(value => (value / total) * 100)
-}
-
-export function evenPanelSizes(count: number): PanelLayoutSizes {
-  if (count <= 0) return []
-  const base = 100 / count
-  return Array.from({ length: count }, () => base)
-}
-
-export function resizeAdjacentPanels(
-  sizes: PanelLayoutSizes,
-  configs: PanelConfig[],
-  index: number,
-  deltaPercent: number,
-): PanelLayoutSizes {
-  if (index < 0 || index >= sizes.length - 1) return sizes
-
-  const next = [...sizes]
-  const leftMin = configs[index]?.minSize ?? 5
-  const leftMax = configs[index]?.maxSize ?? 95
-  const rightMin = configs[index + 1]?.minSize ?? 5
-  const rightMax = configs[index + 1]?.maxSize ?? 95
-
-  let left = next[index] + deltaPercent
-  let right = next[index + 1] - deltaPercent
-
-  if (left < leftMin) {
-    right -= leftMin - left
-    left = leftMin
-  } else if (left > leftMax) {
-    right -= leftMax - left
-    left = leftMax
-  }
-
-  if (right < rightMin) {
-    left -= rightMin - right
-    right = rightMin
-  } else if (right > rightMax) {
-    left -= rightMax - right
-    right = rightMax
-  }
-
-  next[index] = left
-  next[index + 1] = right
-  return normalizePanelSizes(next, configs)
-}
-
-export function serializePanelLayoutPreference(
-  sizes: PanelLayoutSizes,
-): PanelLayoutPreferenceState {
-  return {
-    version: PLATFORM_PANEL_LAYOUT_STATE_VERSION,
-    sizes,
-  }
-}
-
-export function patchPanelLayoutPreference(
-  sizes: PanelLayoutSizes,
-): Record<string, PanelLayoutPreferenceState> {
-  return {
-    [PLATFORM_PANEL_LAYOUT_PREFERENCE_KEY]:
-      serializePanelLayoutPreference(sizes),
-  }
-}
-
-export function readPanelLayoutFromAppSettings(
-  appSettings: Record<string, unknown>,
-  defaultSizes: PanelLayoutSizes,
-  configs: PanelConfig[],
-): PanelLayoutSizes {
-  const parsed = parsePanelLayoutPreference(
-    appSettings[PLATFORM_PANEL_LAYOUT_PREFERENCE_KEY],
-  )
-  if (!parsed || parsed.length !== defaultSizes.length) {
-    return normalizePanelSizes(defaultSizes, configs)
-  }
-  return normalizePanelSizes(parsed, configs)
-}
-
-export function parsePanelLayoutPreference(
-  value: unknown,
-): PanelLayoutSizes | null {
-  if (!value || typeof value !== 'object') return null
-  const record = value as Record<string, unknown>
-  if (record.version !== PLATFORM_PANEL_LAYOUT_STATE_VERSION) return null
-  if (!Array.isArray(record.sizes)) return null
-  const sizes = record.sizes.filter(
-    (entry): entry is number =>
-      typeof entry === 'number' && Number.isFinite(entry),
-  )
-  return sizes.length > 0 ? sizes : null
-}
-
-function clamp(value: number, min: number, max: number): number {
-  return Math.min(max, Math.max(min, value))
-}
-
-/** Hide the handle between `handleIndex` and `handleIndex + 1` when either side is collapsed. */
-export function isPanelResizeHandleHidden(
-  handleIndex: number,
-  collapsed: readonly boolean[],
-): boolean {
-  return Boolean(collapsed[handleIndex] || collapsed[handleIndex + 1])
-}
-
-export function visiblePanelResizeHandleCount(
-  collapsed: readonly boolean[],
-  handleCount: number,
-): number {
-  let count = 0
-  for (let index = 0; index < handleCount; index += 1) {
-    if (!isPanelResizeHandleHidden(index, collapsed)) count += 1
-  }
-  return count
-}
-
-/** Renormalize stored sizes across non-collapsed panels (sum → 100). */
-export function visiblePanelLayoutSizes(
-  sizes: PanelLayoutSizes,
-  collapsed: readonly boolean[],
-): PanelLayoutSizes {
-  if (sizes.length === 0) return sizes
-
-  let visibleTotal = 0
-  for (let index = 0; index < sizes.length; index += 1) {
-    if (collapsed[index]) continue
-    visibleTotal += sizes[index] ?? 0
-  }
-
-  if (visibleTotal <= 0) {
-    return sizes.map(() => 0)
-  }
-
-  return sizes.map((size, index) =>
-    collapsed[index] ? 0 : ((size ?? 0) / visibleTotal) * 100,
-  )
-}
-
-export function panelFlexBasis(
-  sizePercent: number,
-  visibleDividerCount: number,
-): string {
-  const ratio = sizePercent / 100
-  return `calc((100% - ${visibleDividerCount * 2}px) * ${ratio})`
-}
+import {
+  PLATFORM_PANEL_LAYOUT_PREFERENCE_KEY,
+  PLATFORM_PANEL_LAYOUT_STATE_VERSION,
+} from './panelLayoutConstants.js'
+import type {
+  PanelConfig,
+  PanelLayoutPreferenceState,
+  PanelLayoutSizes,
+} from './panelLayoutTypes.js'
+
+export function normalizePanelSizes(
+  sizes: PanelLayoutSizes,
+  configs: PanelConfig[],
+): PanelLayoutSizes {
+  if (sizes.length !== configs.length || sizes.length === 0) {
+    return sizes
+  }
+
+  const clamped = sizes.map((size, index) => {
+    const minSize = configs[index]?.minSize ?? 5
+    const maxSize = configs[index]?.maxSize ?? 95
+    return clamp(size, minSize, maxSize)
+  })
+
+  const total = clamped.reduce((sum, value) => sum + value, 0)
+  if (total <= 0) {
+    return evenPanelSizes(configs.length)
+  }
+
+  return clamped.map(value => (value / total) * 100)
+}
+
+export function evenPanelSizes(count: number): PanelLayoutSizes {
+  if (count <= 0) return []
+  const base = 100 / count
+  return Array.from({ length: count }, () => base)
+}
+
+export function resizeAdjacentPanels(
+  sizes: PanelLayoutSizes,
+  configs: PanelConfig[],
+  index: number,
+  deltaPercent: number,
+): PanelLayoutSizes {
+  if (index < 0 || index >= sizes.length - 1) return sizes
+
+  const next = [...sizes]
+  const leftMin = configs[index]?.minSize ?? 5
+  const leftMax = configs[index]?.maxSize ?? 95
+  const rightMin = configs[index + 1]?.minSize ?? 5
+  const rightMax = configs[index + 1]?.maxSize ?? 95
+
+  let left = next[index] + deltaPercent
+  let right = next[index + 1] - deltaPercent
+
+  if (left < leftMin) {
+    right -= leftMin - left
+    left = leftMin
+  } else if (left > leftMax) {
+    right -= leftMax - left
+    left = leftMax
+  }
+
+  if (right < rightMin) {
+    left -= rightMin - right
+    right = rightMin
+  } else if (right > rightMax) {
+    left -= rightMax - right
+    right = rightMax
+  }
+
+  next[index] = left
+  next[index + 1] = right
+  return normalizePanelSizes(next, configs)
+}
+
+export function serializePanelLayoutPreference(
+  sizes: PanelLayoutSizes,
+): PanelLayoutPreferenceState {
+  return {
+    version: PLATFORM_PANEL_LAYOUT_STATE_VERSION,
+    sizes,
+  }
+}
+
+export function patchPanelLayoutPreference(
+  sizes: PanelLayoutSizes,
+): Record<string, PanelLayoutPreferenceState> {
+  return {
+    [PLATFORM_PANEL_LAYOUT_PREFERENCE_KEY]:
+      serializePanelLayoutPreference(sizes),
+  }
+}
+
+export function readPanelLayoutFromAppSettings(
+  appSettings: Record<string, unknown>,
+  defaultSizes: PanelLayoutSizes,
+  configs: PanelConfig[],
+): PanelLayoutSizes {
+  const parsed = parsePanelLayoutPreference(
+    appSettings[PLATFORM_PANEL_LAYOUT_PREFERENCE_KEY],
+  )
+  if (!parsed || parsed.length !== defaultSizes.length) {
+    return normalizePanelSizes(defaultSizes, configs)
+  }
+  return normalizePanelSizes(parsed, configs)
+}
+
+export function parsePanelLayoutPreference(
+  value: unknown,
+): PanelLayoutSizes | null {
+  if (!value || typeof value !== 'object') return null
+  const record = value as Record<string, unknown>
+  if (record.version !== PLATFORM_PANEL_LAYOUT_STATE_VERSION) return null
+  if (!Array.isArray(record.sizes)) return null
+  const sizes = record.sizes.filter(
+    (entry): entry is number =>
+      typeof entry === 'number' && Number.isFinite(entry),
+  )
+  return sizes.length > 0 ? sizes : null
+}
+
+function clamp(value: number, min: number, max: number): number {
+  return Math.min(max, Math.max(min, value))
+}
+
+/** Hide the handle between `handleIndex` and `handleIndex + 1` when either side is collapsed. */
+export function isPanelResizeHandleHidden(
+  handleIndex: number,
+  collapsed: readonly boolean[],
+): boolean {
+  return Boolean(collapsed[handleIndex] || collapsed[handleIndex + 1])
+}
+
+export function visiblePanelResizeHandleCount(
+  collapsed: readonly boolean[],
+  handleCount: number,
+): number {
+  let count = 0
+  for (let index = 0; index < handleCount; index += 1) {
+    if (!isPanelResizeHandleHidden(index, collapsed)) count += 1
+  }
+  return count
+}
+
+/** Renormalize stored sizes across non-collapsed panels (sum → 100). */
+export function visiblePanelLayoutSizes(
+  sizes: PanelLayoutSizes,
+  collapsed: readonly boolean[],
+): PanelLayoutSizes {
+  if (sizes.length === 0) return sizes
+
+  let visibleTotal = 0
+  for (let index = 0; index < sizes.length; index += 1) {
+    if (collapsed[index]) continue
+    visibleTotal += sizes[index] ?? 0
+  }
+
+  if (visibleTotal <= 0) {
+    return sizes.map(() => 0)
+  }
+
+  return sizes.map((size, index) =>
+    collapsed[index] ? 0 : ((size ?? 0) / visibleTotal) * 100,
+  )
+}
+
+export function panelFlexBasis(
+  sizePercent: number,
+  visibleDividerCount: number,
+): string {
+  const ratio = sizePercent / 100
+  return `calc((100% - ${visibleDividerCount * 2}px) * ${ratio})`
+}

package/src/components/common/layout/panelLayoutTypes.ts

@@ -1,19 +1,19 @@
-/** Percent widths for sibling panels; must sum to 100 after normalization. */
-export type PanelLayoutSizes = number[]
-
-export interface PanelLayoutPreferenceState {
-  version: number
-  sizes: PanelLayoutSizes
-}
-
-export type PanelGroupDirection = 'horizontal' | 'vertical'
-
-export interface PanelLayoutPersistence {
-  load(): PanelLayoutSizes | null
-  save(sizes: PanelLayoutSizes): void
-}
-
-export interface PanelConfig {
-  minSize?: number
-  maxSize?: number
-}
+/** Percent widths for sibling panels; must sum to 100 after normalization. */
+export type PanelLayoutSizes = number[]
+
+export interface PanelLayoutPreferenceState {
+  version: number
+  sizes: PanelLayoutSizes
+}
+
+export type PanelGroupDirection = 'horizontal' | 'vertical'
+
+export interface PanelLayoutPersistence {
+  load(): PanelLayoutSizes | null
+  save(sizes: PanelLayoutSizes): void
+}
+
+export interface PanelConfig {
+  minSize?: number
+  maxSize?: number
+}