{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "casework-setup",
  "title": "Casework setup",
  "description": "A wizard that creates or changes a team, its staff, its leader and its queue, with a check step before anything is sent and a done step after.",
  "dependencies": [
    "@registrystack/app-runtime@~0.43.0-next.0"
  ],
  "registryDependencies": [
    "@registrystack/casework-announce",
    "@registrystack/casework-content",
    "@registrystack/casework-shared",
    "@registrystack/lib-content",
    "@registrystack/lib-format",
    "@registrystack/lib-queue-parts",
    "@registrystack/ui-button",
    "@registrystack/ui-input"
  ],
  "files": [
    {
      "path": "casework/setup.tsx",
      "content": "import {\n  useEffect,\n  useRef,\n  useState,\n  type ChangeEvent,\n  type FormEvent,\n  type ReactNode,\n} from \"react\";\nimport type {\n  CaseworkDirectory,\n  CaseworkSetupInput,\n  CaseworkTeam,\n} from \"@registrystack/app-runtime\";\nimport {\n  useCaseworkDirectory,\n  useCaseworkSetup,\n} from \"@registrystack/app-runtime/react\";\nimport { fill, listOf } from \"@/blocks/lib/format\";\nimport { useBlockContent, useLocale } from \"@/blocks/lib/content\";\nimport { Button } from \"@/components/ui/button\";\nimport { Input, Textarea } from \"@/components/ui/input\";\nimport { useCaseworkContent, type CaseworkContent } from \"@/blocks/casework/casework-content\";\nimport { QueueTable, type QueueColumn } from \"@/blocks/lib/queue-parts\";\nimport { ErrorSummary, Loading } from \"@/blocks/casework/shared\";\nimport { LiveAnnouncer, useAnnouncement } from \"@/blocks/casework/announce\";\n\n/** How a page renders an error: with a retry when the write or read can be sent\n    again, without one for a refusal, which is answered once and stands. */\ntype RenderError = (error: unknown, retry?: () => void) => ReactNode;\n\n/** The four field names, shared by the labels, the errors and the summary links. */\nexport const teamNameField = \"team-name\",\n  staffField = \"staff-ids\",\n  leaderField = \"team-leader\",\n  queueField = \"queue\";\n\n/** What the administrator has typed. Kept exactly as typed for confirmation,\n    submission and Back navigation; principal whitespace can be meaningful. */\ninterface SetupDraft {\n  teamId: string;\n  staffText: string;\n  supervisorSubject: string;\n  queueId: string;\n}\nconst emptyDraft: SetupDraft = {\n  teamId: \"\",\n  staffText: \"\",\n  supervisorSubject: \"\",\n  queueId: \"\",\n};\n\n/** The frozen `CaseworkSetupInput` the host receives, built from what was typed. */\nexport function wireValues(draft: SetupDraft): CaseworkSetupInput {\n  return {\n    teamId: draft.teamId,\n    staffSubjects: draft.staffText\n      .split(\"\\n\")\n      .filter((line) => line.length > 0),\n    supervisorSubject: draft.supervisorSubject,\n    queueId: draft.queueId,\n  };\n}\n\nconst maximumIdentifierBytes = 128;\nconst maximumPrincipalBytes = 2_048;\nconst maximumStaff = 100;\nconst directoryIdentifier = /^[A-Za-z0-9._-]+$/;\nconst unicodeControl = /[\\u0000-\\u001f\\u007f-\\u009f]/u;\n\nfunction byteLength(value: string): number {\n  return new TextEncoder().encode(value).length;\n}\n\nfunction validDirectoryIdentifier(value: string): boolean {\n  return (\n    byteLength(value) <= maximumIdentifierBytes &&\n    directoryIdentifier.test(value)\n  );\n}\n\nfunction validDirectoryPrincipal(value: string): boolean {\n  return (\n    value.trim().length > 0 &&\n    byteLength(value) <= maximumPrincipalBytes &&\n    !unicodeControl.test(value)\n  );\n}\n\n/** The checks the administrator can be told about before anything is sent. */\nexport function setupErrors(\n  input: CaseworkSetupInput,\n  directory: CaseworkDirectory | undefined,\n  c: CaseworkContent,\n  locale: string,\n): Record<string, string> {\n  const found: Record<string, string> = {};\n  if (!input.teamId) found[teamNameField] = c.setupTeamNameRequired;\n  else if (!validDirectoryIdentifier(input.teamId))\n    found[teamNameField] = c.setupTeamNameInvalid;\n  else if (directory?.teams.some((team) => team.id === input.teamId))\n    found[teamNameField] = fill(\n      c.setupTeamNameTaken,\n      { name: input.teamId },\n      locale,\n    );\n  if (!input.staffSubjects.length) found[staffField] = c.setupStaffRequired;\n  else if (input.staffSubjects.length > maximumStaff)\n    found[staffField] = c.setupStaffTooMany;\n  else if (new Set(input.staffSubjects).size !== input.staffSubjects.length)\n    found[staffField] = c.setupStaffDuplicate;\n  else if (\n    input.staffSubjects.some((subject) => !validDirectoryPrincipal(subject))\n  )\n    found[staffField] = c.setupStaffInvalid;\n  if (!input.supervisorSubject) found[leaderField] = c.setupLeaderRequired;\n  else if (!validDirectoryPrincipal(input.supervisorSubject))\n    found[leaderField] = c.setupLeaderInvalid;\n  if (!input.queueId) found[queueField] = c.setupQueueRequired;\n  else if (\n    !validDirectoryIdentifier(input.queueId) ||\n    (directory !== undefined &&\n      !directory.queues.some((queue) => queue.id === input.queueId))\n  )\n    found[queueField] = c.setupQueueInvalid;\n  return found;\n}\n\n/** The queue as the administrator reads it, falling back to the identifier\n    they typed when the directory carries no label for it. */\nexport function queueLabel(directory: CaseworkDirectory | undefined, id: string) {\n  return directory?.queues.find((queue) => queue.id === id)?.label ?? id;\n}\n\n/**\n * A step's own heading. Each step of this wizard replaces the page outright\n * rather than updating one mounted view, so the heading remounts with it and\n * takes focus the way a freshly routed page would.\n */\nfunction Heading({\n  title,\n  description,\n}: {\n  title: string;\n  description?: string;\n}) {\n  const heading = useRef<HTMLHeadingElement>(null);\n  useEffect(() => {\n    heading.current?.focus({ preventScroll: true });\n  }, [title]);\n  return (\n    <div className=\"page-heading\">\n      <div>\n        <h1 ref={heading} tabIndex={-1}>\n          {title}\n        </h1>\n        {description && <p className=\"lead\">{description}</p>}\n      </div>\n    </div>\n  );\n}\n\n/**\n * A setup field: the label, a one-line hint, one example value and the error,\n * all wired into the control's accessible description.\n */\nfunction SetupField({\n  name,\n  label,\n  hint,\n  example,\n  error,\n  value,\n  onChange,\n  multiline = false,\n  queues,\n}: {\n  name: string;\n  label: string;\n  hint: string;\n  example?: string;\n  error?: string;\n  value: string;\n  onChange: (value: string) => void;\n  multiline?: boolean;\n  /** Present only when the directory read succeeded; renders a select. */\n  queues?: CaseworkDirectory[\"queues\"];\n}) {\n  const c = useBlockContent();\n  const props = {\n    id: name,\n    name,\n    value,\n    onChange: (\n      event: ChangeEvent<\n        HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement\n      >,\n    ) => onChange(event.target.value),\n    \"aria-invalid\": !!error,\n    \"aria-describedby\": [\n      `${name}-hint`,\n      example ? `${name}-example` : \"\",\n      error ? `${name}-error` : \"\",\n    ]\n      .filter(Boolean)\n      .join(\" \"),\n    required: true,\n  };\n  return (\n    <div className={`field ${error ? \"field-error\" : \"\"}`}>\n      <label htmlFor={name}>{label}</label>\n      <p className=\"field-hint\" id={`${name}-hint`}>\n        {hint}\n      </p>\n      {example && (\n        <p className=\"field-hint setup-example\" id={`${name}-example`}>\n          {example}\n        </p>\n      )}\n      {error && (\n        <p className=\"field-error-message\" id={`${name}-error`}>\n          <span className=\"sr-only\">{c.errorPrefix} </span>\n          {error}\n        </p>\n      )}\n      {queues ? (\n        <select {...props}>\n          <option value=\"\">{c.selectOption}</option>\n          {queues.map((queue) => (\n            <option key={queue.id} value={queue.id}>\n              {queue.label}\n            </option>\n          ))}\n        </select>\n      ) : multiline ? (\n        <Textarea {...props} rows={4} />\n      ) : (\n        <Input {...props} />\n      )}\n    </div>\n  );\n}\n\n/** The teams Casework already holds, so the administrator is not guessing. */\nexport function ExistingTeams({ directory }: { directory: CaseworkDirectory }) {\n  const c = useCaseworkContent();\n  const locale = useLocale();\n  if (!directory.teams.length) return <p className=\"muted\">{c.setupNoTeams}</p>;\n  const columns: QueueColumn<CaseworkTeam>[] = [\n    {\n      key: \"team\",\n      header: c.setupTeamColumn,\n      rowHeader: true,\n      cell: (team) => team.id,\n    },\n    {\n      key: \"staff\",\n      header: c.setupStaffColumn,\n      cell: (team) => team.staff.length,\n    },\n    {\n      key: \"leaders\",\n      header: c.setupLeadersColumn,\n      cell: (team) => team.supervisors.length,\n    },\n    {\n      key: \"queues\",\n      header: c.setupQueuesColumn,\n      cell: (team) =>\n        listOf(\n          team.queues.map((id) => queueLabel(directory, id)),\n          locale,\n        ),\n    },\n  ];\n  return (\n    <section className=\"setup-teams\">\n      <h2>{c.setupExistingTeams}</h2>\n      <QueueTable\n        caption={c.setupTeamsCaption}\n        columns={columns}\n        rows={directory.teams}\n        rowKey={(team) => team.id}\n      />\n    </section>\n  );\n}\n\n/** The confirmation step: nothing is created until the administrator confirms it here. */\nexport function SetupCheck({\n  input,\n  directory,\n  pending,\n  error,\n  onChangeAnswer,\n  onCreate,\n  onBack,\n  renderError,\n}: {\n  input: CaseworkSetupInput;\n  directory: CaseworkDirectory | undefined;\n  pending: boolean;\n  error: unknown;\n  onChangeAnswer: (field: string) => void;\n  onCreate: () => void;\n  onBack: () => void;\n  renderError: RenderError;\n}) {\n  const c = useCaseworkContent();\n  return (\n    <>\n      <Heading title={c.setupCheckTitle} description={c.setupCheckDescription} />\n      <section className=\"card setup-check\">\n        <dl className=\"confirmation-context\">\n          <div>\n            <dt>{c.setupTeamName}</dt>\n            <dd>\n              <div>{input.teamId}</div>\n              <Button\n                variant=\"ghost\"\n                className=\"change-answer\"\n                disabled={pending}\n                onClick={() => onChangeAnswer(teamNameField)}\n              >\n                {c.setupChangeTeamName}\n              </Button>\n            </dd>\n          </div>\n          <div>\n            <dt>{c.setupCheckStaff}</dt>\n            <dd>\n              <ul className=\"setup-staff\">\n                {input.staffSubjects.map((subject) => (\n                  <li key={subject}>{subject}</li>\n                ))}\n              </ul>\n              <Button\n                variant=\"ghost\"\n                className=\"change-answer\"\n                disabled={pending}\n                onClick={() => onChangeAnswer(staffField)}\n              >\n                {c.setupChangeStaff}\n              </Button>\n            </dd>\n          </div>\n          <div>\n            <dt>{c.setupCheckLeader}</dt>\n            <dd>\n              <div>{input.supervisorSubject}</div>\n              <Button\n                variant=\"ghost\"\n                className=\"change-answer\"\n                disabled={pending}\n                onClick={() => onChangeAnswer(leaderField)}\n              >\n                {c.setupChangeLeader}\n              </Button>\n            </dd>\n          </div>\n          <div>\n            <dt>{c.setupCheckQueue}</dt>\n            <dd>\n              <div>{queueLabel(directory, input.queueId)}</div>\n              <Button\n                variant=\"ghost\"\n                className=\"change-answer\"\n                disabled={pending}\n                onClick={() => onChangeAnswer(queueField)}\n              >\n                {c.setupChangeQueue}\n              </Button>\n            </dd>\n          </div>\n        </dl>\n        <div className=\"actions\">\n          <Button onClick={onCreate} disabled={pending}>\n            {pending ? c.setupCreating : c.setupCreate}\n          </Button>\n          <Button variant=\"ghost\" onClick={onBack} disabled={pending}>\n            {c.setupBack}\n          </Button>\n        </div>\n      </section>\n      {!!error && renderError(error)}\n    </>\n  );\n}\n\n/** The final step: the team is created, and its staff take work from the queue themselves. */\nexport function SetupDone({\n  created,\n  directory,\n  announcement,\n  onReset,\n}: {\n  created: CaseworkSetupInput;\n  directory: CaseworkDirectory | undefined;\n  announcement: string;\n  onReset: () => void;\n}) {\n  const c = useCaseworkContent();\n  const locale = useLocale();\n  return (\n    <>\n      <LiveAnnouncer message={announcement} />\n      <Heading\n        title={fill(c.setupDoneTitle, { name: created.teamId }, locale)}\n        description={c.setupDoneNext}\n      />\n      <section className=\"card setup-check\">\n        <p>\n          {fill(\n            c.setupDoneQueue,\n            { queue: queueLabel(directory, created.queueId) },\n            locale,\n          )}\n        </p>\n        <div className=\"actions\">\n          <Button onClick={onReset}>{c.setupAnother}</Button>\n        </div>\n      </section>\n    </>\n  );\n}\n\n/** The administrator's one-time bootstrap of a team, its people and its queue. */\nexport function CaseworkSetup({ renderError, onDirtyChange, onDone, queues }: {\n  renderError: RenderError;\n  onDirtyChange?: (dirty: boolean) => void;\n  /** An app can end the bootstrap journey instead of offering another team. */\n  onDone?: () => void;\n  /** Restrict initial setup to the configured queues that still need a team. */\n  queues?: CaseworkDirectory[\"queues\"];\n}) {\n  const c = useCaseworkContent();\n  const locale = useLocale();\n  const directory = useCaseworkDirectory();\n  const { setup, pending, error } = useCaseworkSetup();\n  const [draft, setDraft] = useState(emptyDraft);\n  const [step, setStep] = useState<\"form\" | \"check\" | \"done\">(\"form\");\n  const [errors, setErrors] = useState<Record<string, string>>({});\n  const [errorFocusRequest, setErrorFocusRequest] = useState(0);\n  const [created, setCreated] = useState<CaseworkSetupInput | null>(null);\n  const [announcement, announce] = useAnnouncement();\n  const editField = useRef<string | null>(null);\n  const input = wireValues(draft);\n  useEffect(() => {\n    onDirtyChange?.(step !== \"done\" && Object.values(draft).some((value) => value.length > 0));\n  }, [draft, step, onDirtyChange]);\n  useEffect(() => {\n    if (step !== \"form\" || !editField.current) return;\n    const field = editField.current;\n    editField.current = null;\n    document.getElementById(field)?.focus({ preventScroll: true });\n  }, [step]);\n  if (directory.isPending) return <Loading />;\n\n  function changeAnswer(field: string) {\n    editField.current = field;\n    setStep(\"form\");\n  }\n\n  function check(event: FormEvent) {\n    event.preventDefault();\n    const found = setupErrors(input, directory.data, c, locale);\n    setErrors(found);\n    if (Object.keys(found).length)\n      setErrorFocusRequest((request) => request + 1);\n    else setStep(\"check\");\n  }\n\n  function changeField(field: string, patch: Partial<SetupDraft>) {\n    setDraft((previous) => ({ ...previous, ...patch }));\n    setErrors((previous) => {\n      if (!(field in previous)) return previous;\n      const next = { ...previous };\n      delete next[field];\n      return next;\n    });\n  }\n\n  async function create() {\n    if (!(await setup(input))) return;\n    setCreated(input);\n    setStep(\"done\");\n    announce(fill(c.setupDoneTitle, { name: input.teamId }, locale));\n    void directory.refetch();\n  }\n\n  if (step === \"done\" && created)\n    return (\n      <SetupDone\n        created={created}\n        directory={directory.data}\n        announcement={announcement}\n        onReset={() => {\n          if (onDone) { onDone(); return; }\n          setDraft(emptyDraft);\n          setCreated(null);\n          setErrors({});\n          setStep(\"form\");\n        }}\n      />\n    );\n\n  if (step === \"check\")\n    return (\n      <SetupCheck\n        input={input}\n        directory={directory.data}\n        pending={pending}\n        error={error}\n        onChangeAnswer={changeAnswer}\n        onCreate={() => void create()}\n        onBack={() => setStep(\"form\")}\n        renderError={renderError}\n      />\n    );\n\n  return (\n    <>\n      <Heading title={c.setupHeading} description={c.setupHeadingDescription} />\n      {/* A directory that cannot be read costs the administrator the team list\n          and the queue names, never the form itself. */}\n      {directory.error || !directory.data ? (\n        renderError(directory.error, () => void directory.refetch())\n      ) : (\n        <ExistingTeams directory={directory.data} />\n      )}\n      <form className=\"card form-card setup-form\" noValidate onSubmit={check}>\n        <h2>{c.setupCreateHeading}</h2>\n        <ErrorSummary errors={errors} focusRequest={errorFocusRequest} />\n        <SetupField\n          name={teamNameField}\n          label={c.setupTeamName}\n          hint={c.setupTeamNameHint}\n          example={c.setupTeamNameExample}\n          error={errors[teamNameField]}\n          value={draft.teamId}\n          onChange={(teamId) => changeField(teamNameField, { teamId })}\n        />\n        <SetupField\n          name={staffField}\n          label={c.setupStaff}\n          hint={c.setupStaffHint}\n          example={c.setupStaffExample}\n          error={errors[staffField]}\n          value={draft.staffText}\n          onChange={(staffText) => changeField(staffField, { staffText })}\n          multiline\n        />\n        <SetupField\n          name={leaderField}\n          label={c.setupLeader}\n          hint={c.setupLeaderHint}\n          example={c.setupLeaderExample}\n          error={errors[leaderField]}\n          value={draft.supervisorSubject}\n          onChange={(supervisorSubject) =>\n            changeField(leaderField, { supervisorSubject })\n          }\n        />\n        <SetupField\n          name={queueField}\n          label={c.setupQueue}\n          hint={directory.data ? c.setupQueueHint : c.setupQueueTypedHint}\n          example={directory.data ? undefined : c.setupQueueExample}\n          error={errors[queueField]}\n          value={draft.queueId}\n          onChange={(queueId) => changeField(queueField, { queueId })}\n          queues={queues ?? directory.data?.queues}\n        />\n        <div className=\"actions\">\n          <Button type=\"submit\">{c.setupContinue}</Button>\n        </div>\n      </form>\n    </>\n  );\n}\n",
      "type": "registry:block",
      "target": "@components/casework/setup.tsx"
    }
  ],
  "type": "registry:block"
}