gsd-pi 2.35.0-dev.cd3b7ea → 2.36.0-dev.d612764

package/dist/resources/extensions/shared/wizard-ui.js

@@ -1,478 +0,0 @@
-/**
- * General-purpose multi-page wizard UI.
- *
- * Supports declarative page definitions with select and text fields.
- * Pages can conditionally route to different next pages based on answers.
- *
- * Navigation:
- *   ←           go back one page (on page 1: triggers exit confirmation)
- *   → / Enter   advance to next page (or submit on last page)
- *   Escape      triggers exit confirmation overlay
- *
- * Exit confirmation (shown on Escape or ← from page 1):
- *   1. Go back  — dismiss and return to current page
- *   2. Exit     — cancel the wizard, returns null to caller
- *
- * Returns:
- *   Record<pageId, Record<fieldId, string | string[]>>  on completion
- *   null                                                 on exit/cancel
- *
- * Example:
- *
- *   const result = await showWizard(ctx, {
- *     title: "New Project",
- *     pages: [
- *       {
- *         id: "mode",
- *         fields: [
- *           {
- *             type: "select",
- *             id: "start_type",
- *             question: "How do you want to start?",
- *             options: [
- *               { label: "Describe it", description: "Type what you want to build." },
- *               { label: "Provide a file", description: "Point to an existing doc." },
- *             ],
- *           },
- *         ],
- *         next: (answers) =>
- *           answers["mode"]?.["start_type"] === "Provide a file" ? "file_path" : null,
- *       },
- *       {
- *         id: "file_path",
- *         fields: [
- *           { type: "text", id: "path", label: "File path", placeholder: "/path/to/doc.md" },
- *         ],
- *         next: () => null,
- *       },
- *     ],
- *   });
- *
- *   if (!result) return; // user exited
- *   const startType = result["mode"]["start_type"]; // "Describe it" | "Provide a file"
- *   const filePath  = result["file_path"]?.["path"];
- */
-import { Editor, Key, matchesKey, truncateToWidth, } from "@gsd/pi-tui";
-import { makeUI } from "./ui.js";
-// ─── Main export ──────────────────────────────────────────────────────────────
-/**
- * Show a multi-page wizard and return collected answers, or null if the user exits.
- */
-export async function showWizard(ctx, opts) {
-    const pageMap = new Map(opts.pages.map((p) => [p.id, p]));
-    return ctx.ui.custom((tui, theme, _kb, done) => {
-        // ── State ──────────────────────────────────────────────────────────────
-        /** Stack of page ids visited — drives back navigation */
-        const pageStack = [opts.pages[0].id];
-        const pageStates = new Map();
-        /** Collected answers across all pages */
-        const answers = {};
-        /** Whether the exit-confirmation overlay is showing */
-        let showingExitConfirm = false;
-        /** Cursor in the exit-confirm overlay: 0 = go back, 1 = exit */
-        let exitCursor = 0;
-        let cachedLines;
-        // Editors keyed by fieldId — one per text field
-        // editorTheme is derived from the design system at first render
-        const editors = new Map();
-        let resolvedEditorTheme = null;
-        function getEditor(fieldId) {
-            if (!resolvedEditorTheme)
-                resolvedEditorTheme = makeUI(theme, 80).editorTheme;
-            if (!editors.has(fieldId))
-                editors.set(fieldId, new Editor(tui, resolvedEditorTheme));
-            return editors.get(fieldId);
-        }
-        // ── Page state helpers ─────────────────────────────────────────────────
-        function getPageState(pageId) {
-            if (!pageStates.has(pageId)) {
-                pageStates.set(pageId, {
-                    selectStates: new Map(),
-                    textValues: new Map(),
-                    focusedFieldId: null,
-                });
-            }
-            return pageStates.get(pageId);
-        }
-        function getSelectState(pageId, fieldId, _optCount) {
-            const ps = getPageState(pageId);
-            if (!ps.selectStates.has(fieldId)) {
-                ps.selectStates.set(fieldId, {
-                    cursorIndex: 0,
-                    committedIndex: null, // nothing pre-committed — user must explicitly confirm
-                    checkedIndices: new Set(),
-                });
-            }
-            return ps.selectStates.get(fieldId);
-        }
-        // ── Current page ───────────────────────────────────────────────────────
-        function currentPageId() {
-            return pageStack[pageStack.length - 1];
-        }
-        function currentPage() {
-            return pageMap.get(currentPageId());
-        }
-        function currentPageState() {
-            return getPageState(currentPageId());
-        }
-        // ── Validation ─────────────────────────────────────────────────────────
-        function isPageComplete(page, ps) {
-            for (const field of page.fields) {
-                if (field.type === "select") {
-                    const ss = ps.selectStates.get(field.id);
-                    if (!ss)
-                        return false;
-                    if (field.allowMultiple) {
-                        if (ss.checkedIndices.size === 0)
-                            return false;
-                    }
-                    else {
-                        if (ss.committedIndex === null)
-                            return false;
-                    }
-                }
-                else {
-                    const val = ps.textValues.get(field.id) ?? "";
-                    if (!val.trim())
-                        return false;
-                }
-            }
-            return true;
-        }
-        // ── Collect answers for a page ─────────────────────────────────────────
-        function collectPageAnswers(page, ps) {
-            const result = {};
-            for (const field of page.fields) {
-                if (field.type === "select") {
-                    const ss = ps.selectStates.get(field.id);
-                    if (!ss)
-                        continue;
-                    if (field.allowMultiple) {
-                        result[field.id] = Array.from(ss.checkedIndices)
-                            .sort((a, b) => a - b)
-                            .map((i) => field.options[i].label);
-                    }
-                    else {
-                        if (ss.committedIndex !== null && ss.committedIndex < field.options.length) {
-                            result[field.id] = field.options[ss.committedIndex].label;
-                        }
-                    }
-                }
-                else {
-                    result[field.id] = ps.textValues.get(field.id) ?? "";
-                }
-            }
-            return result;
-        }
-        // ── Auto-focus helper ──────────────────────────────────────────────────
-        /** If a page's first field is a text field, focus it immediately on arrival. */
-        function autoFocusPageIfText(pageId) {
-            const page = pageMap.get(pageId);
-            if (!page)
-                return;
-            const firstField = page.fields[0];
-            if (firstField?.type === "text") {
-                const ps = getPageState(pageId);
-                ps.focusedFieldId = firstField.id;
-                const editor = getEditor(firstField.id);
-                editor.setText(ps.textValues.get(firstField.id) ?? "");
-            }
-        }
-        // Auto-focus the first page if it starts with a text field
-        autoFocusPageIfText(opts.pages[0].id);
-        // ── Navigation ─────────────────────────────────────────────────────────
-        function advance() {
-            const page = currentPage();
-            const ps = currentPageState();
-            if (!isPageComplete(page, ps)) {
-                refresh();
-                return;
-            }
-            // Save text field values from editors
-            for (const field of page.fields) {
-                if (field.type === "text") {
-                    ps.textValues.set(field.id, getEditor(field.id).getText().trim());
-                }
-            }
-            // Collect answers for this page
-            answers[page.id] = collectPageAnswers(page, ps);
-            // Route to next page
-            const nextId = page.next ? page.next(answers) : null;
-            if (!nextId) {
-                // End of wizard
-                done(answers);
-                return;
-            }
-            const nextPage = pageMap.get(nextId);
-            if (!nextPage) {
-                done(answers);
-                return;
-            }
-            pageStack.push(nextId);
-            autoFocusPageIfText(nextId);
-            refresh();
-        }
-        function goBack() {
-            if (pageStack.length <= 1) {
-                // Already at first page — Esc here means exit
-                showingExitConfirm = true;
-                exitCursor = 0;
-                refresh();
-                return;
-            }
-            pageStack.pop();
-            autoFocusPageIfText(currentPageId());
-            refresh();
-        }
-        function refresh() {
-            cachedLines = undefined;
-            tui.requestRender();
-        }
-        // ── Input handler ──────────────────────────────────────────────────────
-        function handleInput(data) {
-            // ── Exit confirm overlay ─────────────────────────────────────────
-            if (showingExitConfirm) {
-                if (matchesKey(data, Key.up)) {
-                    exitCursor = 0;
-                    refresh();
-                    return;
-                }
-                if (matchesKey(data, Key.down)) {
-                    exitCursor = 1;
-                    refresh();
-                    return;
-                }
-                if (data === "1") {
-                    showingExitConfirm = false;
-                    refresh();
-                    return;
-                }
-                if (data === "2") {
-                    done(null);
-                    return;
-                }
-                if (matchesKey(data, Key.enter) || matchesKey(data, Key.space)) {
-                    if (exitCursor === 0) {
-                        showingExitConfirm = false;
-                        refresh();
-                    }
-                    else {
-                        done(null);
-                    }
-                    return;
-                }
-                // Esc on the confirm screen = go back (dismiss confirm)
-                if (matchesKey(data, Key.escape)) {
-                    showingExitConfirm = false;
-                    refresh();
-                    return;
-                }
-                return;
-            }
-            // ── Text field focus ─────────────────────────────────────────────
-            const ps = currentPageState();
-            if (ps.focusedFieldId) {
-                const editor = getEditor(ps.focusedFieldId);
-                if (matchesKey(data, Key.escape)) {
-                    // First Esc: unfocus the text field
-                    ps.textValues.set(ps.focusedFieldId, editor.getText().trim());
-                    ps.focusedFieldId = null;
-                    refresh();
-                    return;
-                }
-                if (matchesKey(data, Key.enter)) {
-                    ps.textValues.set(ps.focusedFieldId, editor.getText().trim());
-                    ps.focusedFieldId = null;
-                    advance();
-                    return;
-                }
-                editor.handleInput(data);
-                refresh();
-                return;
-            }
-            // ── Esc with no text field focused: go back (or exit if on page 1) ──
-            if (matchesKey(data, Key.escape)) {
-                goBack();
-                return;
-            }
-            // ── Enter / → to advance ─────────────────────────────────────────
-            if (matchesKey(data, Key.enter) || matchesKey(data, Key.right)) {
-                // For single-select fields, commit cursor before advancing
-                const page = currentPage();
-                for (const field of page.fields) {
-                    if (field.type === "select" && !field.allowMultiple) {
-                        const ss = getSelectState(currentPageId(), field.id, field.options.length);
-                        if (ss.committedIndex === null)
-                            ss.committedIndex = ss.cursorIndex;
-                    }
-                }
-                advance();
-                return;
-            }
-            // ── Select field interactions ────────────────────────────────────
-            const page = currentPage();
-            for (const field of page.fields) {
-                if (field.type !== "select")
-                    continue;
-                const ss = getSelectState(currentPageId(), field.id, field.options.length);
-                const totalOpts = field.options.length;
-                if (matchesKey(data, Key.up)) {
-                    ss.cursorIndex = (ss.cursorIndex - 1 + totalOpts) % totalOpts;
-                    refresh();
-                    return;
-                }
-                if (matchesKey(data, Key.down)) {
-                    ss.cursorIndex = (ss.cursorIndex + 1) % totalOpts;
-                    refresh();
-                    return;
-                }
-                if (field.allowMultiple) {
-                    if (matchesKey(data, Key.space)) {
-                        if (ss.checkedIndices.has(ss.cursorIndex))
-                            ss.checkedIndices.delete(ss.cursorIndex);
-                        else
-                            ss.checkedIndices.add(ss.cursorIndex);
-                        refresh();
-                        return;
-                    }
-                }
-                else {
-                    // Numeric shortcut: press the number to select and immediately advance
-                    if (data.length === 1 && data >= "1" && data <= "9") {
-                        const idx = parseInt(data, 10) - 1;
-                        if (idx < totalOpts) {
-                            ss.cursorIndex = idx;
-                            ss.committedIndex = idx;
-                            advance();
-                            return;
-                        }
-                    }
-                    // Enter/Space commit cursor and advance (Enter handled above, Space here)
-                    if (matchesKey(data, Key.space)) {
-                        ss.committedIndex = ss.cursorIndex;
-                        advance();
-                        return;
-                    }
-                }
-                // Only handle the first select field for nav
-                break;
-            }
-        }
-        // ── Render ─────────────────────────────────────────────────────────────
-        function renderExitConfirm(width) {
-            const ui = makeUI(theme, width);
-            const lines = [];
-            const push = (...rows) => { for (const r of rows)
-                lines.push(...r); };
-            push(ui.bar(), ui.blank(), ui.header("  Exit wizard?"), ui.blank(), ui.subtitle("  Your progress will be lost."), ui.blank());
-            if (exitCursor === 0)
-                push(ui.actionSelected(1, "Go back", "Return to where you were."));
-            else
-                push(ui.actionUnselected(1, "Go back", "Return to where you were."));
-            push(ui.blank());
-            if (exitCursor === 1)
-                push(ui.actionSelected(2, "Exit", "Cancel and discard all answers."));
-            else
-                push(ui.actionUnselected(2, "Exit", "Cancel and discard all answers."));
-            push(ui.blank(), ui.hints(["↑/↓ to choose", "1/2 to quick-select", "enter to confirm"]), ui.bar());
-            return lines;
-        }
-        function renderSelectField(ui, field, lines) {
-            const push = (...rows) => { for (const r of rows)
-                lines.push(...r); };
-            const ss = getSelectState(currentPageId(), field.id, field.options.length);
-            const multi = !!field.allowMultiple;
-            push(ui.question(`  ${field.question}`));
-            if (multi)
-                push(ui.meta("  (select all that apply — space to toggle, enter to confirm)"));
-            push(ui.blank());
-            for (let i = 0; i < field.options.length; i++) {
-                const opt = field.options[i];
-                const isCursor = i === ss.cursorIndex;
-                const isCommitted = i === ss.committedIndex;
-                if (multi) {
-                    const isChecked = ss.checkedIndices.has(i);
-                    if (isCursor)
-                        push(ui.checkboxSelected(opt.label, opt.description, isChecked));
-                    else
-                        push(ui.checkboxUnselected(opt.label, opt.description, isChecked));
-                }
-                else {
-                    if (isCursor)
-                        push(ui.optionSelected(i + 1, opt.label, opt.description, isCommitted));
-                    else
-                        push(ui.optionUnselected(i + 1, opt.label, opt.description, { isCommitted }));
-                }
-            }
-        }
-        function renderTextField(ui, field, ps, lines, width) {
-            const push = (...rows) => { for (const r of rows)
-                lines.push(...r); };
-            const isFocused = ps.focusedFieldId === field.id;
-            const value = isFocused ? getEditor(field.id).getText() : (ps.textValues.get(field.id) ?? "");
-            push(ui.question(`  ${field.label}`), ui.blank());
-            if (isFocused) {
-                for (const line of getEditor(field.id).render(width - 2))
-                    lines.push(truncateToWidth(` ${line}`, width));
-            }
-            else if (value) {
-                push(ui.answer(`  ${value}`));
-            }
-            else if (field.placeholder) {
-                push(ui.meta(`  ${field.placeholder}`));
-            }
-        }
-        function render(width) {
-            if (cachedLines)
-                return cachedLines;
-            if (showingExitConfirm) {
-                cachedLines = renderExitConfirm(width);
-                return cachedLines;
-            }
-            const ui = makeUI(theme, width);
-            const lines = [];
-            const push = (...rows) => { for (const r of rows)
-                lines.push(...r); };
-            push(ui.bar(), ui.header(`  ${opts.title}`));
-            // ── Page indicator ────────────────────────────────────────────────
-            if (opts.pages.length > 1) {
-                push(ui.pageDots(opts.pages.length, pageStack.length - 1));
-            }
-            // ── Page content ──────────────────────────────────────────────────
-            const page = currentPage();
-            const ps = currentPageState();
-            if (page.subtitle) {
-                push(ui.blank(), ui.subtitle(`  ${page.subtitle}`));
-            }
-            push(ui.blank());
-            for (const field of page.fields) {
-                if (field.type === "select")
-                    renderSelectField(ui, field, lines);
-                else
-                    renderTextField(ui, field, ps, lines, width);
-                push(ui.blank());
-            }
-            // ── Footer hints ──────────────────────────────────────────────────
-            const isFirst = pageStack.length === 1;
-            const ps2 = currentPageState();
-            const hints = [];
-            if (ps2.focusedFieldId) {
-                hints.push("enter to continue");
-                hints.push("esc to unfocus");
-            }
-            else {
-                hints.push("↑/↓ to move");
-                hints.push("enter to select");
-                hints.push(!isFirst ? "esc to go back" : "esc to exit");
-            }
-            push(ui.hints(hints), ui.bar());
-            cachedLines = lines;
-            return lines;
-        }
-        return {
-            render,
-            invalidate: () => { cachedLines = undefined; },
-            handleInput,
-        };
-    });
-}

