google-stitch-mcp 0.3.2

package/dist/ui/checklist/spec.d.ts

@@ -0,0 +1,191 @@
+import { z } from 'zod';
+export declare const ChecklistItemState: z.ZodEnum<["PENDING", "IN_PROGRESS", "COMPLETE", "SKIPPED", "FAILED"]>;
+export type ChecklistItemStateType = z.infer<typeof ChecklistItemState>;
+export declare const ChecklistItemSchema: z.ZodType<ChecklistItem>;
+export type ChecklistItem = {
+    id: string;
+    label: string;
+    children?: ChecklistItem[];
+};
+export declare const ChecklistConfigSchema: z.ZodObject<{
+    title: z.ZodDefault<z.ZodString>;
+    items: z.ZodArray<z.ZodType<ChecklistItem, z.ZodTypeDef, ChecklistItem>, "many">;
+    showProgress: z.ZodDefault<z.ZodBoolean>;
+    animationDelayMs: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    items: ChecklistItem[];
+    showProgress: boolean;
+    animationDelayMs: number;
+}, {
+    items: ChecklistItem[];
+    title?: string | undefined;
+    showProgress?: boolean | undefined;
+    animationDelayMs?: number | undefined;
+}>;
+export type ChecklistConfig = z.infer<typeof ChecklistConfigSchema>;
+export declare const UpdateItemInputSchema: z.ZodObject<{
+    itemId: z.ZodString;
+    state: z.ZodEnum<["PENDING", "IN_PROGRESS", "COMPLETE", "SKIPPED", "FAILED"]>;
+    detail: z.ZodOptional<z.ZodString>;
+    reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    itemId: string;
+    state: "PENDING" | "IN_PROGRESS" | "COMPLETE" | "SKIPPED" | "FAILED";
+    detail?: string | undefined;
+    reason?: string | undefined;
+}, {
+    itemId: string;
+    state: "PENDING" | "IN_PROGRESS" | "COMPLETE" | "SKIPPED" | "FAILED";
+    detail?: string | undefined;
+    reason?: string | undefined;
+}>;
+export type UpdateItemInput = z.infer<typeof UpdateItemInputSchema>;
+export declare const ChecklistErrorCode: z.ZodEnum<["ITEM_NOT_FOUND", "INVALID_STATE_TRANSITION", "RENDER_FAILED", "UNKNOWN_ERROR"]>;
+export declare const RenderSuccess: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        output: z.ZodString;
+        completedCount: z.ZodNumber;
+        totalCount: z.ZodNumber;
+        percentComplete: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        output: string;
+        completedCount: number;
+        totalCount: number;
+        percentComplete: number;
+    }, {
+        output: string;
+        completedCount: number;
+        totalCount: number;
+        percentComplete: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    success: true;
+    data: {
+        output: string;
+        completedCount: number;
+        totalCount: number;
+        percentComplete: number;
+    };
+}, {
+    success: true;
+    data: {
+        output: string;
+        completedCount: number;
+        totalCount: number;
+        percentComplete: number;
+    };
+}>;
+export declare const RenderFailure: z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    error: z.ZodObject<{
+        code: z.ZodEnum<["ITEM_NOT_FOUND", "INVALID_STATE_TRANSITION", "RENDER_FAILED", "UNKNOWN_ERROR"]>;
+        message: z.ZodString;
+        recoverable: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        code: "UNKNOWN_ERROR" | "ITEM_NOT_FOUND" | "INVALID_STATE_TRANSITION" | "RENDER_FAILED";
+        message: string;
+        recoverable: boolean;
+    }, {
+        code: "UNKNOWN_ERROR" | "ITEM_NOT_FOUND" | "INVALID_STATE_TRANSITION" | "RENDER_FAILED";
+        message: string;
+        recoverable: boolean;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    success: false;
+    error: {
+        code: "UNKNOWN_ERROR" | "ITEM_NOT_FOUND" | "INVALID_STATE_TRANSITION" | "RENDER_FAILED";
+        message: string;
+        recoverable: boolean;
+    };
+}, {
+    success: false;
+    error: {
+        code: "UNKNOWN_ERROR" | "ITEM_NOT_FOUND" | "INVALID_STATE_TRANSITION" | "RENDER_FAILED";
+        message: string;
+        recoverable: boolean;
+    };
+}>;
+export type RenderResult = z.infer<typeof RenderSuccess> | z.infer<typeof RenderFailure>;
+export declare const UpdateSuccess: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        itemId: z.ZodString;
+        previousState: z.ZodEnum<["PENDING", "IN_PROGRESS", "COMPLETE", "SKIPPED", "FAILED"]>;
+        newState: z.ZodEnum<["PENDING", "IN_PROGRESS", "COMPLETE", "SKIPPED", "FAILED"]>;
+    }, "strip", z.ZodTypeAny, {
+        itemId: string;
+        previousState: "PENDING" | "IN_PROGRESS" | "COMPLETE" | "SKIPPED" | "FAILED";
+        newState: "PENDING" | "IN_PROGRESS" | "COMPLETE" | "SKIPPED" | "FAILED";
+    }, {
+        itemId: string;
+        previousState: "PENDING" | "IN_PROGRESS" | "COMPLETE" | "SKIPPED" | "FAILED";
+        newState: "PENDING" | "IN_PROGRESS" | "COMPLETE" | "SKIPPED" | "FAILED";
+    }>;
+}, "strip", z.ZodTypeAny, {
+    success: true;
+    data: {
+        itemId: string;
+        previousState: "PENDING" | "IN_PROGRESS" | "COMPLETE" | "SKIPPED" | "FAILED";
+        newState: "PENDING" | "IN_PROGRESS" | "COMPLETE" | "SKIPPED" | "FAILED";
+    };
+}, {
+    success: true;
+    data: {
+        itemId: string;
+        previousState: "PENDING" | "IN_PROGRESS" | "COMPLETE" | "SKIPPED" | "FAILED";
+        newState: "PENDING" | "IN_PROGRESS" | "COMPLETE" | "SKIPPED" | "FAILED";
+    };
+}>;
+export declare const UpdateFailure: z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    error: z.ZodObject<{
+        code: z.ZodEnum<["ITEM_NOT_FOUND", "INVALID_STATE_TRANSITION", "RENDER_FAILED", "UNKNOWN_ERROR"]>;
+        message: z.ZodString;
+        recoverable: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        code: "UNKNOWN_ERROR" | "ITEM_NOT_FOUND" | "INVALID_STATE_TRANSITION" | "RENDER_FAILED";
+        message: string;
+        recoverable: boolean;
+    }, {
+        code: "UNKNOWN_ERROR" | "ITEM_NOT_FOUND" | "INVALID_STATE_TRANSITION" | "RENDER_FAILED";
+        message: string;
+        recoverable: boolean;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    success: false;
+    error: {
+        code: "UNKNOWN_ERROR" | "ITEM_NOT_FOUND" | "INVALID_STATE_TRANSITION" | "RENDER_FAILED";
+        message: string;
+        recoverable: boolean;
+    };
+}, {
+    success: false;
+    error: {
+        code: "UNKNOWN_ERROR" | "ITEM_NOT_FOUND" | "INVALID_STATE_TRANSITION" | "RENDER_FAILED";
+        message: string;
+        recoverable: boolean;
+    };
+}>;
+export type UpdateResult = z.infer<typeof UpdateSuccess> | z.infer<typeof UpdateFailure>;
+export interface ChecklistUI {
+    /** Initialize the checklist with items */
+    initialize(config: ChecklistConfig): void;
+    /** Update an item's state */
+    updateItem(input: UpdateItemInput): UpdateResult;
+    /** Render the current checklist state to a string */
+    render(): RenderResult;
+    /** Print the checklist to stdout (with optional in-place update) */
+    print(options?: {
+        clearPrevious?: boolean;
+    }): void;
+    /** Get current progress as percentage */
+    getProgress(): {
+        completed: number;
+        total: number;
+        percent: number;
+    };
+    /** Check if all items are complete or skipped */
+    isComplete(): boolean;
+}

