@danxbot/ui 14.0.1 → 14.2.0

package/dist/types/components/rbac/Can.d.ts

@@ -0,0 +1,19 @@
+import type { ReactNode } from "react";
+export interface CanProps {
+    /** A single permission key the effective role must carry. */
+    permission?: string;
+    /** Rendered when the effective role carries ANY of these keys. */
+    anyOf?: string[];
+    /** Shown when the permission check fails. Defaults to nothing at all. */
+    fallback?: ReactNode;
+    children: ReactNode;
+}
+/**
+ * Reads `hasPermission` off `useRBAC()` directly — the same derived function
+ * `Can` itself calls — so a consumer that needs the boolean without wanting
+ * `Can`'s all-or-nothing render (to feed a `disabled` prop, a tooltip, a
+ * conditional menu section) never has to reach past this component's own
+ * public surface to get it.
+ */
+export declare function useHasPermission(key: string): boolean;
+export declare function Can({ permission, anyOf, fallback, children }: CanProps): ReactNode;

package/dist/types/components/rbac/DevToolsPopover.d.ts

@@ -1,5 +1,19 @@
 export interface DevToolsPopoverProps {
     /** Deep link to the dev-only Use Case Ledger. Omit and the row does not render. */
     onOpenUseCaseLedger?: () => void;
+    /**
+     * Shows the Data source / Network speed / Regenerate demo data section —
+     * all three read and write THIS LIBRARY's OWN `src/lib/sim/` layer
+     * (`createSimStore`), which exists for the pitch-deck demo and has nothing
+     * to do with role-based access control. Defaults `true` so this package's
+     * own demo pages need no change. A consuming app with a real backend and no
+     * `createSimStore` usage of its own sets this `false` — otherwise the panel
+     * shows a "Simulated ↔ Live" toggle and a "Regenerate demo data" button
+     * that do nothing observable in that app, which reads as broken rather than
+     * inert. "View as" role impersonation (the RBAC feature this component
+     * exists to gate) and "Reset to actual" are unaffected either way — they
+     * have nothing to do with the sim layer.
+     */
+    showSimControls?: boolean;
 }
-export declare function DevToolsPopover({ onOpenUseCaseLedger }?: DevToolsPopoverProps): import("react").JSX.Element | null;
+export declare function DevToolsPopover({ onOpenUseCaseLedger, showSimControls }?: DevToolsPopoverProps): import("react").JSX.Element | null;

package/dist/types/components/rbac/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./types";
 export * from "./RBACProvider";
+export * from "./Can";
 export * from "./AccountMenu";
 export * from "./DevToolsPopover";
 export * from "./RolePermissionMatrix";

package/dist/types/components/rbac/types.d.ts

