@productivemark/snipcss 1.0.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,17 @@
+{
+  "name": "snipcss",
+  "owner": { "name": "SnipCSS" },
+  "metadata": {
+    "description": "CSS extraction and Tailwind conversion tools for Claude Code"
+  },
+  "plugins": [
+    {
+      "name": "snipcss",
+      "source": {
+        "source": "github",
+        "repo": "mrieck/snipcss-playwright-claudeplugin"
+      },
+      "description": "Convert repos to Tailwind or extract pixel-perfect designs from any website. Gives Claude design super-powers via Playwright and SnipCSS."
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,10 @@
+{
+  "name": "snipcss",
+  "description": "Snipcss tools are the most accurate way to convert a repo to tailwind or extract designs from existing websites. The agent can use playwright with SnipCSS on any local or remote url. This plugin allows Claude to use SnipCSS however needed to achieve a goal - whether it's Tailwind conversion or importing pixel-perfect designs, this plugin will give Claude design super-powers.",
+  "version": "1.0.0",
+  "author": { "name": "SnipCSS" },
+  "homepage": "https://www.snipcss.com",
+  "repository": "https://github.com/mrieck/snipcss-playwright-claudeplugin",
+  "license": "UNLICENSED",
+  "keywords": ["css", "tailwind", "extraction", "design"]
+}

package/.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "snipcss": {
+      "command": "npx",
+      "args": ["-y", "@productivemark/snipcss"]
+    }
+  }
+}

package/dist/auth/config-manager.d.ts

@@ -0,0 +1,13 @@
+export interface SnipcssConfig {
+    apiKey?: string;
+    usageCount: number;
+    lastVerified?: string;
+    verifiedPro?: boolean;
+}
+export declare function loadConfig(): SnipcssConfig;
+export declare function saveConfig(config: SnipcssConfig): void;
+export declare function getUsageCount(): number;
+export declare function incrementUsage(): number;
+export declare function setApiKey(key: string): void;
+export declare function getApiKey(): string | undefined;
+//# sourceMappingURL=config-manager.d.ts.map

package/dist/auth/config-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-manager.d.ts","sourceRoot":"","sources":["../../src/auth/config-manager.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AASD,wBAAgB,UAAU,IAAI,aAAa,CAW1C;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAKtD;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,cAAc,IAAI,MAAM,CAKvC;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAO3C;AAED,wBAAgB,SAAS,IAAI,MAAM,GAAG,SAAS,CAE9C"}

package/dist/auth/config-manager.js

@@ -0,0 +1,48 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+const CONFIG_DIR = join(homedir(), '.snipcss');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+const DEFAULT_CONFIG = {
+    usageCount: 0,
+};
+export function loadConfig() {
+    try {
+        if (!existsSync(CONFIG_FILE)) {
+            return { ...DEFAULT_CONFIG };
+        }
+        const raw = readFileSync(CONFIG_FILE, 'utf-8');
+        const parsed = JSON.parse(raw);
+        return { ...DEFAULT_CONFIG, ...parsed };
+    }
+    catch {
+        return { ...DEFAULT_CONFIG };
+    }
+}
+export function saveConfig(config) {
+    if (!existsSync(CONFIG_DIR)) {
+        mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+    writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), 'utf-8');
+}
+export function getUsageCount() {
+    return loadConfig().usageCount;
+}
+export function incrementUsage() {
+    const config = loadConfig();
+    config.usageCount++;
+    saveConfig(config);
+    return config.usageCount;
+}
+export function setApiKey(key) {
+    const config = loadConfig();
+    config.apiKey = key;
+    // Clear cached verification when key changes
+    delete config.lastVerified;
+    delete config.verifiedPro;
+    saveConfig(config);
+}
+export function getApiKey() {
+    return loadConfig().apiKey;
+}
+//# sourceMappingURL=config-manager.js.map

