@extension.dev/mcp 6.3.0 → 6.5.0

package/dist/src/lib/vendor/chrome-theme/chrome-theme-reference.d.ts

@@ -0,0 +1,270 @@
+/**
+ * Ground truth for how CURRENT stable Chrome renders an installed extension
+ * theme, transcribed from the Chromium source tree (refs/heads/main, cached
+ * under parity/chromium-src-cache, fetched 2026-07-04).
+ *
+ * Three load-bearing facts anchor everything here:
+ *
+ * 1. browser_theme_pack.cc:237 kOverwritableColorTable is the complete list
+ *    of manifest color keys modern Chrome parses. Anything else in
+ *    theme.colors is silently dropped at parse time.
+ * 2. theme_service.cc:741 GetColorProviderKey sets custom_theme = nullptr
+ *    for incognito profiles: incognito windows NEVER render an extension
+ *    theme. Every *_incognito manifest key parses into the pack but is
+ *    unreachable at render time.
+ * 3. chrome_color_provider_utils.cc ShouldApplyChromeMaterialOverrides
+ *    returns !key.custom_theme: the GM3/material mixer layer is skipped
+ *    entirely for themed clients, so the classic mixers + the
+ *    theme_properties.cc defaults below are the exact render pipeline.
+ */
+/** How a manifest theme.colors key behaves in current stable Chrome. */
+export type ChromeThemeColorKeyStatus = 
+/** Parsed and rendered (possibly only on specific surfaces). */
+"rendered"
+/** Parsed but never rendered (incognito windows drop themes). */
+ | "incognito-dead"
+/** Not in kOverwritableColorTable: silently dropped at parse. */
+ | "dropped"
+/** Legacy alias parsed into another key. */
+ | "alias";
+export interface ChromeThemeColorKeyInfo {
+    status: ChromeThemeColorKeyStatus;
+    /** For "alias": the key that actually receives the value. */
+    aliasFor?: string;
+    note?: string;
+}
+/**
+ * Per-key status table for manifest theme.colors, derived from
+ * kOverwritableColorTable (browser_theme_pack.cc:237-271) plus the
+ * incognito suppression (theme_service.cc:741) and the ntp_section legacy
+ * fallback (browser_theme_pack.cc:1451-1457).
+ *
+ * Keys of historical themes that do NOT appear in the table (tab_text_inactive,
+ * tab_text_incognito, ntp_link_underline, ntp_section_text,
+ * tab_background_separator, ...) are "dropped": ReadColorsFromJSON only
+ * accepts keys it can map (browser_theme_pack.cc:1459-1463).
+ */
+export declare const CHROME_THEME_COLOR_KEYS: Record<string, ChromeThemeColorKeyInfo>;
+/** kTintTable (browser_theme_pack.cc:222-232). */
+export declare const CHROME_THEME_TINT_KEYS: readonly ["buttons", "frame", "frame_inactive", "background_tab", "frame_incognito", "frame_incognito_inactive"];
+/** kPersistingImages manifest keys (browser_theme_pack.cc:141-168). */
+export declare const CHROME_THEME_IMAGE_KEYS: readonly ["theme_frame", "theme_frame_inactive", "theme_frame_incognito", "theme_frame_incognito_inactive", "theme_toolbar", "theme_tab_background", "theme_tab_background_inactive", "theme_tab_background_incognito", "theme_tab_background_incognito_inactive", "theme_ntp_background", "theme_frame_overlay", "theme_frame_overlay_inactive", "theme_button_background", "theme_ntp_attribution", "theme_window_control_background"];
+/** kDisplayProperties (browser_theme_pack.cc:297-306). */
+export declare const CHROME_THEME_PROPERTY_KEYS: readonly ["ntp_background_alignment", "ntp_background_repeat", "ntp_logo_alternate"];
+/**
+ * theme_properties.cc GetLightModeColor defaults: the base colors the pack
+ * derivations and the classic mixers fall back to for themed clients
+ * (material overrides are off with a custom theme, so these ARE the
+ * baseline).
+ */
+export declare const CHROME_THEME_DEFAULTS: {
+    /** theme_properties.cc:39 COLOR_FRAME_ACTIVE. */
+    readonly frame: "#dee1e6";
+    /** chrome_color_mixer.cc:741 kColorToolbar (light). */
+    readonly toolbar: "#ffffff";
+    /** theme_properties.cc:54 / chrome_color_mixer.cc:799: kGoogleGrey800. */
+    readonly toolbarText: "#3c4043";
+    /** chrome_color_mixer.cc:762: HSLShift(kGoogleGrey700, TINT_BUTTONS). */
+    readonly toolbarButtonIconBase: "#5f6368";
+    /** theme_properties.cc:56 COLOR_NTP_BACKGROUND. */
+    readonly ntpBackground: "#ffffff";
+    /** theme_properties.cc:58 COLOR_NTP_TEXT. */
+    readonly ntpText: "#000000";
+    /** theme_properties.cc:60 COLOR_NTP_LINK. */
+    readonly ntpLink: "#063774";
+    /** theme_properties.cc:62 COLOR_NTP_HEADER. */
+    readonly ntpHeader: "#969696";
+    /** browser_theme_pack.cc:1680: omnibox text opaquify base, kGoogleGrey100. */
+    readonly omniboxTextOpaquifyBase: "#f1f3f4";
+};
+/**
+ * theme_properties.cc:218 GetDefaultTint (non-incognito, non-dark): the only
+ * default tint that is not a no-op is TINT_FRAME_INACTIVE, so an unspecified
+ * frame_inactive is a LIGHTENED frame, not a copy.
+ */
+export declare const CHROME_THEME_DEFAULT_TINTS: {
+    readonly frame: {
+        readonly h: -1;
+        readonly s: -1;
+        readonly l: -1;
+    };
+    /** theme_properties.cc:250: #DEE1E6 -> #E7EAED. */
+    readonly frame_inactive: {
+        readonly h: -1;
+        readonly s: -1;
+        readonly l: 0.642;
+    };
+    readonly buttons: {
+        readonly h: -1;
+        readonly s: -1;
+        readonly l: -1;
+    };
+    readonly background_tab: {
+        readonly h: -1;
+        readonly s: -1;
+        readonly l: -1;
+    };
+};
+/**
+ * tab_strip_color_mixer.cc:79-84 kTabFgToContrastMap: contrast each tab
+ * foreground is blended to reach against its background when the theme does
+ * not set it explicitly.
+ */
+export declare const CHROME_TAB_FOREGROUND_CONTRAST: {
+    readonly activeFrameActive: 10.46;
+    readonly activeFrameInactive: 5;
+    readonly inactiveFrameActive: 7.98;
+    readonly inactiveFrameInactive: 4.5;
+};
+/**
+ * tab_strip_color_mixer.cc:106-111: inactive-window foregrounds start from
+ * the active-window color blended 75% toward the background before the
+ * contrast pass.
+ */
+export declare const CHROME_TAB_INACTIVE_WINDOW_FG_BLEND = 0.75;
+/** tab_strip_color_mixer.cc:141-164 hover/selected surface blends. */
+export declare const CHROME_TAB_SURFACE_BLENDS: {
+    readonly inactiveHover: 0.4;
+    readonly selected: 0.75;
+    readonly selectedHover: 0.85;
+};
+/** browser_theme_pack.cc:613 kMinOmniboxToolbarContrast. */
+export declare const CHROME_OMNIBOX_TOOLBAR_MIN_CONTRAST = 1.3;
+/**
+ * window_frame_util.cc:11: a fully opaque button_background is knocked down
+ * to 0xCC before blending over the frame.
+ */
+export declare const CHROME_CAPTION_BUTTON_OPAQUE_ALPHA = 204;
+/** theme_properties.h:206 kFrameHeightAboveTabs: tab background image offset. */
+export declare const CHROME_FRAME_HEIGHT_ABOVE_TABS = 16;
+/**
+ * browser_theme_pack.cc:332-348 GetImagesToCrop: max useful image heights.
+ * kTallestTabHeight = 41, kTallestFrameHeight = 41 + 19 = 60.
+ */
+export declare const CHROME_THEME_IMAGE_CROP_HEIGHTS: {
+    readonly frame: 60;
+    readonly toolbar: 200;
+    readonly buttonBackground: 60;
+    readonly windowControlBackground: 50;
+};
+/**
+ * Image PAINT rules (THEME_REALISM_PLAN.md Phase 3), transcribed at
+ * refs/tags/143.0.7499.4.
+ *
+ * One anchor governs every frame/toolbar/tab image: theme image (0,0) sits
+ * at (browserViewLeft, browserViewTop - kFrameHeightAboveTabs) in window
+ * coordinates. browser_view.cc:1711 GetThemeOffsetFromBrowserView returns
+ * exactly that source offset, and every paint site routes through it:
+ * top_container_background.cc:49-75 PaintThemeAlignedImage (toolbar,
+ * bookmarks bar), tab_style_views.cc:989-998 (BOTH the active tab's toolbar
+ * image and inactive tabs' tab_background image), and
+ * browser_frame_view_mac.mm:633-647 PaintThemedFrame (frame). On macOS the
+ * BrowserView starts at the window top, so the anchor is 16 DIPs ABOVE the
+ * window: the top 16 rows of frame/toolbar images are never visible (they
+ * exist for the Windows/Linux frame band above the tabs).
+ *
+ * Tiling everywhere is SkTileMode::kRepeat horizontally and kMirror
+ * vertically (top_container_background.cc:72-74). CSS has no mirror tiling;
+ * the mock approximates y with plain repeat, which only diverges when an
+ * image is shorter than the painted band (the density guidance in the
+ * themes app warns before that happens).
+ */
+export declare const CHROME_THEME_IMAGE_RULES: {
+    /**
+     * Vertical anchor shared by all frame/toolbar/tab images: image (0,0) is
+     * kFrameHeightAboveTabs DIPs above the BrowserView top
+     * (browser_view.cc:1711-1721).
+     */
+    readonly themeAnchorYAboveBrowserView: 16;
+    /**
+     * theme_frame: tiled horizontally across the window at natural height,
+     * frame color underneath (browser_frame_view_mac.mm:640-644). Painted for
+     * the whole frame band; rows 0-15 are cut on macOS (anchor above window).
+     */
+    readonly frame: {
+        readonly repeatX: true;
+        readonly repeatY: false;
+        readonly macTopCropPx: 16;
+    };
+    /**
+     * theme_frame_overlay: drawn ONCE at the window top-left corner, natural
+     * size, no tiling, over the frame image
+     * (browser_frame_view_mac.mm:645-646).
+     */
+    readonly frameOverlay: {
+        readonly repeatX: false;
+        readonly repeatY: false;
+    };
+    /**
+     * theme_toolbar: theme-aligned (shared anchor), so the toolbar band shows
+     * image rows starting at (16 + surface offset below BrowserView top). The
+     * ACTIVE TAB uses the same image and the same anchor
+     * (tab_style_views.cc:605-607, 989-998): the active tab looks "cut from"
+     * the toolbar, exactly like real Chrome.
+     */
+    readonly toolbar: {
+        readonly themeAligned: true;
+    };
+    /**
+     * theme_tab_background paints INACTIVE tabs, theme-aligned. When absent
+     * but theme_frame is present, the pack GENERATES it: frame color base +
+     * frame image shifted UP by kFrameHeightAboveTabs + background_tab tint,
+     * clamped to kTallestTabHeight = 41 (browser_theme_pack.cc:2036-2057).
+     * Net effect: inactive tabs show the (tinted) frame pixels behind them.
+     */
+    readonly tabBackground: {
+        readonly themeAligned: true;
+        readonly generatedFromFrameShiftPx: 16;
+        readonly generatedTint: "background_tab";
+        readonly generatedHeightClampPx: 41;
+    };
+    /**
+     * theme_ntp_background CSS matrix (new_tab_page_handler.cc:252-288):
+     * size "initial" (natural size, never cover), alignment bitmask maps to
+     * position with LEFT winning over RIGHT and TOP over BOTTOM, center
+     * default on each axis; tiling maps to per-axis repeat pairs. Alignment
+     * strings parse as whitespace-separated case-insensitive tokens
+     * (theme_properties.cc:148-164); tiling defaults to no-repeat
+     * (theme_properties.cc:167-178).
+     */
+    readonly ntpBackground: {
+        readonly cssSize: "auto";
+        readonly repeatCss: {
+            readonly "no-repeat": {
+                readonly x: "no-repeat";
+                readonly y: "no-repeat";
+            };
+            readonly "repeat-x": {
+                readonly x: "repeat";
+                readonly y: "no-repeat";
+            };
+            readonly "repeat-y": {
+                readonly x: "no-repeat";
+                readonly y: "repeat";
+            };
+            readonly repeat: {
+                readonly x: "repeat";
+                readonly y: "repeat";
+            };
+        };
+    };
+    /**
+     * theme_ntp_attribution: fixed to the BOTTOM-LEFT corner (inline-start in
+     * RTL), 16px bottom and inline margins, natural image size, under a
+     * localized "Theme created by" caption in the NTP secondary text color
+     * (app.html:155-160, app.css:210-216). NOT bottom-right, NOT dimmed.
+     */
+    readonly ntpAttribution: {
+        readonly corner: "bottom-left";
+        readonly offsetPx: 16;
+    };
+    /**
+     * theme_button_background / theme_window_control_background: the only
+     * paint site is the Windows/Linux opaque frame's caption buttons
+     * (opaque_browser_frame_view.cc:824). No macOS paint site; a mac-styled
+     * mock correctly renders nothing for them.
+     */
+    readonly buttonBackground: {
+        readonly macPaintSite: false;
+    };
+};

