@kerfjs/ui 4.5.0-beta.1 → 5.0.0-beta.100

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kerfjs/ui",
-  "version": "4.5.0-beta.1",
+  "version": "5.0.0-beta.100",
   "description": "Accessible, composable UI primitives for kerf applications.",
   "type": "module",
   "license": "MIT",
@@ -30,20 +30,36 @@
   "bin": {
     "kerf-ui-analyze": "./analyzer/cli.mjs",
     "kerf-ui-doctor": "./doctor/cli.mjs",
-    "kerf-ui-evaluate": "./evaluator/cli.mjs"
+    "kerf-ui-evaluate": "./evaluator/cli.mjs",
+    "kerf-catalog-demo": "./catalog-projection-cli.mjs"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "sideEffects": [
     "**/*.css",
     "./dist/browser/*.js",
-    "./dist/select-register.js"
+    "./dist/select-register.js",
+    "./dist/popup-menu-register.js",
+    "./dist/help-tags-register.js",
+    "./dist/surface-scaffold-register.js"
   ],
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./css-values": {
+      "types": "./dist/css-values.d.ts",
+      "import": "./dist/css-values.js"
+    },
+    "./catalog-projection": {
+      "types": "./catalog-projection.d.mts",
+      "import": "./catalog-projection.mjs"
+    },
+    "./vite-ux-review": {
+      "types": "./vite-ux-review.d.mts",
+      "import": "./vite-ux-review.mjs"
+    },
     "./lucide-icon": {
       "types": "./dist/lucide-icon.d.ts",
       "browser": "./dist/browser/lucide-icon.js",
@@ -54,6 +70,16 @@
       "browser": "./dist/browser/disclosure-arrow.js",
       "import": "./dist/disclosure-arrow.js"
     },
+    "./badge": {
+      "types": "./dist/badge.d.ts",
+      "browser": "./dist/browser/badge.js",
+      "import": "./dist/badge.js"
+    },
+    "./chip": {
+      "types": "./dist/chip.d.ts",
+      "browser": "./dist/browser/chip.js",
+      "import": "./dist/chip.js"
+    },
     "./toolbar": {
       "types": "./dist/toolbar.d.ts",
       "browser": "./dist/browser/toolbar.js",
@@ -64,6 +90,15 @@
       "browser": "./dist/browser/toolbar-control-group.js",
       "import": "./dist/toolbar-control-group.js"
     },
+    "./surface-scaffold": {
+      "types": "./dist/surface-scaffold.d.ts",
+      "browser": "./dist/browser/surface-scaffold.js",
+      "import": "./dist/surface-scaffold.js"
+    },
+    "./surface-scaffold/register": {
+      "types": "./dist/surface-scaffold-register.d.ts",
+      "import": "./dist/surface-scaffold-register.js"
+    },
     "./floating-toolbar": {
       "types": "./dist/floating-toolbar.d.ts",
       "browser": "./dist/browser/floating-toolbar.js",
@@ -74,11 +109,31 @@
       "browser": "./dist/browser/toolbar-text.js",
       "import": "./dist/toolbar-text.js"
     },
+    "./text": {
+      "types": "./dist/text.d.ts",
+      "browser": "./dist/browser/text.js",
+      "import": "./dist/text.js"
+    },
     "./list": {
       "types": "./dist/list.d.ts",
       "browser": "./dist/browser/list.js",
       "import": "./dist/list.js"
     },
+    "./row": {
+      "types": "./dist/row.d.ts",
+      "browser": "./dist/browser/row.js",
+      "import": "./dist/row.js"
+    },
+    "./grid": {
+      "types": "./dist/grid.d.ts",
+      "browser": "./dist/browser/grid.js",
+      "import": "./dist/grid.js"
+    },
+    "./spacer": {
+      "types": "./dist/spacer.d.ts",
+      "browser": "./dist/browser/spacer.js",
+      "import": "./dist/spacer.js"
+    },
     "./list-action-row": {
       "types": "./dist/list-action-row.d.ts",
       "browser": "./dist/browser/list-action-row.js",
@@ -104,6 +159,11 @@
       "browser": "./dist/browser/list-inset-text.js",
       "import": "./dist/list-inset-text.js"
     },