package/dist/auth/config-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-manager.js","sourceRoot":"","sources":["../../src/auth/config-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AACxE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAS7B,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;AAC/C,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAEpD,MAAM,cAAc,GAAkB;IACpC,UAAU,EAAE,CAAC;CACd,CAAC;AAEF,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7B,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;QAC/B,CAAC;QACD,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,OAAO,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;IAC/B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAqB;IAC9C,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IACD,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,UAAU,EAAE,CAAC,UAAU,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,CAAC,UAAU,EAAE,CAAC;IACpB,UAAU,CAAC,MAAM,CAAC,CAAC;IACnB,OAAO,MAAM,CAAC,UAAU,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC;IACpB,6CAA6C;IAC7C,OAAO,MAAM,CAAC,YAAY,CAAC;IAC3B,OAAO,MAAM,CAAC,WAAW,CAAC;IAC1B,UAAU,CAAC,MAAM,CAAC,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,UAAU,EAAE,CAAC,MAAM,CAAC;AAC7B,CAAC"}

package/dist/auth/usage-gate.d.ts

@@ -0,0 +1,13 @@
+export interface AccessResult {
+    allowed: boolean;
+    message?: string;
+    isPro?: boolean;
+    remaining?: number;
+}
+export declare function verifyApiKey(apiKey: string): Promise<{
+    isPro: boolean;
+    email?: string;
+    error?: string;
+}>;
+export declare function checkAccess(): Promise<AccessResult>;
+//# sourceMappingURL=usage-gate.d.ts.map

package/dist/auth/usage-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-gate.d.ts","sourceRoot":"","sources":["../../src/auth/usage-gate.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAe9G;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC,CAoDzD"}

package/dist/auth/usage-gate.js

@@ -0,0 +1,69 @@
+import { loadConfig, saveConfig, incrementUsage } from './config-manager.js';
+const VERIFY_URL = 'https://templates.snipcss.com/api/verify_claude_skill';
+const FREE_LIMIT = 25;
+const CACHE_HOURS = 24;
+export async function verifyApiKey(apiKey) {
+    try {
+        const res = await fetch(VERIFY_URL, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ api_key: apiKey }),
+        });
+        const data = await res.json();
+        if (data.success && data.is_pro) {
+            return { isPro: true, email: data.email };
+        }
+        return { isPro: false, error: data.error || 'Not a Pro account' };
+    }
+    catch (err) {
+        return { isPro: false, error: `Verification failed: ${err.message}` };
+    }
+}
+export async function checkAccess() {
+    const config = loadConfig();
+    // If user has an API key, try to verify Pro status
+    if (config.apiKey) {
+        // Check if we have a cached verification that's still fresh
+        if (config.lastVerified && config.verifiedPro) {
+            const verifiedAt = new Date(config.lastVerified).getTime();
+            const now = Date.now();
+            const hoursSince = (now - verifiedAt) / (1000 * 60 * 60);
+            if (hoursSince < CACHE_HOURS) {
+                return { allowed: true, isPro: true };
+            }
+        }
+        // Verify with the API
+        const result = await verifyApiKey(config.apiKey);
+        if (result.isPro) {
+            config.verifiedPro = true;
+            config.lastVerified = new Date().toISOString();
+            saveConfig(config);
+            return { allowed: true, isPro: true };
+        }
+        // Key exists but not Pro — clear cached status and fall through to free tier
+        config.verifiedPro = false;
+        delete config.lastVerified;
+        saveConfig(config);
+    }
+    // Free tier: check usage count
+    if (config.usageCount < FREE_LIMIT) {
+        const newCount = incrementUsage();
+        const remaining = FREE_LIMIT - newCount;
+        return {
+            allowed: true,
+            isPro: false,
+            remaining,
+            message: remaining <= 3
+                ? `${remaining} free extraction${remaining === 1 ? '' : 's'} remaining. Get unlimited extractions with SnipCSS Pro: https://www.snipcss.com/pricing`
+                : undefined,
+        };
+    }
+    // Over the free limit
+    return {
+        allowed: false,
+        isPro: false,
+        remaining: 0,
+        message: 'You have used all 25 free extractions. To continue, upgrade to SnipCSS Pro at https://www.snipcss.com/pricing and then set your API key using the set_api_key tool. Your API key can be found on your dashboard at https://www.snipcss.com/dashboard',
+    };
+}
+//# sourceMappingURL=usage-gate.js.map