package/dist/src/lib/vendor/chrome-theme/chrome-theme-resolve.d.ts

@@ -0,0 +1,52 @@
+export interface ChromeThemeManifestTheme {
+    colors?: Record<string, number[]>;
+    tints?: Record<string, number[]>;
+    properties?: Record<string, unknown>;
+    images?: Record<string, string>;
+}
+/** All hex unless noted. Slot names follow Chromium's color ids. */
+export interface ResolvedChromeTheme {
+    frameActive: string;
+    frameInactive: string;
+    toolbar: string;
+    toolbarText: string;
+    toolbarButtonIcon: string;
+    toolbarTopSeparator: string;
+    tabBackgroundActiveFrameActive: string;
+    tabBackgroundActiveFrameInactive: string;
+    tabBackgroundInactiveFrameActive: string;
+    tabBackgroundInactiveFrameInactive: string;
+    tabForegroundActiveFrameActive: string;
+    tabForegroundActiveFrameInactive: string;
+    tabForegroundInactiveFrameActive: string;
+    tabForegroundInactiveFrameInactive: string;
+    tabBackgroundInactiveHoverFrameActive: string;
+    tabBackgroundSelectedFrameActive: string;
+    bookmarkText: string;
+    ntpBackground: string;
+    ntpText: string;
+    ntpLink: string;
+    ntpHeader: string;
+    /** rgba() string: header at 0x50 alpha (browser_theme_pack.cc:2010). */
+    ntpSectionBorder: string;
+    ntpLogoAlternate: 0 | 1;
+    omniboxFieldBackground: string;
+    omniboxFieldText: string;
+    omniboxResultsBackground: string;
+    windowControlButtonBackgroundActive: string;
+    windowControlButtonBackgroundInactive: string;
+    newTabButtonForeground: string;
+    newTabButtonBackground: string;
+    properties: {
+        ntpBackgroundAlignment: string;
+        ntpBackgroundRepeat: "no-repeat" | "repeat" | "repeat-x" | "repeat-y";
+    };
+    /** Honored manifest keys that were dropped/ignored, with reasons. */
+    ignoredKeys: {
+        key: string;
+        reason: string;
+    }[];
+    /** Fidelity caveats (e.g. image-derived colors not modeled). */
+    caveats: string[];
+}
+export declare function resolveChromeTheme(theme: ChromeThemeManifestTheme): ResolvedChromeTheme;