package/dist/resources/skills/swiftui/SKILL.md

@@ -1,208 +0,0 @@
----
-name: swiftui
-description: SwiftUI apps from scratch through App Store. Full lifecycle - create, debug, test, optimize, ship.
----
-
-<essential_principles>
-## How We Work
-
-**The user is the product owner. Claude is the developer.**
-
-The user does not write code. The user does not read code. The user describes what they want and judges whether the result is acceptable. Claude implements, verifies, and reports outcomes.
-
-### 1. Prove, Don't Promise
-
-Never say "this should work." Prove it:
-```bash
-xcodebuild build 2>&1 | xcsift  # Build passes
-xcodebuild test                  # Tests pass
-open .../App.app                 # App launches
-```
-If you didn't run it, you don't know it works.
-
-### 2. Tests for Correctness, Eyes for Quality
-
-| Question | How to Answer |
-|----------|---------------|
-| Does the logic work? | Write test, see it pass |
-| Does it look right? | Launch app, user looks at it |
-| Does it feel right? | User uses it |
-| Does it crash? | Test + launch |
-| Is it fast enough? | Profiler |
-
-Tests verify *correctness*. The user verifies *desirability*.
-
-### 3. Report Outcomes, Not Code
-
-**Bad:** "I refactored the view model to use @Observable with environment injection"
-**Good:** "Fixed the state bug. App now updates correctly when you add items. Ready for you to verify."
-
-The user doesn't care what you changed. The user cares what's different.
-
-### 4. Small Steps, Always Verified
-
-```
-Change → Verify → Report → Next change
-```
-
-Never batch up work. Never say "I made several changes." Each change is verified before the next. If something breaks, you know exactly what caused it.
-
-### 5. Ask Before, Not After
-
-Unclear requirement? Ask now.
-Multiple valid approaches? Ask which.
-Scope creep? Ask if wanted.
-Big refactor needed? Ask permission.
-
-Wrong: Build for 30 minutes, then "is this what you wanted?"
-Right: "Before I start, does X mean Y or Z?"
-
-### 6. Always Leave It Working
-
-Every stopping point = working state. Tests pass, app launches, changes committed. The user can walk away anytime and come back to something that works.
-</essential_principles>
-
-<swiftui_principles>
-## SwiftUI Framework Principles
-
-### Declarative Mindset
-Describe what the UI should look like for a given state, not how to mutate it. Let SwiftUI manage the rendering. Never force updates - change the state and let the framework react.
-
-### Single Source of Truth
-Every piece of data has one authoritative location. Use the right property wrapper: @State for view-local, @Observable for shared objects, @Environment for app-wide. Derived data should be computed, not stored.
-
-### Composition Over Inheritance
-Build complex UIs by composing small, focused views. Extract reusable components when patterns emerge. Prefer many small views over few large ones.
-
-### Platform-Adaptive Design
-Write once but respect platform idioms. Use native navigation patterns, respect safe areas, adapt to screen sizes. Test on all target platforms.
-</swiftui_principles>
-
-<intake>
-**What would you like to do?**
-
-1. Build a new SwiftUI app
-2. Debug an existing SwiftUI app
-3. Add a feature to an existing app
-4. Write/run tests
-5. Optimize performance
-6. Ship/release to App Store
-7. Something else
-
-**Then read the matching workflow from `workflows/` and follow it.**
-</intake>
-
-<routing>
-| Response | Workflow |
-|----------|----------|
-| 1, "new", "create", "build", "start" | `workflows/build-new-app.md` |
-| 2, "broken", "fix", "debug", "crash", "bug" | `workflows/debug-swiftui.md` |
-| 3, "add", "feature", "implement", "change" | `workflows/add-feature.md` |
-| 4, "test", "tests", "TDD", "coverage" | `workflows/write-tests.md` |
-| 5, "slow", "optimize", "performance", "fast" | `workflows/optimize-performance.md` |
-| 6, "ship", "release", "deploy", "publish", "app store" | `workflows/ship-app.md` |
-| 7, other | Clarify, then select workflow or references |
-</routing>
-
-<verification_loop>
-## After Every Change
-
-```bash
-# 1. Does it build?
-xcodebuild -scheme AppName build 2>&1 | xcsift
-
-# 2. Do tests pass? (use Core scheme for SwiftUI apps to avoid @main hang)
-xcodebuild -scheme AppNameCore test
-
-# 3. Does it launch?
-# macOS:
-open ./build/Build/Products/Debug/AppName.app
-
-# iOS Simulator:
-xcrun simctl boot "iPhone 15 Pro" 2>/dev/null || true
-xcrun simctl install booted ./build/Build/Products/Debug-iphonesimulator/AppName.app
-xcrun simctl launch booted com.yourcompany.appname
-```
-
-Note: If tests hang, the test target likely depends on the app target which has `@main`. Extract testable code to a framework target. See `../macos-apps/references/testing-tdd.md` for the pattern.
-
-Report to the user:
-- "Build: ✓"
-- "Tests: 12 pass, 0 fail"
-- "App launches, ready for you to check [specific thing]"
-</verification_loop>
-
-<cli_infrastructure>
-## CLI Workflow References
-
-For building, debugging, testing, and shipping from CLI without opening Xcode, read these from `../macos-apps/references/`:
-
-| Reference | Use For |
-|-----------|---------|
-| `cli-workflow.md` | Build, run, test commands; xcodebuild usage; code signing |
-| `cli-observability.md` | Log streaming, crash analysis, memory debugging, LLDB |
-| `project-scaffolding.md` | XcodeGen project.yml templates, file structure, entitlements |
-| `testing-tdd.md` | Test patterns that work from CLI, avoiding @main hangs |
-
-These docs are platform-agnostic. For iOS, change destinations:
-```bash
-# iOS Simulator
-xcodebuild -scheme AppName -destination 'platform=iOS Simulator,name=iPhone 15 Pro' build
-
-# macOS
-xcodebuild -scheme AppName build
-```
-</cli_infrastructure>
-
-<reference_index>
-## Domain Knowledge
-
-All in `references/`:
-
-**Core:**
-- architecture.md - MVVM patterns, project structure, dependency injection
-- state-management.md - Property wrappers, @Observable, data flow
-- layout-system.md - Stacks, grids, GeometryReader, custom layouts
-
-**Navigation & Animation:**
-- navigation.md - NavigationStack, sheets, tabs, deep linking
-- animations.md - Built-in animations, transitions, matchedGeometryEffect
-
-**Data & Platform:**
-- swiftdata.md - Persistence, @Model, @Query, CloudKit sync
-- platform-integration.md - iOS/macOS/watchOS/visionOS specifics
-- uikit-appkit-interop.md - UIViewRepresentable, hosting controllers
-
-**Support:**
-- networking-async.md - async/await, .task modifier, API clients
-- testing-debugging.md - Previews, unit tests, UI tests, debugging
-- performance.md - Profiling, lazy loading, view identity
-</reference_index>
-
-<workflows_index>
-## Workflows
-
-All in `workflows/`:
-
-| Workflow | Purpose |
-|----------|---------|
-| build-new-app.md | Create new SwiftUI app from scratch |
-| debug-swiftui.md | Find and fix SwiftUI bugs |
-| add-feature.md | Add functionality to existing app |
-| write-tests.md | Write UI and unit tests |
-| optimize-performance.md | Profile and improve performance |
-| ship-app.md | App Store submission, TestFlight, distribution |
-</workflows_index>
-
-<canonical_terminology>
-## Terminology
-
-Use these terms consistently:
-- **view** (not: widget, component, element)
-- **@Observable** (not: ObservableObject, @Published for new iOS 17+ code)
-- **NavigationStack** (not: NavigationView - deprecated)
-- **SwiftData** (not: Core Data for new projects)
-- **@Environment** (not: @EnvironmentObject for new code)
-- **modifier** (not: method/function when describing view modifiers)
-- **body** (not: render/build when describing view body)
-</canonical_terminology>