package/dist/auth/usage-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-gate.js","sourceRoot":"","sources":["../../src/auth/usage-gate.ts"],"names":[],"mappings":"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"}

package/dist/browser/browser-manager.d.ts

@@ -0,0 +1,15 @@
+import { Browser, Page, BrowserContext, CDPSession } from 'playwright';
+export interface BrowserPage {
+    page: Page;
+    cdp: CDPSession;
+    context: BrowserContext;
+}
+export declare class BrowserManager {
+    private browser;
+    launch(): Promise<Browser>;
+    createPage(url: string, timeout?: number): Promise<BrowserPage>;
+    closePage(bp: BrowserPage): Promise<void>;
+    close(): Promise<void>;
+    isRunning(): boolean;
+}
+//# sourceMappingURL=browser-manager.d.ts.map

package/dist/browser/browser-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-manager.d.ts","sourceRoot":"","sources":["../../src/browser/browser-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEjF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,IAAI,CAAC;IACX,GAAG,EAAE,UAAU,CAAC;IAChB,OAAO,EAAE,cAAc,CAAC;CACzB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAwB;IAEjC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAgB1B,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,SAAQ,GAAG,OAAO,CAAC,WAAW,CAAC;IA8B9D,SAAS,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAUzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,SAAS,IAAI,OAAO;CAGrB"}

package/dist/browser/browser-manager.js

@@ -0,0 +1,61 @@
+import { chromium } from 'playwright';
+export class BrowserManager {
+    browser = null;
+    async launch() {
+        if (this.browser)
+            return this.browser;
+        this.browser = await chromium.launch({
+            headless: true,
+            args: [
+                '--no-sandbox',
+                '--disable-setuid-sandbox',
+                '--disable-dev-shm-usage',
+                '--disable-gpu',
+            ],
+        });
+        return this.browser;
+    }
+    async createPage(url, timeout = 30000) {
+        if (!this.browser) {
+            await this.launch();
+        }
+        const context = await this.browser.newContext({
+            viewport: { width: 1366, height: 768 },
+            ignoreHTTPSErrors: true,
+        });
+        const page = await context.newPage();
+        // Create CDP session - this replaces chrome.debugger.attach()
+        const cdp = await context.newCDPSession(page);
+        // Enable CDP domains - replaces onDebuggerAttach() from snipbackground.js:306-341
+        await cdp.send('DOM.enable');
+        await cdp.send('CSS.enable');
+        await cdp.send('Network.enable');
+        await cdp.send('Runtime.enable');
+        // Navigate to URL
+        await page.goto(url, {
+            waitUntil: 'networkidle',
+            timeout,
+        });
+        return { page, cdp, context };
+    }
+    async closePage(bp) {
+        try {
+            await bp.cdp.detach();
+        }
+        catch {
+            // CDP session may already be detached
+        }
+        await bp.page.close();
+        await bp.context.close();
+    }
+    async close() {
+        if (this.browser) {
+            await this.browser.close();
+            this.browser = null;
+        }
+    }
+    isRunning() {
+        return this.browser !== null;
+    }
+}
+//# sourceMappingURL=browser-manager.js.map

package/dist/browser/browser-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-manager.js","sourceRoot":"","sources":["../../src/browser/browser-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAA6C,MAAM,YAAY,CAAC;AAQjF,MAAM,OAAO,cAAc;IACjB,OAAO,GAAmB,IAAI,CAAC;IAEvC,KAAK,CAAC,MAAM;QACV,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC;QAEtC,IAAI,CAAC,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;YACnC,QAAQ,EAAE,IAAI;YACd,IAAI,EAAE;gBACJ,cAAc;gBACd,0BAA0B;gBAC1B,yBAAyB;gBACzB,eAAe;aAChB;SACF,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,GAAW,EAAE,OAAO,GAAG,KAAK;QAC3C,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QACtB,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAQ,CAAC,UAAU,CAAC;YAC7C,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;YACtC,iBAAiB,EAAE,IAAI;SACxB,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QAErC,8DAA8D;QAC9D,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAE9C,kFAAkF;QAClF,MAAM,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC7B,MAAM,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC7B,MAAM,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACjC,MAAM,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAEjC,kBAAkB;QAClB,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;YACnB,SAAS,EAAE,aAAa;YACxB,OAAO;SACR,CAAC,CAAC;QAEH,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,EAAe;QAC7B,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,sCAAsC;QACxC,CAAC;QACD,MAAM,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QACtB,MAAM,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC3B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,CAAC;IACH,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC;IAC/B,CAAC;CACF"}

