# CoreBox Window Behavior & UI View Cache

## CoreBox height & resize

CoreBox height is driven by the renderer result list and applied in the main process.

- Window position stays fixed (only height changes).
- When window resize animation is enabled, bounds changes are animated in the main process.

**Related settings**

- `appSetting.animation.coreBoxResize`
  - `true`: animate CoreBox bounds changes
  - `false`: apply bounds immediately

## Recommendations on empty input

When input is empty and no providers are active, CoreBox requests recommendations from the main process.

To avoid “flash collapse” while recommendations are still in-flight, the renderer keeps a pending flag until a response arrives (or a short timeout).

## AutoPaste / AutoClear (CoreBox show phase)

**AutoPaste**

- Only fires automatically when CoreBox is opened by its shortcut. Explicit pastes and plugin actions the user triggers keep manual semantics.
- Freshness is decided by `autoPaste.time` (seconds): `0` means no limit, `-1` disables it. Implicit input fill, clipboard tags and query input all pass through the same gate.
- The main process supplies `autoPasteEligible`, `observedAt` and `freshnessBaseAt`; the renderer's visibility, clipboard and search hooks reuse the same predicate.
- While CoreBox is hidden the main process only records the latest clipboard entry — it does not activate renderer state. Freshness is re-evaluated when the window is shown again.
- Text up to 80 characters is filled straight into the input; longer text is only attached as a tag. Files and images use their own modes.
- `autoPastedClipboardIdentities` deduplicates entries (TTL 1h), and `clearClipboard(remember)` prevents the same content from firing twice.

**AutoClear**

- Only compares `lastHidden` against `autoClear` when CoreBox is **shown again**.
- Past the timeout it clears the input, mode, files/layout and clipboard cache, and deactivates providers.
- It is not a background timer: a window that stays visible never triggers it.

## Plugin `attachUIView` cache

For `webcontent` features, CoreBox can attach a plugin UI via Electron `WebContentsView`.

**Goal**

Reuse recently-used views so reopening a feature does not reload its page every time.

**Cache config**

- `appSetting.viewCache.maxCachedViews`
  - `0`: disabled (always create/destroy views)
  - `> 0`: enable LRU cache

- `appSetting.viewCache.hotCacheDurationMs`
  - Used for stale cleanup.

**Notes**

- Cache key: `pluginName:featureId`.
- Cache is best-effort: destroyed views are dropped automatically.

**Resume event**

Whenever CoreBox attaches a plugin UI view, it emits `core-box:ui-resume` to the plugin process.

Payload:

- `source`: `attach` | `cache`
- `featureId`: optional feature id
- `url`: the attached URL

## Troubleshooting (recent reports)

**1) Empty input with no recommendations does not collapse**

- Check whether `recommendationPending` is stuck at `true` — `applyLayoutUpdate` skips the collapse while it is.
- The `search.noResults` event does not change window height on its own; a `layout.update` is still required.
- Check whether you are in UI Mode: the main process skips layout updates outright there.
- Check whether `activeActivations` is non-empty — an active activation forces the window to stay expanded.

**2) AutoPaste still fires past the configured time**

- `autoPaste.time = 0` means no limit. For an actual time window pick an explicit value: 1, 3, 5 seconds or longer.
- `ClipboardEvents.getLatest` refreshes the clipboard snapshot when the shortcut opens CoreBox. AutoPaste judges freshness by `freshnessBaseAt` / `observedAt`, not by `item.timestamp`.
- If stale content still comes through, confirm the stored value: `appSetting.tools.autoPaste.time` is in seconds, and `-1` disables it.

**3) AutoClear does nothing long after a plugin is activated**

- `autoClear` is only checked when CoreBox is shown again; a UI that stays visible never triggers it.
- `lastHidden` is written in `onHide`, so it does not advance while UI Mode keeps the window visible.