@@ -3,21 +3,48 @@ export interface Permission {
     key: string;
     label: string;
     category?: string;
+    /** Longer prose for a permission-matrix cell or a "what does this grant"
+     *  tooltip. Optional — a consumer with nothing more to say than `label`
+     *  omits it and every reader (`RolePermissionMatrix`, `AccountMenu`) falls
+     *  back to `label` alone, exactly as before this field existed. */
+    description?: string;
 }
 export interface Role {
     id: string;
     label: string;
     permissionKeys: string[];
+    /** Longer prose about what this role is for. Optional, same fallback rule
+     *  as `Permission.description`. */
+    description?: string;
+    /** True for a role the consumer seeds rather than a person authors — the
+     *  library draws no behavior from this beyond what a consumer's own UI
+     *  (a "System" badge, a disabled rename field) chooses to key off it. */
+    system?: boolean;
+    /** True for a role a consumer's own rules forbid editing or deleting
+     *  outright (the immutable "every permission, always" role a system tends
+     *  to keep one of). Distinct from `system`: a system role can still be
+     *  editable (its permission set changed, even reset to default), while a
+     *  locked role cannot be touched at all. Never derived here — the library
+     *  has no opinion on which role, if any, deserves this. */
+    locked?: boolean;
 }
 export interface User {
     id: string;
     name: string;
     email: string;
     avatarUrl?: string;
+    /** A stable handle distinct from the display `name`, when a consumer's
+     *  account model has one (sign-in identifier, `@handle`). Optional — a
+     *  consumer with no separate concept of a username omits it. */
+    username?: string;
 }
 export interface Team {
     id: string;
     name: string;
+    /** The team's own brand mark, when it has uploaded one. `undefined`
+     *  (never `null`) is "no logo set" — the same optional-field convention
+     *  every other field on this type already uses. */
+    logoUrl?: string;
 }
 export interface TeamMembership {
     userId: string;

package/dist/types/index.d.ts

@@ -124,7 +124,7 @@ export { cellLabel, eventLabel, formatDateRange, longDate, monthTitle, timeOfDay
 export { initialFocusDay, isInMonth, nextDayForKey, useGridNavigation, type GridNavigation, type GridNavigationOptions, } from "./components/calendar/use-grid-navigation";
 export { AmbiguousTimeError, addDays, addDuration, addMonths, atMidnight, atTime, comparePlainDate, dayFraction, dayLengthMs, dayOfWeek, daysBetween, daysInMonth, endOfMonth, hoursInDay, instantAtFraction, instantToPlainDate, instantToPlainDateTime, isSameDate, isoDateString, isoDateTimeString, monthGridDays, nextDay, offsetAt, parsePlainDate, plainDateTimeToInstant, relativeAge, startOfDay, startOfMonth, startOfWeek, weekDays, type CalendarDuration, type Disambiguation, type Instant, type PlainDate, type PlainDateTime, type TimeZone, } from "./lib/time";
 export { allDayBandSegment, dayKey, daySlots, isAllDay, packBand, packLanes, snapFractionToInstant, timeSegments, timedBandSegment, type AllDayEvent, type BandInput, type BandOptions, type BandPlacement, type BandResult, type BandSegment, type CalendarEvent, type CalendarEventId, type CalendarView, type DaySlot, type DragKind, type EventDraft, type EventPalette, type LaneInput, type LaneOptions, type LanePlacement, type PaletteEntry, type TimeSegment, type TimedEvent, type VisibleRange, } from "./lib/calendar";
-export { RBACProvider, useRBAC, AccountMenu, DevToolsPopover, RolePermissionMatrix, ProfilePage, RolesPermissionsPage, type RBACProviderProps, type RBACHookResult, type AccountMenuProps, type DevToolsPopoverProps, type RolePermissionMatrixProps, type Permission, type Role, type User, type Team, type TeamMembership, } from "./components/rbac";
+export { RBACProvider, useRBAC, Can, useHasPermission, AccountMenu, DevToolsPopover, RolePermissionMatrix, ProfilePage, RolesPermissionsPage, type RBACProviderProps, type RBACHookResult, type CanProps, type AccountMenuProps, type DevToolsPopoverProps, type RolePermissionMatrixProps, type Permission, type Role, type User, type Team, type TeamMembership, } from "./components/rbac";
 export { UseCaseCard, RoadmapItemCard, RoadmapSwimlaneBoard, UseCaseLedgerPage, RoadmapPage, PhaseManager, TrackManager, deriveRoadmapItemStatus, isFullyBuilt, isUnbuilt, trackIds, trackProgress, toneForIndex, CATEGORY_TONES, type Domain, type Phase, type Track, type RoadmapItem, type RoadmapItemStatus, type UseCase, type UseCaseStatus, type UseCaseDecision, type UseCaseCardProps, type RoadmapItemCardProps, type RoadmapSwimlaneBoardProps, type UseCaseLedgerPageProps, type RoadmapPageProps, type PhaseManagerProps, type TrackManagerProps, } from "./components/roadmap";
 export { ProvenanceDisclosure, ProvenanceDetail, ProvenanceBadge, ConfidenceReadout, ConfidenceMeter, ConfidenceBar, provenanceStateLabel, confidenceBand, confidenceScore, scoredConfidence, ratedConfidence, type ProvenanceRecord, type ProvenanceState, type ProvenanceSource, type ProvenanceCheck, type ProvenanceCall, type ProvenanceSignoff, type ConfidenceBand, type ConfidenceScore, type ProvenanceConfidence, type ConfidenceReadoutProps, type ConfidenceBarProps, type ConfidenceBarSize, type ProvenanceDisclosureProps, type ProvenanceDetailProps, type ProvenanceDetailTitleAs, type ProvenanceTriggerBadge, type ProvenanceBadgeProps, type ProvenanceBadgeAppearance, type ConfidenceMeterProps, } from "./components/provenance";
 export { confidenceLevel, CONFIDENCE_LEVEL_LABELS, type ConfidenceLevel } from "./lib/confidence";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danxbot/ui",
-  "version": "14.0.1",
+  "version": "14.2.0",
   "type": "module",
   "description": "Danxbot — a domain-agnostic React design system with motion as a first-class primitive.",
   "license": "MIT",