package/dist/browser/viewport-manager.d.ts

@@ -0,0 +1,8 @@
+import { CDPSession } from 'playwright';
+import { ViewportConfig } from '../types/index.js';
+export declare class ViewportManager {
+    setViewport(cdp: CDPSession, viewport: ViewportConfig): Promise<void>;
+    clearViewport(cdp: CDPSession): Promise<void>;
+    getViewportsForOption(option: string, customWidth?: number): ViewportConfig[];
+}
+//# sourceMappingURL=viewport-manager.d.ts.map

package/dist/browser/viewport-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport-manager.d.ts","sourceRoot":"","sources":["../../src/browser/viewport-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,cAAc,EAAqB,MAAM,mBAAmB,CAAC;AAEtE,qBAAa,eAAe;IACpB,WAAW,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBrE,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE;CA0B9E"}

package/dist/browser/viewport-manager.js

@@ -0,0 +1,50 @@
+import { DEFAULT_VIEWPORTS } from '../types/index.js';
+export class ViewportManager {
+    async setViewport(cdp, viewport) {
+        const params = {
+            width: viewport.width,
+            height: viewport.height,
+            deviceScaleFactor: viewport.deviceScaleFactor || 1,
+            mobile: viewport.mobile || false,
+        };
+        await cdp.send('Emulation.setDeviceMetricsOverride', params);
+        if (viewport.userAgent) {
+            await cdp.send('Emulation.setUserAgentOverride', {
+                userAgent: viewport.userAgent,
+            });
+            await cdp.send('Network.setUserAgentOverride', {
+                userAgent: viewport.userAgent,
+            });
+        }
+    }
+    async clearViewport(cdp) {
+        await cdp.send('Emulation.clearDeviceMetricsOverride');
+    }
+    getViewportsForOption(option, customWidth) {
+        switch (option) {
+            case 'desktop':
+                return [DEFAULT_VIEWPORTS.default];
+            case 'tablet':
+                return [DEFAULT_VIEWPORTS.ipad];
+            case 'mobile':
+                return [DEFAULT_VIEWPORTS.iphonexs];
+            case 'all':
+                return [
+                    DEFAULT_VIEWPORTS.default,
+                    DEFAULT_VIEWPORTS.iphonexs,
+                    DEFAULT_VIEWPORTS.ipad,
+                    DEFAULT_VIEWPORTS.ipadlandscape,
+                ];
+            default:
+                if (customWidth) {
+                    return [{
+                            name: `custom-${customWidth}`,
+                            width: customWidth,
+                            height: 768,
+                        }];
+                }
+                return [DEFAULT_VIEWPORTS.default];
+        }
+    }
+}
+//# sourceMappingURL=viewport-manager.js.map

package/dist/browser/viewport-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport-manager.js","sourceRoot":"","sources":["../../src/browser/viewport-manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtE,MAAM,OAAO,eAAe;IAC1B,KAAK,CAAC,WAAW,CAAC,GAAe,EAAE,QAAwB;QACzD,MAAM,MAAM,GAAQ;YAClB,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB,IAAI,CAAC;YAClD,MAAM,EAAE,QAAQ,CAAC,MAAM,IAAI,KAAK;SACjC,CAAC;QAEF,MAAM,GAAG,CAAC,IAAI,CAAC,oCAAoC,EAAE,MAAM,CAAC,CAAC;QAE7D,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;YACvB,MAAM,GAAG,CAAC,IAAI,CAAC,gCAAgC,EAAE;gBAC/C,SAAS,EAAE,QAAQ,CAAC,SAAS;aAC9B,CAAC,CAAC;YACH,MAAM,GAAG,CAAC,IAAI,CAAC,8BAA8B,EAAE;gBAC7C,SAAS,EAAE,QAAQ,CAAC,SAAS;aAC9B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,GAAe;QACjC,MAAM,GAAG,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IACzD,CAAC;IAED,qBAAqB,CAAC,MAAc,EAAE,WAAoB;QACxD,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,SAAS;gBACZ,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;YACrC,KAAK,QAAQ;gBACX,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAClC,KAAK,QAAQ;gBACX,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;YACtC,KAAK,KAAK;gBACR,OAAO;oBACL,iBAAiB,CAAC,OAAO;oBACzB,iBAAiB,CAAC,QAAQ;oBAC1B,iBAAiB,CAAC,IAAI;oBACtB,iBAAiB,CAAC,aAAa;iBAChC,CAAC;YACJ;gBACE,IAAI,WAAW,EAAE,CAAC;oBAChB,OAAO,CAAC;4BACN,IAAI,EAAE,UAAU,WAAW,EAAE;4BAC7B,KAAK,EAAE,WAAW;4BAClB,MAAM,EAAE,GAAG;yBACZ,CAAC,CAAC;gBACL,CAAC;gBACD,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;CACF"}

