size control

[Bahlaouane-Hamza]

Can we have control over SuperIsland/Utilities/Constants.swift ?
Since extensions are sandboxed, maybe in app settings ? impact current built-in widgets ?

Thanks

[shobhit99]

@claude work on this, we have exhaustive list of constants, make a list of constants that a regular would want to tweak
create a separate list for the constants that developer would want to tweak for the extensions and expose them in the sdk, also update the .md file for the extensions api

[claude]

Claude finished @shobhit99's task in 3m 23s —— View job • claude/issue-24-20260412-0114 • Create PR ➔

---

Working on Issue #24: Size Control / Constants Exposure

• Read CLAUDE.md and gather repo context
• Read Constants.swift and catalog all constants
• Categorize constants: user-tweakable vs developer/SDK-tweakable
• Restructure Constants.swift into user, developer/SDK, and internal sections
• Expose developer layout constants via SuperIsland.constants in the JS SDK
• Update SUPER-ISLAND-EXTENSION-API.md to document SuperIsland.constants

---

What was done

SuperIsland/Utilities/Constants.swift — reorganized into three clearly documented sections:

Section	Constants	Purpose
User-Tweakable	hudAutoDismissDelay, hoverPeekDelay, notificationDisplayDuration, notificationHoverFullExpandWindow, weatherRefreshInterval	Timing/behaviour values a regular user might want to adjust in Settings
Developer/SDK Layout	compactSize, nonNotchCompactSize, expandedSize, fullExpandedSize, compactCornerRadius, expandedCornerRadius, fullExpandedCornerRadius	Island geometry exposed to extensions via SuperIsland.constants.layout
Internal Renderer	All notch insets, window bounds, module cycler sizes, animation springs	Host-only; not exposed to users or extensions

ExtensionHost/ExtensionJSRuntime.swift — added injectConstants() which wires SuperIsland.constants.layout into every extension's JS context with all 11 layout properties (widths, heights, corner radii for compact, expanded, and full-expanded states).

SUPER-ISLAND-EXTENSION-API.md — new section documenting SuperIsland.constants.layout with a full property table and usage example:

const { layout } = SuperIsland.constants;

SuperIsland.registerModule({
  compact() {
    return View.frame(View.text("Hello"), {
      maxWidth: layout.compactWidth,
      maxHeight: layout.compactHeight
    });
  }
});

Note for next step: the user-tweakable constants (hudAutoDismissDelay, etc.) are now clearly flagged in code — they're the natural candidates to wire up to an in-app Settings UI (e.g. an "Advanced Behaviour" section) as a follow-up.

•