Changelog

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

0.2.2 — 2026-07-23

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

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.

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.

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.

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.

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.

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

@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.