package/dist/extraction/css-variable-resolver.d.ts

@@ -0,0 +1,27 @@
+import { ExtractionContext } from '../types/index.js';
+/**
+ * Resolves CSS custom properties (variables) to their computed values.
+ * Port of CSS variable resolution from snipbackground.js
+ */
+export declare class CssVariableResolver {
+    /**
+     * Resolve a CSS variable reference like var(--my-color) to its value.
+     * Handles nested var() references recursively.
+     */
+    resolveVar(varName: string, ctx: ExtractionContext, depth?: number): string | null;
+    /**
+     * Replace all var(--xxx) references in a value string with their resolved values.
+     * Handles fallback values like var(--primary, #000).
+     */
+    resolveVarReferences(value: string, ctx: ExtractionContext, depth?: number): string;
+    /**
+     * Generate CSS text for all used CSS variables that need to be defined.
+     * Creates a :root block with the variable definitions that were used.
+     */
+    generateVariablesCss(ctx: ExtractionContext): string;
+    /**
+     * Get all resolved variables as a map.
+     */
+    getResolvedVariables(ctx: ExtractionContext): Record<string, string>;
+}
+//# sourceMappingURL=css-variable-resolver.d.ts.map

package/dist/extraction/css-variable-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-variable-resolver.d.ts","sourceRoot":"","sources":["../../src/extraction/css-variable-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAoB,MAAM,mBAAmB,CAAC;AAExE;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,EAAE,KAAK,SAAI,GAAG,MAAM,GAAG,IAAI;IA8C7E;;;OAGG;IACH,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,EAAE,KAAK,SAAI,GAAG,MAAM;IAmB9E;;;OAGG;IACH,oBAAoB,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM;IAqBpD;;OAEG;IACH,oBAAoB,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAYrE"}

package/dist/extraction/css-variable-resolver.js