package/dist/ui/checklist.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Result of a verification check
+ */
+export interface VerifyResult {
+    success: boolean;
+    message?: string;
+}
+/**
+ * A single step in the checklist
+ */
+export interface ChecklistStep {
+    id: string;
+    title: string;
+    command: string;
+    instruction?: string;
+    verifyCommand?: string[];
+    verifyFn?: () => Promise<VerifyResult>;
+    env?: Record<string, string>;
+}
+/**
+ * Options for running the checklist
+ */
+export interface ChecklistOptions {
+    autoVerify: boolean;
+    startingStepNumber?: number;
+}
+/**
+ * Result of running the checklist
+ */
+export interface ChecklistResult {
+    success: boolean;
+    completedSteps: string[];
+    failedStep?: string;
+    error?: string;
+}
+/**
+ * Verify all steps upfront to determine which can be skipped
+ */
+export declare function verifyAllSteps(steps: ChecklistStep[], env?: Record<string, string>): Promise<Map<string, VerifyResult>>;
+/**
+ * Checklist runner - guides user through steps
+ */
+export declare class Checklist {
+    private completedSteps;
+    private env;
+    /**
+     * Run the checklist
+     */
+    run(steps: ChecklistStep[], options: ChecklistOptions): Promise<ChecklistResult>;
+}
+/**
+ * Create a new checklist runner
+ */
+export declare function createChecklist(): Checklist;

