# IDEA.md – en egen Launchpad för macOS 26 och senare Det här är en uppdragsbeskrivning. Ge den i sin helhet till Claude Code (eller ett liknande verktyg) för att bygga en egen implementation. Den bygger på ett färdigt projekt, Launchpad 27, och innehåller det som visade sig viktigt under bygget. ## 1. Vad som ska byggas macOS 26 tog bort Launchpad och ersatte det med en Apps-vy i Spotlight, utan egna mappar och utan egen ordning. Bygg en ersättare: en app som visar alla installerade appar i ett rutnät över hela skärmen, med ikon och namn, för den som vill se allt på en gång och ordna det själv. Det ska gå att: - öppna rutnätet från ett skärmhörn (hot corner), med ett globalt kortkommando, från en menyradsikon och från Dock - starta en app med ett klick, och stänga rutnätet med Esc, klick på tom yta eller genom att byta app - bläddra mellan sidor med tvåfingersvep, piltangenter och klick på sidpunkter - söka direkt genom att skriva; pilar väljer bland träffarna, Retur startar - ordna om genom att dra, även mellan sidor - skapa en mapp genom att dra en app på en annan, lägga fler appar i den, dra ut dem igen och byta namn på mappen - ställa in antal appar per rad och antal rader - importera ordningen och mapparna från gamla Launchpad, om dess databas finns kvar - starta appen i bakgrunden vid inloggning, utan ikon i Dock Ingår inte: avinstallation av appar, nyp-gesten på styrplattan, märken och nedladdningsförlopp på ikonerna, mappar i mappar. ## 2. Stack och arkitektur - **Swift och AppKit.** Inget språk är tvingande, men appen består nästan bara av anrop till macOS egna API:er: ett fönster över alla Spaces, appikoner, global musbevakning, kortkommando. Rust med objc2 går, men varje anrop går då via bindningar. - **Swift Package Manager, inget Xcode-projekt.** Två mål: en kärna med all logik och utan fönster, och ett tunt AppKit-skal. App-bunten sätts ihop av ett byggskript: binären, en `Info.plist` ur en mall, ikonen, och `codesign --sign -` (ad hoc). - **Swift Testing** för kärnan. Command Line Tools räcker för att bygga. - **Inga externa beroenden.** SQLite finns i systemet. Det viktiga är uppdelningen i kärna och skal. Språket och byggsättet går att byta. ## 3. Beslut som visade sig avgörande **Ingen behörighet i Systeminställningar.** macOS har inget API för att lägga till en egen åtgärd i ett skärmhörn. Bevaka muspekaren själv med `NSEvent.addGlobalMonitorForEvents(matching: .mouseMoved)` plus en lokal monitor. Musrörelser i en global monitor kräver inte Accessibility; det gör bara tangenter. Använd Carbons `RegisterEventHotKey` för kortkommandot, av samma skäl. Skälet är signeringen: en behörighet knyts till signaturen, och en ad hoc-signatur byts vid varje bygge, så en beviljad behörighet slutar gälla efter nästa version. **Reglerna i kärnan, inte i vyn.** Allt som får hända med layouten är funktioner på en datamodell: flytta, släppa app på app, ta ut ur mapp, jämka mot installerade appar, fylla om sidor. Var cellerna ligger och vad ett drag siktar på räknas också ut i kärnan. Vyn frågar och ritar. Det gör att reglerna går att testa utan fönster. **Rutnätet är en egen vy med lager, inte NSCollectionView och inte SwiftUI.** Varje cell är ett `CALayer`. Vyn tar själv emot alla mushändelser och räknar ut vilken cell de träffar. Draget måste kunna skapa mappar, byta sida vid kanten och flytta undan grannarna medan man drar, och det styrs enklast när draget är ens eget. **Under ett drag ändras en arbetskopia.** Rutnätet visar kopian, och den sparas först när man släpper. Ett avbrutet drag ändrar då ingenting. **Draget tolkas efter var pekaren är i cellen.** Mitt på en annan ikon betyder "lägg i mapp". I mellanrummet betyder vänster halva av en cell "före" och höger halva "efter". Grannarna flyttar sig först när pekaren legat still i ungefär 0,2 sekunder, annars hoppar de runt när man drar förbi. **Hörnet utlöses av en tillståndsmaskin med dröjtid.** Pekaren ska ligga i hörnet en kort stund (0,15 s), hörnet armeras om först när pekaren lämnat det, och det utlöses inte medan en musknapp hålls nere. Med flera skärmar räknas bara hörn där pekaren inte kan fortsätta till en annan skärm. **Fönstret ligger strax under Dock.** Då syns Dock och menyraden och går att använda medan rutnätet är uppe. Sätt `collectionBehavior` till `canJoinAllSpaces` och `fullScreenAuxiliary`. **Sökfältet har tangentbordet hela tiden.** Fånga pilar, Retur och Esc i `control(_:textView:doCommandBy:)`, inte i `keyDown`. **Bakgrundsstart med en LaunchAgent.** En plist i `~/Library/LaunchAgents` som startar appen med ett argument som betyder "visa inte rutnätet", och `KeepAlive` med `SuccessfulExit` falskt så att appen startas om efter en krasch men inte efter Quit. Sätt `LSUIElement` i `Info.plist` så att appen startar utan Dock-ikon, och byt till vanlig app vid start om användaren valt det. ## 4. Fallgropar - **Läs gamla Launchpads databas med loggen.** Den ligger i `$(getconf DARWIN_USER_DIR)com.apple.dock.launchpad/db/db`, inte under Application Support. Kopiera `db`, `db-wal` och `db-shm` till en tillfällig katalog och läs kopian. Utan loggen ser innehållet helt annorlunda ut (197 appar på 15 sidor i stället för 158 på en), och originalet ska aldrig röras. - **Ta med HOLDINGPAGE.** I `items` är typ 1 rot, 2 mapp, 3 sida och 4 app. Efter uppgraderingen kan hela layouten ligga på sidan som heter `HOLDINGPAGE`. Ta alla rotens barn av typ 3. En mapps appar ligger under mappens egna sidor. - **Använd inte Spotlight för att hitta appar.** `mdfind` räknar hjälpappar inuti andra appar. Gå igenom `/Applications`, `/System/Applications`, `~/Applications` och `/System/Cryptexes/App/System/Applications` (Safari), två nivåer ned, aldrig in i en `.app`. - **Välj inte F4 som kortkommando.** Ett globalt kortkommando tar tangenten från alla andra program. Kräv en modifierare. - **Stäng av systemets egen åtgärd i samma hörn**, annars utlöses båda. Fråga användaren; ändra aldrig inställningen utan ett ja. - **Fyll om sidorna när rutnätet byter storlek.** Att lägga överskottet på en egen sida ger småsidor när storleken ändras stegvis (35 och 20 platser blev 20, 5, 5, 5 och 20). - **Släpp sist på en full sida ska flytta grannen, inte det dragna.** Annars hoppar vyn till nästa sida. - **Gör den öppna mappens platta tät.** En genomskinlig platta låter rutnätets ikoner lysa igenom mellan mappens. - **Ge appen en ikon i det nya formatet.** macOS 26 lägger en `.icns`-ikon förminskad på en ljusgrå platta i 16 och 32 pixlar. Gör en Icon Composer-ikon (`AppIcon.icon` med `icon.json` och motivet som ett lager utan plattan), kompilera med `actool` till `Assets.car`, och sätt `CFBundleIconName`. Behåll `.icns` för äldre macOS. - **Ladda inte in LaunchAgenten när användaren slår på den.** Appen kör redan, och det startar en andra kopia. Låt den börja gälla vid nästa inloggning, och låt en kopia avsluta sig själv om en annan redan kör. - **Installera tjänsten bara från `/Applications`.** En tjänst som pekar på en byggkatalog slutar gälla vid nästa bygge. - **Peka ut knappar med namn i automatiska prov, aldrig med ordningsnummer.** Ett prov som klickade på "knapp 1" träffade knappen som ändrar en systeminställning. - **Stava namnet rätt från början.** Namnet hamnar i bundle-id, datakatalog, tjänstens etikett och miljövariabler. Ett byte kräver kod som flyttar över användarens data. ## 5. Krav och mått Riktmärken från det färdiga projektet, på en Mac med Apple Silicon: - skanning av 161 appar: under en halv sekund - en ny eller borttagen app märks inom fem sekunder (FSEvents) - ingen behörighet i Systeminställningar - dmg: omkring 2 MB, varav ikonen i det nya formatet 1,5 MB - rutnät från 3×2 till 14×10; ikoner högst 128 punkter - den nedersta femtedelen av skärmen lämnas tom ## 6. Så verifieras det - **Enhetstester för kärnan**: flytt, mappregler (mappen ligger kvar med en app och försvinner när den töms), omfyllning av sidor, jämkning mot installerade appar, lagring, sökningens rangordning, var ett drag siktar, hörnets geometri med en och flera skärmar, import ur en testdatabas med samma schema. Det färdiga projektet har 86. - **Skärmbilder utan skärmfångst**: en miljövariabel som får appen att rita fönstrets lager till en PNG och avsluta. Då kommer inget av användarens skrivbord med. - **Riktiga händelser mot den byggda bunten**: tangenter via System Events, klick och drag som `CGEvent` från ett litet skript. Läs resultatet ur appens logg och ur den sparade filen. - **Egen datakatalog vid varje prov**, via en miljövariabel. Proven rör aldrig användarens riktiga layout. - **Kontrollera ikonen med vad systemet ritar** (`NSWorkspace.shared.icon(forFile:)`) i 16 och 32 pixlar, inte med vad som står i filen. Klart betyder verifierat, inte skrivet. Det som bara går att bedöma vid skärmen – svepgester, dragkänsla, start vid inloggning – lämnas till en människa, med exakta steg. ## 7. Arbetssätt - Börja med research: hur gamla Launchpad fungerade, hur andra ersättare löst hörnet och fönstret, och vad som finns kvar på maskinen. - Skriv en plan och få den godkänd innan något byggs. Ställ frågor om det som är verkliga beslut: språk, sätt att öppna, om appar ska kunna avinstalleras. - Dela upp arbetet i kort på en ärendebräda, ett i taget. Skriv in vad som mättes när ett kort stängs. - Bygg kärnan med tester först, sedan en vy i taget, och provkör varje del innan nästa påbörjas. - Ändra aldrig en systeminställning i ett prov. ## 8. Prompten ``` Läs IDEA.md i sin helhet. Jag vill bygga en egen ersättare för Launchpad för macOS [version], som beskrivs där. Börja med research och en plan, och bygg ingenting innan jag godkänt planen. Kontrollera vad som finns på den här maskinen: installerade appar, om gamla Launchpads databas finns kvar, och om systemet har en åtgärd i det skärmhörn jag vill använda ([nedre högra]). Fråga mig om de beslut som är mina: [språk], hur appen ska öppnas, och vad som inte ska ingå. Appen ska heta [namn] och ha bundle-id [omvänd domän].[Namn]. Dela upp arbetet i kort, ett i taget. Verifiera varje kort mot den byggda appen innan du går vidare, och säg vad du inte kunnat prova själv. ```