mac-human-design 0.1.2 → 0.1.5

package/README.md

@@ -1,8 +1,9 @@
-# human-design
+# mac-human-design
 
 A reusable shared library for Tauri macOS apps. It includes:
 
-- `MacSegmentedControl` and macOS-focused BaseUI theme tokens.
+- macOS-styled wrappers for every public `@base-ui/react` component family.
+- `MacSegmentedControl` and macOS design tokens/classes.
 - A reusable SF Symbols fetch layer with React hooks/components.
 - A Rust/Tauri plugin crate that exposes a native command:
   `system_symbol_png_data_url`.
@@ -10,6 +11,7 @@ A reusable shared library for Tauri macOS apps. It includes:
 ## Structure
 
 - `src/` - TypeScript/React library exports
+- `docs/macos-base-ui-coverage.md` - Base UI component coverage and variants
 - `src-tauri/` - Rust plugin crate (`human-design-tauri-system-symbols`)
 
 ## Install
@@ -17,7 +19,17 @@ A reusable shared library for Tauri macOS apps. It includes:
 From the consumer app:
 
 ```bash
-npm i human-design
+npm i mac-human-design @base-ui/react react react-dom
+```
+
+`@base-ui/react`, `react`, and `react-dom` are peer dependencies. Install
+`@tauri-apps/api` too when using the SF Symbols helpers or Tauri integration.
+
+Consumer apps should also include the macOS Base UI stylesheet once near their
+app root:
+
+```ts
+import "mac-human-design/styles/macos-base-ui.css";
 ```
 
 In the Tauri Rust side, add the local path dependency while developing:
@@ -42,8 +54,9 @@ fn main() {
 
 ```ts
 import { useState } from "react";
-import { MacSegmentedControl } from "human-design";
-import { SystemSymbolImage } from "human-design/symbols";
+import { MacButton, MacSegmentedControl, MacSelect } from "mac-human-design";
+import { SystemSymbolImage } from "mac-human-design/symbols";
+import "mac-human-design/styles/macos-base-ui.css";
 
 export function Demo() {
   const [tab, setTab] = useState<"files" | "settings">("files");
@@ -59,18 +72,50 @@ export function Demo() {
         value={tab}
         onChange={setTab}
       />
+      <MacButton data-variant="primary">Continue</MacButton>
+      <MacSelect.Root items={[{ label: "Files", value: "files" }]}>
+        <MacSelect.Trigger>
+          <MacSelect.Value placeholder="Choose" />
+        </MacSelect.Trigger>
+      </MacSelect.Root>
     </div>
   );
 }
 ```
 
+## Verify
+
+```bash
+npm run check
+npm run dev:gallery -- --port 5177
+```
+
 ## Why it works cross-platform
 
+The React components stay browser-safe. The optional Tauri plugin is the only
+native layer:
+
+- On macOS, Rust command renders the symbol to PNG via `NSImage`.
+- On non-macOS, command returns `None` so invocations stay safe and predictable.
+
 ## Shared UI components moved in
 
 The following components are now in the shared library and can be imported by any app:
 
 - `AppWindowShell`
+- `MacAccordion`, `MacAlertDialog`, `MacAutocomplete`, `MacAvatar`,
+  `MacButton`, `MacPrimaryButton`, `MacSecondaryButton`,
+  `MacDestructiveButton`, `MacPlainButton`, `MacIconButton`,
+  `MacHelpButton`, `MacCheckbox`, `MacCheckboxGroup`, `MacCollapsible`,
+  `MacCombobox`, `MacContextMenu`, `MacDialog`, `MacDrawer`, `MacField`,
+  `MacFieldset`, `MacForm`, `MacInput`, `MacTextField`, `MacSearchField`,
+  `MacMenu`, `MacMenubar`, `MacMeter`, `MacNavigationMenu`,
+  `MacNumberField`, `MacOTPField`, `MacPopover`,
+  `MacPreviewCard`, `MacProgress`, `MacRadio`, `MacRadioGroup`,
+  `MacScrollArea`, `MacSelect`, `MacSeparator`, `MacSlider`, `MacSwitch`,
+  `MacTabs`, `MacToast`, `MacToggle`, `MacToolbarToggle`,
+  `MacToggleGroup`, `MacSegmentedToggleGroup`,
+  `MacSeparatedSegmentedToggleGroup`, `MacToolbar`, `MacTooltip`
 - `StatusMessage`
 - `SymbolIconButton`
 - `ViewDragRegion`
@@ -85,8 +130,5 @@ import {
   SymbolIconButton,
   ViewDragRegion,
   isDraggableAreaTarget,
-} from "human-design";
+} from "mac-human-design";
 ```
-
-- On macOS, Rust command renders the symbol to PNG via `NSImage`.
-- On non-macOS, command returns `None` so invocations stay safe and predictable.

package/changelog.md

@@ -0,0 +1,55 @@
+# Changelog
+
+This file tracks changes between published npm versions of `mac-human-design`.
+
+## 0.1.5
+
+### Changed
+
+- Replaced the previous Base Web `baseui` foundation with `@base-ui/react`.
+- Updated the package peer dependencies so consumers install `@base-ui/react`,
+  `react`, and `react-dom` alongside `mac-human-design`.
+- Updated README and coverage documentation to use the published package name
+  `mac-human-design` in install and import examples.
+
+### Added
+
+- Added macOS-styled wrappers for every public renderable `@base-ui/react`
+  component family in version 1.5.0:
+  `Accordion`, `AlertDialog`, `Autocomplete`, `Avatar`, `Button`,
+  `Checkbox`, `CheckboxGroup`, `Collapsible`, `Combobox`, `ContextMenu`,
+  `CSPProvider`, `Dialog`, `DirectionProvider`, `Drawer`, `Field`,
+  `Fieldset`, `Form`, `Input`, `Menu`, `Menubar`, `Meter`,
+  `NavigationMenu`, `NumberField`, `OTPField`, `Popover`, `PreviewCard`,
+  `Progress`, `Radio`, `RadioGroup`, `ScrollArea`, `Select`, `Separator`,
+  `Slider`, `Switch`, `Tabs`, `Toast`, `Toggle`, `ToggleGroup`, `Toolbar`,
+  and `Tooltip`.
+- Added macOS-native variants for common platform control styles, including
+  primary, secondary, destructive, plain, icon, and help buttons; text and
+  search fields; pop-up and pull-down select triggers; segmented controls;
+  toolbar buttons; sheet dialogs; and sidebar drawers.
+- Added `src/styles/macosBaseUi.css`, which defines the macOS control styling,
+  system font stack, light/dark tokens, focus rings, reduced-motion behavior,
+  popup/menu/dialog surfaces, and state styling used by the wrappers.
+- Added `MacBaseUIGallery` and a Vite example app at
+  `examples/macos-base-ui-gallery` to visually exercise the wrapped component
+  families and variants.
+- Added `docs/macos-base-ui-coverage.md` to document Base UI family coverage,
+  intentional utility exclusions, native variants, and verification commands.
+- Added verification scripts for Base UI coverage, macOS design constraints,
+  gallery buildability, CSS selector coverage, stale Base Web references, and
+  npm package contents.
+
+### Removed
+
+- Removed the old `baseui` dependency path from package metadata, source,
+  docs, examples, and the lockfile.
+- Removed any dependency on Base Web or Styletron as the shared UI foundation.
+
+### Verification
+
+- `npm run check` typechecks the package, verifies all public Base UI component
+  wrappers and namespace parts, validates macOS design constraints, and builds
+  the gallery.
+- `npm pack --dry-run --json` confirms the npm package includes source, styles,
+  docs, examples, scripts, README, license, and this changelog.

package/docs/macos-base-ui-coverage.md

@@ -0,0 +1,114 @@
+# macOS Base UI Coverage
+
+`mac-human-design` wraps every public component family exported by `@base-ui/react`
+1.5.0 with macOS-oriented class names. Import the CSS once:
+
+```ts
+import "mac-human-design/styles/macos-base-ui.css";
+```
+
+Consumer apps install `@base-ui/react`, `react`, and `react-dom` as peer
+dependencies alongside this package.
+
+## Component Families
+
+| Base UI family | macOS export |
+| --- | --- |
+| `accordion` | `MacAccordion` |
+| `alert-dialog` | `MacAlertDialog` |
+| `autocomplete` | `MacAutocomplete` |
+| `avatar` | `MacAvatar` |
+| `button` | `MacButton` |
+| `checkbox` | `MacCheckbox` |
+| `checkbox-group` | `MacCheckboxGroup` |
+| `collapsible` | `MacCollapsible` |
+| `combobox` | `MacCombobox` |
+| `context-menu` | `MacContextMenu` |
+| `csp-provider` | `MacCSPProvider` |
+| `dialog` | `MacDialog` |
+| `direction-provider` | `MacDirectionProvider` |
+| `drawer` | `MacDrawer` |
+| `field` | `MacField` |
+| `fieldset` | `MacFieldset` |
+| `form` | `MacForm` |
+| `input` | `MacInput` |
+| `menu` | `MacMenu` |
+| `menubar` | `MacMenubar` |
+| `meter` | `MacMeter` |
+| `navigation-menu` | `MacNavigationMenu` |
+| `number-field` | `MacNumberField` |
+| `otp-field` | `MacOTPField` |
+| `popover` | `MacPopover` |
+| `preview-card` | `MacPreviewCard` |
+| `progress` | `MacProgress` |
+| `radio` | `MacRadio` |
+| `radio-group` | `MacRadioGroup` |
+| `scroll-area` | `MacScrollArea` |
+| `select` | `MacSelect` |
+| `separator` | `MacSeparator` |
+| `slider` | `MacSlider` |
+| `switch` | `MacSwitch` |
+| `tabs` | `MacTabs` |
+| `toast` | `MacToast` |
+| `toggle` | `MacToggle` |
+| `toggle-group` | `MacToggleGroup` |
+| `toolbar` | `MacToolbar` |
+| `tooltip` | `MacTooltip` |
+
+Support exports such as `merge-props`, `use-render`, and
+`unstable-use-media-query` are intentionally not wrapped because they do not
+render UI.
+
+## Native Variants
+
+| Native role | Export |
+| --- | --- |
+| Default push button | `MacButton` |
+| Blue default button | `MacPrimaryButton` |
+| Secondary push button | `MacSecondaryButton` |
+| Destructive button | `MacDestructiveButton` |
+| Borderless button | `MacPlainButton` |
+| Icon button | `MacIconButton` |
+| Help button | `MacHelpButton` |
+| Text field | `MacTextField` / `MacInput` |
+| Search field | `MacSearchField` |
+| Pop-up button | `MacSelect.PopUpButtonTrigger` |
+| Pull-down button | `MacSelect.PullDownButtonTrigger` |
+| Segmented control | `MacSegmentedToggleGroup` |
+| Separated segmented control | `MacSeparatedSegmentedToggleGroup` |
+| Toolbar toggle | `MacToolbarToggle` |
+| Toolbar icon button | `MacToolbar.IconButton` |
+| Window sheet | `MacDialog.SheetPopup` |
+| Sidebar drawer | `MacDrawer.SidebarPopup` |
+
+The gallery at `examples/macos-base-ui-gallery` renders these wrappers across
+normal, selected, disabled, mixed, popup, dialog, and narrow-width states.
+
+## Verification
+
+Run the full local gate before publishing wrapper changes:
+
+```bash
+npm run check
+```
+
+The gate typechecks the library and verifies:
+
+- every public `@base-ui/react` component family has a `Mac...` wrapper export,
+- every renderable namespace part in each wrapped family has a matching macOS part,
+- every component family is listed in this coverage document,
+- required native variants are exported,
+- nested native variant parts such as pop-up buttons, sheets, and sidebar drawers are exported,
+- every class assigned by the wrapper module has a matching CSS selector,
+- every public wrapper export is represented in the visual gallery source,
+- macOS design features are present: system font stack, dark mode, reduced motion,
+  keyboard focus rings, accent tokens, styled `hd-mac` classes, and typography
+  constraints,
+- the visual gallery can be bundled for production from the shipped source,
+- old UI-foundation references have not returned.
+
+Run the visual gallery with:
+
+```bash
+npm run dev:gallery -- --port 5177
+```

package/examples/macos-base-ui-gallery/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>human-design macOS Base UI gallery</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/examples/macos-base-ui-gallery/src/main.tsx

@@ -0,0 +1,13 @@
+import { StrictMode } from "react";
+import { createRoot } from "react-dom/client";
+import { AppWindowShell, MacBaseUIGallery } from "../../../src";
+import "../../../src/styles/macosBaseUi.css";
+import "../../../src/styles/macosTauri.css";
+
+createRoot(document.getElementById("root") as HTMLElement).render(
+  <StrictMode>
+    <AppWindowShell>
+      <MacBaseUIGallery />
+    </AppWindowShell>
+  </StrictMode>,
+);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mac-human-design",
-  "version": "0.1.2",
+  "version": "0.1.5",
   "description": "Reusable macOS-oriented UI primitives and SF Symbols bridge for Tauri apps.",
   "type": "module",
   "main": "src/index.ts",
@@ -11,10 +11,17 @@
     "./theme": "./src/theme/index.ts",
     "./symbols": "./src/symbols/index.ts",
     "./tauri": "./src/tauri/index.ts",
+    "./tauri/macos-window-config": "./src/tauri/macosWindowConfig.ts",
+    "./styles/macos-base-ui.css": "./src/styles/macosBaseUi.css",
     "./utils": "./src/utils/index.ts",
+    "./styles/macos-tauri.css": "./src/styles/macosTauri.css",
     "./rust": "./src-tauri"
   },
   "files": [
+    "changelog.md",
+    "docs/**/*",
+    "examples/**/*",
+    "scripts/**/*",
     "src/**/*",
     "src-tauri/**/*",
     "README.md",
@@ -29,31 +36,36 @@
     "components"
   ],
   "scripts": {
-    "publish": "npm publish --access public --ignore-scripts"
+    "check": "npm run typecheck && npm run verify:base-ui && npm run verify:design && npm run verify:gallery",
+    "dev:gallery": "vite --host 127.0.0.1 examples/macos-base-ui-gallery",
+    "publish": "npm publish --access public --ignore-scripts",
+    "typecheck": "tsc --noEmit",
+    "verify:base-ui": "node scripts/verify-base-ui-coverage.mjs",
+    "verify:design": "node scripts/verify-macos-design.mjs",
+    "verify:gallery": "rm -rf .verify/macos-base-ui-gallery && vite build examples/macos-base-ui-gallery --outDir ../../.verify/macos-base-ui-gallery --emptyOutDir && rm -rf .verify/macos-base-ui-gallery"
   },
   "author": "human-design",
   "license": "MIT",
   "peerDependencies": {
+    "@base-ui/react": "^1.5.0",
     "@tauri-apps/api": "^2",
-    "baseui": ">=18",
     "react": ">=18",
-    "react-dom": ">=18",
-    "styletron-react": "^6.1.1",
-    "styletron-standard": "^3.1.0"
+    "react-dom": ">=18"
   },
   "peerDependenciesMeta": {
     "@tauri-apps/api": {
       "optional": true
-    },
-    "baseui": {
-      "optional": true
-    },
-    "styletron-react": {
-      "optional": true
-    },
-    "styletron-standard": {
-      "optional": true
     }
   },
-  "dependencies": {}
+  "devDependencies": {
+    "@base-ui/react": "^1.5.0",
+    "@tauri-apps/api": "^2.11.0",
+    "@types/react": "^19.2.17",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^6.0.2",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
+    "typescript": "^6.0.3",
+    "vite": "^8.0.16"
+  }
 }

package/scripts/verify-base-ui-coverage.mjs

@@ -0,0 +1,273 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const packageJsonPath = path.join(repoRoot, "node_modules", "@base-ui", "react", "package.json");
+const wrapperPath = path.join(repoRoot, "src", "components", "MacBaseUI.tsx");
+const galleryPath = path.join(repoRoot, "src", "components", "MacBaseUIGallery.tsx");
+const stylesPath = path.join(repoRoot, "src", "styles", "macosBaseUi.css");
+const docsPath = path.join(repoRoot, "docs", "macos-base-ui-coverage.md");
+
+const nonComponentExports = new Set([
+  ".",
+  "esm",
+  "merge-props",
+  "types",
+  "unstable-use-media-query",
+  "use-render",
+]);
+
+const acronymParts = new Map([
+  ["csp", "CSP"],
+  ["otp", "OTP"],
+]);
+
+function readText(filePath) {
+  return fs.readFileSync(filePath, "utf8");
+}
+
+function toMacExportName(family) {
+  return `Mac${family
+    .split("-")
+    .map((part) => acronymParts.get(part) ?? `${part[0].toUpperCase()}${part.slice(1)}`)
+    .join("")}`;
+}
+
+function getBaseUiFamilies() {
+  const packageJson = JSON.parse(readText(packageJsonPath));
+  return Object.keys(packageJson.exports)
+    .filter((exportKey) => exportKey.startsWith("./"))
+    .map((exportKey) => exportKey.slice(2))
+    .filter((exportName) => !exportName.startsWith("internals/"))
+    .filter((exportName) => exportName !== "package.json")
+    .filter((exportName) => !nonComponentExports.has(exportName))
+    .sort();
+}
+
+function getMacExports(source) {
+  return new Set(
+    Array.from(source.matchAll(/^export const (Mac[A-Za-z0-9]+)\b/gm), (match) => match[1]),
+  );
+}
+
+function getBaseUiParts(family) {
+  const partsPath = path.join(repoRoot, "node_modules", "@base-ui", "react", family, "index.parts.d.ts");
+  if (!fs.existsSync(partsPath)) {
+    return [];
+  }
+
+  const partsSource = readText(partsPath);
+  const parts = new Set();
+
+  for (const match of partsSource.matchAll(/export\s+\{\s*[A-Za-z0-9_$]+\s+as\s+([A-Z][A-Za-z0-9_$]*)\s*\}/g)) {
+    parts.add(match[1]);
+  }
+
+  for (const match of partsSource.matchAll(/export\s+\{\s*([A-Z][A-Za-z0-9_$]*)\s*\}/g)) {
+    parts.add(match[1]);
+  }
+
+  return Array.from(parts).sort();
+}
+
+function getMacObjectPartKeys(source, macExport) {
+  const objectStart = source.match(new RegExp(`export const ${macExport} = \\\\{`));
+  if (!objectStart) {
+    return null;
+  }
+
+  const startIndex = objectStart.index + objectStart[0].length;
+  let depth = 1;
+  let index = startIndex;
+
+  while (index < source.length && depth > 0) {
+    const char = source[index];
+    if (char === "{") {
+      depth += 1;
+    } else if (char === "}") {
+      depth -= 1;
+    }
+    index += 1;
+  }
+
+  const objectBody = source.slice(startIndex, index - 1);
+  return new Set(
+    Array.from(objectBody.matchAll(/^\s*([A-Z][A-Za-z0-9_$]*):/gm), (match) => match[1]),
+  );
+}
+
+function fail(message, details = []) {
+  console.error(message);
+  for (const detail of details) {
+    console.error(`- ${detail}`);
+  }
+  process.exitCode = 1;
+}
+
+const families = getBaseUiFamilies();
+const wrapperSource = readText(wrapperPath);
+const gallerySource = readText(galleryPath);
+const stylesSource = readText(stylesPath);
+const docsSource = readText(docsPath);
+const macExports = getMacExports(wrapperSource);
+
+const missingWrappers = families
+  .map((family) => [family, toMacExportName(family)])
+  .filter(([, macExport]) => !macExports.has(macExport))
+  .map(([family, macExport]) => `${family} -> ${macExport}`);
+
+if (missingWrappers.length > 0) {
+  fail("Missing macOS wrappers for public @base-ui/react component families.", missingWrappers);
+}
+
+const missingPartWrappers = [];
+for (const family of families) {
+  const macExport = toMacExportName(family);
+  const baseParts = getBaseUiParts(family);
+  if (baseParts.length === 0) {
+    continue;
+  }
+
+  const macParts = getMacObjectPartKeys(wrapperSource, macExport);
+  if (!macParts) {
+    continue;
+  }
+
+  for (const part of baseParts) {
+    if (!macParts.has(part)) {
+      missingPartWrappers.push(`${family}.${part} -> ${macExport}.${part}`);
+    }
+  }
+}
+
+if (missingPartWrappers.length > 0) {
+  fail("Missing macOS wrappers for public @base-ui/react namespace parts.", missingPartWrappers);
+}
+
+const missingDocsRows = families
+  .map((family) => [family, toMacExportName(family)])
+  .filter(([family, macExport]) => {
+    return !docsSource.includes(`| \`${family}\` | \`${macExport}\` |`);
+  })
+  .map(([family, macExport]) => `${family} -> ${macExport}`);
+
+if (missingDocsRows.length > 0) {
+  fail("Missing coverage documentation rows.", missingDocsRows);
+}
+
+const requiredVariants = [
+  "MacPrimaryButton",
+  "MacSecondaryButton",
+  "MacDestructiveButton",
+  "MacPlainButton",
+  "MacIconButton",
+  "MacHelpButton",
+  "MacTextField",
+  "MacSearchField",
+  "MacToolbarToggle",
+  "MacSegmentedToggleGroup",
+  "MacSeparatedSegmentedToggleGroup",
+];
+
+const missingVariants = requiredVariants.filter((variant) => !macExports.has(variant));
+if (missingVariants.length > 0) {
+  fail("Missing expected native macOS variant exports.", missingVariants);
+}
+
+const requiredNestedVariants = [
+  "MacSelect.PopUpButtonTrigger",
+  "MacSelect.PullDownButtonTrigger",
+  "MacDialog.SheetPopup",
+  "MacDrawer.SidebarPopup",
+  "MacToolbar.IconButton",
+];
+
+const missingNestedVariants = requiredNestedVariants.filter((variantPath) => {
+  const [exportName, partName] = variantPath.split(".");
+  return !new RegExp(`export const ${exportName} = [\\s\\S]*?^\\s*${partName}:`, "m").test(
+    wrapperSource,
+  );
+});
+
+if (missingNestedVariants.length > 0) {
+  fail("Missing expected native macOS nested variant exports.", missingNestedVariants);
+}
+
+const missingGalleryCoverage = Array.from(macExports)
+  .sort()
+  .filter((macExport) => !gallerySource.includes(macExport));
+
+if (missingGalleryCoverage.length > 0) {
+  fail("Missing gallery coverage for public macOS wrapper exports.", missingGalleryCoverage);
+}
+
+const wrapperClasses = new Set(
+  Array.from(wrapperSource.matchAll(/"([^"]*hd-mac[^"]*)"/g))
+    .flatMap((match) => match[1].split(/\s+/))
+    .filter(Boolean),
+);
+
+const missingClassStyles = Array.from(wrapperClasses)
+  .sort()
+  .filter((className) => {
+    const escapedClassName = className.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    return !new RegExp(`\\.${escapedClassName}(?![a-zA-Z0-9_-])`).test(stylesSource);
+  });
+
+if (missingClassStyles.length > 0) {
+  fail("Missing CSS selectors for macOS wrapper classes.", missingClassStyles);
+}
+
+const forbiddenPatterns = [
+  /\bfrom\s+["']baseui(?:\/[^"']*)?["']/,
+  /\bbaseui\b/,
+  /\bstyletron\b/i,
+  /Base Web/,
+];
+
+function listFiles(directory, relativePrefix = "") {
+  const files = [];
+  for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
+    const relativePath = path.join(relativePrefix, entry.name);
+    const absolutePath = path.join(directory, entry.name);
+    if (entry.isDirectory()) {
+      files.push(...listFiles(absolutePath, relativePath));
+    } else if (entry.isFile()) {
+      files.push(relativePath);
+    }
+  }
+  return files;
+}
+
+const sourceFiles = [
+  "package.json",
+  "package-lock.json",
+  "README.md",
+  "docs/macos-base-ui-coverage.md",
+  ...listFiles(path.join(repoRoot, "src")).map((filePath) => path.join("src", filePath)),
+  ...listFiles(path.join(repoRoot, "examples")).map((filePath) => path.join("examples", filePath)),
+];
+
+const forbiddenHits = [];
+for (const relativeFile of sourceFiles) {
+  const absoluteFile = path.join(repoRoot, relativeFile);
+  const text = readText(absoluteFile);
+  for (const pattern of forbiddenPatterns) {
+    if (pattern.test(text)) {
+      forbiddenHits.push(`${relativeFile}: ${pattern}`);
+    }
+  }
+}
+
+if (forbiddenHits.length > 0) {
+  fail("Forbidden Base Web or Styletron references found.", forbiddenHits);
+}
+
+if (process.exitCode) {
+  process.exit();
+}
+
+console.log(
+  `Verified ${families.length} @base-ui/react component families, namespace parts, ${requiredVariants.length} native variants, ${requiredNestedVariants.length} nested variants, ${wrapperClasses.size} wrapper classes, gallery coverage, and no Base Web references.`,
+);