package/dist/ui/copy-behaviors/clipboard.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Copy text to clipboard
+ */
+export declare function copyText(text: string): Promise<void>;
+/**
+ * Copy JSON-serialized value to clipboard
+ */
+export declare function copyJson(value: any): Promise<void>;
+/**
+ * Download an image from URL and copy to clipboard.
+ * Uses platform-specific commands for image clipboard.
+ */
+/**
+ * Download an image from URL.
+ */
+export declare function downloadImage(url: string): Promise<ArrayBuffer>;
+/**
+ * Download an image from URL and copy to clipboard.
+ * Uses platform-specific commands for image clipboard.
+ */
+export declare function downloadAndCopyImage(url: string): Promise<void>;
+/**
+ * Download text content from URL and copy to clipboard.
+ */
+/**
+ * Download text content from URL.
+ */
+export declare function downloadText(url: string): Promise<string>;
+/**
+ * Download text content from URL and copy to clipboard.
+ */
+export declare function downloadAndCopyText(url: string): Promise<void>;

package/dist/ui/copy-behaviors/handlers.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Copy handlers - isolated behavior implementations.
+ */
+import type { CopyHandler } from './types.js';
+/**
+ * Default handler: copies value on "c", copies {key: value} on "cc"
+ */
+export declare const defaultCopyHandler: CopyHandler;
+/**
+ * Image URL handler: copies URL on "c", downloads and copies image on "cc"
+ */
+export declare const imageUrlCopyHandler: CopyHandler;
+/**
+ * HTML code URL handler: copies URL on "c", downloads and copies HTML code on "cc"
+ */
+export declare const htmlCodeCopyHandler: CopyHandler;

package/dist/ui/copy-behaviors/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Copy behaviors for JSON viewer.
+ * Provides isolated, reusable copy handlers.
+ */
+export type { CopyHandler, CopyContext, CopyResult, PathMatcher } from './types.js';
+export { copyText, copyJson, downloadAndCopyImage } from './clipboard.js';
+export { defaultCopyHandler, imageUrlCopyHandler } from './handlers.js';
+export { registerHandler, getHandler, endsWith, contains } from './registry.js';

package/dist/ui/copy-behaviors/registry.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Registry for path-based copy handler selection.
+ */
+import type { CopyHandler, PathMatcher } from './types.js';
+import { defaultCopyHandler, imageUrlCopyHandler, htmlCodeCopyHandler } from './handlers.js';
+/**
+ * Register a handler for paths matching the given pattern.
+ * Later registrations take precedence over earlier ones.
+ */
+export declare function registerHandler(matcher: PathMatcher, handler: CopyHandler): void;
+/**
+ * Get the appropriate handler for a given path.
+ * Returns the most recently registered matching handler, or default.
+ */
+export declare function getHandler(path: string): CopyHandler;
+/**
+ * Create a matcher that checks if path ends with the given suffix.
+ */
+export declare function endsWith(suffix: string): PathMatcher;
+/**
+ * Create a matcher that checks if path contains the given segment.
+ */
+export declare function contains(segment: string): PathMatcher;
+export { defaultCopyHandler, imageUrlCopyHandler, htmlCodeCopyHandler };

