API Reference

Extensions run in an isolated JavaScriptCore context. The following globals are available:

Global	Description
`DynamicIsland.island`	Control island state (activate, dismiss, read state)
`DynamicIsland.store`	Persistent key-value storage (extension-scoped)
`DynamicIsland.settings`	Read/write user-facing settings from `settings.json`
`DynamicIsland.http`	Network fetch API (requires `network` permission)
`DynamicIsland.notifications`	Send notifications (requires `notifications` permission)
`DynamicIsland.system`	Read system data (AI usage, recent notifications)
`DynamicIsland.mascot`	Control the mascot companion
`DynamicIsland.playFeedback`	Haptic + audio feedback
`DynamicIsland.openURL`	Open a URL in the default browser
`View`	Declarative view builder
`setTimeout`, `setInterval`, etc.	Standard timers
`console.log`, `console.warn`, `console.error`	Logging (appears in Extension Debug Log)

Sandbox

Extensions run in a restricted sandbox:

eval() is not available
Function() constructor is not available
Direct file system access is not available (use DynamicIsland.store for persistence)
Network access requires the "network" permission in manifest.json

For editor autocompletion, install the type definitions:

npm install --save-dev @superisland/extension-types

Then add to tsconfig.json:

{
  "compilerOptions": {
    "types": ["@superisland/extension-types"]
  }
}