26 lines
898 B
Markdown
26 lines
898 B
Markdown
# @add-ideas/toolbox-contract
|
|
|
|
Typed, runtime-validated toolbox application manifests and catalogs, plus safe
|
|
same-origin context discovery and URL resolution.
|
|
|
|
```ts
|
|
import {
|
|
loadToolboxContext,
|
|
parseToolboxApp,
|
|
} from "@add-ideas/toolbox-contract";
|
|
|
|
const app = parseToolboxApp(await response.json());
|
|
const result = await loadToolboxContext();
|
|
```
|
|
|
|
The package also owns the versioned same-origin browser preference contract. Use
|
|
`readToolboxPreferences()` and `writeToolboxPreferences()` to share pinned apps,
|
|
ordering, visibility, and light/dark/system mode with the Toolbox portal.
|
|
|
|
See the workspace [README](https://git.add-ideas.de/zemion/toolbox-sdk#readme)
|
|
for the v1 document formats and full API.
|
|
|
|
The canonical schemas are also published at
|
|
`@add-ideas/toolbox-contract/schemas/toolbox-app.v1.schema.json` and
|
|
`@add-ideas/toolbox-contract/schemas/toolbox-catalog.v1.schema.json`.
|