fix(chartjs): widen codegen type-prop guard for multi-line docs + regenerate all leaves

The prop-docs backfill (7c6a8eb) expanded Chart.rozie's `type` prop from a
single line to a multi-line block with a `docs: { description }`. The chartjs
per-type variant codegen removes the `type` prop via a regex that only matched
the old single-line shape, so `@rozie-ui/chartjs#build` failed the transform
guard ("no `type` prop line") — cascading every framework matrix to red.

- Widen `typePropRe` to match the multi-line `type` block (keeps the
  `type: String` / `default: 'line'` anchors fail-loud; lazily skips the nested
  4-space `docs: {` close to the 2-space prop close).
- Regenerate all 19 families' leaves: `docs.description` now emits as prop JSDoc
  (`@example` on primary/model props) across React/Vue/Svelte/Solid/Angular/Lit
  and into the generated family READMEs.

Local CI-equivalent gate green: turbo build (25 families), typecheck (253),
core (1689), dist-parity (1001). Additive JSDoc only — no emitter/type changes.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011JE6gykywo57CcqUJZTsB9

Author: serpentblade

packages/ui/captcha/packages/angular/src/Captcha.ts

@@ -31,12 +31,35 @@ import { loadCaptchaApi } from './internal/loadCaptchaApi';
   host: { '(focusout)': '__rozieCvaOnTouched()' },
 })
 export class Captcha {
+  /**
+   * Which widget to render: `recaptcha` (Google reCAPTCHA v2), `hcaptcha`, `turnstile` (Cloudflare), or `friendly` (Friendly Captcha). The first three share a near-identical explicit-render API; Friendly Captcha rides an internal `adapt()` bridge onto the same surface. Construction-time — re-key the component to switch it live.
+   */
   provider = input<string>('recaptcha');
+  /**
+   * Required. The public site key from your provider dashboard. Identifies your site to the chosen provider.
+   */
   sitekey = input.required<string>();
+  /**
+   * The verified response token (two-way `r-model`). As the sole `model: true` prop it drives the Angular `ControlValueAccessor`. Written by the widget on success and cleared on expire/reset, so reading it gives you the live response to send to your server for form submission.
+   * @example
+   * <Captcha r-model:token="token" provider="recaptcha" sitekey="…" />
+   */
   token = model<string>('');
+  /**
+   * Widget color theme: `light` or `dark` (all three core providers), or `auto` (Turnstile only). Construction-time — re-key the component to change it live.
+   */
   theme = input<string>('light');
+  /**
+   * Widget size. reCAPTCHA/hCaptcha accept `normal`/`compact`/`invisible`; Turnstile accepts `normal`/`compact`/`flexible`. A no-op for Friendly Captcha (its `startMode` analog rides through the `options` escape hatch instead). Construction-time.
+   */
   size = input<string>('normal');
+  /**
+   * Optional tab index forwarded to the rendered widget. Omitted from the render config when left unset (`null`).
+   */
   tabindex = input<(number) | null>(null);
+  /**
+   * Escape hatch — provider-specific render options merged last (e.g. Turnstile `action`/`cData`/`retry`, hCaptcha `hl`, reCAPTCHA `badge`, Friendly Captcha `startMode`). Lets you reach keys this component does not promote to first-class props.
+   */
   options = input<Record<string, any>>((() => ({}))());
   widgetEl = viewChild<ElementRef<HTMLDivElement>>('widgetEl');
   verify = output<unknown>();

packages/ui/captcha/packages/angular/src/RecaptchaV3.ts

@@ -31,9 +31,23 @@ import { loadRecaptchaV3, execute as v3Execute } from './internal/loadRecaptchaV
   host: { '(focusout)': '__rozieCvaOnTouched()' },
 })
 export class RecaptchaV3 {
+  /**
+   * Required. The public reCAPTCHA v3 site key from your Google admin console.
+   */
   sitekey = input.required<string>();
+  /**
+   * The default action label reported to reCAPTCHA's risk analysis (e.g. `submit`, `login`). Overridable per call via `execute(action)`.
+   */
   action = input<string>('submit');
+  /**
+   * The latest verification token (two-way `r-model`). As the sole `model: true` prop it drives the Angular `ControlValueAccessor`. Written on each successful `execute()` — read it to attach the fresh token to your request.
+   * @example
+   * <RecaptchaV3 r-model:token="token" sitekey="…" action="signup" />
+   */
   token = model<string>('');
+  /**
+   * Opt in to running one `execute()` at mount and emitting `@verify` with the initial token. Off by default — v3 is imperative-first and tokens are short-lived (~2 min), so fetch one at the moment of submission rather than eagerly at mount.
+   */
   executeOnMount = input<boolean>(false);
   error = output<unknown>();
   verify = output<unknown>();

packages/ui/captcha/packages/lit/src/Captcha.ts

@@ -16,13 +16,36 @@ import { loadCaptchaApi } from './internal/loadCaptchaApi';
 
 @customElement('rozie-captcha')
 export default class Captcha extends SignalWatcher(LitElement) {
+  /**
+   * Which widget to render: `recaptcha` (Google reCAPTCHA v2), `hcaptcha`, `turnstile` (Cloudflare), or `friendly` (Friendly Captcha). The first three share a near-identical explicit-render API; Friendly Captcha rides an internal `adapt()` bridge onto the same surface. Construction-time — re-key the component to switch it live.
+   */
   @property({ type: String, reflect: true }) provider: string = 'recaptcha';
+  /**
+   * Required. The public site key from your provider dashboard. Identifies your site to the chosen provider.
+   */
   @property({ type: String, reflect: true }) sitekey!: string;
+  /**
+   * The verified response token (two-way `r-model`). As the sole `model: true` prop it drives the Angular `ControlValueAccessor`. Written by the widget on success and cleared on expire/reset, so reading it gives you the live response to send to your server for form submission.
+   * @example
+   * <Captcha r-model:token="token" provider="recaptcha" sitekey="…" />
+   */
   @property({ type: String, attribute: 'token' }) _token_attr: string = '';
   private _tokenControllable = createLitControllableProperty<string>({ host: this, eventName: 'token-change', defaultValue: '', initialControlledValue: undefined });
+  /**
+   * Widget color theme: `light` or `dark` (all three core providers), or `auto` (Turnstile only). Construction-time — re-key the component to change it live.
+   */
   @property({ type: String, reflect: true }) theme: string = 'light';
+  /**
+   * Widget size. reCAPTCHA/hCaptcha accept `normal`/`compact`/`invisible`; Turnstile accepts `normal`/`compact`/`flexible`. A no-op for Friendly Captcha (its `startMode` analog rides through the `options` escape hatch instead). Construction-time.
+   */
   @property({ type: String, reflect: true }) size: string = 'normal';
+  /**
+   * Optional tab index forwarded to the rendered widget. Omitted from the render config when left unset (`null`).
+   */
   @property({ type: Number, reflect: true }) tabindex: number = null;
+  /**
+   * Escape hatch — provider-specific render options merged last (e.g. Turnstile `action`/`cData`/`retry`, hCaptcha `hl`, reCAPTCHA `badge`, Friendly Captcha `startMode`). Lets you reach keys this component does not promote to first-class props.
+   */
   @property({ type: Object }) options: any = {};
   @query('[data-rozie-ref="widgetEl"]') private _refWidgetEl!: HTMLElement;
 

packages/ui/captcha/packages/lit/src/RecaptchaV3.ts

@@ -16,10 +16,24 @@ import { loadRecaptchaV3, execute as v3Execute } from './internal/loadRecaptchaV
 
 @customElement('rozie-recaptcha-v3')
 export default class RecaptchaV3 extends SignalWatcher(LitElement) {
+  /**
+   * Required. The public reCAPTCHA v3 site key from your Google admin console.
+   */
   @property({ type: String, reflect: true }) sitekey!: string;
+  /**
+   * The default action label reported to reCAPTCHA's risk analysis (e.g. `submit`, `login`). Overridable per call via `execute(action)`.
+   */
   @property({ type: String, reflect: true }) action: string = 'submit';
+  /**
+   * The latest verification token (two-way `r-model`). As the sole `model: true` prop it drives the Angular `ControlValueAccessor`. Written on each successful `execute()` — read it to attach the fresh token to your request.
+   * @example
+   * <RecaptchaV3 r-model:token="token" sitekey="…" action="signup" />
+   */
   @property({ type: String, attribute: 'token' }) _token_attr: string = '';
   private _tokenControllable = createLitControllableProperty<string>({ host: this, eventName: 'token-change', defaultValue: '', initialControlledValue: undefined });
+  /**
+   * Opt in to running one `execute()` at mount and emitting `@verify` with the initial token. Off by default — v3 is imperative-first and tokens are short-lived (~2 min), so fetch one at the moment of submission rather than eagerly at mount.
+   */
   @property({ type: Boolean, reflect: true }) executeOnMount: boolean = false;
 
   private _disconnectCleanups: Array<() => void> = [];

packages/ui/captcha/packages/react/src/Captcha.d.ts

@@ -3,14 +3,37 @@ import type { ForwardRefExoticComponent, RefAttributes } from 'react';
 import type * as React from 'react';
 
 export interface CaptchaProps {
+  /**
+   * Which widget to render: `recaptcha` (Google reCAPTCHA v2), `hcaptcha`, `turnstile` (Cloudflare), or `friendly` (Friendly Captcha). The first three share a near-identical explicit-render API; Friendly Captcha rides an internal `adapt()` bridge onto the same surface. Construction-time — re-key the component to switch it live.
+   */
   provider?: string;
+  /**
+   * Required. The public site key from your provider dashboard. Identifies your site to the chosen provider.
+   */
   sitekey: string;
+  /**
+   * The verified response token (two-way `r-model`). As the sole `model: true` prop it drives the Angular `ControlValueAccessor`. Written by the widget on success and cleared on expire/reset, so reading it gives you the live response to send to your server for form submission.
+   * @example
+   * <Captcha r-model:token="token" provider="recaptcha" sitekey="…" />
+   */
   token?: string;
   defaultToken?: string;
   onTokenChange?: (next: string) => void;
+  /**
+   * Widget color theme: `light` or `dark` (all three core providers), or `auto` (Turnstile only). Construction-time — re-key the component to change it live.
+   */
   theme?: string;
+  /**
+   * Widget size. reCAPTCHA/hCaptcha accept `normal`/`compact`/`invisible`; Turnstile accepts `normal`/`compact`/`flexible`. A no-op for Friendly Captcha (its `startMode` analog rides through the `options` escape hatch instead). Construction-time.
+   */
   size?: string;
+  /**
+   * Optional tab index forwarded to the rendered widget. Omitted from the render config when left unset (`null`).
+   */
   tabindex?: (number) | null;
+  /**
+   * Escape hatch — provider-specific render options merged last (e.g. Turnstile `action`/`cData`/`retry`, hCaptcha `hl`, reCAPTCHA `badge`, Friendly Captcha `startMode`). Lets you reach keys this component does not promote to first-class props.
+   */
   options?: Record<string, unknown>;
   onVerify?: (...args: unknown[]) => void;
   onExpire?: (...args: unknown[]) => void;

packages/ui/captcha/packages/react/src/Captcha.tsx

@@ -13,14 +13,37 @@ import { loadCaptchaApi } from './internal/loadCaptchaApi';
 // teardown (TS2304). Top-level — like api/widgetId — is visible to both.
 
 interface CaptchaProps {
+  /**
+   * Which widget to render: `recaptcha` (Google reCAPTCHA v2), `hcaptcha`, `turnstile` (Cloudflare), or `friendly` (Friendly Captcha). The first three share a near-identical explicit-render API; Friendly Captcha rides an internal `adapt()` bridge onto the same surface. Construction-time — re-key the component to switch it live.
+   */
   provider?: string;
+  /**
+   * Required. The public site key from your provider dashboard. Identifies your site to the chosen provider.
+   */
   sitekey: string;
+  /**
+   * The verified response token (two-way `r-model`). As the sole `model: true` prop it drives the Angular `ControlValueAccessor`. Written by the widget on success and cleared on expire/reset, so reading it gives you the live response to send to your server for form submission.
+   * @example
+   * <Captcha r-model:token="token" provider="recaptcha" sitekey="…" />
+   */
   token?: string;
   defaultToken?: string;
   onTokenChange?: (token: string) => void;
+  /**
+   * Widget color theme: `light` or `dark` (all three core providers), or `auto` (Turnstile only). Construction-time — re-key the component to change it live.
+   */
   theme?: string;
+  /**
+   * Widget size. reCAPTCHA/hCaptcha accept `normal`/`compact`/`invisible`; Turnstile accepts `normal`/`compact`/`flexible`. A no-op for Friendly Captcha (its `startMode` analog rides through the `options` escape hatch instead). Construction-time.
+   */
   size?: string;
+  /**
+   * Optional tab index forwarded to the rendered widget. Omitted from the render config when left unset (`null`).
+   */
   tabindex?: (number) | null;
+  /**
+   * Escape hatch — provider-specific render options merged last (e.g. Turnstile `action`/`cData`/`retry`, hCaptcha `hl`, reCAPTCHA `badge`, Friendly Captcha `startMode`). Lets you reach keys this component does not promote to first-class props.
+   */
   options?: Record<string, any>;
   onVerify?: (...args: any[]) => void;
   onExpire?: (...args: any[]) => void;

packages/ui/captcha/packages/react/src/RecaptchaV3.d.ts

@@ -3,11 +3,25 @@ import type { ForwardRefExoticComponent, RefAttributes } from 'react';
 import type * as React from 'react';
 
 export interface RecaptchaV3Props {
+  /**
+   * Required. The public reCAPTCHA v3 site key from your Google admin console.
+   */
   sitekey: string;
+  /**
+   * The default action label reported to reCAPTCHA's risk analysis (e.g. `submit`, `login`). Overridable per call via `execute(action)`.
+   */
   action?: string;
+  /**
+   * The latest verification token (two-way `r-model`). As the sole `model: true` prop it drives the Angular `ControlValueAccessor`. Written on each successful `execute()` — read it to attach the fresh token to your request.
+   * @example
+   * <RecaptchaV3 r-model:token="token" sitekey="…" action="signup" />
+   */
   token?: string;
   defaultToken?: string;
   onTokenChange?: (next: string) => void;
+  /**
+   * Opt in to running one `execute()` at mount and emitting `@verify` with the initial token. Off by default — v3 is imperative-first and tokens are short-lived (~2 min), so fetch one at the moment of submission rather than eagerly at mount.
+   */
   executeOnMount?: boolean;
   onError?: (...args: unknown[]) => void;
   onVerify?: (...args: unknown[]) => void;

packages/ui/captcha/packages/react/src/RecaptchaV3.tsx

@@ -13,11 +13,25 @@ import { loadRecaptchaV3, execute as v3Execute } from './internal/loadRecaptchaV
 // guards a late execute() resolve that fires after the component unmounts.
 
 interface RecaptchaV3Props {
+  /**
+   * Required. The public reCAPTCHA v3 site key from your Google admin console.
+   */
   sitekey: string;
+  /**
+   * The default action label reported to reCAPTCHA's risk analysis (e.g. `submit`, `login`). Overridable per call via `execute(action)`.
+   */
   action?: string;
+  /**
+   * The latest verification token (two-way `r-model`). As the sole `model: true` prop it drives the Angular `ControlValueAccessor`. Written on each successful `execute()` — read it to attach the fresh token to your request.
+   * @example
+   * <RecaptchaV3 r-model:token="token" sitekey="…" action="signup" />
+   */
   token?: string;
   defaultToken?: string;
   onTokenChange?: (token: string) => void;
+  /**
+   * Opt in to running one `execute()` at mount and emitting `@verify` with the initial token. Off by default — v3 is imperative-first and tokens are short-lived (~2 min), so fetch one at the moment of submission rather than eagerly at mount.
+   */
   executeOnMount?: boolean;
   onError?: (...args: any[]) => void;
   onVerify?: (...args: any[]) => void;

packages/ui/captcha/packages/solid/src/Captcha.tsx

@@ -14,14 +14,37 @@ import { loadCaptchaApi } from './internal/loadCaptchaApi';
 // teardown (TS2304). Top-level — like api/widgetId — is visible to both.
 
 interface CaptchaProps {
+  /**
+   * Which widget to render: `recaptcha` (Google reCAPTCHA v2), `hcaptcha`, `turnstile` (Cloudflare), or `friendly` (Friendly Captcha). The first three share a near-identical explicit-render API; Friendly Captcha rides an internal `adapt()` bridge onto the same surface. Construction-time — re-key the component to switch it live.
+   */
   provider?: string;
+  /**
+   * Required. The public site key from your provider dashboard. Identifies your site to the chosen provider.
+   */
   sitekey: string;
+  /**
+   * The verified response token (two-way `r-model`). As the sole `model: true` prop it drives the Angular `ControlValueAccessor`. Written by the widget on success and cleared on expire/reset, so reading it gives you the live response to send to your server for form submission.
+   * @example
+   * <Captcha r-model:token="token" provider="recaptcha" sitekey="…" />
+   */
   token?: string;
   defaultToken?: string;
   onTokenChange?: (token: string) => void;
+  /**
+   * Widget color theme: `light` or `dark` (all three core providers), or `auto` (Turnstile only). Construction-time — re-key the component to change it live.
+   */
   theme?: string;
+  /**
+   * Widget size. reCAPTCHA/hCaptcha accept `normal`/`compact`/`invisible`; Turnstile accepts `normal`/`compact`/`flexible`. A no-op for Friendly Captcha (its `startMode` analog rides through the `options` escape hatch instead). Construction-time.
+   */
   size?: string;
+  /**
+   * Optional tab index forwarded to the rendered widget. Omitted from the render config when left unset (`null`).
+   */
   tabindex?: (number) | null;
+  /**
+   * Escape hatch — provider-specific render options merged last (e.g. Turnstile `action`/`cData`/`retry`, hCaptcha `hl`, reCAPTCHA `badge`, Friendly Captcha `startMode`). Lets you reach keys this component does not promote to first-class props.
+   */
   options?: Record<string, any>;
   onVerify?: (...args: unknown[]) => void;
   onExpire?: (...args: unknown[]) => void;

packages/ui/captcha/packages/solid/src/RecaptchaV3.tsx

@@ -14,11 +14,25 @@ import { loadRecaptchaV3, execute as v3Execute } from './internal/loadRecaptchaV
 // guards a late execute() resolve that fires after the component unmounts.
 
 interface RecaptchaV3Props {
+  /**
+   * Required. The public reCAPTCHA v3 site key from your Google admin console.
+   */
   sitekey: string;
+  /**
+   * The default action label reported to reCAPTCHA's risk analysis (e.g. `submit`, `login`). Overridable per call via `execute(action)`.
+   */
   action?: string;
+  /**
+   * The latest verification token (two-way `r-model`). As the sole `model: true` prop it drives the Angular `ControlValueAccessor`. Written on each successful `execute()` — read it to attach the fresh token to your request.
+   * @example
+   * <RecaptchaV3 r-model:token="token" sitekey="…" action="signup" />
+   */
   token?: string;
   defaultToken?: string;
   onTokenChange?: (token: string) => void;
+  /**
+   * Opt in to running one `execute()` at mount and emitting `@verify` with the initial token. Off by default — v3 is imperative-first and tokens are short-lived (~2 min), so fetch one at the moment of submission rather than eagerly at mount.
+   */
   executeOnMount?: boolean;
   onError?: (...args: unknown[]) => void;
   onVerify?: (...args: unknown[]) => void;