uicontract 0.1.0

package/dist/fuzzy-match.js

@@ -0,0 +1,134 @@
+/**
+ * Fuzzy string matching utilities for the `uic find` command.
+ *
+ * Implements Levenshtein distance and word-level fuzzy matching so that
+ * queries such as "pase subscribtion" can find "pause-subscription".
+ *
+ * No external dependencies -- everything is computed inline.
+ */
+// ---------------------------------------------------------------------------
+// Levenshtein distance
+// ---------------------------------------------------------------------------
+/**
+ * Compute the Levenshtein edit distance between two strings.
+ * Uses a single-row dynamic-programming approach (O(min(a,b)) space).
+ */
+export function levenshtein(a, b) {
+    if (a === b)
+        return 0;
+    if (a.length === 0)
+        return b.length;
+    if (b.length === 0)
+        return a.length;
+    // Ensure `a` is the shorter string so the row array is small.
+    if (a.length > b.length) {
+        [a, b] = [b, a];
+    }
+    const aLen = a.length;
+    const bLen = b.length;
+    // Previous row of distances (indices 0..aLen).
+    const row = Array.from({ length: aLen + 1 }, (_, i) => i);
+    for (let j = 1; j <= bLen; j++) {
+        let prev = j;
+        for (let i = 1; i <= aLen; i++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            const rowPrev = row[i];
+            const rowCurr = row[i - 1];
+            const val = Math.min(rowPrev + 1, prev + 1, rowCurr + cost);
+            row[i - 1] = prev;
+            prev = val;
+        }
+        row[aLen] = prev;
+    }
+    return row[aLen];
+}
+// ---------------------------------------------------------------------------
+// Tokenisation helpers
+// ---------------------------------------------------------------------------
+/**
+ * Split a string into lowercase tokens. Handles camelCase, PascalCase,
+ * kebab-case, snake_case, dot.separated, and slash/separated paths.
+ *
+ * Examples:
+ *   "handlePauseSubscription" => ["handle", "pause", "subscription"]
+ *   "pause-subscription"     => ["pause", "subscription"]
+ *   "settings.billing"       => ["settings", "billing"]
+ */
+export function tokenize(str) {
+    const spaced = str.replace(/([a-z])([A-Z])/g, '$1 $2');
+    return spaced
+        .split(/[\s\-_./\\:]+/)
+        .map((t) => t.toLowerCase())
+        .filter((t) => t.length > 0);
+}
+// ---------------------------------------------------------------------------
+// Scoring
+// ---------------------------------------------------------------------------
+const PERFECT_SCORE = 1.0;
+const DEFAULT_THRESHOLD = 0.3;
+/**
+ * Compute a similarity score (0..1) between two individual tokens.
+ * 1.0 = identical, 0.0 = completely different.
+ */
+function tokenSimilarity(a, b) {
+    if (a === b)
+        return PERFECT_SCORE;
+    if (a.includes(b) || b.includes(a)) {
+        const longer = Math.max(a.length, b.length);
+        const shorter = Math.min(a.length, b.length);
+        return 0.8 + 0.2 * (shorter / longer);
+    }
+    const maxLen = Math.max(a.length, b.length);
+    if (maxLen === 0)
+        return PERFECT_SCORE;
+    const dist = levenshtein(a, b);
+    return 1 - dist / maxLen;
+}
+/**
+ * Score how well a query matches a single target field.
+ *
+ * Strategy:
+ * 1. Exact substring match on the raw field => high score.
+ * 2. Tokenise both query and field, then find the best token-level
+ *    alignment (each query token matched to the best field token).
+ *
+ * Returns a score in [0, 1]. Higher is better.
+ */
+export function scoreField(query, field) {
+    const qLower = query.toLowerCase();
+    const fLower = field.toLowerCase();
+    if (fLower.includes(qLower)) {
+        return 0.9 + 0.1 * (qLower.length / fLower.length);
+    }
+    const qTokens = tokenize(query);
+    const fTokens = tokenize(field);
+    if (qTokens.length === 0 || fTokens.length === 0)
+        return 0;
+    let totalSim = 0;
+    for (const qt of qTokens) {
+        let bestSim = 0;
+        for (const ft of fTokens) {
+            const sim = tokenSimilarity(qt, ft);
+            if (sim > bestSim)
+                bestSim = sim;
+        }
+        totalSim += bestSim;
+    }
+    return (totalSim / qTokens.length) * 0.85;
+}
+/**
+ * Score a set of fields against a search query using fuzzy matching.
+ * Returns the best score across all fields and whether it exceeds the threshold.
+ */
+export function fuzzyMatchElement(fields, query, threshold = DEFAULT_THRESHOLD) {
+    let bestScore = 0;
+    for (const field of fields) {
+        if (field === null)
+            continue;
+        const s = scoreField(query, field);
+        if (s > bestScore)
+            bestScore = s;
+    }
+    return { score: bestScore, matches: bestScore >= threshold };
+}
+//# sourceMappingURL=fuzzy-match.js.map

package/dist/fuzzy-match.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * uic CLI — makes web app UIs machine-readable.
+ */
+export declare const VERSION = "0.0.0";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+/**
+ * uic CLI — makes web app UIs machine-readable.
+ */
+export const VERSION = '0.0.0';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "uicontract",
+  "version": "0.1.0",
+  "description": "CLI tool that makes web app UIs machine-readable for AI agents",
+  "type": "module",
+  "license": "MIT",
+  "author": "UIC Contributors",
+  "homepage": "https://github.com/sherifkozman/uicontract",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sherifkozman/uicontract.git",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/sherifkozman/uicontract/issues"
+  },
+  "keywords": [
+    "uic",
+    "ui-contracts",
+    "cli",
+    "agent-id",
+    "data-agent-id",
+    "manifest",
+    "accessibility",
+    "testing",
+    "automation"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "uicontract": "./dist/bin/uic.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "dependencies": {
+    "@uicontract/parser-react": "0.1.0",
+    "@uicontract/core": "0.1.0",
+    "@uicontract/parser-vue": "0.1.0",
+    "@uicontract/namer": "0.1.0",
+    "@uicontract/annotator": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src"
+  }
+}