package/dist/ui/copy-behaviors/types.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Copy behavior types for the JSON viewer.
+ * Handlers implement this interface to provide custom copy behaviors.
+ */
+export interface CopyContext {
+    /** The key name of the property */
+    key: string;
+    /** The value of the property */
+    value: any;
+    /** Full dot-notation path (e.g., "projects.0.thumbnailScreenshot.downloadUrl") */
+    path: string;
+    /** Optional callback to show progress during async operations */
+    onProgress?: (message: string) => void;
+}
+export interface CopyResult {
+    success: boolean;
+    message: string;
+}
+export interface CopyHandler {
+    /** Handle "c" - single copy (typically just the value) */
+    copy(ctx: CopyContext): Promise<CopyResult>;
+    /** Handle "cc" - extended copy (typically key+value or special action) */
+    copyExtended(ctx: CopyContext): Promise<CopyResult>;
+}
+/** Check if a path matches a pattern (supports glob-like segments) */
+export type PathMatcher = (path: string) => boolean;

package/dist/ui/navigation-behaviors/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Navigation behaviors for the JSON viewer.
+ * Handles drill-down navigation into screens and back navigation.
+ */
+export interface NavigationContext {
+    /** Current selected path */
+    path: string;
+    /** Current node value */
+    value: any;
+    /** The key of the node */
+    key: string;
+}
+export interface NavigationResult {
+    /** Whether navigation should occur */
+    shouldNavigate: boolean;
+    /** Target resource to navigate to */
+    target?: string;
+    /** Type of navigation (e.g., 'screen', 'project') */
+    type?: string;
+}
+export type NavigationHandler = (ctx: NavigationContext) => NavigationResult;
+/**
+ * Detects if the current node is within screenInstances and can navigate to a screen.
+ * When on screenInstances[x] or screenInstances[x].sourceScreen, extract the sourceScreen value.
+ */
+export declare function screenInstanceNavigationHandler(ctx: NavigationContext): NavigationResult;
+/**
+ * Get navigation result for a given context.
+ */
+export declare function getNavigationTarget(ctx: NavigationContext): NavigationResult;
+/**
+ * Register a custom navigation handler.
+ */
+export declare function registerNavigationHandler(handler: NavigationHandler): void;

package/dist/ui/serve-behaviors/handlers.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Serve handlers - isolated behavior implementations.
+ */
+import type { ServeHandler } from './types.js';
+import { serveHtmlInMemory } from './server.js';
+export declare const deps: {
+    serveHtmlInMemory: typeof serveHtmlInMemory;
+};
+export declare const htmlCodeServeHandler: ServeHandler;

package/dist/ui/serve-behaviors/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Serve behaviors for JSON viewer.
+ */
+export type { ServeHandler, ServeContext, ServeResult, PathMatcher } from './types.js';
+export { serveHtmlInMemory } from './server.js';
+export { htmlCodeServeHandler } from './handlers.js';
+export { registerServeHandler, getServeHandler, endsWith, contains } from './registry.js';

package/dist/ui/serve-behaviors/registry.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Registry for path-based serve handler selection.
+ */
+import type { ServeHandler, PathMatcher } from './types.js';
+import { htmlCodeServeHandler } from './handlers.js';
+export declare function registerServeHandler(matcher: PathMatcher, handler: ServeHandler): void;
+export declare function getServeHandler(path: string): ServeHandler | null;
+export declare function endsWith(suffix: string): PathMatcher;
+export declare function contains(segment: string): PathMatcher;
+export { htmlCodeServeHandler };

package/dist/ui/serve-behaviors/server.d.ts

@@ -0,0 +1,8 @@
+export interface ServeInstance {
+    url: string;
+    stop: () => void;
+}
+export declare function serveHtmlInMemory(html: string, options?: {
+    timeout?: number;
+    openBrowser?: boolean;
+}): Promise<ServeInstance>;

package/dist/ui/serve-behaviors/types.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Serve behavior types for the JSON viewer.
+ */
+export interface ServeContext {
+    key: string;
+    value: any;
+    path: string;
+    onProgress?: (message: string) => void;
+}
+export interface ServeResult {
+    success: boolean;
+    message: string;
+    url?: string;
+}
+export interface ServeHandler {
+    serve(ctx: ServeContext): Promise<ServeResult>;
+}
+export type PathMatcher = (path: string) => boolean;

package/dist/ui/spinner.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Wrapper for ora spinner with consistent styling
+ */
+export declare class Spinner {
+    private spinner;
+    start(message: string): void;
+    succeed(message: string): void;
+    fail(message: string): void;
+    stop(): void;
+}
+export declare function createSpinner(): Spinner;