package/dist/src/tools/open.d.ts

@@ -1,4 +1,5 @@
 import { type ActArgs } from "../lib/act";
+export declare function navigateToUrl(projectPath: string, browser: string, url: string, timeout?: number): Promise<string>;
 export declare function clampPopupBounds(width: number, height: number): {
     width: number;
     height: number;

package/dist/src/tools/preview-web.d.ts

@@ -0,0 +1,76 @@
+export declare const schema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            projectPath: {
+                type: string;
+                description: string;
+            };
+            browser: {
+                type: string;
+                enum: string[];
+                default: string;
+                description: string;
+            };
+            build: {
+                type: string;
+                default: boolean;
+                description: string;
+            };
+            distPath: {
+                type: string;
+                description: string;
+            };
+            surface: {
+                type: string;
+                enum: string[];
+                default: string;
+                description: string;
+            };
+            hostUrl: {
+                type: string;
+                description: string;
+            };
+            inspectUrl: {
+                type: string;
+                description: string;
+            };
+            probe: {
+                type: string;
+                default: boolean;
+                description: string;
+            };
+            open: {
+                type: string;
+                default: boolean;
+                description: string;
+            };
+            openIn: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            share: {
+                type: string;
+                default: boolean;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handler(args: {
+    projectPath: string;
+    browser?: string;
+    build?: boolean;
+    distPath?: string;
+    surface?: string;
+    hostUrl?: string;
+    inspectUrl?: string;
+    probe?: boolean;
+    open?: boolean;
+    openIn?: string;
+    share?: boolean;
+}): Promise<string>;

package/dist/src/tools/shares.d.ts

@@ -0,0 +1,51 @@
+export declare const schema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            action: {
+                type: string;
+                enum: string[];
+                default: string;
+                description: string;
+            };
+            artifactId: {
+                type: string;
+                description: string;
+            };
+            url: {
+                type: string;
+                description: string;
+            };
+            projectPath: {
+                type: string;
+                description: string;
+            };
+            status: {
+                type: string;
+                enum: string[];
+                default: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            api: {
+                type: string;
+                description: string;
+            };
+        };
+        required: never[];
+    };
+};
+export declare function handler(args: {
+    action?: string;
+    artifactId?: string;
+    url?: string;
+    projectPath?: string;
+    status?: string;
+    limit?: number;
+    api?: string;
+}): Promise<string>;