+    "./content-item": {
+      "types": "./dist/content-item.d.ts",
+      "browser": "./dist/browser/content-item.js",
+      "import": "./dist/content-item.js"
+    },
     "./resizable-region": {
       "types": "./dist/resizable-region.d.ts",
       "browser": "./dist/browser/resizable-region.js",
@@ -124,6 +184,7 @@
     },
     "./catalog": {
       "types": "./dist/catalog.d.ts",
+      "browser": "./dist/browser/catalog.js",
       "import": "./dist/catalog.js"
     },
     "./catalog-resources": {
@@ -159,16 +220,38 @@
       "types": "./dist/wire-tab-bars.d.ts",
       "import": "./dist/wire-tab-bars.js"
     },
+    "./wire-scroll-dividers": {
+      "types": "./dist/wire-scroll-dividers.d.ts",
+      "import": "./dist/wire-scroll-dividers.js"
+    },
+    "./wire-list-reorder": {
+      "types": "./dist/wire-list-reorder.d.ts",
+      "import": "./dist/wire-list-reorder.js"
+    },
+    "./wire-list-focus-scroll": {
+      "types": "./dist/wire-list-focus-scroll.d.ts",
+      "import": "./dist/wire-list-focus-scroll.js"
+    },
+    "./wire-toolbar-visibility": {
+      "types": "./dist/wire-toolbar-visibility.d.ts",
+      "import": "./dist/wire-toolbar-visibility.js"
+    },
     "./nav-stack": {
       "types": "./dist/nav-stack.d.ts",
+      "browser": "./dist/browser/nav-stack.js",
       "import": "./dist/nav-stack.js"
     },
     "./wire-nav-stack": {
       "types": "./dist/wire-nav-stack.d.ts",
       "import": "./dist/wire-nav-stack.js"
     },
+    "./wire-content-items": {
+      "types": "./dist/wire-content-items.d.ts",
+      "import": "./dist/wire-content-items.js"
+    },
     "./split-view": {
       "types": "./dist/split-view.d.ts",
+      "browser": "./dist/browser/split-view.js",
       "import": "./dist/split-view.js"
     },
     "./pane": {
@@ -178,23 +261,30 @@
     },
     "./workbench": {
       "types": "./dist/workbench.d.ts",
+      "browser": "./dist/browser/workbench.js",
       "import": "./dist/workbench.js"
     },
     "./collapsible-panel": {
       "types": "./dist/collapsible-panel.d.ts",
+      "browser": "./dist/browser/collapsible-panel.js",
       "import": "./dist/collapsible-panel.js"
     },
     "./wire-sidebar": {
       "types": "./dist/wire-sidebar.d.ts",
       "import": "./dist/wire-sidebar.js"
     },