@@ -0,0 +1,105 @@
+/**
+ * Resolves CSS custom properties (variables) to their computed values.
+ * Port of CSS variable resolution from snipbackground.js
+ */
+export class CssVariableResolver {
+    /**
+     * Resolve a CSS variable reference like var(--my-color) to its value.
+     * Handles nested var() references recursively.
+     */
+    resolveVar(varName, ctx, depth = 0) {
+        if (depth > 10)
+            return null; // Prevent infinite recursion
+        // Check resolved cache first
+        if (ctx.cssvarResolvedValues[varName]) {
+            return ctx.cssvarResolvedValues[varName];
+        }
+        // Check cssvarAllArr (global :root variables)
+        if (ctx.cssvarAllArr[varName]) {
+            let val = ctx.cssvarAllArr[varName].replace(/;$/, '').trim();
+            // If value contains another var() reference, resolve it
+            if (val.includes('var(')) {
+                val = this.resolveVarReferences(val, ctx, depth + 1);
+            }
+            ctx.cssvarResolvedValues[varName] = val;
+            return val;
+        }
+        // Check cssvarDefinedArr (contextual variables)
+        if (ctx.cssvarDefinedArr[varName] && ctx.cssvarDefinedArr[varName].length > 0) {
+            // Get the most specific definition (prefer global scope)
+            const definitions = ctx.cssvarDefinedArr[varName];
+            let bestDef = null;
+            for (const def of definitions) {
+                if (!bestDef || def.source === 'stylesheet') {
+                    bestDef = def;
+                }
+            }
+            if (bestDef) {
+                let val = bestDef.value.replace(/;$/, '').trim();
+                if (val.includes('var(')) {
+                    val = this.resolveVarReferences(val, ctx, depth + 1);
+                }
+                ctx.cssvarResolvedValues[varName] = val;
+                return val;
+            }
+        }
+        return null;
+    }
+    /**
+     * Replace all var(--xxx) references in a value string with their resolved values.
+     * Handles fallback values like var(--primary, #000).
+     */
+    resolveVarReferences(value, ctx, depth = 0) {
+        if (depth > 10)
+            return value;
+        return value.replace(/var\(\s*(--[a-zA-Z0-9_-]+)(?:\s*,\s*([^)]+))?\s*\)/g, (_match, varName, fallback) => {
+            const resolved = this.resolveVar(varName, ctx, depth);
+            if (resolved !== null)
+                return resolved;
+            if (fallback) {
+                // Fallback may also contain var() references
+                if (fallback.includes('var(')) {
+                    return this.resolveVarReferences(fallback.trim(), ctx, depth + 1);
+                }
+                return fallback.trim();
+            }
+            return _match; // Return original if unresolvable
+        });
+    }
+    /**
+     * Generate CSS text for all used CSS variables that need to be defined.
+     * Creates a :root block with the variable definitions that were used.
+     */
+    generateVariablesCss(ctx) {
+        if (ctx.cssvarUsedArr.length === 0)
+            return '';
+        const lines = [];
+        const addedVars = new Set();
+        for (const varName of ctx.cssvarUsedArr) {
+            if (addedVars.has(varName))
+                continue;
+            const resolved = this.resolveVar(varName, ctx);
+            if (resolved !== null) {
+                lines.push(`  ${varName}: ${resolved};`);
+                addedVars.add(varName);
+            }
+        }
+        if (lines.length === 0)
+            return '';
+        return `:root {\n${lines.join('\n')}\n}`;
+    }
+    /**
+     * Get all resolved variables as a map.
+     */
+    getResolvedVariables(ctx) {
+        const resolved = {};
+        for (const varName of ctx.cssvarUsedArr) {
+            const val = this.resolveVar(varName, ctx);
+            if (val !== null) {
+                resolved[varName] = val;
+            }
+        }
+        return resolved;
+    }
+}
+//# sourceMappingURL=css-variable-resolver.js.map

package/dist/extraction/css-variable-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-variable-resolver.js","sourceRoot":"","sources":["../../src/extraction/css-variable-resolver.ts"],"names":[],"mappings":"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"}

package/dist/extraction/dom-labeler.d.ts

@@ -0,0 +1,26 @@
+import { Page } from 'playwright';
+import { LabelResult } from '../types/index.js';
+/**
+ * Labels DOM elements with unique snipcss marker classes.
+ * Replaces the content script's snipcssLabelSubelements function.
+ * Runs entirely via page.evaluate() - no content script needed.
+ */
+export declare class DomLabeler {
+    /**
+     * Label the target element and all its descendants with unique snipcss classes.
+     * Returns the list of classnames and the HTML.
+     *
+     * Port of snipcssLabelSubelements from sniptools.js
+     */
+    labelElements(page: Page, selector: string): Promise<LabelResult>;
+    /**
+     * Remove all snipcss marker classes from the page DOM.
+     * Called after extraction is complete.
+     */
+    removeLabels(page: Page): Promise<void>;
+    /**
+     * Get the outerHTML of an element after labels have been removed.
+     */
+    getCleanHtml(page: Page, selector: string): Promise<string>;
+}
+//# sourceMappingURL=dom-labeler.d.ts.map

package/dist/extraction/dom-labeler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-labeler.d.ts","sourceRoot":"","sources":["../../src/extraction/dom-labeler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD;;;;GAIG;AACH,qBAAa,UAAU;IACrB;;;;;OAKG;IACG,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAqEvE;;;OAGG;IACG,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB7C;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAkClE"}