@kerfjs/ui 5.0.0-beta.6 → 5.0.0-beta.61

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kerfjs/ui",
-  "version": "5.0.0-beta.6",
+  "version": "5.0.0-beta.61",
   "description": "Accessible, composable UI primitives for kerf applications.",
   "type": "module",
   "license": "MIT",
@@ -27,18 +27,29 @@
   "publishConfig": {
     "access": "public"
   },
+  "bin": {
+    "kerf-ui-analyze": "./analyzer/cli.mjs",
+    "kerf-ui-doctor": "./doctor/cli.mjs",
+    "kerf-ui-evaluate": "./evaluator/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"
   ],
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./css-values": {
+      "types": "./dist/css-values.d.ts",
+      "import": "./dist/css-values.js"
+    },
     "./lucide-icon": {
       "types": "./dist/lucide-icon.d.ts",
       "browser": "./dist/browser/lucide-icon.js",
@@ -49,6 +60,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",
@@ -59,25 +80,75 @@
       "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"
+    },
+    "./floating-toolbar": {
+      "types": "./dist/floating-toolbar.d.ts",
+      "browser": "./dist/browser/floating-toolbar.js",
+      "import": "./dist/floating-toolbar.js"
+    },
     "./toolbar-text": {
       "types": "./dist/toolbar-text.d.ts",
       "browser": "./dist/browser/toolbar-text.js",
       "import": "./dist/toolbar-text.js"
     },
-    "./menu-action-row": {
-      "types": "./dist/menu-action-row.d.ts",
-      "browser": "./dist/browser/menu-action-row.js",
-      "import": "./dist/menu-action-row.js"
-    },
-    "./menu-item": {
-      "types": "./dist/menu-item.d.ts",
-      "browser": "./dist/browser/menu-item.js",
-      "import": "./dist/menu-item.js"
-    },
-    "./menu-header": {
-      "types": "./dist/menu-header.d.ts",
-      "browser": "./dist/browser/menu-header.js",
-      "import": "./dist/menu-header.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",
+      "import": "./dist/list-action-row.js"
+    },
+    "./list-item": {
+      "types": "./dist/list-item.d.ts",
+      "browser": "./dist/browser/list-item.js",
+      "import": "./dist/list-item.js"
+    },
+    "./list-header": {
+      "types": "./dist/list-header.d.ts",
+      "browser": "./dist/browser/list-header.js",
+      "import": "./dist/list-header.js"
+    },
+    "./list-inset-control": {
+      "types": "./dist/list-inset-control.d.ts",
+      "browser": "./dist/browser/list-inset-control.js",
+      "import": "./dist/list-inset-control.js"
+    },
+    "./list-inset-text": {
+      "types": "./dist/list-inset-text.d.ts",
+      "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",
@@ -97,6 +168,35 @@
       "browser": "./dist/browser/app-tab.js",
       "import": "./dist/app-tab.js"
     },
+    "./catalog": {
+      "types": "./dist/catalog.d.ts",
+      "browser": "./dist/browser/catalog.js",
+      "import": "./dist/catalog.js"
+    },
+    "./catalog-resources": {
+      "types": "./dist/catalog-resources.d.ts",
+      "import": "./dist/catalog-resources.js"
+    },
+    "./analyzer": {
+      "types": "./analyzer/index.d.mts",
+      "import": "./analyzer/index.mjs"
+    },
+    "./analyzer/report.schema.json": "./analyzer/report.schema.json",
+    "./doctor": {
+      "types": "./doctor/index.d.mts",
+      "import": "./doctor/index.mjs"
+    },
+    "./doctor/config.schema.json": "./doctor/config.schema.json",
+    "./doctor/report.schema.json": "./doctor/report.schema.json",
+    "./evaluator": {
+      "types": "./evaluator/index.d.mts",
+      "import": "./evaluator/index.mjs"
+    },
+    "./evaluator/report.schema.json": "./evaluator/report.schema.json",
+    "./wire-catalog": {
+      "types": "./dist/wire-catalog.d.ts",
+      "import": "./dist/wire-catalog.js"
+    },
     "./tab-bar": {
       "types": "./dist/tab-bar.d.ts",
       "browser": "./dist/browser/tab-bar.js",
@@ -106,8 +206,13 @@
       "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"
+    },
     "./nav-stack": {
       "types": "./dist/nav-stack.d.ts",
+      "browser": "./dist/browser/nav-stack.js",
       "import": "./dist/nav-stack.js"
     },
     "./wire-nav-stack": {
@@ -116,20 +221,41 @@
     },
     "./split-view": {
       "types": "./dist/split-view.d.ts",
+      "browser": "./dist/browser/split-view.js",
       "import": "./dist/split-view.js"
     },
+    "./pane": {
+      "types": "./dist/pane.d.ts",
+      "browser": "./dist/browser/pane.js",
+      "import": "./dist/pane.js"
+    },
     "./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",
+      "browser": "./dist/browser/tab-scaffold.js",
       "import": "./dist/tab-scaffold.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",
       "browser": "./dist/browser/loading-spinner.js",
@@ -140,6 +266,16 @@
       "browser": "./dist/browser/select.js",
       "import": "./dist/select.js"
     },