package/dist/ui/theme.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Theme colors matching the shell script aesthetic
+ */
+export declare const theme: {
+    blue: import("chalk").ChalkInstance;
+    green: import("chalk").ChalkInstance;
+    gray: import("chalk").ChalkInstance;
+    red: import("chalk").ChalkInstance;
+    yellow: import("chalk").ChalkInstance;
+    cyan: import("chalk").ChalkInstance;
+    bgDark: import("chalk").ChalkInstance;
+};
+export declare const icons: {
+    success: string;
+    error: string;
+    info: string;
+    warning: string;
+};

package/dist/ui/wizard.d.ts

@@ -0,0 +1,36 @@
+export type McpClient = 'antigravity' | 'vscode' | 'cursor' | 'claude-code' | 'gemini-cli' | 'codex' | 'opencode';
+/**
+ * Prompt user to select their MCP client
+ */
+export declare function promptMcpClient(): Promise<McpClient>;
+/**
+ * Prompt user to select Authentication Mode
+ */
+export declare function promptAuthMode(): Promise<'apiKey' | 'oauth'>;
+/**
+ * Prompt user to select API Key storage
+ */
+export declare function promptApiKeyStorage(): Promise<'.env' | 'config' | 'skip'>;
+/**
+ * Prompt user to enter API Key
+ */
+export declare function promptApiKey(): Promise<string>;
+/**
+ * Prompt user to select from a list of options
+ */
+export declare function promptSelect<T extends string>(message: string, choices: Array<{
+    name: string;
+    value: T;
+}>): Promise<T>;
+/**
+ * Prompt user to enter text
+ */
+export declare function promptInput(message: string, defaultValue?: string): Promise<string>;
+/**
+ * Prompt user for confirmation
+ */
+export declare function promptConfirm(message: string, defaultValue?: boolean): Promise<boolean>;
+/**
+ * Prompt user to select transport type
+ */
+export declare function promptTransportType(authMode?: 'apiKey' | 'oauth'): Promise<'http' | 'stdio'>;

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "google-stitch-mcp",
+  "version": "0.3.2",
+  "description": "Stitch MCP CLI helper. Automates Google Cloud authentication. Generates MCP config for your client. Sets up a proxy server.",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dongitran/stitch-mcp.git"
+  },
+  "bin": {
+    "stitch-mcp": "./bin/stitch-mcp.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "bun build src/index.ts src/cli.ts --outdir=dist --target=node --format=esm --external lightningcss --external vite --external @astrojs/compiler && tsc -p tsconfig.build.json && bun scripts/generate-bin.ts",
+    "dev": "bun run src/cli.ts",
+    "test": "bun test --preload ./tests/setup.ts",
+    "prepublishOnly": "bun run build",
+    "verify-pack": "bun scripts/verify-pack.ts",
+    "release": "np"
+  },
+  "keywords": [],
+  "author": "David East",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@astrojs/compiler": "^2.13.1",
+    "@inquirer/prompts": "^8.2.0",
+    "@modelcontextprotocol/sdk": "^1.25.2",
+    "adm-zip": "^0.5.16",
+    "chalk": "^5.6.2",
+    "cheerio": "^1.2.0",
+    "clipboardy": "^5.2.1",
+    "commander": "^12.1.0",
+    "dotenv": "^17.2.3",
+    "fs-extra": "^11.3.3",
+    "ink": "^6.6.0",
+    "ink-spinner": "^5.0.0",
+    "ink-text-input": "^6.0.0",
+    "ora": "^8.1.1",
+    "p-limit": "^7.3.0",
+    "react": "^19.2.4",
+    "vite": "^7.3.1",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@happy-dom/global-registrator": "^20.5.0",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/react": "^16.3.2",
+    "@types/adm-zip": "^0.5.7",
+    "@types/bun": "latest",
+    "@types/clipboardy": "^2.0.4",
+    "@types/express": "^5.0.6",
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^25.0.9",
+    "@types/react": "^19.2.10",
+    "happy-dom": "^20.5.0",
+    "ink-testing-library": "^4.0.0",
+    "jsdom": "^28.0.0",
+    "np": "^10.2.0",
+    "react-devtools-core": "^6.1.2",
+    "signal-exit": "^4.1.0",
+    "typescript": "^5.7.3",
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}