# Changelog

All notable changes to the independently versioned Toolbox SDK packages are
recorded here. The packages currently share one release version.

## 0.2.3 — 2026-07-27

### Changed

- Moved the canonical repository, schema identifiers, examples, and source
  metadata to the `lotobo` (LocalToolBox) Gitea organization.
- Moved publication of all three packages to the `lotobo` Gitea npm registry.

## 0.2.2 — 2026-07-23

### Added

- `ToolboxPersonalizePanel` for the portal-style personalization heading,
  storage warning, appearance picker, and portal extension content.

### Changed

- The invariant top row now fixes the Toolbox brand/home at the far left and
  Help, source, Apps, and Personalize at the far right in that order while the
  text identity remains geometrically centered.
- Default app personalization now matches the central portal's panel styling;
  portal-only catalogue counts and import/export actions remain extensible
  content.

## 0.2.1 — 2026-07-23

### Added

- `ToolboxHeader.personalizeContent` for custom preferences inside the shared
  controlled popover and `brandIconUrl` for a portal favicon with an inline
  Toolbox cube fallback.
- Accessible, mutually exclusive Personalize and Apps popovers that close on
  Escape, outside interaction, and link selection.

### Changed

- The invariant top row now orders Personalize, Apps, source, and Help on the
  left, keeps the text-only app identity geometrically centered, and fixes the
  Toolbox brand/home block at the far right.
- Personalize and Apps keep visible desktop labels, become compact icon controls
  responsively without losing accessible names, and source and Help remain
  present at every supported width.
- `AppShell` now renders version, privacy, manifest actions, and legacy app
  actions in a standard footer instead of changing the top-row geometry.
- `iconUrl`, `leadingActions`, and `metadata` remain accepted for source
  compatibility but are deprecated for the fixed header design.

## 0.2.0 — 2026-07-22

### Added

- A reusable, genuinely centered `ToolboxHeader` with standard Help, Gitea
  source, Personalize, and Apps controls.
- Shared versioned browser preferences in `@add-ideas/toolbox-contract`, using
  the portal's existing storage key so light, dark, and system mode follow the
  user between same-origin Toolbox apps.

### Changed

- `AppShell` now uses the common top bar in both connected and standalone mode,
  derives its source link from manifest metadata, and offers app switching from
  a consistent Apps menu.
- Explicit relative `manifestUrl` values now resolve against the deployed page
  URL, including nested-path deployments.

## 0.1.1 — 2026-07-20

### Fixed

- Reject C0 and DEL control characters consistently in manifest and catalogue
  URL references across runtime parsing, URL resolution, and the published JSON
  Schemas.

## 0.1.0 — 2026-07-20

### Added

- `@add-ideas/toolbox-contract` with v1 app and catalog types, published JSON
  Schemas, strict forward-compatible runtime parsing, same-origin context
  discovery, hydrated catalog loading, resolved URL helpers, and graceful result
  types.
- `@add-ideas/toolbox-shell-react` with the standalone-safe `AppShell`, built-in
  light/dark/system theme, app metadata and privacy display, actions, toolbox
  home, and accessible full-page app switching.
- `@add-ideas/toolbox-testkit` with the `toolbox-check` CLI for manifest/assets,
  unsafe-path detection, nested-prefix resource checks, and standalone/context
  HTTP smoke tests.
- React integration and manifest/catalog examples, Vitest/jsdom coverage, and
  workspace build, typecheck, lint, formatting, and package scripts.