@danxbot/ui 15.14.0 → 15.15.1

package/dist/types/index.d.ts

@@ -113,6 +113,7 @@ export { cn } from "./lib/cn";
 export { formatBytes, formatTokens, formatCompactNumber } from "./lib/format";
 export { copyText } from "./lib/clipboard";
 export { formatDate, parseDate, formatDateTime, parseDateTime, type FormatDateTimeOptions, type ParseDateTimeOptions, formatCurrency, parseCurrency, formatNumber, parseNumber, type FormatNumberOptions, formatBoolean, parseBoolean, type FormatBooleanOptions, } from "./lib/values";
+export { COMPONENT_GUIDANCE, type ComponentGuidanceRule } from "./lib/component-guidance";
 export { useFillHeight } from "./lib/use-fill-height";
 export { useTheme, useUiScale, useContrast, useMotionPreference, type Theme, type UiScale, type ContrastPreference, type MotionPreference, } from "./lib/preferences";
 export { usePersistedState, readStored, writeStored, clearStored, storageKey, type PersistedStateOptions, } from "./lib/persist";

package/dist/types/lib/component-guidance.d.ts

@@ -0,0 +1,15 @@
+export interface ComponentGuidanceRule {
+    /** Stable id — used only for messages/tooling, never matched against. */
+    id: string;
+    /** Tested against a whole file's source text. Deliberately case-sensitive
+     *  (see `raw-*` rules below) — a lowercase native tag is the violation; the
+     *  identically-spelled PascalCase `@danxbot/ui` export is not. */
+    pattern: RegExp;
+    /** The component(s) that usually fit better than the matched shape. */
+    preferInstead: readonly string[];
+    /** Why the richer alternative usually fits — surfaced in a consumer's
+     *  violation message, and what a `UI-LIBRARY-ALLOW: <reason>` comment is
+     *  answering when the richer one genuinely does not apply here. */
+    reason: string;
+}
+export declare const COMPONENT_GUIDANCE: readonly ComponentGuidanceRule[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danxbot/ui",
-  "version": "15.14.0",
+  "version": "15.15.1",
   "type": "module",
   "description": "Danxbot — a domain-agnostic React design system with motion as a first-class primitive.",
   "license": "MIT",
@@ -74,7 +74,7 @@
     "gates": "npm run shoot && npm run a11y && node scripts/shoot-overlays.mjs && npm run probe",
     "a11y": "node scripts/a11y-scan.mjs",
     "shoot": "node scripts/shoot.mjs",
-    "probe": "node scripts/probe-scale.mjs && node scripts/probe-switch.mjs && node scripts/probe-slider.mjs && node scripts/probe-panel.mjs && node scripts/probe-popover-width.mjs && node scripts/probe-api.mjs && node scripts/probe-api-live.mjs && node scripts/probe-tabs-overflow.mjs && node scripts/probe-stat-row.mjs && node scripts/probe-packaging.mjs && node scripts/probe-containment.mjs && node scripts/probe-popover-containment.mjs && node scripts/probe-shell.mjs && node scripts/probe-nav-trigger-tap-target.mjs && node scripts/probe-card-header.mjs && node scripts/probe-inline-edit.mjs && node scripts/probe-read-more.mjs",
+    "probe": "node scripts/probe-scale.mjs && node scripts/probe-switch.mjs && node scripts/probe-slider.mjs && node scripts/probe-panel.mjs && node scripts/probe-popover-width.mjs && node scripts/probe-api.mjs && node scripts/probe-api-live.mjs && node scripts/probe-tabs-overflow.mjs && node scripts/probe-stat-row.mjs && node scripts/probe-packaging.mjs && node scripts/probe-containment.mjs && node scripts/probe-popover-containment.mjs && node scripts/probe-theme-menu-overflow.mjs && node scripts/probe-shell.mjs && node scripts/probe-nav-trigger-tap-target.mjs && node scripts/probe-card-header.mjs && node scripts/probe-inline-edit.mjs && node scripts/probe-read-more.mjs",
     "sync": "node scripts/sync.mjs",
     "visual": "node scripts/visual-docker.mjs",
     "visual:update": "node scripts/visual-docker.mjs --update-snapshots",