wrapguard-mcp 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,80 @@
+export type LocaleSetting = "auto" | "ko" | "en";
+export interface WrapGuardConfig {
+    serverName: string;
+    defaultLocale: LocaleSetting;
+    viewports: number[];
+    allowedHosts: string[];
+    allowedFileRoots: string[];
+    ignoreSelectors: string[];
+    ignorePatterns: string[];
+    timeoutMs: number;
+    browserHeadless: boolean;
+    browserChannel: "auto" | "chromium" | "chrome" | "msedge";
+    allowRemoteUrls: boolean;
+    allowWrites: boolean;
+}
+export interface AuditRequest {
+    target: string;
+    viewports?: number[] | undefined;
+    locale?: LocaleSetting | undefined;
+    ignoreSelectors?: string[] | undefined;
+    screenshotDir?: string | undefined;
+}
+export type WrapIssueKind = "avoidable_midword_wrap" | "unavoidable_long_token" | "forced_newline_inside_word";
+export interface WrapCssSnapshot {
+    wordBreak: string;
+    overflowWrap: string;
+    lineBreak: string;
+    whiteSpace: string;
+    hyphens: string;
+    textWrap: string;
+}
+export interface WrapIssue {
+    kind: WrapIssueKind;
+    severity: "error" | "warning";
+    token: string;
+    locale: "ko" | "en" | "mixed";
+    selector: string;
+    viewport: number;
+    lineCount: number;
+    lineTops: number[];
+    elementWidth: number;
+    estimatedTokenWidth: number;
+    context: string;
+    css: WrapCssSnapshot;
+    suggestion: string;
+}
+export interface ViewportAudit {
+    viewport: number;
+    issueCount: number;
+    errorCount: number;
+    warningCount: number;
+    screenshot?: string;
+}
+export interface AuditReport {
+    version: string;
+    target: string;
+    resolvedTarget: string;
+    serverName: string;
+    generatedAt: string;
+    locale: LocaleSetting;
+    passed: boolean;
+    counts: {
+        errors: number;
+        warnings: number;
+        total: number;
+    };
+    viewports: ViewportAudit[];
+    issues: WrapIssue[];
+}
+export interface CssInspection {
+    selector: string;
+    matched: boolean;
+    computed?: WrapCssSnapshot;
+    matchingRules: Array<{
+        selector: string;
+        declarations: Partial<WrapCssSnapshot>;
+        source: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "wrapguard-mcp",
+  "version": "0.1.0",
+  "description": "MCP server and CLI that detect unnatural Korean and English mid-word wrapping in responsive web pages.",
+  "mcpName": "io.github.yuni9959/wrapguard-mcp",
+  "type": "module",
+  "bin": {
+    "wrapguard-mcp": "dist/stdio.js",
+    "wrapguard": "dist/cli.js",
+    "wrapguard-http": "dist/http.js"
+  },
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "SECURITY.md",
+    "wrapguard.config.example.json"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "start": "node dist/stdio.js",
+    "start:http": "node dist/http.js",
+    "audit": "node dist/cli.js audit",
+    "prepublishOnly": "npm run check && npm test && npm run build"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "keywords": [
+    "mcp",
+    "playwright",
+    "responsive",
+    "typography",
+    "korean",
+    "word-wrap",
+    "accessibility"
+  ],
+  "license": "MIT",
+  "author": "WrapGuard MCP contributors",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Yuni9959/wrapguard-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Yuni9959/wrapguard-mcp/issues"
+  },
+  "homepage": "https://github.com/Yuni9959/wrapguard-mcp#readme",
+  "dependencies": {
+    "@modelcontextprotocol/node": "^2.0.0",
+    "@modelcontextprotocol/server": "^2.0.0",
+    "playwright": "^1.62.1",
+    "zod": "^4.5.4"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/client": "^2.0.0",
+    "@types/node": "^24.3.0",
+    "tsx": "^4.20.5",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.11"
+  }
+}

package/wrapguard.config.example.json

@@ -0,0 +1,24 @@
+{
+  "serverName": "WrapGuard MCP",
+  "defaultLocale": "auto",
+  "viewports": [320, 375, 768, 1024],
+  "allowedHosts": ["localhost", "127.0.0.1"],
+  "allowedFileRoots": ["./fixtures"],
+  "ignoreSelectors": [
+    "code",
+    "pre",
+    "kbd",
+    "samp",
+    "[data-wrapguard-ignore]"
+  ],
+  "ignorePatterns": [
+    "https?://\\S+",
+    "^SHA-?\\d+",
+    "\\b[0-9a-fA-F]{32,}\\b"
+  ],
+  "timeoutMs": 30000,
+  "browserHeadless": true,
+  "browserChannel": "auto",
+  "allowRemoteUrls": false,
+  "allowWrites": false
+}