package/dist/src/tools/stop.d.ts

@@ -28,7 +28,6 @@ interface StopOutcome {
     stopped: boolean;
     reaped: number[];
     detail: string;
-    /** Set when this stop took the live-preview carrier back out of the project. */
     carrierRemoved?: string;
 }
 export declare function stopOne(projectPath: string, browser: string): Promise<StopOutcome>;

package/dist/src/tools/store-status.d.ts

@@ -36,7 +36,6 @@ interface ReviewView {
     buildId?: string;
     checkedAt?: string;
 }
-/** Latest submissions.json record per store, newest submittedAt first. */
 export declare function latestSubmissionsByStore(json: unknown): Record<string, SubmissionView>;
 export interface NormalizedStoresStatus {
     lastSubmission?: Record<string, unknown>;
@@ -44,14 +43,6 @@ export interface NormalizedStoresStatus {
     reviews: Record<string, ReviewView>;
     lastPollAt?: string;
 }
-/**
- * Accept any historical shape of stores/status.json. SchemaVersion 3 carries
- * lastSubmission / lastOverride / lastPoll / reviews as sections. Legacy v2
- * came in two flavors that used to clobber each other: the submit-path shape
- * (kind "stores_status", lastSubmission only) and the poller shape (kind
- * "store_status" with perStore/updates at the top level) whose updates seed
- * the reviews map here, mirroring the registry template's normalizer.
- */
 export declare function normalizeStoresStatus(json: unknown): NormalizedStoresStatus;
 export declare function handler(args: {
     workspace?: string;

package/dist/src/tools/theme-verify.d.ts

@@ -0,0 +1,22 @@
+export declare const schema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            manifest: {
+                type: string;
+                description: string;
+            };
+            manifestPath: {
+                type: string;
+                description: string;
+            };
+        };
+        required: never[];
+    };
+};
+export declare function handler(args: {
+    manifest?: Record<string, unknown>;
+    manifestPath?: string;
+}): Promise<string>;