{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "access-matrix",
  "title": "Access Matrix",
  "description": "Shows which permissions each subject holds, as a table or as one list entry per subject.",
  "dependencies": [
    "@vllnt/ui@^0.3.0"
  ],
  "registryDependencies": [],
  "files": [
    {
      "path": "registry/default/access-matrix/access-matrix.tsx",
      "content": "\"use client\";\n\nimport * as React from \"react\";\n\nimport { cva } from \"class-variance-authority\";\nimport { Check, CornerDownRight, type LucideIcon, X } from \"lucide-react\";\n\nimport { cn } from \"@vllnt/ui\";\nimport { Button } from \"@vllnt/ui\";\nimport {\n  Table,\n  TableBody,\n  TableCell,\n  TableHead,\n  TableHeader,\n  TableRow,\n} from \"@vllnt/ui\";\n\n/** What one subject holds for one permission. */\nexport type AccessMatrixState = \"denied\" | \"granted\" | \"inherited\";\n\n/** `grid` renders a real table, `list` renders one entry per subject. */\nexport type AccessMatrixMode = \"grid\" | \"list\";\n\n/** A row of the matrix: who or what holds the permissions. */\nexport type AccessMatrixSubject = {\n  description?: string;\n  id: string;\n  label: string;\n};\n\n/** A column of the matrix: one permission. */\nexport type AccessMatrixPermission = {\n  id: string;\n  label: string;\n};\n\n/** Subject id, then permission id, then state. A missing entry reads as `denied`. */\nexport type AccessMatrixValue = Record<\n  string,\n  Record<string, AccessMatrixState>\n>;\n\n/** The word shown and announced for each state. */\nexport type AccessMatrixLabels = Record<AccessMatrixState, string>;\n\n/** Called with the state a cell asks for. Inherited cells never call it. */\nexport type AccessMatrixChangeHandler = (\n  subjectId: string,\n  permissionId: string,\n  next: \"denied\" | \"granted\",\n) => void;\n\nexport type AccessMatrixProps = Omit<\n  React.ComponentPropsWithoutRef<\"section\">,\n  \"onChange\" | \"title\"\n> & {\n  labels?: Partial<AccessMatrixLabels>;\n  mode?: AccessMatrixMode;\n  onChange?: AccessMatrixChangeHandler;\n  permissions: AccessMatrixPermission[];\n  subjects: AccessMatrixSubject[];\n  title?: string;\n  value: AccessMatrixValue;\n};\n\ntype AccessMatrixBodyProps = {\n  labelledBy?: string;\n  labels: AccessMatrixLabels;\n  onChange?: AccessMatrixChangeHandler;\n  permissions: AccessMatrixPermission[];\n  subjects: AccessMatrixSubject[];\n  value: AccessMatrixValue;\n};\n\ntype AccessMatrixHeaderProps = {\n  inheritedLabel: string;\n  showInherited: boolean;\n  title?: string;\n  titleId: string;\n};\n\ntype MatrixCellProps = Pick<\n  AccessMatrixBodyProps,\n  \"labels\" | \"onChange\" | \"value\"\n> & {\n  permission: AccessMatrixPermission;\n  showWord: boolean;\n  subject: AccessMatrixSubject;\n};\n\ntype StateControlProps = {\n  framed: boolean;\n  label: string;\n  onToggle?: () => void;\n  permissionLabel: string;\n  showWord: boolean;\n  state: AccessMatrixState;\n  subjectLabel: string;\n};\n\nconst DEFAULT_LABELS: AccessMatrixLabels = {\n  denied: \"Denied\",\n  granted: \"Granted\",\n  inherited: \"Inherited\",\n};\n\nconst STATE_ICONS: Record<AccessMatrixState, LucideIcon> = {\n  denied: X,\n  granted: Check,\n  inherited: CornerDownRight,\n};\n\nconst accessMatrixStateVariants = cva(\n  \"inline-flex items-center justify-center gap-1.5 text-sm font-medium\",\n  {\n    defaultVariants: {\n      state: \"denied\",\n    },\n    variants: {\n      state: {\n        denied: \"text-muted-foreground\",\n        granted: \"text-success\",\n        inherited: \"text-info\",\n      },\n    },\n  },\n);\n\nfunction resolveLabels(\n  labels: Partial<AccessMatrixLabels> | undefined,\n): AccessMatrixLabels {\n  return {\n    denied: labels?.denied ?? DEFAULT_LABELS.denied,\n    granted: labels?.granted ?? DEFAULT_LABELS.granted,\n    inherited: labels?.inherited ?? DEFAULT_LABELS.inherited,\n  };\n}\n\nfunction getState(\n  value: AccessMatrixValue,\n  subjectId: string,\n  permissionId: string,\n): AccessMatrixState {\n  return value[subjectId]?.[permissionId] ?? \"denied\";\n}\n\nfunction StateControl({\n  framed,\n  label,\n  onToggle,\n  permissionLabel,\n  showWord,\n  state,\n  subjectLabel,\n}: StateControlProps): React.JSX.Element {\n  const Icon = STATE_ICONS[state];\n  const content = (\n    <span\n      className={cn(\n        accessMatrixStateVariants({ state }),\n        !onToggle && framed && (showWord ? \"h-9 px-3\" : \"size-10\"),\n      )}\n    >\n      <Icon aria-hidden=\"true\" className=\"size-4 shrink-0\" />\n      <span className={cn(!showWord && \"sr-only\")}>{label}</span>\n    </span>\n  );\n\n  if (!onToggle) {\n    return content;\n  }\n\n  return (\n    <Button\n      aria-label={`${subjectLabel}, ${permissionLabel}: ${label}`}\n      onClick={onToggle}\n      size={showWord ? \"sm\" : \"icon\"}\n      type=\"button\"\n      variant=\"ghost\"\n    >\n      {content}\n    </Button>\n  );\n}\n\nfunction MatrixCell({\n  labels,\n  onChange,\n  permission,\n  showWord,\n  subject,\n  value,\n}: MatrixCellProps): React.JSX.Element {\n  const state = getState(value, subject.id, permission.id);\n  const next = state === \"granted\" ? \"denied\" : \"granted\";\n  const isEditable = onChange !== undefined && state !== \"inherited\";\n\n  return (\n    <StateControl\n      framed={onChange !== undefined}\n      label={labels[state]}\n      onToggle={\n        isEditable\n          ? () => {\n              onChange(subject.id, permission.id, next);\n            }\n          : undefined\n      }\n      permissionLabel={permission.label}\n      showWord={showWord}\n      state={state}\n      subjectLabel={subject.label}\n    />\n  );\n}\n\nfunction SubjectText({\n  subject,\n}: {\n  subject: AccessMatrixSubject;\n}): React.JSX.Element {\n  return (\n    <>\n      <span className=\"block text-sm font-medium text-foreground\">\n        {subject.label}\n      </span>\n      {subject.description ? (\n        <span className=\"block text-xs font-normal text-muted-foreground\">\n          {subject.description}\n        </span>\n      ) : null}\n    </>\n  );\n}\n\nfunction AccessMatrixGrid({\n  labelledBy,\n  labels,\n  onChange,\n  permissions,\n  subjects,\n  value,\n}: AccessMatrixBodyProps): React.JSX.Element {\n  return (\n    <Table aria-labelledby={labelledBy}>\n      <TableHeader>\n        <TableRow className=\"hover:bg-transparent\">\n          <TableCell />\n          {permissions.map((permission) => (\n            <TableHead className=\"text-center\" key={permission.id} scope=\"col\">\n              {permission.label}\n            </TableHead>\n          ))}\n        </TableRow>\n      </TableHeader>\n      <TableBody>\n        {subjects.map((subject) => (\n          <TableRow key={subject.id}>\n            <TableHead className=\"h-auto py-3 text-foreground\" scope=\"row\">\n              <SubjectText subject={subject} />\n            </TableHead>\n            {permissions.map((permission) => (\n              <TableCell className=\"text-center\" key={permission.id}>\n                <MatrixCell\n                  labels={labels}\n                  onChange={onChange}\n                  permission={permission}\n                  showWord={false}\n                  subject={subject}\n                  value={value}\n                />\n              </TableCell>\n            ))}\n          </TableRow>\n        ))}\n      </TableBody>\n    </Table>\n  );\n}\n\nfunction AccessMatrixList({\n  labelledBy,\n  labels,\n  onChange,\n  permissions,\n  subjects,\n  value,\n}: AccessMatrixBodyProps): React.JSX.Element {\n  return (\n    <ul aria-labelledby={labelledBy} className=\"divide-y\">\n      {subjects.map((subject) => (\n        <li className=\"space-y-3 px-4 py-3\" key={subject.id}>\n          <div>\n            <SubjectText subject={subject} />\n          </div>\n          <ul className=\"space-y-1\">\n            {permissions.map((permission) => (\n              <li\n                className=\"flex items-center justify-between gap-3 text-sm\"\n                key={permission.id}\n              >\n                <span className=\"text-muted-foreground\">\n                  {permission.label}\n                </span>\n                <MatrixCell\n                  labels={labels}\n                  onChange={onChange}\n                  permission={permission}\n                  showWord\n                  subject={subject}\n                  value={value}\n                />\n              </li>\n            ))}\n          </ul>\n        </li>\n      ))}\n    </ul>\n  );\n}\n\nfunction AccessMatrixHeader({\n  inheritedLabel,\n  showInherited,\n  title,\n  titleId,\n}: AccessMatrixHeaderProps): null | React.JSX.Element {\n  if (!title && !showInherited) {\n    return null;\n  }\n\n  return (\n    <header className=\"flex flex-wrap items-center justify-between gap-2 border-b px-4 py-3\">\n      {title ? (\n        <h3\n          className=\"text-base font-semibold leading-none tracking-tight\"\n          id={titleId}\n        >\n          {title}\n        </h3>\n      ) : null}\n      {showInherited ? (\n        <p\n          aria-hidden=\"true\"\n          className=\"inline-flex items-center gap-1.5 text-xs text-muted-foreground\"\n        >\n          <CornerDownRight className=\"size-3.5 shrink-0\" />\n          {inheritedLabel}\n        </p>\n      ) : null}\n    </header>\n  );\n}\n\n/**\n * Shows which permissions each subject holds, as a table (`grid`) or as one\n * list entry per subject (`list`). Each cell reads `granted`, `denied` or\n * `inherited`, with a glyph and a word. With `onChange`, granted and denied\n * cells become buttons that ask for the opposite state; inherited cells never\n * change. The host picks the mode and owns the value.\n */\nexport const AccessMatrix = ({\n  className,\n  labels,\n  mode = \"grid\",\n  onChange,\n  permissions,\n  ref: reference,\n  subjects,\n  title,\n  value,\n  ...props\n}: AccessMatrixProps & {\n  ref?: React.Ref<HTMLElement>;\n}): React.JSX.Element => {\n  const titleId = React.useId();\n  const resolvedLabels = resolveLabels(labels);\n  const hasEntries = subjects.length > 0 && permissions.length > 0;\n  const hasInherited = subjects.some((subject) =>\n    permissions.some(\n      (permission) =>\n        getState(value, subject.id, permission.id) === \"inherited\",\n    ),\n  );\n  const bodyProps: AccessMatrixBodyProps = {\n    labelledBy: title ? titleId : undefined,\n    labels: resolvedLabels,\n    onChange,\n    permissions,\n    subjects,\n    value,\n  };\n\n  return (\n    <section\n      className={cn(\n        \"w-full rounded-lg border bg-card text-card-foreground shadow-sm\",\n        className,\n      )}\n      ref={reference}\n      {...props}\n    >\n      <AccessMatrixHeader\n        inheritedLabel={resolvedLabels.inherited}\n        showInherited={hasInherited}\n        title={title}\n        titleId={titleId}\n      />\n      {hasEntries ? (\n        mode === \"list\" ? (\n          <AccessMatrixList {...bodyProps} />\n        ) : (\n          <AccessMatrixGrid {...bodyProps} />\n        )\n      ) : null}\n    </section>\n  );\n};\n\nAccessMatrix.displayName = \"AccessMatrix\";\n",
      "type": "registry:component"
    }
  ],
  "type": "registry:component",
  "version": "0.3.0",
  "stability": "stable",
  "platforms": [
    "web"
  ]
}