+    "./skeleton": {
+      "types": "./dist/skeleton.d.ts",
+      "browser": "./dist/browser/skeleton.js",
+      "import": "./dist/skeleton.js"
+    },
+    "./sunken-panel": {
+      "types": "./dist/sunken-panel.d.ts",
+      "browser": "./dist/browser/sunken-panel.js",
+      "import": "./dist/sunken-panel.js"
+    },
     "./segmented-control": {
       "types": "./dist/segmented-control.d.ts",
       "browser": "./dist/browser/segmented-control.js",
@@ -150,14 +286,31 @@
       "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"
+    },
+    "./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"
@@ -172,11 +325,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",
@@ -187,31 +335,49 @@
       "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",
-    "./menu-action-row.css": "./dist/styles/menu-action-row.css",
-    "./menu-item.css": "./dist/styles/menu-item.css",
-    "./menu-header.css": "./dist/styles/menu-header.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",
     "./tab-bar.css": "./dist/styles/tab-bar.css",
     "./nav-stack.css": "./dist/styles/nav-stack.css",
     "./split-view.css": "./dist/styles/split-view.css",
+    "./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",
     "./loading-spinner.css": "./dist/styles/loading-spinner.css",
     "./select.css": "./dist/styles/select.css",
+    "./popup-menu.css": "./dist/styles/popup-menu.css",
+    "./skeleton.css": "./dist/styles/skeleton.css",
+    "./sunken-panel.css": "./dist/styles/sunken-panel.css",
     "./segmented-control.css": "./dist/styles/segmented-control.css",
     "./token-search-field.css": "./dist/styles/token-search-field.css",
     "./state-banner.css": "./dist/styles/state-banner.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/*"
@@ -219,6 +385,10 @@
   "files": [
     "dist",
     "ai",
+    "analyzer",
+    "doctor",
+    "evaluator",
+    "traversal-exclusions.mjs",
     "docs",
     "ux-demo/recipes",
     "llms.txt",
@@ -228,41 +398,74 @@
   "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 \"src/**/*.css\" \"ux-demo/**/*.css\"",
-    "catalog:sync": "node scripts/sync-component-catalog.mjs",
-    "check:catalog": "node scripts/sync-component-catalog.mjs --check && node scripts/check-component-catalog.mjs",
+    "check:format": "prettier --check . --ignore-unknown",
+    "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:ai-regressions": "node scripts/check-ai-regressions.mjs && node scripts/audit-ai-regression-results.mjs",
+    "check:css-ownership": "node scripts/check-css-ownership.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",
     "ai:regressions:score": "node scripts/score-ai-regression.mjs",
     "check:guidance": "node scripts/check-decision-guidance.mjs",
-    "lint": "eslint src tests ux-demo docs/examples --max-warnings 0",
+    "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",
+    "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:consumer-types": "npm run build && node node_modules/typescript7/bin/tsc -p tests/consumer-types/webawesome/tsconfig.json",
-    "test:e2e": "npm run demo:build && playwright test",
-    "check": "npm run check:format && npm run check:catalog && 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 pack --dry-run",
-    "prepublishOnly": "npm run check"
+    "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: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": "playwright test",
+    "check": "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",
+    "design-templates:build": "node scripts/build-design-templates.mjs"
   },
   "peerDependencies": {
     "@awesome.me/webawesome": "^3.12.0",
     "kerfjs": "^5.0.0-0",
-    "lucide": "^1.43.0"
+    "lucide": "^1.43.0",
+    "playwright": "^1.63.0"
   },
   "peerDependenciesMeta": {
     "@awesome.me/webawesome": {
       "optional": true
+    },
+    "playwright": {
+      "optional": true
     }
   },
+  "dependencies": {
+    "postcss": "^8.5.28",
+    "typescript": "^6.0.3"
+  },
   "devDependencies": {
     "@awesome.me/webawesome": "3.12.0",
     "@eslint/js": "^10.0.1",
@@ -271,6 +474,7 @@
     "@typescript-eslint/eslint-plugin": "^8.65.0",
     "@typescript-eslint/parser": "^8.65.0",
     "@vitest/coverage-v8": "4.1.11",
+    "domotion-svg": "^0.30.1",
     "esbuild": "^0.25.0",
     "eslint": "^10.8.0",
     "eslint-plugin-simple-import-sort": "^12.1.1",

package/traversal-exclusions.mjs

@@ -0,0 +1,27 @@
+import { relative, sep } from 'node:path';
+
+export const UI_TRAVERSAL_IGNORED_DIRECTORY_NAMES = Object.freeze([
+  '.git',
+  '.kerf-cache',
+  'coverage',
+  'dist',
+  'kerf-ui-evidence',
+  'node_modules',
+]);
+const ignoredDirectoryNames = new Set(UI_TRAVERSAL_IGNORED_DIRECTORY_NAMES);
+
+export const UI_TRAVERSAL_ESLINT_IGNORES = Object.freeze([
+  ...UI_TRAVERSAL_IGNORED_DIRECTORY_NAMES.map((name) => `**/${name}/**`),
+  '**/.claude/worktrees/**',
+]);
+
+export function isUiTraversalExcluded(root, candidate) {
+  const segments = relative(root, candidate).split(sep);
+  return (
+    segments.some((segment) => ignoredDirectoryNames.has(segment)) ||
+    segments.some(
+      (segment, index) =>
+        segment === '.claude' && segments[index + 1] === 'worktrees',
+    )
+  );
+}