-    "./tab-scaffold": {
-      "types": "./dist/tab-scaffold.d.ts",
-      "import": "./dist/tab-scaffold.js"
+    "./tab-navigator": {
+      "types": "./dist/tab-navigator.d.ts",
+      "browser": "./dist/browser/tab-navigator.js",
+      "import": "./dist/tab-navigator.js"
+    },
+    "./wire-tab-navigator": {
+      "types": "./dist/wire-tab-navigator.d.ts",
+      "import": "./dist/wire-tab-navigator.js"
     },
-    "./wire-tab-scaffold": {
-      "types": "./dist/wire-tab-scaffold.d.ts",
-      "import": "./dist/wire-tab-scaffold.js"
+    "./wire-workbench": {
+      "types": "./dist/wire-workbench.d.ts",
+      "import": "./dist/wire-workbench.js"
     },
     "./loading-spinner": {
       "types": "./dist/loading-spinner.d.ts",
@@ -221,23 +311,126 @@
       "browser": "./dist/browser/segmented-control.js",
       "import": "./dist/segmented-control.js"
     },
+    "./choice-chips": {
+      "types": "./dist/choice-chips.d.ts",
+      "browser": "./dist/browser/choice-chips.js",
+      "import": "./dist/choice-chips.js"
+    },
+    "./composer": {
+      "types": "./dist/composer.d.ts",
+      "browser": "./dist/browser/composer.js",
+      "import": "./dist/composer.js"
+    },
+    "./wire-composers": {
+      "types": "./dist/wire-composers.d.ts",
+      "import": "./dist/wire-composers.js"
+    },
     "./token-search-field": {
       "types": "./dist/token-search-field.d.ts",
       "browser": "./dist/browser/token-search-field.js",
       "import": "./dist/token-search-field.js"
     },
+    "./token-search-model": {
+      "types": "./dist/token-search-model.d.ts",
+      "import": "./dist/token-search-model.js"
+    },
     "./wire-token-search-fields": {
       "types": "./dist/wire-token-search-fields.d.ts",
       "import": "./dist/wire-token-search-fields.js"
     },
+    "./popup-menu": {
+      "types": "./dist/popup-menu.d.ts",
+      "browser": "./dist/browser/popup-menu.js",
+      "import": "./dist/popup-menu.js"
+    },
+    "./anchored-surface": {
+      "types": "./dist/anchored-surface.d.ts",
+      "browser": "./dist/browser/anchored-surface.js",
+      "import": "./dist/anchored-surface.js"
+    },
+    "./popup-menu/register": {
+      "types": "./dist/popup-menu-register.d.ts",
+      "import": "./dist/popup-menu-register.js"
+    },
     "./select/register": {
       "types": "./dist/select-register.d.ts",
       "import": "./dist/select-register.js"
     },
+    "./help-tags/register": {
+      "types": "./dist/help-tags-register.d.ts",
+      "import": "./dist/help-tags-register.js"
+    },
     "./webawesome": {
       "types": "./dist/webawesome.d.ts",
       "import": "./dist/webawesome.js"
     },
+    "./summary-row": {
+      "types": "./dist/summary-row.d.ts",
+      "browser": "./dist/browser/summary-row.js",
+      "import": "./dist/summary-row.js"
+    },
+    "./framed-list": {
+      "types": "./dist/framed-list.d.ts",
+      "browser": "./dist/browser/framed-list.js",
+      "import": "./dist/framed-list.js"
+    },
+    "./split-button": {
+      "types": "./dist/split-button.d.ts",
+      "browser": "./dist/browser/split-button.js",
+      "import": "./dist/split-button.js"
+    },
+    "./icon-toggle-button": {
+      "types": "./dist/icon-toggle-button.d.ts",
+      "browser": "./dist/browser/icon-toggle-button.js",
+      "import": "./dist/icon-toggle-button.js"
+    },
+    "./icon-button": {
+      "types": "./dist/icon-button.d.ts",
+      "browser": "./dist/browser/icon-button.js",
+      "import": "./dist/icon-button.js"
+    },
+    "./edge-activity-indicator": {
+      "types": "./dist/edge-activity-indicator.d.ts",
+      "browser": "./dist/browser/edge-activity-indicator.js",
+      "import": "./dist/edge-activity-indicator.js"
+    },
+    "./combobox": {
+      "types": "./dist/combobox.d.ts",
+      "browser": "./dist/browser/combobox.js",
+      "import": "./dist/combobox.js"
+    },
+    "./wire-comboboxes": {
+      "types": "./dist/wire-comboboxes.d.ts",
+      "import": "./dist/wire-comboboxes.js"
+    },
+    "./file-picker": {
+      "types": "./dist/file-picker.d.ts",
+      "browser": "./dist/browser/file-picker.js",
+      "import": "./dist/file-picker.js"
+    },
+    "./wire-file-pickers": {
+      "types": "./dist/wire-file-pickers.d.ts",
+      "import": "./dist/wire-file-pickers.js"
+    },
+    "./content-swap": {
+      "types": "./dist/content-swap.d.ts",
+      "browser": "./dist/browser/content-swap.js",
+      "import": "./dist/content-swap.js"
+    },
+    "./column-track": {
+      "types": "./dist/column-track.d.ts",
+      "browser": "./dist/browser/column-track.js",
+      "import": "./dist/column-track.js"
+    },
+    "./corner-status": {
+      "types": "./dist/corner-status.d.ts",
+      "browser": "./dist/browser/corner-status.js",
+      "import": "./dist/corner-status.js"
+    },
+    "./wire-corner-status": {
+      "types": "./dist/wire-corner-status.d.ts",
+      "import": "./dist/wire-corner-status.js"
+    },
     "./state-banner": {
       "types": "./dist/state-banner.d.ts",
       "browser": "./dist/browser/state-banner.js",
@@ -248,11 +441,6 @@
       "browser": "./dist/browser/empty-state.js",
       "import": "./dist/empty-state.js"
     },
-    "./panel-header": {
-      "types": "./dist/panel-header.d.ts",
-      "browser": "./dist/browser/panel-header.js",
-      "import": "./dist/panel-header.js"
-    },
     "./value-table": {
       "types": "./dist/value-table.d.ts",
       "browser": "./dist/browser/value-table.js",
@@ -263,21 +451,30 @@
       "import": "./dist/index.js"
     },
     "./foundation.css": "./dist/styles/foundation.css",
+    "./document.css": "./dist/styles/document.css",
     "./layout.css": "./dist/styles/layout.css",
     "./webawesome.css": "./dist/styles/webawesome.css",
     "./styles.css": "./dist/styles/styles.css",
     "./lucide-icon.css": "./dist/styles/lucide-icon.css",
+    "./badge.css": "./dist/styles/badge.css",
+    "./chip.css": "./dist/styles/chip.css",
     "./disclosure-arrow.css": "./dist/styles/disclosure-arrow.css",
     "./toolbar.css": "./dist/styles/toolbar.css",
     "./toolbar-control-group.css": "./dist/styles/toolbar-control-group.css",
+    "./surface-scaffold.css": "./dist/styles/surface-scaffold.css",
     "./floating-toolbar.css": "./dist/styles/floating-toolbar.css",
     "./toolbar-text.css": "./dist/styles/toolbar-text.css",
+    "./text.css": "./dist/styles/text.css",
     "./list.css": "./dist/styles/list.css",
+    "./row.css": "./dist/styles/row.css",
+    "./grid.css": "./dist/styles/grid.css",
+    "./spacer.css": "./dist/styles/spacer.css",
     "./list-action-row.css": "./dist/styles/list-action-row.css",
     "./list-item.css": "./dist/styles/list-item.css",
     "./list-header.css": "./dist/styles/list-header.css",
     "./list-inset-control.css": "./dist/styles/list-inset-control.css",
     "./list-inset-text.css": "./dist/styles/list-inset-text.css",
+    "./content-item.css": "./dist/styles/content-item.css",
     "./resizable-region.css": "./dist/styles/resizable-region.css",
     "./app-tab.css": "./dist/styles/app-tab.css",
     "./catalog.css": "./dist/styles/catalog.css",
@@ -287,16 +484,30 @@
     "./pane.css": "./dist/styles/pane.css",
     "./workbench.css": "./dist/styles/workbench.css",
     "./collapsible-panel.css": "./dist/styles/collapsible-panel.css",
-    "./tab-scaffold.css": "./dist/styles/tab-scaffold.css",
+    "./tab-navigator.css": "./dist/styles/tab-navigator.css",
     "./loading-spinner.css": "./dist/styles/loading-spinner.css",
     "./select.css": "./dist/styles/select.css",
+    "./popup-menu.css": "./dist/styles/popup-menu.css",
+    "./anchored-surface.css": "./dist/styles/anchored-surface.css",
     "./skeleton.css": "./dist/styles/skeleton.css",
     "./sunken-panel.css": "./dist/styles/sunken-panel.css",
     "./segmented-control.css": "./dist/styles/segmented-control.css",
+    "./choice-chips.css": "./dist/styles/choice-chips.css",
+    "./composer.css": "./dist/styles/composer.css",
     "./token-search-field.css": "./dist/styles/token-search-field.css",
     "./state-banner.css": "./dist/styles/state-banner.css",
+    "./corner-status.css": "./dist/styles/corner-status.css",
+    "./column-track.css": "./dist/styles/column-track.css",
+    "./content-swap.css": "./dist/styles/content-swap.css",
+    "./file-picker.css": "./dist/styles/file-picker.css",
+    "./combobox.css": "./dist/styles/combobox.css",
+    "./edge-activity-indicator.css": "./dist/styles/edge-activity-indicator.css",
+    "./icon-button.css": "./dist/styles/icon-button.css",
+    "./icon-toggle-button.css": "./dist/styles/icon-toggle-button.css",
+    "./split-button.css": "./dist/styles/split-button.css",
+    "./framed-list.css": "./dist/styles/framed-list.css",
+    "./summary-row.css": "./dist/styles/summary-row.css",
     "./empty-state.css": "./dist/styles/empty-state.css",
-    "./panel-header.css": "./dist/styles/panel-header.css",
     "./value-table.css": "./dist/styles/value-table.css",
     "./ai/*": "./ai/*",
     "./docs/*": "./docs/*"
@@ -304,6 +515,12 @@
   "files": [
     "dist",
     "ai",
+    "catalog-projection.mjs",
+    "catalog-projection.d.mts",
+    "catalog-projection-cli.mjs",
+    "vite-ux-review.mjs",
+    "vite-ux-review.d.mts",
+    "scripts/component-catalog-extension-validation.mjs",
     "analyzer",
     "doctor",
     "evaluator",
@@ -317,22 +534,32 @@
   "scripts": {
     "build": "tsup && node ../scripts/clean-dist-output.mjs dist && node scripts/build-css.mjs && node scripts/build-browser-entries.mjs",
     "dev": "npm run build && vite --config ux-demo/vite.config.ts",
-    "demo:build": "npm run build && vite build --config ux-demo/vite.config.ts && node scripts/check-demo-bundle.mjs",
+    "demo:bundle": "npm run build && vite build --config ux-demo/vite.config.ts",
+    "demo:build": "npm run demo:bundle && node scripts/check-demo-bundle.mjs",
     "demo:serve": "vite preview --config ux-demo/vite.config.ts",
+    "test:e2e:serve": "npm run check:catalog && npm run check:demo-conformance && npm run demo:build && npm run demo:serve",
     "format": "prettier --write . --ignore-unknown",
     "format:css": "prettier --write \"src/**/*.css\" \"ux-demo/**/*.css\"",
     "check:format": "prettier --check . --ignore-unknown",
-    "catalog:sync": "node scripts/sync-component-catalog.mjs && node scripts/sync-component-catalog-v2.mjs",
-    "catalog:v2:sync": "node scripts/sync-component-catalog-v2.mjs",
-    "check:catalog": "node scripts/sync-component-catalog.mjs --check && node scripts/sync-component-catalog-v2.mjs --check && node scripts/check-component-catalog.mjs",
+    "catalog:sync": "node scripts/sync-component-catalog.mjs && node scripts/sync-component-composition.mjs && node scripts/sync-component-docs.mjs",
+    "composition:sync": "node scripts/sync-component-composition.mjs && node scripts/sync-component-docs.mjs",
+    "check:component-integrations": "node scripts/check-component-integrations.mjs",
+    "component-integrations:dry-run": "node scripts/check-component-integrations.mjs --dry-run",
+    "check:change": "node scripts/check-ui-change.mjs",
+    "check:catalog": "node scripts/sync-component-catalog.mjs --check && node scripts/sync-component-composition.mjs --check && node scripts/sync-component-docs.mjs --check && node scripts/check-component-catalog.mjs",
     "check:profile": "node scripts/check-application-ui-profile.mjs",
     "check:demo-conformance": "node scripts/check-catalog-demo-conformance.mjs",
     "check:recipes": "node scripts/check-recipes.mjs",
+    "check:css-ownership": "node scripts/check-css-ownership.mjs",
+    "check:source-organization": "node scripts/check-source-organization.mjs",
     "check:ai-regressions": "node scripts/check-ai-regressions.mjs && node scripts/audit-ai-regression-results.mjs && node scripts/audit-ai-regression-results-v3.mjs",
     "check:ai-signatures": "node scripts/sync-ai-public-signatures.mjs --check",
     "ai:signatures:sync": "npm run build && node scripts/sync-ai-public-signatures.mjs",
+    "check:ai-compatibility": "node scripts/sync-ai-compatibility.mjs",
+    "ai:compatibility:sync": "node scripts/sync-ai-compatibility.mjs --write",
     "ai:regressions:compile": "node scripts/compile-ai-regression-response.mjs",
     "ai:regressions:prepare": "node scripts/prepare-ai-regression.mjs",
+    "ai:regressions:measure-context": "node scripts/measure-ai-regression-context.mjs",
     "ai:regressions:record": "node scripts/record-ai-regression-run.mjs",
     "ai:regressions:record-v3": "node scripts/record-ai-regression-run-v3.mjs",
     "ai:regressions:replay-v3": "node scripts/replay-ai-regression-run-v3.mjs",
@@ -341,17 +568,19 @@
     "lint:eslint": "eslint src tests ux-demo docs/examples --max-warnings 0",
     "lint": "npm run lint:eslint && npm run check:format",
     "typecheck": "node node_modules/typescript7/bin/tsc --noEmit",
-    "test": "npm run test:unit && npm run test:bundle && npm run test:analyzer && npm run test:doctor && npm run test:evaluator",
+    "test": "npm run test:unit && npm run test:bundle && npm run test:analyzer && npm run test:doctor && npm run test:evaluator && npm run test:ai-regressions",
     "test:unit": "vitest run tests/unit --coverage",
     "test:bundle": "npm run build && vitest run tests/bundle",
     "test:analyzer": "vitest run tests/integration/ui-analyzer-downstream.test.ts",
-    "test:doctor": "vitest run tests/unit/ui-doctor.test.ts tests/integration/ui-doctor-downstream.test.ts",
+    "test:doctor": "vitest run tests/unit/ui-doctor.test.ts tests/unit/ui-doctor-component-styles.test.ts tests/integration/ui-doctor-downstream.test.ts",
     "test:evaluator": "vitest run tests/unit/ui-evaluator.test.ts tests/integration/ui-evaluator-downstream.test.ts",
+    "test:ai-regressions": "vitest run tests/integration/ai-regressions-v3.test.ts",
     "test:contract-types:source": "node node_modules/typescript7/bin/tsc -p tests/consumer-types/contracts/tsconfig.source.json",
     "test:contract-types:packed": "node scripts/check-packed-type-contracts.mjs",
     "test:consumer-types": "npm run test:contract-types:source && npm run build && node node_modules/typescript7/bin/tsc -p tests/consumer-types/webawesome/tsconfig.json && npm run test:contract-types:packed",
-    "test:e2e": "npm run demo:build && playwright test",
-    "check": "npm run check:catalog && npm run check:profile && npm run check:demo-conformance && npm run check:recipes && npm run check:guidance && npm run check:ai-regressions && npm run lint && npm run typecheck && npm test && npm run test:consumer-types && npm run check:ai-signatures && npm run demo:build && npm run check:design-templates && npm pack --dry-run",
+    "test:e2e": "playwright test",
+    "bench:micro": "vitest bench --run tests/bench",
+    "check": "npm run check:source-organization && npm run check:catalog && npm run check:component-integrations && npm run check:profile && npm run check:demo-conformance && npm run check:recipes && npm run check:css-ownership && npm run check:guidance && npm run check:ai-compatibility && npm run check:ai-regressions && npm run lint && npm run typecheck && npm test && npm run test:consumer-types && npm run check:ai-signatures && npm run demo:build && npm run check:design-templates && npm pack --dry-run",
     "prepublishOnly": "npm run check",
     "check:design-templates": "node scripts/check-design-templates.mjs",
     "check:design-templates:drift": "node scripts/check-design-templates-drift.mjs",
@@ -359,7 +588,7 @@
   },
   "peerDependencies": {
     "@awesome.me/webawesome": "^3.12.0",
-    "kerfjs": "^4.0.0-0",
+    "kerfjs": "^5.0.0-0",
     "lucide": "^1.43.0",
     "playwright": "^1.63.0"
   },
@@ -372,6 +601,7 @@
     }
   },
   "dependencies": {
+    "@floating-ui/dom": "^1.8.0",
     "postcss": "^8.5.28",
     "typescript": "^6.0.3"
   },
@@ -383,6 +613,7 @@
     "@typescript-eslint/eslint-plugin": "^8.65.0",
     "@typescript-eslint/parser": "^8.65.0",
     "@vitest/coverage-v8": "4.1.11",
+    "axe-core": "^4.14.0",
     "domotion-svg": "^0.30.1",
     "esbuild": "^0.25.0",
     "eslint": "^10.8.0",

package/scripts/component-catalog-extension-validation.mjs

@@ -0,0 +1,28 @@
+export function validateCatalogExtensionReferences(extension, kerfCatalog) {
+  const failures = [];
+  const kerfIds = new Set(kerfCatalog.entries.map(({ id }) => id));
+  const extensionIds = new Set(extension.entries.map(({ id }) => id));
+  const knownIds = new Set([...kerfIds, ...extensionIds]);
+  const seenExtensionIds = new Set();
+
+  for (const entry of extension.entries) {
+    if (seenExtensionIds.has(entry.id))
+      failures.push(`${entry.id} duplicates a consumer catalog id`);
+    seenExtensionIds.add(entry.id);
+    if (kerfIds.has(entry.id))
+      failures.push(`${entry.id} duplicates a Kerf catalog id`);
+    for (const dependency of entry.uses ?? []) {
+      if (!knownIds.has(dependency))
+        failures.push(`${entry.id} uses unknown entry ${dependency}`);
+    }
+  }
+
+  return failures;
+}
+
+const repositoryPathPattern =
+  /^(?!.*(?:^|\/)\.{1,2}(?:\/|$))[A-Za-z0-9._-]+(?:\/[A-Za-z0-9._-]+)*$/;
+
+export function isRepositoryPath(value) {
+  return typeof value === 'string' && repositoryPathPattern.test(value);
+}

package/traversal-exclusions.mjs

@@ -1,12 +1,16 @@
-import { relative, sep } from 'node:path';
+import { execFile } from 'node:child_process';
+import { dirname, relative, resolve, sep } from 'node:path';
 
 export const UI_TRAVERSAL_IGNORED_DIRECTORY_NAMES = Object.freeze([
   '.git',
   '.kerf-cache',
+  'blob-report',
   'coverage',
   'dist',
   'kerf-ui-evidence',
   'node_modules',
+  'playwright-report',
+  'test-results',
 ]);
 const ignoredDirectoryNames = new Set(UI_TRAVERSAL_IGNORED_DIRECTORY_NAMES);
 
@@ -25,3 +29,58 @@ export function isUiTraversalExcluded(root, candidate) {
     )
   );
 }
