{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "auth-02",
  "title": "扫码优先登录",
  "description": "以扫码为主、短信和密码为备用入口的线条网格登录区块，包含五种扫码状态。",
  "dependencies": [
    "uqr",
    "zod",
    "lucide-react"
  ],
  "registryDependencies": [
    "button",
    "https://yiui.dev/r/grid-layout.json",
    "https://yiui.dev/r/segmented-control.json",
    "https://yiui.dev/r/toggle-switch.json",
    "https://yiui.dev/r/phone-input.json",
    "https://yiui.dev/r/bar-field.json"
  ],
  "files": [
    {
      "path": "src/registry/blocks/auth-02/auth-02.tsx",
      "content": "\"use client\"\n\nimport {\n  useCallback,\n  useEffect,\n  useRef,\n  useState,\n  type ComponentProps,\n  type ReactNode,\n} from \"react\"\nimport { Check, Smartphone } from \"lucide-react\"\nimport { encode } from \"uqr\"\nimport { Button } from \"@/components/ui/button\"\nimport { cn } from \"@/lib/utils\"\nimport { useControllableState } from \"@/hooks/use-controllable-state\"\nimport {\n  GridContainer,\n  GridSection,\n  GridColumns,\n} from \"@/components/ui/grid-layout/grid-layout\"\nimport { SegmentedControl } from \"@/components/ui/segmented-control/segmented-control\"\nimport { resolveLabels, type Auth02Labels } from \"./config\"\nimport { CodeSignIn, PasswordSignIn, type SignInValues } from \"./sign-in-form\"\nimport { Auth02QrCode } from \"./qr-code\"\n\ntype Auth02Status = \"pending\" | \"scanned\" | \"expired\" | \"confirmed\" | \"error\"\ntype Auth02Provider = {\n  id: string\n  label: string\n  icon?: ReactNode\n  description?: string\n}\ntype Auth02Code = { value: string; expiresAt?: number }\nconst DEFAULT_PROVIDERS: Auth02Provider[] = [\n  { id: \"app\", label: \"App 扫码\", icon: <Smartphone aria-hidden /> },\n]\nconst unavailable = async () => {\n  throw new Error(\"请先接入认证服务\")\n}\n\n/** 扫码优先登录；认证和服务端状态订阅由调用方负责。 */\nfunction Auth02({\n  brand = { name: \"工作空间\" },\n  providers = DEFAULT_PROVIDERS,\n  status: statusProp,\n  defaultStatus = \"pending\",\n  onStatusChange,\n  onRequestCode,\n  onConfirmed,\n  onSignIn = unavailable,\n  onSendCode = unavailable,\n  labels,\n  termsHref = \"#\",\n  privacyHref = \"#\",\n  className,\n  ...props\n}: Omit<ComponentProps<\"div\">, \"onError\"> & {\n  /** 品牌名称与标志 */\n  brand?: { name: string; logo?: ReactNode }\n  /** 可配置扫码提供方，至少一项 */\n  providers?: readonly Auth02Provider[]\n  /** 受控扫码状态 */\n  status?: Auth02Status\n  /** 初始扫码状态 @default \"pending\" */\n  defaultStatus?: Auth02Status\n  onStatusChange?: (status: Auth02Status) => void\n  /** 生成二维码；时间戳为毫秒，抛出的错误向用户展示 */\n  onRequestCode: (providerId: string) => Promise<Auth02Code>\n  /** 确认成功后的异步动作 */\n  onConfirmed?: () => Promise<void>\n  onSignIn?: (values: SignInValues) => Promise<void>\n  onSendCode?: (phone: string) => Promise<void>\n  labels?: Partial<Auth02Labels>\n  termsHref?: string\n  privacyHref?: string\n}) {\n  const text = resolveLabels(labels)\n  const [status, setStatus] = useControllableState({\n    prop: statusProp,\n    defaultProp: defaultStatus,\n    onChange: onStatusChange,\n  })\n  const [providerId, setProviderId] = useState(providers[0]?.id ?? \"\")\n  const provider =\n    providers.find((item) => item.id === providerId) ?? providers[0]\n  const [view, setView] = useState<\"qr\" | \"code\" | \"password\">(\"qr\")\n  const [code, setCode] = useState<Auth02Code>()\n  const [loading, setLoading] = useState(false)\n  const [error, setError] = useState(\"\")\n  const [seconds, setSeconds] = useState<number>()\n  const sequence = useRef(0)\n  const requestRef = useRef(onRequestCode)\n  useEffect(() => {\n    requestRef.current = onRequestCode\n  }, [onRequestCode])\n  const fallbackRef = useRef(text.requestFailed)\n  useEffect(() => {\n    fallbackRef.current = text.requestFailed\n  }, [text.requestFailed])\n  const request = useCallback(\n    async (id: string, reset = true) => {\n      const ticket = ++sequence.current\n      setLoading(true)\n      setError(\"\")\n      setCode(undefined)\n      if (reset) setStatus(\"pending\")\n      try {\n        const next = await requestRef.current(id)\n        if (!next.value) throw new Error(fallbackRef.current)\n        encode(next.value, { border: 4, ecc: \"M\" })\n        if (ticket !== sequence.current) return\n        setCode(next)\n      } catch (caught) {\n        if (ticket !== sequence.current) return\n        setError(caught instanceof Error ? caught.message : fallbackRef.current)\n        setStatus(\"error\")\n      } finally {\n        if (ticket === sequence.current) setLoading(false)\n      }\n    },\n    [setStatus],\n  )\n  const invalidate = useCallback(() => {\n    sequence.current++\n  }, [])\n  const activeProviderId = provider?.id\n  useEffect(() => {\n    const timer = setTimeout(() => {\n      if (activeProviderId) void request(activeProviderId, false)\n    }, 0)\n    return () => {\n      clearTimeout(timer)\n      // 清理时使正在等待的异步结果失效。\n      invalidate()\n    }\n  }, [activeProviderId, request, invalidate]) // 提供方变化使旧请求失效\n  useEffect(() => {\n    if (!code?.expiresAt || ![\"pending\", \"scanned\"].includes(status)) return\n    const tick = () => {\n      const remaining = Math.max(\n        0,\n        Math.ceil((code.expiresAt! - Date.now()) / 1000),\n      )\n      setSeconds(remaining)\n      if (!remaining) setStatus(\"expired\")\n    }\n    tick()\n    const timer = setInterval(tick, 1000)\n    return () => clearInterval(timer)\n  }, [code, status, setStatus])\n  const confirmedRef = useRef(onConfirmed)\n  useEffect(() => {\n    confirmedRef.current = onConfirmed\n  }, [onConfirmed])\n  useEffect(() => {\n    if (status !== \"confirmed\") return\n    let active = true\n    Promise.resolve()\n      .then(() => confirmedRef.current?.())\n      .catch((caught) => {\n        if (active) {\n          setError(\n            caught instanceof Error ? caught.message : fallbackRef.current,\n          )\n          setStatus(\"error\")\n        }\n      })\n    return () => {\n      active = false\n    }\n  }, [status, setStatus])\n  return (\n    <div\n      data-slot=\"auth-02\"\n      data-state={status}\n      className={cn(\n        \"w-full overflow-x-clip bg-background py-8 text-foreground md:py-16\",\n        className,\n      )}\n      {...props}\n    >\n      <GridContainer className=\"max-w-4xl\">\n        <GridSection topLine className=\"space-y-3 px-4 py-6 sm:px-6\">\n          <div className=\"flex items-center gap-2 text-sm font-medium\">\n            {brand.logo}\n            {brand.name}\n          </div>\n          <h1 className=\"text-2xl font-semibold tracking-tight\">\n            {text.title}\n          </h1>\n          <p className=\"text-sm leading-7 text-muted-foreground md:hidden\">\n            {text.mobileHint}\n          </p>\n          {/* 手机上通常扫不了自己屏幕上的码：短信入口提到最前面，桌面仍放在底部的备用入口里 */}\n          {view === \"qr\" ? (\n            <Button\n              size=\"lg\"\n              className=\"w-full md:hidden\"\n              onClick={() => setView(\"code\")}\n            >\n              {text.sms}\n            </Button>\n          ) : null}\n        </GridSection>\n        {view === \"qr\" ? (\n          <GridSection>\n            <GridColumns className=\"sm:grid-cols-1 sm:divide-x-0 sm:divide-y md:grid-cols-2 md:divide-x md:divide-y-0\">\n              <div className=\"flex flex-col items-center gap-4 px-4 py-8\">\n                <div\n                  data-slot=\"auth-02-code-region\"\n                  aria-busy={loading}\n                  className=\"relative flex size-64 max-w-full items-center justify-center\"\n                >\n                  {loading ? (\n                    <p role=\"status\">{text.loading}</p>\n                  ) : status === \"scanned\" || status === \"confirmed\" ? (\n                    <div className=\"flex flex-col items-center gap-4 text-center\">\n                      {status === \"confirmed\" ? (\n                        <Check aria-hidden className=\"size-12\" />\n                      ) : (\n                        <Smartphone aria-hidden className=\"size-12\" />\n                      )}\n                      <p>{text[status]}</p>\n                    </div>\n                  ) : status === \"error\" ? (\n                    <p className=\"px-4 text-center text-destructive\">\n                      {error || text.error}\n                    </p>\n                  ) : code ? (\n                    <Auth02QrCode value={code.value} label={text.qrLabel} />\n                  ) : null}\n                  {status === \"expired\" && !loading && (\n                    <div className=\"absolute inset-0 flex flex-col items-center justify-center gap-4 bg-background/95\">\n                      <p>{text.expired}</p>\n                      <Button\n                        size=\"lg\"\n                        onClick={() => provider && void request(provider.id)}\n                      >\n                        {text.refresh}\n                      </Button>\n                    </div>\n                  )}\n                </div>\n                <p\n                  aria-live=\"polite\"\n                  className=\"text-center text-sm text-muted-foreground\"\n                >\n                  {loading\n                    ? text.loading\n                    : status === \"error\"\n                      ? error || text.error\n                      : text[status]}\n                </p>\n                {status === \"pending\" &&\n                  seconds !== undefined &&\n                  code?.expiresAt && (\n                    <p className=\"font-mono text-xs text-muted-foreground\">\n                      {text.remaining.replace(\"{seconds}\", String(seconds))}\n                    </p>\n                  )}\n                {(status === \"scanned\" || status === \"error\") && (\n                  <Button\n                    size=\"lg\"\n                    variant=\"outline\"\n                    disabled={loading}\n                    onClick={() => provider && void request(provider.id)}\n                  >\n                    {status === \"error\" ? text.retry : text.rescan}\n                  </Button>\n                )}\n              </div>\n              <div className=\"flex min-w-0 flex-col justify-center gap-6 px-4 py-8 sm:px-6\">\n                {providers.length > 1 && (\n                  <SegmentedControl\n                    aria-label={text.providerLabel}\n                    size=\"lg\"\n                    value={provider?.id}\n                    options={providers.map((item) => ({\n                      value: item.id,\n                      label: item.label,\n                      icon: item.icon,\n                    }))}\n                    onValueChange={(id) => {\n                      setProviderId(id)\n                      setStatus(\"pending\")\n                    }}\n                  />\n                )}\n                <div>\n                  <h2 className=\"font-medium\">{provider?.label}</h2>\n                  <p className=\"mt-2 text-sm leading-7 text-muted-foreground\">\n                    {provider?.description}\n                  </p>\n                </div>\n                <ol className=\"space-y-5\">\n                  {[text.stepOpen, text.stepScan, text.stepConfirm].map(\n                    (step, i) => (\n                      <li key={i} className=\"flex items-center gap-4\">\n                        <span className=\"flex size-8 shrink-0 items-center justify-center border border-edge font-mono text-sm\">\n                          {i + 1}\n                        </span>\n                        {step}\n                      </li>\n                    ),\n                  )}\n                </ol>\n              </div>\n            </GridColumns>\n          </GridSection>\n        ) : (\n          <GridSection className=\"px-4 py-8\">\n            <div className=\"mx-auto max-w-md space-y-6\">\n              <h2 className=\"text-xl font-medium\">\n                {view === \"code\" ? text.sms : text.password}\n              </h2>\n              {view === \"code\" ? (\n                <CodeSignIn\n                  onSignIn={onSignIn}\n                  onSendCode={onSendCode}\n                  labels={labels}\n                />\n              ) : (\n                <PasswordSignIn onSignIn={onSignIn} labels={labels} />\n              )}\n              <Button\n                size=\"lg\"\n                variant=\"outline\"\n                className=\"w-full\"\n                onClick={() => setView(\"qr\")}\n              >\n                {text.back}\n              </Button>\n            </div>\n          </GridSection>\n        )}\n        <GridSection className=\"space-y-4 px-4 py-5 sm:px-6\">\n          <div className=\"flex flex-wrap gap-2\">\n            <Button\n              size=\"lg\"\n              variant=\"outline\"\n              className={cn(view === \"qr\" && \"max-md:hidden\")}\n              onClick={() => setView(\"code\")}\n            >\n              {text.sms}\n            </Button>\n            <Button\n              size=\"lg\"\n              variant=\"ghost\"\n              onClick={() => setView(\"password\")}\n            >\n              {text.password}\n            </Button>\n          </div>\n          <p className=\"text-xs leading-6 text-muted-foreground\">\n            {text.termsPrefix}{\" \"}\n            <a className=\"underline\" href={termsHref}>\n              {text.termsOfService}\n            </a>{\" \"}\n            {text.termsConjunction}{\" \"}\n            <a className=\"underline\" href={privacyHref}>\n              {text.privacyPolicy}\n            </a>\n          </p>\n        </GridSection>\n      </GridContainer>\n    </div>\n  )\n}\nexport { Auth02 }\nexport type {\n  Auth02Status,\n  Auth02Provider,\n  Auth02Code,\n  Auth02Labels,\n  SignInValues,\n}\n",
      "type": "registry:component",
      "target": "@components/auth-02/auth-02.tsx"
    },
    {
      "path": "src/registry/blocks/auth-02/sign-in-form.tsx",
      "content": "\"use client\"\n\nimport { useMemo } from \"react\"\n\nimport {\n  PhoneInput,\n  PhoneInputSendButton,\n} from \"@/components/ui/phone-input/phone-input\"\nimport { ToggleSwitch } from \"@/components/ui/toggle-switch/toggle-switch\"\n\nimport { formatLabel, resolveLabels, type Auth02Labels } from \"./config\"\nimport { FormError, PasswordField, SubmitButton, TextField } from \"./form-parts\"\nimport {\n  PHONE_LENGTH,\n  createCodeSignInSchema,\n  createSignInSchema,\n} from \"./schemas\"\nimport { useAsyncAction, useAuthForm } from \"./use-auth-form\"\n\ntype SignInValues =\n  | { method: \"password\"; account: string; password: string; remember: boolean }\n  | { method: \"code\"; phone: string; code: string }\n\nconst CODE_COOLDOWN = 60\n\nfunction PasswordSignIn({\n  onSignIn,\n  labels,\n}: {\n  onSignIn: (values: SignInValues) => Promise<void>\n  labels?: Partial<Auth02Labels>\n}) {\n  // labels 引用不变时 text 与 schema 都不重建，避免每次输入都重新编译 zod schema\n  const text = useMemo(() => resolveLabels(labels), [labels])\n  const schema = useMemo(() => createSignInSchema(text), [text])\n  const form = useAuthForm(\n    schema,\n    { account: \"\", password: \"\", remember: false },\n    { fallbackError: text.requestFailed },\n  )\n  return (\n    <form\n      data-slot=\"auth-02-sign-in-password\"\n      noValidate\n      onSubmit={form.handleSubmit((values) =>\n        onSignIn({ method: \"password\", ...values }),\n      )}\n      className=\"flex flex-col gap-5\"\n    >\n      <FormError message={form.formError} />\n      <TextField\n        id=\"sign-in-account\"\n        label={text.accountLabel}\n        autoComplete=\"username\"\n        placeholder={text.accountPlaceholder}\n        value={form.values.account}\n        error={form.errors.account}\n        onChange={(event) => form.setValue(\"account\", event.target.value)}\n        onBlur={() => form.blur(\"account\")}\n      />\n      <PasswordField\n        id=\"sign-in-password\"\n        label={text.passwordLabel}\n        autoComplete=\"current-password\"\n        placeholder={text.passwordPlaceholder}\n        value={form.values.password}\n        error={form.errors.password}\n        onChange={(event) => form.setValue(\"password\", event.target.value)}\n        onBlur={() => form.blur(\"password\")}\n        labels={labels}\n      />\n      {/* 记住登录状态是即时生效的开关，不是需要同意的声明，所以用开关而不是复选框 */}\n      <ToggleSwitch\n        label={text.remember}\n        tone=\"primary\"\n        checked={form.values.remember}\n        onCheckedChange={(checked) => form.setValue(\"remember\", checked)}\n      />\n      <SubmitButton pending={form.pending} pendingText={text.signInPending}>\n        {text.signInSubmit}\n      </SubmitButton>\n    </form>\n  )\n}\n\nfunction CodeSignIn({\n  onSignIn,\n  onSendCode,\n  labels,\n}: {\n  onSignIn: (values: SignInValues) => Promise<void>\n  onSendCode: (phone: string) => Promise<void>\n  labels?: Partial<Auth02Labels>\n}) {\n  const text = useMemo(() => resolveLabels(labels), [labels])\n  const schema = useMemo(() => createCodeSignInSchema(text), [text])\n  const form = useAuthForm(\n    schema,\n    { phone: \"\", code: \"\" },\n    { fallbackError: text.requestFailed },\n  )\n  const sender = useAsyncAction(text.requestFailed)\n\n  // 失败时必须 throw：PhoneInputSendButton 遇到抛错就不进入倒计时，用户可以马上重试\n  const sendCode = async () => {\n    if (!form.validateField(\"phone\"))\n      throw new Error(text.validationPhoneInvalid)\n    const sent = await sender.run(() => onSendCode(form.values.phone))\n    if (!sent) throw new Error(text.requestFailed)\n  }\n  const phoneInvalid = formatLabel(text.validationPhoneInvalid, {\n    length: PHONE_LENGTH,\n  })\n  return (\n    <form\n      data-slot=\"auth-02-sign-in-code\"\n      noValidate\n      onSubmit={form.handleSubmit((values) =>\n        onSignIn({ method: \"code\", ...values }),\n      )}\n      className=\"flex flex-col gap-5\"\n    >\n      <FormError message={form.formError ?? sender.error} />\n      <PhoneInput\n        id=\"sign-in-phone\"\n        size=\"lg\"\n        label={text.phoneLabel}\n        placeholder={text.phonePlaceholder}\n        value={form.values.phone}\n        error={form.errors.phone}\n        labels={{ invalid: phoneInvalid, required: phoneInvalid }}\n        onValueChange={(phone) => form.setValue(\"phone\", phone)}\n        onBlur={() => form.blur(\"phone\")}\n        action={\n          <PhoneInputSendButton\n            cooldown={CODE_COOLDOWN}\n            onSend={sendCode}\n            labels={{\n              send: text.sendCode,\n              sending: text.sendCodePending,\n              countdown: text.resendCode,\n              resend: text.sendCode,\n            }}\n          />\n        }\n      />\n      <TextField\n        id=\"sign-in-code\"\n        label={text.codeLabel}\n        inputMode=\"numeric\"\n        maxLength={6}\n        autoComplete=\"one-time-code\"\n        placeholder={text.codePlaceholder}\n        value={form.values.code}\n        error={form.errors.code}\n        onChange={(event) => form.setValue(\"code\", event.target.value)}\n        onBlur={() => form.blur(\"code\")}\n      />\n      <SubmitButton pending={form.pending} pendingText={text.signInPending}>\n        {text.signInSubmit}\n      </SubmitButton>\n    </form>\n  )\n}\n\nexport { PasswordSignIn, CodeSignIn }\nexport type { SignInValues }\n",
      "type": "registry:component",
      "target": "@components/auth-02/sign-in-form.tsx"
    },
    {
      "path": "src/registry/blocks/auth-02/qr-code.tsx",
      "content": "import { encode } from \"uqr\"\n\n/** 保留四模块静区，SVG 只使用主题色。 */\nfunction Auth02QrCode({ value, label }: { value: string; label: string }) {\n  const qr = encode(value, { border: 4, ecc: \"M\" })\n  return (\n    <svg\n      data-slot=\"auth-02-qr-code\"\n      role=\"img\"\n      aria-label={label}\n      viewBox={`0 0 ${qr.size} ${qr.size}`}\n      className=\"size-60 max-w-full\"\n      shapeRendering=\"crispEdges\"\n    >\n      <rect width={qr.size} height={qr.size} className=\"fill-background dark:fill-foreground\" />\n      <path\n        className=\"fill-foreground dark:fill-background\"\n        d={qr.data\n          .flatMap((row, y) =>\n            row.flatMap((cell, x) => (cell ? [`M${x},${y}h1v1h-1z`] : [])),\n          )\n          .join(\"\")}\n      />\n    </svg>\n  )\n}\nexport { Auth02QrCode }\n",
      "type": "registry:component",
      "target": "@components/auth-02/qr-code.tsx"
    },
    {
      "path": "src/registry/blocks/auth-02/page.tsx",
      "content": "\"use client\"\n\nimport { Auth02 } from \"@/components/auth-02/auth-02\"\n\n/** 将生成二维码的回调换成认证服务；不要在客户端创建认证凭据。 */\nexport default function LoginPage() {\n  return (\n    <Auth02\n      onRequestCode={async () => {\n        throw new Error(\"请接入生成登录二维码的接口\")\n      }}\n    />\n  )\n}\n",
      "type": "registry:page",
      "target": "app/login-02/page.tsx"
    },
    {
      "path": "src/registry/blocks/auth-02/schemas.ts",
      "content": "import { z } from \"zod\"\n\nimport { formatLabel, type Auth02Labels } from \"./config\"\n\n/**\n * 校验规则常量：改策略只改这里，提示文案里的 {min}、{length} 会自动带入新值。\n * 提示文案本身全部来自 labels（config.ts 的 validation* 键），可逐实例覆盖。\n */\n\n/** 密码最少位数 */\nconst PASSWORD_MIN_LENGTH = 8\n\n/** 姓名最少字符数 */\nconst NAME_MIN_LENGTH = 2\n\n/** 短信验证码位数 */\nconst CODE_LENGTH = 6\n\n/** 中国大陆手机号位数，需与 PHONE_PATTERN 的位数一致 */\nconst PHONE_LENGTH = 11\n\n/** 中国大陆 11 位手机号；面向海外用户时替换这条规则 */\nconst PHONE_PATTERN = /^1[3-9]\\d{9}$/\n\n/** 验证码只接受数字，位数由 CODE_LENGTH 决定 */\nconst CODE_PATTERN = new RegExp(`^\\\\d{${CODE_LENGTH}}$`)\n\nfunction emailField(labels: Auth02Labels) {\n  return z\n    .string()\n    .trim()\n    .min(1, labels.validationEmailRequired)\n    .email(labels.validationEmailInvalid)\n}\n\nfunction passwordField(labels: Auth02Labels) {\n  return z\n    .string()\n    .min(\n      PASSWORD_MIN_LENGTH,\n      formatLabel(labels.validationPasswordMin, { min: PASSWORD_MIN_LENGTH }),\n    )\n    .regex(/[A-Za-z]/, labels.validationPasswordLetter)\n    .regex(/\\d/, labels.validationPasswordDigit)\n}\n\nfunction phoneField(labels: Auth02Labels) {\n  return z\n    .string()\n    .trim()\n    .regex(\n      PHONE_PATTERN,\n      formatLabel(labels.validationPhoneInvalid, { length: PHONE_LENGTH }),\n    )\n}\n\n/** 密码登录。labels 需是合并过默认值的完整文案。 */\nfunction createSignInSchema(labels: Auth02Labels) {\n  return z.object({\n    account: z.string().trim().min(1, labels.validationAccountRequired),\n    password: z.string().min(1, labels.validationPasswordRequired),\n    remember: z.boolean(),\n  })\n}\n\n/** 验证码登录。 */\nfunction createCodeSignInSchema(labels: Auth02Labels) {\n  return z.object({\n    phone: phoneField(labels),\n    code: z\n      .string()\n      .trim()\n      .regex(\n        CODE_PATTERN,\n        formatLabel(labels.validationCodeInvalid, { length: CODE_LENGTH }),\n      ),\n  })\n}\n\n/** 注册：确认密码与条款勾选也在前端校验。 */\nfunction createSignUpSchema(labels: Auth02Labels) {\n  return z\n    .object({\n      name: z\n        .string()\n        .trim()\n        .min(\n          NAME_MIN_LENGTH,\n          formatLabel(labels.validationNameMin, { min: NAME_MIN_LENGTH }),\n        ),\n      email: emailField(labels),\n      password: passwordField(labels),\n      confirm: z.string().min(1, labels.validationConfirmRequired),\n      terms: z\n        .boolean()\n        .refine((value) => value, labels.validationTermsRequired),\n    })\n    .refine((values) => values.password === values.confirm, {\n      message: labels.validationPasswordMismatch,\n      path: [\"confirm\"],\n    })\n}\n\n/** 找回密码。 */\nfunction createForgotPasswordSchema(labels: Auth02Labels) {\n  return z.object({ email: emailField(labels) })\n}\n\nexport {\n  CODE_LENGTH,\n  NAME_MIN_LENGTH,\n  PASSWORD_MIN_LENGTH,\n  PHONE_LENGTH,\n  PHONE_PATTERN,\n  createCodeSignInSchema,\n  createForgotPasswordSchema,\n  createSignInSchema,\n  createSignUpSchema,\n}\n",
      "type": "registry:component",
      "target": "@components/auth-02/schemas.ts"
    },
    {
      "path": "src/registry/blocks/auth-02/config.ts",
      "content": "/**\n * 登录页所有用户可见的文案，包含表单校验提示（validation* 键）。\n * 校验提示里的 {min}、{length} 由 schemas.ts 的规则常量填入；只改规则（密码策略、手机号格式）\n * 不用动文案，想换提示语则覆盖对应的 validation* 键。\n * 品牌名、标题、特性列表属于品牌数据，见 brand.ts。\n */\nconst DEFAULT_LABELS = {\n  title: \"扫码登录，继续你的工作\",\n  mobileHint: \"手机上通常无法扫描自己屏幕上的码，建议使用短信登录。\",\n  providerLabel: \"扫码方式\",\n  pending: \"请用手机扫描登录二维码\",\n  scanned: \"已扫码，请在手机上确认\",\n  expired: \"二维码已过期\",\n  confirmed: \"登录成功\",\n  error: \"二维码生成失败\",\n  refresh: \"刷新\",\n  retry: \"重试\",\n  rescan: \"重新扫码\",\n  loading: \"正在生成二维码…\",\n  qrLabel: \"登录二维码，请用手机扫描\",\n  stepOpen: \"打开 App\",\n  stepScan: \"扫一扫\",\n  stepConfirm: \"在手机上确认\",\n  sms: \"短信验证码登录\",\n  password: \"账号密码登录\",\n  back: \"返回扫码\",\n  remaining: \"剩余 {seconds} 秒\",\n  // 品牌面板\n  brandPanelLabel: \"{name} 品牌介绍\",\n  // 登录\n  signInTitle: \"欢迎回来\",\n  signInDescription: \"输入账号信息即可登录\",\n  signInMethodLabel: \"登录方式\",\n  signInPasswordTab: \"密码登录\",\n  signInCodeTab: \"验证码登录\",\n  accountLabel: \"用户名或邮箱\",\n  accountPlaceholder: \"请输入用户名或邮箱\",\n  passwordLabel: \"密码\",\n  passwordPlaceholder: \"请输入密码\",\n  forgotPassword: \"忘记密码？\",\n  remember: \"记住登录状态\",\n  signInSubmit: \"登录\",\n  signInPending: \"登录中…\",\n  phoneLabel: \"手机号\",\n  phonePlaceholder: \"请输入 11 位手机号\",\n  codeLabel: \"验证码\",\n  codePlaceholder: \"6 位数字验证码\",\n  sendCode: \"获取验证码\",\n  sendCodePending: \"发送中…\",\n  resendCode: \"{seconds}s 后重发\",\n  socialDivider: \"或\",\n  noAccount: \"还没有账号？\",\n  signUpLink: \"注册\",\n  // 注册\n  signUpTitle: \"创建账号\",\n  signUpDescription: \"填写以下信息即可完成注册\",\n  nameLabel: \"姓名\",\n  namePlaceholder: \"请输入姓名\",\n  emailLabel: \"邮箱\",\n  emailPlaceholder: \"name@example.com\",\n  newPasswordPlaceholder: \"至少 8 位，包含字母和数字\",\n  confirmPasswordLabel: \"确认密码\",\n  confirmPasswordPlaceholder: \"再次输入密码\",\n  termsPrefix: \"我已阅读并同意\",\n  termsOfService: \"服务条款\",\n  termsConjunction: \"和\",\n  privacyPolicy: \"隐私政策\",\n  signUpSubmit: \"注册\",\n  signUpPending: \"注册中…\",\n  haveAccount: \"已有账号？\",\n  signInLink: \"登录\",\n  // 找回密码\n  forgotPasswordTitle: \"找回密码\",\n  forgotPasswordDescription: \"输入注册时使用的邮箱，我们会发送重置链接\",\n  sendResetLink: \"发送重置链接\",\n  sendResetLinkPending: \"发送中…\",\n  backToSignIn: \"返回登录\",\n  emailSentTitle: \"邮件已发送\",\n  emailSentDescription:\n    \"我们已向 {email} 发送了重置密码的链接，请查收邮件。没收到？请检查垃圾邮件箱。\",\n  // 输入框与密码强度\n  showPassword: \"显示密码\",\n  hidePassword: \"隐藏密码\",\n  passwordStrength: \"强度：{level}\",\n  passwordStrengthEmpty: \"强度：—\",\n  strengthWeak: \"弱\",\n  strengthFair: \"一般\",\n  strengthGood: \"较强\",\n  strengthStrong: \"强\",\n  // 校验提示（schemas.ts 使用，{min}、{length} 由规则常量填入）\n  validationAccountRequired: \"请输入用户名或邮箱\",\n  validationPasswordRequired: \"请输入密码\",\n  validationEmailRequired: \"请输入邮箱\",\n  validationEmailInvalid: \"请输入有效的邮箱地址\",\n  validationPhoneInvalid: \"请输入有效的 {length} 位手机号\",\n  validationCodeInvalid: \"请输入 {length} 位数字验证码\",\n  validationPasswordMin: \"密码至少 {min} 位\",\n  validationPasswordLetter: \"密码需要包含字母\",\n  validationPasswordDigit: \"密码需要包含数字\",\n  validationNameMin: \"姓名至少 {min} 个字符\",\n  validationConfirmRequired: \"请再次输入密码\",\n  validationTermsRequired: \"请先阅读并同意服务条款\",\n  validationPasswordMismatch: \"两次输入的密码不一致\",\n  // 通用\n  requestFailed: \"操作失败，请稍后重试\",\n} as const\n\ntype Auth02Labels = { [Key in keyof typeof DEFAULT_LABELS]: string }\n\n/** 合并用户传入的文案与默认文案。 */\nfunction resolveLabels(labels?: Partial<Auth02Labels>): Auth02Labels {\n  return { ...DEFAULT_LABELS, ...labels }\n}\n\n/** 把文案里的 {key} 占位符替换成实际值，例如「强度：{level}」。 */\nfunction formatLabel(\n  template: string,\n  values: Record<string, string | number>,\n): string {\n  return Object.entries(values).reduce(\n    (text, [key, value]) => text.replaceAll(`{${key}}`, String(value)),\n    template,\n  )\n}\n\n/** 以 {key} 为界把文案拆成前后两段，便于把值渲染成强调元素。 */\nfunction splitLabel(template: string, key: string): [string, string] {\n  const [before = template, after = \"\"] = template.split(`{${key}}`)\n  return [before, after]\n}\n\nexport { DEFAULT_LABELS, formatLabel, resolveLabels, splitLabel }\nexport type { Auth02Labels }\n",
      "type": "registry:component",
      "target": "@components/auth-02/config.ts"
    },
    {
      "path": "src/registry/blocks/auth-02/use-auth-form.ts",
      "content": "\"use client\"\n\nimport { useCallback, useState, type FormEvent } from \"react\"\nimport type { z } from \"zod\"\n\nimport { DEFAULT_LABELS } from \"./config\"\n\ntype FieldErrors = Record<string, string>\n// 字面量初始值（false、\"\"）会被推断成字面量类型，这里放宽为 boolean / string\ntype Widen<T> = {\n  [K in keyof T]: T[K] extends boolean\n    ? boolean\n    : T[K] extends string\n      ? string\n      : T[K]\n}\n\n/** 每个字段只保留第一条错误，避免一次堆出一长串提示 */\nfunction toErrors(error: z.ZodError): FieldErrors {\n  const errors: FieldErrors = {}\n  for (const issue of error.issues) {\n    const key = String(issue.path[0] ?? \"\")\n    if (key && !(key in errors)) errors[key] = issue.message\n  }\n  return errors\n}\n\n/** 把未知错误转成可展示的中文文案；没有 message 时用传入的兜底文案。 */\nfunction errorMessage(\n  error: unknown,\n  fallback: string = DEFAULT_LABELS.requestFailed,\n) {\n  return error instanceof Error && error.message ? error.message : fallback\n}\n\n/** 包装一个异步动作：管理 loading，并把抛出的错误转成可展示的中文文案。 */\nfunction useAsyncAction(fallbackError: string = DEFAULT_LABELS.requestFailed) {\n  const [pending, setPending] = useState(false)\n  const [error, setError] = useState<string | null>(null)\n  const run = useCallback(\n    async (action: () => Promise<void>) => {\n      setPending(true)\n      setError(null)\n      try {\n        await action()\n        return true\n      } catch (caught) {\n        setError(errorMessage(caught, fallbackError))\n        return false\n      } finally {\n        setPending(false)\n      }\n    },\n    [fallbackError],\n  )\n  return { pending, error, run, clearError: () => setError(null) }\n}\n\n/**\n * 极简受控表单：zod 校验 + 字段错误 + 提交状态。\n * 首次提交前，字段失焦时校验该字段；提交失败后，输入时实时重新校验。\n */\nfunction useAuthForm<I extends Record<string, string | boolean>>(\n  schema: z.ZodType,\n  initial: I,\n  options: { fallbackError?: string } = {},\n) {\n  type V = Widen<I>\n  const [values, setValues] = useState<V>(initial as V)\n  const [errors, setErrors] = useState<FieldErrors>({})\n  const [submitted, setSubmitted] = useState(false)\n  const action = useAsyncAction(options.fallbackError)\n\n  const check = useCallback(\n    (next: V) => {\n      const result = schema.safeParse(next)\n      return result.success ? {} : toErrors(result.error)\n    },\n    [schema],\n  )\n\n  const setValue = <K extends keyof V & string>(key: K, value: V[K]) => {\n    const next = { ...values, [key]: value }\n    setValues(next)\n    if (submitted) setErrors(check(next))\n    else if (errors[key]) setErrors((prev) => ({ ...prev, [key]: \"\" }))\n  }\n  const blur = (key: keyof V & string) => {\n    if (values[key] === \"\" && !submitted) return\n    const found = check(values)[key] ?? \"\"\n    setErrors((prev) => ({ ...prev, [key]: found }))\n  }\n  const handleSubmit =\n    (onValid: (values: V) => Promise<void>) =>\n    async (event: FormEvent<HTMLFormElement>) => {\n      event.preventDefault()\n      setSubmitted(true)\n      const found = check(values)\n      setErrors(found)\n      if (Object.keys(found).length) return\n      await action.run(() => onValid(values))\n    }\n\n  return {\n    values,\n    errors,\n    setValue,\n    blur,\n    handleSubmit,\n    pending: action.pending,\n    formError: action.error,\n    run: action.run,\n    /** 校验单个字段并返回是否通过（用于「发送验证码」前校验手机号） */\n    validateField: (key: keyof V & string) => {\n      const found = check(values)[key] ?? \"\"\n      setSubmitted(true)\n      setErrors((prev) => ({ ...prev, [key]: found }))\n      return !found\n    },\n  }\n}\n\nexport { errorMessage, useAsyncAction, useAuthForm }\nexport type { FieldErrors }\n",
      "type": "registry:component",
      "target": "@components/auth-02/use-auth-form.ts"
    },
    {
      "path": "src/registry/blocks/auth-02/form-parts.tsx",
      "content": "\"use client\"\n\nimport { Eye, EyeOff, Loader2 } from \"lucide-react\"\nimport { useState, type ComponentProps, type ReactNode } from \"react\"\n\nimport { Button } from \"@/components/ui/button\"\nimport { BarField } from \"@/components/ui/bar-field/bar-field\"\nimport { cn } from \"@/lib/utils\"\n\nimport { resolveLabels, type Auth02Labels } from \"./config\"\n\n/**\n * 方条输入框：标签在条内左侧，值靠右；错误文字在条下方，通过 aria-describedby 关联，读屏会一并读出。\n * 高度取 lg 档（36px，触屏 44px），与区块里 size=\"lg\" 的按钮等高。\n */\nfunction TextField({\n  id,\n  label,\n  error,\n  footerAction,\n  trailing,\n  className,\n  value,\n  defaultValue,\n  ...props\n}: Omit<ComponentProps<\"input\">, \"id\" | \"size\"> & {\n  id: string\n  label: string\n  error?: string\n  /** 条下方右侧的操作，例如「忘记密码？」；有错误文字时错误在左、操作在右 */\n  footerAction?: ReactNode\n  /** 条内最右侧的元素，例如显示/隐藏密码按钮 */\n  trailing?: ReactNode\n}) {\n  return (\n    <BarField\n      {...props}\n      value={value === undefined ? undefined : String(value)}\n      defaultValue={\n        defaultValue === undefined ? undefined : String(defaultValue)\n      }\n      id={id}\n      label={label}\n      error={error}\n      footerAction={footerAction}\n      suffix={trailing}\n      size=\"lg\"\n      className={cn(className)}\n    />\n  )\n}\n\n/** 带显示/隐藏切换的密码框。 */\nfunction PasswordField({\n  labels,\n  ...props\n}: Omit<ComponentProps<typeof TextField>, \"type\" | \"trailing\"> & {\n  labels?: Partial<Auth02Labels>\n}) {\n  const text = resolveLabels(labels)\n  const [visible, setVisible] = useState(false)\n  return (\n    <TextField\n      {...props}\n      type={visible ? \"text\" : \"password\"}\n      trailing={\n        <Button\n          type=\"button\"\n          variant=\"ghost\"\n          size=\"icon-lg\"\n          onClick={() => setVisible((value) => !value)}\n          aria-label={visible ? text.hidePassword : text.showPassword}\n          aria-pressed={visible}\n          // 按钮比条内边距大，向右让出 8px，图标视觉上仍与条的右缘留足间距\n          className=\"shrink-0 text-muted-foreground hover:text-foreground\"\n        >\n          {visible ? <EyeOff aria-hidden=\"true\" /> : <Eye aria-hidden=\"true\" />}\n        </Button>\n      }\n    />\n  )\n}\n\n/** 表单级错误（接口返回的失败原因等），出现时读屏会立即朗读。 */\nfunction FormError({ message }: { message: string | null }) {\n  if (!message) return null\n  return (\n    <p\n      data-slot=\"auth-02-form-error\"\n      role=\"alert\"\n      className=\"rounded-lg border border-destructive/30 bg-destructive/10 px-3 py-2 text-sm text-destructive\"\n    >\n      {message}\n    </p>\n  )\n}\n\n/** 提交按钮：pending 时显示转圈并禁用。 */\nfunction SubmitButton({\n  pending,\n  pendingText,\n  children,\n}: {\n  pending: boolean\n  pendingText: string\n  children: ReactNode\n}) {\n  return (\n    <Button\n      data-slot=\"auth-02-submit-button\"\n      type=\"submit\"\n      size=\"lg\"\n      className=\"w-full\"\n      disabled={pending}\n    >\n      {pending ? (\n        <>\n          <Loader2 aria-hidden=\"true\" className=\"animate-spin\" />\n          {pendingText}\n        </>\n      ) : (\n        children\n      )}\n    </Button>\n  )\n}\n\n/** 视图头部：标题 + 说明。每个视图只有一个 h1。 */\nfunction ViewHeading({\n  title,\n  description,\n}: {\n  title: string\n  description: string\n}) {\n  return (\n    <div data-slot=\"auth-02-view-heading\" className=\"flex flex-col gap-1\">\n      <h1 className=\"text-2xl font-bold tracking-tight\">{title}</h1>\n      <p className=\"text-sm text-muted-foreground\">{description}</p>\n    </div>\n  )\n}\n\n/** 文字链接样式的按钮，用于视图切换。 */\nfunction LinkButton({ className, ...props }: ComponentProps<\"button\">) {\n  return (\n    <button\n      data-slot=\"auth-02-link-button\"\n      type=\"button\"\n      className={cn(\n        \"rounded-sm font-medium text-primary underline-offset-4 hover:underline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-ring\",\n        className,\n      )}\n      {...props}\n    />\n  )\n}\n\nexport {\n  FormError,\n  LinkButton,\n  PasswordField,\n  SubmitButton,\n  TextField,\n  ViewHeading,\n}\n",
      "type": "registry:component",
      "target": "@components/auth-02/form-parts.tsx"
    },
    {
      "path": "src/registry/hooks/use-controllable-state.ts",
      "content": "\"use client\"\n\nimport * as React from \"react\"\n\ntype UseControllableStateParams<T> = {\n  /** 受控值；传入后组件不再维护内部状态 */\n  prop?: T\n  /** 非受控时的初始值 */\n  defaultProp: T\n  /** 值变化时回调（受控与非受控都会触发） */\n  onChange?: (value: T) => void\n}\n\n/**\n * 同时支持受控与非受控的状态 hook。\n * 约定见 component-conventions 技能第 4 节：open/defaultOpen/onOpenChange 等成对 props 都用它实现。\n */\nfunction useControllableState<T>({\n  prop,\n  defaultProp,\n  onChange,\n}: UseControllableStateParams<T>) {\n  const [uncontrolled, setUncontrolled] = React.useState(defaultProp)\n  const isControlled = prop !== undefined\n  const value = isControlled ? prop : uncontrolled\n\n  // 用 ref 保存最新的回调和值，保证 setValue 引用稳定\n  const onChangeRef = React.useRef(onChange)\n  const valueRef = React.useRef(value)\n  React.useEffect(() => {\n    onChangeRef.current = onChange\n    valueRef.current = value\n  })\n\n  const setValue = React.useCallback(\n    (next: React.SetStateAction<T>) => {\n      const resolved =\n        typeof next === \"function\"\n          ? (next as (prev: T) => T)(valueRef.current)\n          : next\n      if (Object.is(resolved, valueRef.current)) return\n      valueRef.current = resolved\n      if (!isControlled) setUncontrolled(resolved)\n      onChangeRef.current?.(resolved)\n    },\n    [isControlled],\n  )\n\n  return [value, setValue] as const\n}\n\nexport { useControllableState }\n",
      "type": "registry:hook",
      "target": "hooks/use-controllable-state.ts"
    }
  ],
  "cssVars": {
    "theme": {
      "color-edge": "var(--edge)"
    },
    "light": {
      "edge": "color-mix(in oklch, var(--foreground) 12%, transparent)"
    },
    "dark": {
      "edge": "color-mix(in oklch, var(--foreground) 18%, transparent)"
    }
  },
  "type": "registry:block"
}
