# WRNexusJS CAPTCHA complete bundle

This bundle targets WRNexusJS `main-80` / package version `0.3.6` and contains:

- `packages/captcha`: publishable `@wrnexus/captcha` package
- `packages/captcha/components/Captcha.wrn`: Tailwind-only UI component
- `examples/captcha-showcase`: runnable challenge, disturbance, validated-form, and protected-page showcase
- `services/managed-captcha`: managed API starter with projects, keys, hostname restrictions, quotas, and rotation
- `scripts/install-captcha.mjs`: repeat-safe repository installer
- `integration`: integration notes and generated path changes
- `docs/IMAGE-STYLES.md`: renderer catalog with a generated preview gallery

## Install into a WRNexusJS checkout

```bash
bun scripts/install-captcha.mjs /path/to/WRNexusJS \
  --with-showcase \
  --with-managed-service \
  --check
```

The installer copies the package, places `Captcha.wrn` in `packages/ui/components` for current component discovery, adds TypeScript aliases, optionally installs the example and managed service, and can run validation commands.

Read `packages/captcha/README.md`, `packages/captcha/SECURITY.md`, and `services/managed-captcha/README.md` before production deployment.

## Fixed 9 compact-size update

- Compact width is now capped at `max-w-xs` instead of `max-w-sm`.
- Compact padding, gaps, image height, input height, buttons, icons, and text are smaller.
- The subtitle and provider-credit line are hidden in compact mode.
- Normal and big rendering remain unchanged.

## Fixed 8 integration updates

- Added 18 generated CAPTCHA image renderers plus `imageStyle="random"`.
- Added allowed and excluded renderer pools, forced randomization, and resolved style metadata.
- Added the `/styles` showcase page with every renderer and easy/normal/hard random examples.
- Optimized PNG line drawing and CRC generation for fast challenge creation.
- Retains compact/normal/big sizing, Listen controls, not-robot mode, page-gate, 25–75 disturbance, validated form, audio, and runtime compatibility fixes.