+
+/**
+ * Lists the Git-ignored files and directories below `root`, relative to it
+ * and `/`-separated, with directories ending in `/`. Generated output that a
+ * project gitignores (test reports, build caches) is not application source,
+ * so a local tool run must not change what full traversal analyzes. Outside a
+ * Git work tree, or without a `git` binary, nothing is reported.
+ */
+export function listGitIgnoredPaths(root) {
+  return new Promise((done) => {
+    execFile(
+      'git',
+      [
+        'ls-files',
+        '-z',
+        '--others',
+        '--ignored',
+        '--exclude-standard',
+        '--directory',
+      ],
+      { cwd: root, maxBuffer: 64 * 1024 * 1024 },
+      (error, stdout) =>
+        done(error ? [] : String(stdout).split('\0').filter(Boolean)),
+    );
+  });
+}
+
+/**
+ * Builds the complete traversal predicate for `root`: the named
+ * generated/tool-owned directories plus every Git-ignored path.
+ */
+export async function createUiTraversalFilter(root) {
+  const listed = await listGitIgnoredPaths(root);
+  const ignored = new Set(
+    listed.map((path) => resolve(root, path.replace(/\/$/, ''))),
+  );
+  const excluded = (candidate) => {
+    if (isUiTraversalExcluded(root, candidate)) return true;
+    for (let path = resolve(candidate); ;) {
+      if (ignored.has(path)) return true;
+      const parent = dirname(path);
+      if (parent === path || relative(root, parent).startsWith('..'))
+        return false;
+      path = parent;
+    }
+  };
+  excluded.eslintIgnores = [
+    ...UI_TRAVERSAL_ESLINT_IGNORES,
+    ...listed.map((path) => {
+      const escaped = path.replace(/[\\*?[\]{}()!+@]/g, '\\$&');
+      return escaped.endsWith('/') ? `${escaped}**` : escaped;
+    }),
+  ];
+  return excluded;
+}