tempest-react-sdk 0.63.0 → 0.65.0

package/dist/components/InstallBanner/InstallBanner.js

@@ -1,57 +1,82 @@
 import { cn as e } from "../../utils/cn.js";
 import { Button as t } from "../Button/Button.js";
-import { useBeforeInstallPrompt as n } from "../../hooks/use-before-install-prompt.js";
-import r from "./InstallBanner.module.js";
-import { useState as i } from "react";
-import { jsx as a, jsxs as o } from "react/jsx-runtime";
-import { X as s } from "lucide-react";
+import { useInstallPrompt as n } from "../../hooks/use-install-prompt.js";
+import { defaultInstallHint as r } from "../InstallButton/install-hints.js";
+import i from "./InstallBanner.module.js";
+import { useId as a, useState as o } from "react";
+import { jsx as s, jsxs as c } from "react/jsx-runtime";
+import { X as l } from "lucide-react";
 //#region src/components/InstallBanner/InstallBanner.tsx
-function c(e) {
+function u(e, t) {
 	if (!e || typeof window > "u") return !1;
 	try {
-		return window.localStorage.getItem(e) === "1";
+		let n = window.localStorage.getItem(e);
+		if (!n) return !1;
+		if (n === "1") return !0;
+		let r = Number(n);
+		return Number.isFinite(r) ? t === void 0 || Date.now() - r < t : !1;
 	} catch {
 		return !1;
 	}
 }
-function l({ title: l = "Instale o app", description: u, installLabel: d = "Instalar", dismissLabel: f = "Dispensar", icon: p, storageKey: m, onResult: h, className: g }) {
-	let { installable: _, installed: v, isStandalone: y, prompt: b } = n(), [x, S] = i(() => c(m));
-	return !_ || v || y || x ? null : /* @__PURE__ */ o("div", {
-		className: e(r.banner, g),
+function d({ title: d = "Instale o app", description: f, installLabel: p = "Instalar", hintLabel: m = "Como instalar", dismissLabel: h = "Dispensar", icon: g, storageKey: _, declineCooldownMs: v, renderHint: y = r, manualFallbackDelayMs: b, onResult: x, className: S }) {
+	let { method: C, openInChromeIntent: w, install: T } = n({ manualFallbackDelayMs: b }), [E, D] = o(() => u(_, v)), [O, k] = o(!1), A = a();
+	if (C === "none" || E) return null;
+	let j = () => {
+		if (D(!0), _ && typeof window < "u") try {
+			window.localStorage.setItem(_, v === void 0 ? "1" : String(Date.now()));
+		} catch {}
+	}, M = C === "native" ? null : y({
+		method: C,
+		openInChromeIntent: w
+	});
+	return /* @__PURE__ */ c("div", {
+		className: e(i.banner, S),
 		role: "region",
-		"aria-label": String(l),
+		"aria-label": String(d),
 		children: [
-			p && /* @__PURE__ */ a("span", {
-				className: r.icon,
-				children: p
+			g && /* @__PURE__ */ s("span", {
+				className: i.icon,
+				children: g
 			}),
-			/* @__PURE__ */ o("div", {
-				className: r.body,
-				children: [/* @__PURE__ */ a("p", {
-					className: r.title,
-					children: l
-				}), u && /* @__PURE__ */ a("p", {
-					className: r.description,
-					children: u
-				})]
+			/* @__PURE__ */ c("div", {
+				className: i.body,
+				children: [
+					/* @__PURE__ */ s("p", {
+						className: i.title,
+						children: d
+					}),
+					f && /* @__PURE__ */ s("p", {
+						className: i.description,
+						children: f
+					}),
+					O && M ? /* @__PURE__ */ s("p", {
+						className: i.hint,
+						id: A,
+						children: M
+					}) : null
+				]
 			}),
-			/* @__PURE__ */ a(t, {
+			C === "native" ? /* @__PURE__ */ s(t, {
 				size: "sm",
 				onClick: async () => {
-					h?.(await b());
+					let e = await T();
+					x?.(e ? "accepted" : "dismissed");
 				},
-				children: d
+				children: p
+			}) : /* @__PURE__ */ s(t, {
+				size: "sm",
+				"aria-expanded": O,
+				"aria-controls": O && M ? A : void 0,
+				onClick: () => k((e) => !e),
+				children: m
 			}),
-			/* @__PURE__ */ a("button", {
+			/* @__PURE__ */ s("button", {
 				type: "button",
-				className: r.close,
-				"aria-label": f,
-				onClick: () => {
-					if (S(!0), m && typeof window < "u") try {
-						window.localStorage.setItem(m, "1");
-					} catch {}
-				},
-				children: /* @__PURE__ */ a(s, {
+				className: i.close,
+				"aria-label": h,
+				onClick: j,
+				children: /* @__PURE__ */ s(l, {
 					size: 18,
 					"aria-hidden": !0
 				})
@@ -60,6 +85,6 @@ function l({ title: l = "Instale o app", description: u, installLabel: d = "Inst
 	});
 }
 //#endregion
-export { l as InstallBanner };
+export { d as InstallBanner };
 
 //# sourceMappingURL=InstallBanner.js.map

package/dist/components/InstallBanner/InstallBanner.js.map

@@ -1 +1 @@
-{"version":3,"file":"InstallBanner.js","names":[],"sources":["../../../src/components/InstallBanner/InstallBanner.tsx"],"sourcesContent":["/**\n * @tempest-limits props-count — title, description, installLabel and dismissLabel\n * are four strings the app has to write, icon and className the look, storageKey the\n * dismissal memory and onResult the outcome. An install prompt with SDK-authored\n * copy is the one thing nobody ships.\n */\nimport { useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { X } from \"lucide-react\";\nimport { cn } from \"@/utils/cn\";\nimport { Button } from \"@/components/Button\";\nimport { useBeforeInstallPrompt } from \"@/hooks/use-before-install-prompt\";\nimport type { InstallOutcome } from \"@/components/InstallButton\";\nimport styles from \"./InstallBanner.module.css\";\n\nexport interface InstallBannerProps {\n    /** Headline. Default `\"Instale o app\"`. */\n    title?: ReactNode;\n    /** Supporting copy under the title. */\n    description?: ReactNode;\n    /** Install button label. Default `\"Instalar\"`. */\n    installLabel?: string;\n    /** Accessible label for the dismiss button. Default `\"Dispensar\"`. */\n    dismissLabel?: string;\n    /** Optional leading icon. */\n    icon?: ReactNode;\n    /**\n     * `localStorage` key used to remember dismissal across reloads. Omit to\n     * make dismissal last only for the current session (component state).\n     */\n    storageKey?: string;\n    /** Called with the user's choice after the install prompt resolves. */\n    onResult?: (outcome: InstallOutcome) => void;\n    className?: string;\n}\n\nfunction readDismissed(storageKey?: string): boolean {\n    if (!storageKey || typeof window === \"undefined\") return false;\n    try {\n        return window.localStorage.getItem(storageKey) === \"1\";\n    } catch {\n        return false;\n    }\n}\n\n/**\n * Dismissible bottom banner that invites the user to install the PWA. Wired to\n * {@link useBeforeInstallPrompt}: it renders only when the browser captured an\n * install prompt and the app is not already running standalone — so on\n * platforms that never fire `beforeinstallprompt` (e.g. iOS Safari) it stays\n * hidden and you can surface manual instructions elsewhere.\n *\n * @tempest-limits empty-catch — persisting the dismissal is a courtesy, not the\n * feature. When `localStorage` refuses the write (quota, private mode) the banner\n * still hides for this session; the worst case is that it comes back next visit,\n * which beats an error thrown out of a click handler that only closed a banner.\n *\n * @example\n * <InstallBanner\n *     title=\"Instale o FAMACHApp\"\n *     description=\"Acesso offline e atalho na tela inicial.\"\n *     storageKey=\"famacha:install-dismissed\"\n * />\n */\nexport function InstallBanner({\n    title = \"Instale o app\",\n    description,\n    installLabel = \"Instalar\",\n    dismissLabel = \"Dispensar\",\n    icon,\n    storageKey,\n    onResult,\n    className,\n}: InstallBannerProps) {\n    const { installable, installed, isStandalone, prompt } = useBeforeInstallPrompt();\n    const [dismissed, setDismissed] = useState<boolean>(() => readDismissed(storageKey));\n\n    if (!installable || installed || isStandalone || dismissed) return null;\n\n    const dismiss = (): void => {\n        setDismissed(true);\n        if (storageKey && typeof window !== \"undefined\") {\n            try {\n                window.localStorage.setItem(storageKey, \"1\");\n            } catch {\n                /* empty */\n            }\n        }\n    };\n\n    return (\n        <div className={cn(styles.banner, className)} role=\"region\" aria-label={String(title)}>\n            {icon && <span className={styles.icon}>{icon}</span>}\n            <div className={styles.body}>\n                <p className={styles.title}>{title}</p>\n                {description && <p className={styles.description}>{description}</p>}\n            </div>\n            <Button\n                size=\"sm\"\n                onClick={async () => {\n                    onResult?.(await prompt());\n                }}\n            >\n                {installLabel}\n            </Button>\n            <button\n                type=\"button\"\n                className={styles.close}\n                aria-label={dismissLabel}\n                onClick={dismiss}\n            >\n                <X size={18} aria-hidden />\n            </button>\n        </div>\n    );\n}\n"],"mappings":";;;;;;;;AAoCA,SAAS,EAAc,GAA8B;CACjD,IAAI,CAAC,KAAc,OAAO,SAAW,KAAa,OAAO;CACzD,IAAI;EACA,OAAO,OAAO,aAAa,QAAQ,CAAU,MAAM;CACvD,QAAQ;EACJ,OAAO;CACX;AACJ;AAqBA,SAAgB,EAAc,EAC1B,WAAQ,iBACR,gBACA,kBAAe,YACf,kBAAe,aACf,SACA,eACA,aACA,gBACmB;CACnB,IAAM,EAAE,gBAAa,cAAW,iBAAc,cAAW,EAAuB,GAC1E,CAAC,GAAW,KAAgB,QAAwB,EAAc,CAAU,CAAC;CAenF,OAbI,CAAC,KAAe,KAAa,KAAgB,IAAkB,OAc/D,kBAAC,OAAD;EAAK,WAAW,EAAG,EAAO,QAAQ,CAAS;EAAG,MAAK;EAAS,cAAY,OAAO,CAAK;EAApF,UAAA;GACK,KAAQ,kBAAC,QAAD;IAAM,WAAW,EAAO;IAAO,UAAA;GAAW,CAAA;GACnD,kBAAC,OAAD;IAAK,WAAW,EAAO;IAAvB,UAAA,CACI,kBAAC,KAAD;KAAG,WAAW,EAAO;KAAQ,UAAA;IAAS,CAAA,GACrC,KAAe,kBAAC,KAAD;KAAG,WAAW,EAAO;KAAc,UAAA;IAAe,CAAA,CACjE;;GACL,kBAAC,GAAD;IACI,MAAK;IACL,SAAS,YAAY;KACjB,IAAW,MAAM,EAAO,CAAC;IAC7B;IAEC,UAAA;GACG,CAAA;GACR,kBAAC,UAAD;IACI,MAAK;IACL,WAAW,EAAO;IAClB,cAAY;IACZ,eA9BgB;KAExB,IADA,EAAa,EAAI,GACb,KAAc,OAAO,SAAW,KAChC,IAAI;MACA,OAAO,aAAa,QAAQ,GAAY,GAAG;KAC/C,QAAQ,CAER;IAER;IAuBY,UAAA,kBAAC,GAAD;KAAG,MAAM;KAAI,eAAA;IAAa,CAAA;GACtB,CAAA;EACP;;AAEb"}
+{"version":3,"file":"InstallBanner.js","names":[],"sources":["../../../src/components/InstallBanner/InstallBanner.tsx"],"sourcesContent":["/**\n * @tempest-limits props-count — title, description, installLabel and dismissLabel\n * are four strings the app has to write, icon and className the look, storageKey the\n * dismissal memory and onResult the outcome. An install prompt with SDK-authored\n * copy is the one thing nobody ships.\n */\nimport { useId, useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { X } from \"lucide-react\";\nimport { cn } from \"@/utils/cn\";\nimport { Button } from \"@/components/Button\";\nimport { useInstallPrompt } from \"@/hooks/use-install-prompt\";\nimport { defaultInstallHint } from \"@/components/InstallButton/install-hints\";\nimport type { RenderInstallHint } from \"@/components/InstallButton/install-hints\";\nimport type { InstallOutcome } from \"@/components/InstallButton\";\nimport styles from \"./InstallBanner.module.css\";\n\nexport interface InstallBannerProps {\n    /** Headline. Default `\"Instale o app\"`. */\n    title?: ReactNode;\n    /** Supporting copy under the title. */\n    description?: ReactNode;\n    /** Install button label. Default `\"Instalar\"`. */\n    installLabel?: string;\n    /** Accessible label for the dismiss button. Default `\"Dispensar\"`. */\n    dismissLabel?: string;\n    /** Optional leading icon. */\n    icon?: ReactNode;\n    /**\n     * `localStorage` key used to remember dismissal across reloads. Omit to\n     * make dismissal last only for the current session (component state).\n     */\n    storageKey?: string;\n    /**\n     * How long, in ms, a dismissal lasts before the banner may return.\n     *\n     * Omitted, a dismissal written to `storageKey` is permanent, which is what\n     * the component always did and what a stored `\"1\"` keeps meaning. With a\n     * cooldown the dismissal is stored as a timestamp instead, so the banner\n     * comes back after the window — the same shape `useInstallPrompt` uses for\n     * its own decline.\n     */\n    declineCooldownMs?: number;\n    /**\n     * Install button label used when the browser cannot be prompted and the\n     * banner shows the manual instruction. Default `\"Como instalar\"`.\n     */\n    hintLabel?: string;\n    /**\n     * Replaces the instruction shown for the `\"ios\"` and `\"manual\"` methods.\n     *\n     * The default copy is in PT-BR and names the real menu entries.\n     */\n    renderHint?: RenderInstallHint;\n    /**\n     * How long, in ms, to wait for `beforeinstallprompt` before falling back to\n     * the manual instruction. Forwarded to {@link useInstallPrompt}; defaults to\n     * 3000 there.\n     */\n    manualFallbackDelayMs?: number;\n    /** Called with the user's choice after the install prompt resolves. */\n    onResult?: (outcome: InstallOutcome) => void;\n    className?: string;\n}\n\n/**\n * Whether the user already dismissed this banner.\n *\n * Two stored shapes, and both have to keep working: `\"1\"` is the permanent\n * dismissal the component has always written, and a timestamp is what a banner\n * with `declineCooldownMs` writes. A `\"1\"` found while a cooldown is configured\n * still counts as dismissed forever — it was written under the old contract, and\n * reviving a banner the user turned off is worse than keeping it off.\n *\n * @param storageKey - The key holding the dismissal, if any.\n * @param declineCooldownMs - How long a timestamped dismissal lasts.\n * @returns Whether the banner should stay hidden.\n */\nfunction readDismissed(storageKey?: string, declineCooldownMs?: number): boolean {\n    if (!storageKey || typeof window === \"undefined\") return false;\n    try {\n        const raw = window.localStorage.getItem(storageKey);\n        if (!raw) return false;\n        if (raw === \"1\") return true;\n        const dismissedAt = Number(raw);\n        if (!Number.isFinite(dismissedAt)) return false;\n        if (declineCooldownMs === undefined) return true;\n        return Date.now() - dismissedAt < declineCooldownMs;\n    } catch {\n        return false;\n    }\n}\n\n/**\n * Dismissible bottom banner that invites the user to install the PWA, wired to\n * {@link useInstallPrompt}.\n *\n * Where the browser fires `beforeinstallprompt`, the button installs. Where it\n * does not — iOS Safari, and the Android Chromium forks that strip the API — the\n * banner shows that platform's instruction instead of disappearing. It used to\n * disappear: built on `useBeforeInstallPrompt`, it rendered `null` exactly where\n * the user has no other way to find the install entry, which is why every app\n * kept a local copy of this component just to add the two missing paths.\n *\n * @tempest-limits empty-catch — persisting the dismissal is a courtesy, not the\n * feature. When `localStorage` refuses the write (quota, private mode) the banner\n * still hides for this session; the worst case is that it comes back next visit,\n * which beats an error thrown out of a click handler that only closed a banner.\n *\n * @example\n * <InstallBanner\n *     title=\"Instale o FAMACHApp\"\n *     description=\"Acesso offline e atalho na tela inicial.\"\n *     storageKey=\"famacha:install-dismissed\"\n * />\n */\nexport function InstallBanner({\n    title = \"Instale o app\",\n    description,\n    installLabel = \"Instalar\",\n    hintLabel = \"Como instalar\",\n    dismissLabel = \"Dispensar\",\n    icon,\n    storageKey,\n    declineCooldownMs,\n    renderHint = defaultInstallHint,\n    manualFallbackDelayMs,\n    onResult,\n    className,\n}: InstallBannerProps) {\n    const { method, openInChromeIntent, install } = useInstallPrompt({ manualFallbackDelayMs });\n    const [dismissed, setDismissed] = useState<boolean>(() =>\n        readDismissed(storageKey, declineCooldownMs),\n    );\n    const [hintOpen, setHintOpen] = useState(false);\n    const hintId = useId();\n\n    if (method === \"none\" || dismissed) return null;\n\n    const dismiss = (): void => {\n        setDismissed(true);\n        if (storageKey && typeof window !== \"undefined\") {\n            try {\n                window.localStorage.setItem(\n                    storageKey,\n                    declineCooldownMs === undefined ? \"1\" : String(Date.now()),\n                );\n            } catch {\n                /* empty */\n            }\n        }\n    };\n\n    const hint = method === \"native\" ? null : renderHint({ method, openInChromeIntent });\n\n    return (\n        <div className={cn(styles.banner, className)} role=\"region\" aria-label={String(title)}>\n            {icon && <span className={styles.icon}>{icon}</span>}\n            <div className={styles.body}>\n                <p className={styles.title}>{title}</p>\n                {description && <p className={styles.description}>{description}</p>}\n                {hintOpen && hint ? (\n                    <p className={styles.hint} id={hintId}>\n                        {hint}\n                    </p>\n                ) : null}\n            </div>\n            {method === \"native\" ? (\n                <Button\n                    size=\"sm\"\n                    onClick={async () => {\n                        const accepted = await install();\n                        onResult?.(accepted ? \"accepted\" : \"dismissed\");\n                    }}\n                >\n                    {installLabel}\n                </Button>\n            ) : (\n                <Button\n                    size=\"sm\"\n                    aria-expanded={hintOpen}\n                    aria-controls={hintOpen && hint ? hintId : undefined}\n                    onClick={() => setHintOpen((open) => !open)}\n                >\n                    {hintLabel}\n                </Button>\n            )}\n            <button\n                type=\"button\"\n                className={styles.close}\n                aria-label={dismissLabel}\n                onClick={dismiss}\n            >\n                <X size={18} aria-hidden />\n            </button>\n        </div>\n    );\n}\n"],"mappings":";;;;;;;;;AA8EA,SAAS,EAAc,GAAqB,GAAqC;CAC7E,IAAI,CAAC,KAAc,OAAO,SAAW,KAAa,OAAO;CACzD,IAAI;EACA,IAAM,IAAM,OAAO,aAAa,QAAQ,CAAU;EAClD,IAAI,CAAC,GAAK,OAAO;EACjB,IAAI,MAAQ,KAAK,OAAO;EACxB,IAAM,IAAc,OAAO,CAAG;EAG9B,OAFK,OAAO,SAAS,CAAW,IAC5B,MAAsB,KAAA,KACnB,KAAK,IAAI,IAAI,IAAc,IAFQ;CAG9C,QAAQ;EACJ,OAAO;CACX;AACJ;AAyBA,SAAgB,EAAc,EAC1B,WAAQ,iBACR,gBACA,kBAAe,YACf,eAAY,iBACZ,kBAAe,aACf,SACA,eACA,sBACA,gBAAa,GACb,0BACA,aACA,gBACmB;CACnB,IAAM,EAAE,WAAQ,uBAAoB,eAAY,EAAiB,EAAE,yBAAsB,CAAC,GACpF,CAAC,GAAW,KAAgB,QAC9B,EAAc,GAAY,CAAiB,CAC/C,GACM,CAAC,GAAU,KAAe,EAAS,EAAK,GACxC,IAAS,EAAM;CAErB,IAAI,MAAW,UAAU,GAAW,OAAO;CAE3C,IAAM,UAAsB;EAExB,IADA,EAAa,EAAI,GACb,KAAc,OAAO,SAAW,KAChC,IAAI;GACA,OAAO,aAAa,QAChB,GACA,MAAsB,KAAA,IAAY,MAAM,OAAO,KAAK,IAAI,CAAC,CAC7D;EACJ,QAAQ,CAER;CAER,GAEM,IAAO,MAAW,WAAW,OAAO,EAAW;EAAE;EAAQ;CAAmB,CAAC;CAEnF,OACI,kBAAC,OAAD;EAAK,WAAW,EAAG,EAAO,QAAQ,CAAS;EAAG,MAAK;EAAS,cAAY,OAAO,CAAK;EAApF,UAAA;GACK,KAAQ,kBAAC,QAAD;IAAM,WAAW,EAAO;IAAO,UAAA;GAAW,CAAA;GACnD,kBAAC,OAAD;IAAK,WAAW,EAAO;IAAvB,UAAA;KACI,kBAAC,KAAD;MAAG,WAAW,EAAO;MAAQ,UAAA;KAAS,CAAA;KACrC,KAAe,kBAAC,KAAD;MAAG,WAAW,EAAO;MAAc,UAAA;KAAe,CAAA;KACjE,KAAY,IACT,kBAAC,KAAD;MAAG,WAAW,EAAO;MAAM,IAAI;MAC1B,UAAA;KACF,CAAA,IACH;IACH;;GACJ,MAAW,WACR,kBAAC,GAAD;IACI,MAAK;IACL,SAAS,YAAY;KACjB,IAAM,IAAW,MAAM,EAAQ;KAC/B,IAAW,IAAW,aAAa,WAAW;IAClD;IAEC,UAAA;GACG,CAAA,IAER,kBAAC,GAAD;IACI,MAAK;IACL,iBAAe;IACf,iBAAe,KAAY,IAAO,IAAS,KAAA;IAC3C,eAAe,GAAa,MAAS,CAAC,CAAI;IAEzC,UAAA;GACG,CAAA;GAEZ,kBAAC,UAAD;IACI,MAAK;IACL,WAAW,EAAO;IAClB,cAAY;IACZ,SAAS;IAET,UAAA,kBAAC,GAAD;KAAG,MAAM;KAAI,eAAA;IAAa,CAAA;GACtB,CAAA;EACP;;AAEb"}

package/dist/components/InstallBanner/InstallBanner.module.cjs

@@ -1,3 +1,3 @@
 require("../../styles/component/InstallBanner.css");
-var e=`tempest_banner_0oCIc`,t=`tempest_icon_izjRL`,n=`tempest_body_9JAQv`,r=`tempest_title_1E50X`,i=`tempest_description_QY25-`,a=`tempest_close_RN6FO`,o={banner:e,icon:t,body:n,title:r,description:i,close:a};exports.banner=e,exports.body=n,exports.close=a,exports.default=o,exports.description=i,exports.icon=t,exports.title=r;
+var e=`tempest_banner_0oCIc`,t=`tempest_icon_izjRL`,n=`tempest_body_9JAQv`,r=`tempest_title_1E50X`,i=`tempest_description_QY25-`,a=`tempest_close_RN6FO`,o=`tempest_hint_aYJgR`,s={banner:e,icon:t,body:n,title:r,description:i,close:a,hint:o};exports.banner=e,exports.body=n,exports.close=a,exports.default=s,exports.description=i,exports.hint=o,exports.icon=t,exports.title=r;
 //# sourceMappingURL=InstallBanner.module.cjs.map

package/dist/components/InstallBanner/InstallBanner.module.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"InstallBanner.module.cjs","names":[],"sources":["../../../src/components/InstallBanner/InstallBanner.module.css"],"sourcesContent":[".banner {\n    display: flex;\n    align-items: center;\n    gap: var(--tempest-space-3);\n    padding: var(--tempest-space-3) var(--tempest-space-4);\n    border-radius: var(--tempest-radius-lg);\n    border: 1px solid var(--tempest-border);\n    background: var(--tempest-surface);\n    color: var(--tempest-text);\n    box-shadow: var(--tempest-shadow-lg);\n    width: 100%;\n    font-family: var(--tempest-font-sans);\n    font-size: var(--tempest-text-sm);\n    line-height: var(--tempest-leading-snug);\n}\n\n.icon {\n    flex: 0 0 auto;\n    display: inline-flex;\n    align-items: center;\n    line-height: 1;\n    color: var(--tempest-primary);\n}\n\n.body {\n    flex: 1 1 auto;\n    min-width: 0;\n}\n\n.title {\n    margin: 0;\n    font-weight: var(--tempest-weight-semibold);\n    color: var(--tempest-text);\n}\n\n.description {\n    margin: var(--tempest-space-1) 0 0;\n    color: var(--tempest-text-muted);\n}\n\n.close {\n    flex: 0 0 auto;\n    display: inline-flex;\n    align-items: center;\n    justify-content: center;\n    background: none;\n    border: 0;\n    color: var(--tempest-text-muted);\n    cursor: pointer;\n    padding: 0;\n    width: 28px;\n    height: 28px;\n    border-radius: var(--tempest-radius-sm);\n}\n\n.close:hover {\n    background: color-mix(in srgb, currentColor 10%, transparent);\n}\n"],"mappings":";"}
+{"version":3,"file":"InstallBanner.module.cjs","names":[],"sources":["../../../src/components/InstallBanner/InstallBanner.module.css"],"sourcesContent":[".banner {\n    display: flex;\n    align-items: center;\n    gap: var(--tempest-space-3);\n    padding: var(--tempest-space-3) var(--tempest-space-4);\n    border-radius: var(--tempest-radius-lg);\n    border: 1px solid var(--tempest-border);\n    background: var(--tempest-surface);\n    color: var(--tempest-text);\n    box-shadow: var(--tempest-shadow-lg);\n    width: 100%;\n    font-family: var(--tempest-font-sans);\n    font-size: var(--tempest-text-sm);\n    line-height: var(--tempest-leading-snug);\n}\n\n.icon {\n    flex: 0 0 auto;\n    display: inline-flex;\n    align-items: center;\n    line-height: 1;\n    color: var(--tempest-primary);\n}\n\n.body {\n    flex: 1 1 auto;\n    min-width: 0;\n}\n\n.title {\n    margin: 0;\n    font-weight: var(--tempest-weight-semibold);\n    color: var(--tempest-text);\n}\n\n.description {\n    margin: var(--tempest-space-1) 0 0;\n    color: var(--tempest-text-muted);\n}\n\n.close {\n    flex: 0 0 auto;\n    display: inline-flex;\n    align-items: center;\n    justify-content: center;\n    background: none;\n    border: 0;\n    color: var(--tempest-text-muted);\n    cursor: pointer;\n    padding: 0;\n    width: 28px;\n    height: 28px;\n    border-radius: var(--tempest-radius-sm);\n}\n\n.close:hover {\n    background: color-mix(in srgb, currentColor 10%, transparent);\n}\n\n.hint {\n    margin: var(--tempest-space-2) 0 0;\n    color: var(--tempest-text-muted);\n}\n\n.hint a {\n    color: var(--tempest-primary);\n}\n"],"mappings":";"}

package/dist/components/InstallBanner/InstallBanner.module.js

@@ -1,14 +1,15 @@
 import "../../styles/component/InstallBanner.css";
 //#region src/components/InstallBanner/InstallBanner.module.css
-var e = "tempest_banner_0oCIc", t = "tempest_icon_izjRL", n = "tempest_body_9JAQv", r = "tempest_title_1E50X", i = "tempest_description_QY25-", a = "tempest_close_RN6FO", o = {
+var e = "tempest_banner_0oCIc", t = "tempest_icon_izjRL", n = "tempest_body_9JAQv", r = "tempest_title_1E50X", i = "tempest_description_QY25-", a = "tempest_close_RN6FO", o = "tempest_hint_aYJgR", s = {
 	banner: e,
 	icon: t,
 	body: n,
 	title: r,
 	description: i,
-	close: a
+	close: a,
+	hint: o
 };
 //#endregion
-export { e as banner, n as body, a as close, o as default, i as description, t as icon, r as title };
+export { e as banner, n as body, a as close, s as default, i as description, o as hint, t as icon, r as title };
 
 //# sourceMappingURL=InstallBanner.module.js.map

package/dist/components/InstallBanner/InstallBanner.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"InstallBanner.module.js","names":[],"sources":["../../../src/components/InstallBanner/InstallBanner.module.css"],"sourcesContent":[".banner {\n    display: flex;\n    align-items: center;\n    gap: var(--tempest-space-3);\n    padding: var(--tempest-space-3) var(--tempest-space-4);\n    border-radius: var(--tempest-radius-lg);\n    border: 1px solid var(--tempest-border);\n    background: var(--tempest-surface);\n    color: var(--tempest-text);\n    box-shadow: var(--tempest-shadow-lg);\n    width: 100%;\n    font-family: var(--tempest-font-sans);\n    font-size: var(--tempest-text-sm);\n    line-height: var(--tempest-leading-snug);\n}\n\n.icon {\n    flex: 0 0 auto;\n    display: inline-flex;\n    align-items: center;\n    line-height: 1;\n    color: var(--tempest-primary);\n}\n\n.body {\n    flex: 1 1 auto;\n    min-width: 0;\n}\n\n.title {\n    margin: 0;\n    font-weight: var(--tempest-weight-semibold);\n    color: var(--tempest-text);\n}\n\n.description {\n    margin: var(--tempest-space-1) 0 0;\n    color: var(--tempest-text-muted);\n}\n\n.close {\n    flex: 0 0 auto;\n    display: inline-flex;\n    align-items: center;\n    justify-content: center;\n    background: none;\n    border: 0;\n    color: var(--tempest-text-muted);\n    cursor: pointer;\n    padding: 0;\n    width: 28px;\n    height: 28px;\n    border-radius: var(--tempest-radius-sm);\n}\n\n.close:hover {\n    background: color-mix(in srgb, currentColor 10%, transparent);\n}\n"],"mappings":";"}
+{"version":3,"file":"InstallBanner.module.js","names":[],"sources":["../../../src/components/InstallBanner/InstallBanner.module.css"],"sourcesContent":[".banner {\n    display: flex;\n    align-items: center;\n    gap: var(--tempest-space-3);\n    padding: var(--tempest-space-3) var(--tempest-space-4);\n    border-radius: var(--tempest-radius-lg);\n    border: 1px solid var(--tempest-border);\n    background: var(--tempest-surface);\n    color: var(--tempest-text);\n    box-shadow: var(--tempest-shadow-lg);\n    width: 100%;\n    font-family: var(--tempest-font-sans);\n    font-size: var(--tempest-text-sm);\n    line-height: var(--tempest-leading-snug);\n}\n\n.icon {\n    flex: 0 0 auto;\n    display: inline-flex;\n    align-items: center;\n    line-height: 1;\n    color: var(--tempest-primary);\n}\n\n.body {\n    flex: 1 1 auto;\n    min-width: 0;\n}\n\n.title {\n    margin: 0;\n    font-weight: var(--tempest-weight-semibold);\n    color: var(--tempest-text);\n}\n\n.description {\n    margin: var(--tempest-space-1) 0 0;\n    color: var(--tempest-text-muted);\n}\n\n.close {\n    flex: 0 0 auto;\n    display: inline-flex;\n    align-items: center;\n    justify-content: center;\n    background: none;\n    border: 0;\n    color: var(--tempest-text-muted);\n    cursor: pointer;\n    padding: 0;\n    width: 28px;\n    height: 28px;\n    border-radius: var(--tempest-radius-sm);\n}\n\n.close:hover {\n    background: color-mix(in srgb, currentColor 10%, transparent);\n}\n\n.hint {\n    margin: var(--tempest-space-2) 0 0;\n    color: var(--tempest-text-muted);\n}\n\n.hint a {\n    color: var(--tempest-primary);\n}\n"],"mappings":";"}

package/dist/components/InstallButton/InstallButton.cjs

@@ -1,2 +1,2 @@
-const e=require("../Button/Button.cjs"),t=require("../../hooks/use-before-install-prompt.cjs");let n=require("react/jsx-runtime");function r({label:r=`Instalar app`,onResult:i,...a}){let{installable:o,installed:s,isStandalone:c,prompt:l}=t.useBeforeInstallPrompt();return!o||s||c?null:(0,n.jsx)(e.Button,{onClick:async()=>{i?.(await l())},...a,children:r})}exports.InstallButton=r;
+const e=require("../../utils/cn.cjs"),t=require("../Button/Button.cjs"),n=require("../../hooks/use-install-prompt.cjs"),r=require("./install-hints.cjs"),i=require("./InstallButton.module.cjs");let a=require("react"),o=require("react/jsx-runtime");function s({label:s=`Instalar app`,hintLabel:c=`Como instalar`,onResult:l,renderHint:u=r.defaultInstallHint,manualFallbackDelayMs:d,wrapperClassName:f,...p}){let{method:m,openInChromeIntent:h,install:g}=n.useInstallPrompt({manualFallbackDelayMs:d}),[_,v]=(0,a.useState)(!1),y=(0,a.useId)();if(m===`none`)return null;if(m===`native`)return(0,o.jsx)(t.Button,{onClick:async()=>{let e=await g();l?.(e?`accepted`:`dismissed`)},...p,children:s});let b=u({method:m,openInChromeIntent:h});return(0,o.jsxs)(`div`,{className:e.cn(i.default.wrapper,f),children:[(0,o.jsx)(t.Button,{"aria-expanded":_,"aria-controls":_&&b?y:void 0,onClick:()=>v(e=>!e),...p,children:c}),_&&b?(0,o.jsx)(`p`,{className:i.default.hint,id:y,children:b}):null]})}exports.InstallButton=s;
 //# sourceMappingURL=InstallButton.cjs.map

package/dist/components/InstallButton/InstallButton.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"InstallButton.cjs","names":[],"sources":["../../../src/components/InstallButton/InstallButton.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport { Button, type ButtonProps } from \"@/components/Button\";\nimport { useBeforeInstallPrompt } from \"@/hooks/use-before-install-prompt\";\n\nexport type InstallOutcome = \"accepted\" | \"dismissed\" | \"unsupported\";\n\nexport interface InstallButtonProps extends Omit<ButtonProps, \"onClick\" | \"children\"> {\n    /** Button label. Default `\"Instalar app\"`. */\n    label?: ReactNode;\n    /** Called with the user's choice after the install prompt resolves. */\n    onResult?: (outcome: InstallOutcome) => void;\n}\n\n/**\n * Button wired to the PWA install prompt ({@link useBeforeInstallPrompt}).\n * Renders nothing when the app can't be installed — no prompt captured yet,\n * already installed, or running standalone — so you can drop it anywhere\n * without guarding visibility yourself.\n *\n * Inherits every {@link Button} prop (`variant`, `size`, `leftIcon`, …).\n *\n * @example\n * <InstallButton variant=\"primary\" leftIcon={<Download />} />\n */\nexport function InstallButton({ label = \"Instalar app\", onResult, ...props }: InstallButtonProps) {\n    const { installable, installed, isStandalone, prompt } = useBeforeInstallPrompt();\n    if (!installable || installed || isStandalone) return null;\n    return (\n        <Button\n            onClick={async () => {\n                onResult?.(await prompt());\n            }}\n            {...props}\n        >\n            {label}\n        </Button>\n    );\n}\n"],"mappings":"kIAwBA,SAAgB,EAAc,CAAE,QAAQ,eAAgB,WAAU,GAAG,GAA6B,CAC9F,GAAM,CAAE,cAAa,YAAW,eAAc,UAAW,EAAA,uBAAuB,EAEhF,MADI,CAAC,GAAe,GAAa,EAAqB,MAElD,EAAA,EAAA,IAAA,CAAC,EAAA,OAAD,CACI,QAAS,SAAY,CACjB,IAAW,MAAM,EAAO,CAAC,CAC7B,EACA,GAAI,EAEH,SAAA,CACG,CAAA,CAEhB"}
+{"version":3,"file":"InstallButton.cjs","names":[],"sources":["../../../src/components/InstallButton/InstallButton.tsx"],"sourcesContent":["import { useId, useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { Button, type ButtonProps } from \"@/components/Button\";\nimport { useInstallPrompt } from \"@/hooks/use-install-prompt\";\nimport { cn } from \"@/utils/cn\";\nimport { defaultInstallHint, type RenderInstallHint } from \"./install-hints\";\nimport styles from \"./InstallButton.module.css\";\n\nexport type InstallOutcome = \"accepted\" | \"dismissed\" | \"unsupported\";\n\nexport interface InstallButtonProps extends Omit<ButtonProps, \"onClick\" | \"children\"> {\n    /** Button label. Default `\"Instalar app\"`. */\n    label?: ReactNode;\n    /**\n     * Label used when the browser cannot be prompted and the button reveals the\n     * manual instruction instead. Default `\"Como instalar\"`.\n     */\n    hintLabel?: ReactNode;\n    /** Called with the user's choice after the install prompt resolves. */\n    onResult?: (outcome: InstallOutcome) => void;\n    /**\n     * Replaces the instruction shown for the `\"ios\"` and `\"manual\"` methods.\n     *\n     * The default copy is in PT-BR and names the real menu entries. Pass this to\n     * translate it, to shorten it, or to point at a screenshot of your own.\n     */\n    renderHint?: RenderInstallHint;\n    /**\n     * How long, in ms, to wait for `beforeinstallprompt` before falling back to\n     * the manual instruction. Forwarded to {@link useInstallPrompt}; defaults to\n     * 3000 there.\n     */\n    manualFallbackDelayMs?: number;\n    /** Class applied to the wrapper that holds the button and the instruction. */\n    wrapperClassName?: string;\n}\n\n/**\n * Button wired to PWA installation, through {@link useInstallPrompt}.\n *\n * Where the browser fires `beforeinstallprompt`, the click installs. Where it\n * does not — iOS Safari, and the Android Chromium forks (Mi Browser, UC, Opera\n * Mini, Huawei) that strip the API — the click reveals the instruction for that\n * platform instead of the button disappearing.\n *\n * That disappearance was the defect: the component was built on\n * `useBeforeInstallPrompt`, so it rendered `null` exactly where the user needs\n * the most help, and every app re-implemented the iOS and manual paths locally.\n * Nothing renders only when there is genuinely nothing to offer — already\n * installed, running standalone, or inside the decline cooldown.\n *\n * Inherits every {@link Button} prop (`variant`, `size`, `leftIcon`, …).\n *\n * @example\n * <InstallButton variant=\"primary\" leftIcon={<Download />} />\n *\n * @example\n * <InstallButton renderHint={({ method }) => (method === \"ios\" ? <IOSSteps /> : <MenuSteps />)} />\n */\nexport function InstallButton({\n    label = \"Instalar app\",\n    hintLabel = \"Como instalar\",\n    onResult,\n    renderHint = defaultInstallHint,\n    manualFallbackDelayMs,\n    wrapperClassName,\n    ...props\n}: InstallButtonProps) {\n    const { method, openInChromeIntent, install } = useInstallPrompt({ manualFallbackDelayMs });\n    const [hintOpen, setHintOpen] = useState(false);\n    const hintId = useId();\n\n    if (method === \"none\") return null;\n\n    if (method === \"native\") {\n        return (\n            <Button\n                onClick={async () => {\n                    const accepted = await install();\n                    onResult?.(accepted ? \"accepted\" : \"dismissed\");\n                }}\n                {...props}\n            >\n                {label}\n            </Button>\n        );\n    }\n\n    const hint = renderHint({ method, openInChromeIntent });\n\n    return (\n        <div className={cn(styles.wrapper, wrapperClassName)}>\n            <Button\n                aria-expanded={hintOpen}\n                aria-controls={hintOpen && hint ? hintId : undefined}\n                onClick={() => setHintOpen((open) => !open)}\n                {...props}\n            >\n                {hintLabel}\n            </Button>\n            {hintOpen && hint ? (\n                <p className={styles.hint} id={hintId}>\n                    {hint}\n                </p>\n            ) : null}\n        </div>\n    );\n}\n"],"mappings":"uPA2DA,SAAgB,EAAc,CAC1B,QAAQ,eACR,YAAY,gBACZ,WACA,aAAa,EAAA,mBACb,wBACA,mBACA,GAAG,GACgB,CACnB,GAAM,CAAE,SAAQ,qBAAoB,WAAY,EAAA,iBAAiB,CAAE,uBAAsB,CAAC,EACpF,CAAC,EAAU,IAAA,EAAe,EAAA,SAAA,CAAS,EAAK,EACxC,GAAA,EAAS,EAAA,MAAA,CAAM,EAErB,GAAI,IAAW,OAAQ,OAAO,KAE9B,GAAI,IAAW,SACX,OACI,EAAA,EAAA,IAAA,CAAC,EAAA,OAAD,CACI,QAAS,SAAY,CACjB,IAAM,EAAW,MAAM,EAAQ,EAC/B,IAAW,EAAW,WAAa,WAAW,CAClD,EACA,GAAI,EAEH,SAAA,CACG,CAAA,EAIhB,IAAM,EAAO,EAAW,CAAE,SAAQ,oBAAmB,CAAC,EAEtD,OACI,EAAA,EAAA,KAAA,CAAC,MAAD,CAAK,UAAW,EAAA,GAAG,EAAA,QAAO,QAAS,CAAgB,EAAnD,SAAA,EACI,EAAA,EAAA,IAAA,CAAC,EAAA,OAAD,CACI,gBAAe,EACf,gBAAe,GAAY,EAAO,EAAS,IAAA,GAC3C,YAAe,EAAa,GAAS,CAAC,CAAI,EAC1C,GAAI,EAEH,SAAA,CACG,CAAA,EACP,GAAY,GACT,EAAA,EAAA,IAAA,CAAC,IAAD,CAAG,UAAW,EAAA,QAAO,KAAM,GAAI,EAC1B,SAAA,CACF,CAAA,EACH,IACH,GAEb"}

package/dist/components/InstallButton/InstallButton.js

@@ -1,18 +1,42 @@
-import { Button as e } from "../Button/Button.js";
-import { useBeforeInstallPrompt as t } from "../../hooks/use-before-install-prompt.js";
-import { jsx as n } from "react/jsx-runtime";
+import { cn as e } from "../../utils/cn.js";
+import { Button as t } from "../Button/Button.js";
+import { useInstallPrompt as n } from "../../hooks/use-install-prompt.js";
+import { defaultInstallHint as r } from "./install-hints.js";
+import i from "./InstallButton.module.js";
+import { useId as a, useState as o } from "react";
+import { jsx as s, jsxs as c } from "react/jsx-runtime";
 //#region src/components/InstallButton/InstallButton.tsx
-function r({ label: r = "Instalar app", onResult: i, ...a }) {
-	let { installable: o, installed: s, isStandalone: c, prompt: l } = t();
-	return !o || s || c ? null : /* @__PURE__ */ n(e, {
+function l({ label: l = "Instalar app", hintLabel: u = "Como instalar", onResult: d, renderHint: f = r, manualFallbackDelayMs: p, wrapperClassName: m, ...h }) {
+	let { method: g, openInChromeIntent: _, install: v } = n({ manualFallbackDelayMs: p }), [y, b] = o(!1), x = a();
+	if (g === "none") return null;
+	if (g === "native") return /* @__PURE__ */ s(t, {
 		onClick: async () => {
-			i?.(await l());
+			let e = await v();
+			d?.(e ? "accepted" : "dismissed");
 		},
-		...a,
-		children: r
+		...h,
+		children: l
+	});
+	let S = f({
+		method: g,
+		openInChromeIntent: _
+	});
+	return /* @__PURE__ */ c("div", {
+		className: e(i.wrapper, m),
+		children: [/* @__PURE__ */ s(t, {
+			"aria-expanded": y,
+			"aria-controls": y && S ? x : void 0,
+			onClick: () => b((e) => !e),
+			...h,
+			children: u
+		}), y && S ? /* @__PURE__ */ s("p", {
+			className: i.hint,
+			id: x,
+			children: S
+		}) : null]
 	});
 }
 //#endregion
-export { r as InstallButton };
+export { l as InstallButton };
 
 //# sourceMappingURL=InstallButton.js.map

package/dist/components/InstallButton/InstallButton.js.map

@@ -1 +1 @@
-{"version":3,"file":"InstallButton.js","names":[],"sources":["../../../src/components/InstallButton/InstallButton.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport { Button, type ButtonProps } from \"@/components/Button\";\nimport { useBeforeInstallPrompt } from \"@/hooks/use-before-install-prompt\";\n\nexport type InstallOutcome = \"accepted\" | \"dismissed\" | \"unsupported\";\n\nexport interface InstallButtonProps extends Omit<ButtonProps, \"onClick\" | \"children\"> {\n    /** Button label. Default `\"Instalar app\"`. */\n    label?: ReactNode;\n    /** Called with the user's choice after the install prompt resolves. */\n    onResult?: (outcome: InstallOutcome) => void;\n}\n\n/**\n * Button wired to the PWA install prompt ({@link useBeforeInstallPrompt}).\n * Renders nothing when the app can't be installed — no prompt captured yet,\n * already installed, or running standalone — so you can drop it anywhere\n * without guarding visibility yourself.\n *\n * Inherits every {@link Button} prop (`variant`, `size`, `leftIcon`, …).\n *\n * @example\n * <InstallButton variant=\"primary\" leftIcon={<Download />} />\n */\nexport function InstallButton({ label = \"Instalar app\", onResult, ...props }: InstallButtonProps) {\n    const { installable, installed, isStandalone, prompt } = useBeforeInstallPrompt();\n    if (!installable || installed || isStandalone) return null;\n    return (\n        <Button\n            onClick={async () => {\n                onResult?.(await prompt());\n            }}\n            {...props}\n        >\n            {label}\n        </Button>\n    );\n}\n"],"mappings":";;;;AAwBA,SAAgB,EAAc,EAAE,WAAQ,gBAAgB,aAAU,GAAG,KAA6B;CAC9F,IAAM,EAAE,gBAAa,cAAW,iBAAc,cAAW,EAAuB;CAEhF,OADI,CAAC,KAAe,KAAa,IAAqB,OAElD,kBAAC,GAAD;EACI,SAAS,YAAY;GACjB,IAAW,MAAM,EAAO,CAAC;EAC7B;EACA,GAAI;EAEH,UAAA;CACG,CAAA;AAEhB"}
+{"version":3,"file":"InstallButton.js","names":[],"sources":["../../../src/components/InstallButton/InstallButton.tsx"],"sourcesContent":["import { useId, useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { Button, type ButtonProps } from \"@/components/Button\";\nimport { useInstallPrompt } from \"@/hooks/use-install-prompt\";\nimport { cn } from \"@/utils/cn\";\nimport { defaultInstallHint, type RenderInstallHint } from \"./install-hints\";\nimport styles from \"./InstallButton.module.css\";\n\nexport type InstallOutcome = \"accepted\" | \"dismissed\" | \"unsupported\";\n\nexport interface InstallButtonProps extends Omit<ButtonProps, \"onClick\" | \"children\"> {\n    /** Button label. Default `\"Instalar app\"`. */\n    label?: ReactNode;\n    /**\n     * Label used when the browser cannot be prompted and the button reveals the\n     * manual instruction instead. Default `\"Como instalar\"`.\n     */\n    hintLabel?: ReactNode;\n    /** Called with the user's choice after the install prompt resolves. */\n    onResult?: (outcome: InstallOutcome) => void;\n    /**\n     * Replaces the instruction shown for the `\"ios\"` and `\"manual\"` methods.\n     *\n     * The default copy is in PT-BR and names the real menu entries. Pass this to\n     * translate it, to shorten it, or to point at a screenshot of your own.\n     */\n    renderHint?: RenderInstallHint;\n    /**\n     * How long, in ms, to wait for `beforeinstallprompt` before falling back to\n     * the manual instruction. Forwarded to {@link useInstallPrompt}; defaults to\n     * 3000 there.\n     */\n    manualFallbackDelayMs?: number;\n    /** Class applied to the wrapper that holds the button and the instruction. */\n    wrapperClassName?: string;\n}\n\n/**\n * Button wired to PWA installation, through {@link useInstallPrompt}.\n *\n * Where the browser fires `beforeinstallprompt`, the click installs. Where it\n * does not — iOS Safari, and the Android Chromium forks (Mi Browser, UC, Opera\n * Mini, Huawei) that strip the API — the click reveals the instruction for that\n * platform instead of the button disappearing.\n *\n * That disappearance was the defect: the component was built on\n * `useBeforeInstallPrompt`, so it rendered `null` exactly where the user needs\n * the most help, and every app re-implemented the iOS and manual paths locally.\n * Nothing renders only when there is genuinely nothing to offer — already\n * installed, running standalone, or inside the decline cooldown.\n *\n * Inherits every {@link Button} prop (`variant`, `size`, `leftIcon`, …).\n *\n * @example\n * <InstallButton variant=\"primary\" leftIcon={<Download />} />\n *\n * @example\n * <InstallButton renderHint={({ method }) => (method === \"ios\" ? <IOSSteps /> : <MenuSteps />)} />\n */\nexport function InstallButton({\n    label = \"Instalar app\",\n    hintLabel = \"Como instalar\",\n    onResult,\n    renderHint = defaultInstallHint,\n    manualFallbackDelayMs,\n    wrapperClassName,\n    ...props\n}: InstallButtonProps) {\n    const { method, openInChromeIntent, install } = useInstallPrompt({ manualFallbackDelayMs });\n    const [hintOpen, setHintOpen] = useState(false);\n    const hintId = useId();\n\n    if (method === \"none\") return null;\n\n    if (method === \"native\") {\n        return (\n            <Button\n                onClick={async () => {\n                    const accepted = await install();\n                    onResult?.(accepted ? \"accepted\" : \"dismissed\");\n                }}\n                {...props}\n            >\n                {label}\n            </Button>\n        );\n    }\n\n    const hint = renderHint({ method, openInChromeIntent });\n\n    return (\n        <div className={cn(styles.wrapper, wrapperClassName)}>\n            <Button\n                aria-expanded={hintOpen}\n                aria-controls={hintOpen && hint ? hintId : undefined}\n                onClick={() => setHintOpen((open) => !open)}\n                {...props}\n            >\n                {hintLabel}\n            </Button>\n            {hintOpen && hint ? (\n                <p className={styles.hint} id={hintId}>\n                    {hint}\n                </p>\n            ) : null}\n        </div>\n    );\n}\n"],"mappings":";;;;;;;;AA2DA,SAAgB,EAAc,EAC1B,WAAQ,gBACR,eAAY,iBACZ,aACA,gBAAa,GACb,0BACA,qBACA,GAAG,KACgB;CACnB,IAAM,EAAE,WAAQ,uBAAoB,eAAY,EAAiB,EAAE,yBAAsB,CAAC,GACpF,CAAC,GAAU,KAAe,EAAS,EAAK,GACxC,IAAS,EAAM;CAErB,IAAI,MAAW,QAAQ,OAAO;CAE9B,IAAI,MAAW,UACX,OACI,kBAAC,GAAD;EACI,SAAS,YAAY;GACjB,IAAM,IAAW,MAAM,EAAQ;GAC/B,IAAW,IAAW,aAAa,WAAW;EAClD;EACA,GAAI;EAEH,UAAA;CACG,CAAA;CAIhB,IAAM,IAAO,EAAW;EAAE;EAAQ;CAAmB,CAAC;CAEtD,OACI,kBAAC,OAAD;EAAK,WAAW,EAAG,EAAO,SAAS,CAAgB;EAAnD,UAAA,CACI,kBAAC,GAAD;GACI,iBAAe;GACf,iBAAe,KAAY,IAAO,IAAS,KAAA;GAC3C,eAAe,GAAa,MAAS,CAAC,CAAI;GAC1C,GAAI;GAEH,UAAA;EACG,CAAA,GACP,KAAY,IACT,kBAAC,KAAD;GAAG,WAAW,EAAO;GAAM,IAAI;GAC1B,UAAA;EACF,CAAA,IACH,IACH;;AAEb"}

package/dist/components/InstallButton/InstallButton.module.cjs

@@ -0,0 +1,3 @@
+require("../../styles/component/InstallButton.css");
+var e=`tempest_wrapper_M6K7s`,t=`tempest_hint_4lawL`,n={wrapper:e,hint:t};exports.default=n,exports.hint=t,exports.wrapper=e;
+//# sourceMappingURL=InstallButton.module.cjs.map

package/dist/components/InstallButton/InstallButton.module.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"InstallButton.module.cjs","names":[],"sources":["../../../src/components/InstallButton/InstallButton.module.css"],"sourcesContent":[".wrapper {\n    display: inline-flex;\n    flex-direction: column;\n    align-items: flex-start;\n    gap: var(--tempest-space-2);\n    font-family: var(--tempest-font-sans);\n}\n\n.hint {\n    margin: 0;\n    max-width: 36ch;\n    color: var(--tempest-text-muted);\n    font-size: var(--tempest-text-sm);\n    line-height: var(--tempest-leading-snug);\n}\n\n.hint a {\n    color: var(--tempest-primary);\n}\n"],"mappings":";"}

package/dist/components/InstallButton/InstallButton.module.js

@@ -0,0 +1,10 @@
+import "../../styles/component/InstallButton.css";
+//#region src/components/InstallButton/InstallButton.module.css
+var e = "tempest_wrapper_M6K7s", t = "tempest_hint_4lawL", n = {
+	wrapper: e,
+	hint: t
+};
+//#endregion
+export { n as default, t as hint, e as wrapper };
+
+//# sourceMappingURL=InstallButton.module.js.map

package/dist/components/InstallButton/InstallButton.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InstallButton.module.js","names":[],"sources":["../../../src/components/InstallButton/InstallButton.module.css"],"sourcesContent":[".wrapper {\n    display: inline-flex;\n    flex-direction: column;\n    align-items: flex-start;\n    gap: var(--tempest-space-2);\n    font-family: var(--tempest-font-sans);\n}\n\n.hint {\n    margin: 0;\n    max-width: 36ch;\n    color: var(--tempest-text-muted);\n    font-size: var(--tempest-text-sm);\n    line-height: var(--tempest-leading-snug);\n}\n\n.hint a {\n    color: var(--tempest-primary);\n}\n"],"mappings":";"}

package/dist/components/InstallButton/install-hints.cjs

@@ -0,0 +1,2 @@
+let e=require("react/jsx-runtime");function t({method:t,openInChromeIntent:n}){return t===`ios`?(0,e.jsxs)(e.Fragment,{children:[`Toque em `,(0,e.jsx)(`strong`,{children:`Compartilhar`}),` e escolha`,` `,(0,e.jsx)(`strong`,{children:`Adicionar à Tela de Início`}),`.`]}):t===`manual`?(0,e.jsxs)(e.Fragment,{children:[`Abra o menu do navegador (`,(0,e.jsx)(`strong`,{children:`⋮`}),`) e escolha`,` `,(0,e.jsx)(`strong`,{children:`Instalar app`}),`.`,n?(0,e.jsxs)(e.Fragment,{children:[` `,`Se não houver essa opção, `,(0,e.jsx)(`a`,{href:n,children:`abra no Chrome`}),`.`]}):null]}):null}exports.defaultInstallHint=t;
+//# sourceMappingURL=install-hints.cjs.map

package/dist/components/InstallButton/install-hints.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-hints.cjs","names":[],"sources":["../../../src/components/InstallButton/install-hints.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\n\nimport type { InstallMethod } from \"@/hooks/use-install-prompt\";\n\n/** What an install affordance needs to render the instruction for a method. */\nexport interface InstallHintInput {\n    /** The strategy `useInstallPrompt` resolved. */\n    method: InstallMethod;\n    /** An `intent://` URL that re-opens the page in Chrome on Android, if any. */\n    openInChromeIntent: string | null;\n}\n\n/** Renders the instruction shown when the browser has no install prompt. */\nexport type RenderInstallHint = (input: InstallHintInput) => ReactNode;\n\n/**\n * The default instruction for a browser that cannot be prompted.\n *\n * Written out rather than left to the app because every app wrote the same two\n * sentences, and getting them wrong is invisible: an iOS user who is told to\n * look for an \"Install\" menu never finds one, because Safari puts it behind the\n * Share sheet.\n *\n * On an Android fork the copy also offers the `intent://` link the SDK already\n * builds — reopening the page in Chrome is the only path that reaches a real\n * install on a browser whose menu has no install entry at all.\n *\n * @param input - The resolved method and the optional Chrome intent.\n * @returns The instruction, or `null` when the method needs none.\n */\nexport function defaultInstallHint({ method, openInChromeIntent }: InstallHintInput): ReactNode {\n    if (method === \"ios\") {\n        return (\n            <>\n                Toque em <strong>Compartilhar</strong> e escolha{\" \"}\n                <strong>Adicionar à Tela de Início</strong>.\n            </>\n        );\n    }\n    if (method === \"manual\") {\n        return (\n            <>\n                Abra o menu do navegador (<strong>⋮</strong>) e escolha{\" \"}\n                <strong>Instalar app</strong>.\n                {openInChromeIntent ? (\n                    <>\n                        {\" \"}\n                        Se não houver essa opção, <a href={openInChromeIntent}>abra no Chrome</a>.\n                    </>\n                ) : null}\n            </>\n        );\n    }\n    return null;\n}\n"],"mappings":"mCA8BA,SAAgB,EAAmB,CAAE,SAAQ,sBAAmD,CAuB5F,OAtBI,IAAW,OAEP,EAAA,EAAA,KAAA,CAAA,EAAA,SAAA,CAAA,SAAA,CAAE,aACW,EAAA,EAAA,IAAA,CAAC,SAAD,CAAA,SAAQ,cAAoB,CAAA,EAAC,aAAW,KACjD,EAAA,EAAA,IAAA,CAAC,SAAD,CAAA,SAAQ,4BAAkC,CAAA,EAAC,GAC7C,CAAA,CAAA,EAGN,IAAW,UAEP,EAAA,EAAA,KAAA,CAAA,EAAA,SAAA,CAAA,SAAA,CAAE,8BAC4B,EAAA,EAAA,IAAA,CAAC,SAAD,CAAA,SAAQ,GAAS,CAAA,EAAC,cAAY,KACxD,EAAA,EAAA,IAAA,CAAC,SAAD,CAAA,SAAQ,cAAoB,CAAA,EAAC,IAC5B,GACG,EAAA,EAAA,KAAA,CAAA,EAAA,SAAA,CAAA,SAAA,CACK,IAAI,8BACqB,EAAA,EAAA,IAAA,CAAC,IAAD,CAAG,KAAM,EAAoB,SAAA,gBAAiB,CAAA,EAAC,GAC3E,CAAA,CAAA,EACF,IACN,CAAA,CAAA,EAGH,IACX"}

package/dist/components/InstallButton/install-hints.js

@@ -0,0 +1,32 @@
+import { Fragment as e, jsx as t, jsxs as n } from "react/jsx-runtime";
+//#region src/components/InstallButton/install-hints.tsx
+function r({ method: r, openInChromeIntent: i }) {
+	return r === "ios" ? /* @__PURE__ */ n(e, { children: [
+		"Toque em ",
+		/* @__PURE__ */ t("strong", { children: "Compartilhar" }),
+		" e escolha",
+		" ",
+		/* @__PURE__ */ t("strong", { children: "Adicionar à Tela de Início" }),
+		"."
+	] }) : r === "manual" ? /* @__PURE__ */ n(e, { children: [
+		"Abra o menu do navegador (",
+		/* @__PURE__ */ t("strong", { children: "⋮" }),
+		") e escolha",
+		" ",
+		/* @__PURE__ */ t("strong", { children: "Instalar app" }),
+		".",
+		i ? /* @__PURE__ */ n(e, { children: [
+			" ",
+			"Se não houver essa opção, ",
+			/* @__PURE__ */ t("a", {
+				href: i,
+				children: "abra no Chrome"
+			}),
+			"."
+		] }) : null
+	] }) : null;
+}
+//#endregion
+export { r as defaultInstallHint };
+
+//# sourceMappingURL=install-hints.js.map

package/dist/components/InstallButton/install-hints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-hints.js","names":[],"sources":["../../../src/components/InstallButton/install-hints.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\n\nimport type { InstallMethod } from \"@/hooks/use-install-prompt\";\n\n/** What an install affordance needs to render the instruction for a method. */\nexport interface InstallHintInput {\n    /** The strategy `useInstallPrompt` resolved. */\n    method: InstallMethod;\n    /** An `intent://` URL that re-opens the page in Chrome on Android, if any. */\n    openInChromeIntent: string | null;\n}\n\n/** Renders the instruction shown when the browser has no install prompt. */\nexport type RenderInstallHint = (input: InstallHintInput) => ReactNode;\n\n/**\n * The default instruction for a browser that cannot be prompted.\n *\n * Written out rather than left to the app because every app wrote the same two\n * sentences, and getting them wrong is invisible: an iOS user who is told to\n * look for an \"Install\" menu never finds one, because Safari puts it behind the\n * Share sheet.\n *\n * On an Android fork the copy also offers the `intent://` link the SDK already\n * builds — reopening the page in Chrome is the only path that reaches a real\n * install on a browser whose menu has no install entry at all.\n *\n * @param input - The resolved method and the optional Chrome intent.\n * @returns The instruction, or `null` when the method needs none.\n */\nexport function defaultInstallHint({ method, openInChromeIntent }: InstallHintInput): ReactNode {\n    if (method === \"ios\") {\n        return (\n            <>\n                Toque em <strong>Compartilhar</strong> e escolha{\" \"}\n                <strong>Adicionar à Tela de Início</strong>.\n            </>\n        );\n    }\n    if (method === \"manual\") {\n        return (\n            <>\n                Abra o menu do navegador (<strong>⋮</strong>) e escolha{\" \"}\n                <strong>Instalar app</strong>.\n                {openInChromeIntent ? (\n                    <>\n                        {\" \"}\n                        Se não houver essa opção, <a href={openInChromeIntent}>abra no Chrome</a>.\n                    </>\n                ) : null}\n            </>\n        );\n    }\n    return null;\n}\n"],"mappings":";;AA8BA,SAAgB,EAAmB,EAAE,WAAQ,yBAAmD;CAuB5F,OAtBI,MAAW,QAEP,kBAAA,GAAA,EAAA,UAAA;EAAE;EACW,kBAAC,UAAD,EAAA,UAAQ,eAAoB,CAAA;EAAC;EAAW;EACjD,kBAAC,UAAD,EAAA,UAAQ,6BAAkC,CAAA;EAAC;CAC7C,EAAA,CAAA,IAGN,MAAW,WAEP,kBAAA,GAAA,EAAA,UAAA;EAAE;EAC4B,kBAAC,UAAD,EAAA,UAAQ,IAAS,CAAA;EAAC;EAAY;EACxD,kBAAC,UAAD,EAAA,UAAQ,eAAoB,CAAA;EAAC;EAC5B,IACG,kBAAA,GAAA,EAAA,UAAA;GACK;GAAI;GACqB,kBAAC,KAAD;IAAG,MAAM;IAAoB,UAAA;GAAiB,CAAA;GAAC;EAC3E,EAAA,CAAA,IACF;CACN,EAAA,CAAA,IAGH;AACX"}

package/dist/components/SegmentedControl/SegmentedControl.module.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"SegmentedControl.module.cjs","names":[],"sources":["../../../src/components/SegmentedControl/SegmentedControl.module.css"],"sourcesContent":[".group {\n    display: inline-flex;\n    background: var(--tempest-surface-2);\n    border-radius: var(--tempest-radius-md);\n    padding: 2px;\n    font-family: var(--tempest-font-sans);\n    gap: 0;\n}\n\n.group.fullWidth {\n    display: flex;\n    width: 100%;\n}\n\n.segment {\n    flex: 1 1 0;\n    display: inline-flex;\n    align-items: center;\n    justify-content: center;\n    gap: var(--tempest-space-1);\n    padding: 6px 12px;\n    border: 0;\n    background: transparent;\n    color: var(--tempest-text-muted);\n    cursor: pointer;\n    border-radius: calc(var(--tempest-radius-md) - 2px);\n    font-weight: var(--tempest-weight-medium);\n    transition:\n        background var(--tempest-duration-fast, 120ms),\n        color var(--tempest-duration-fast, 120ms);\n    white-space: nowrap;\n}\n\n.group.sm .segment {\n    padding: 4px 10px;\n    font-size: var(--tempest-text-xs);\n    min-height: 24px;\n}\n\n.group.md .segment {\n    padding: 6px 12px;\n    font-size: var(--tempest-text-sm);\n    min-height: 32px;\n}\n\n.group.lg .segment {\n    padding: 8px 14px;\n    font-size: var(--tempest-text-md);\n    min-height: 40px;\n}\n\n.segment:hover {\n    color: var(--tempest-text);\n}\n\n.segment.active {\n    background: var(--tempest-surface);\n    color: var(--tempest-text);\n    box-shadow: var(--tempest-shadow-xs, 0 1px 2px rgb(0 0 0 / 0.08));\n}\n\n.segment:disabled {\n    opacity: 0.4;\n    cursor: not-allowed;\n}\n\n.icon {\n    display: inline-flex;\n    align-items: center;\n}\n\n.label {\n    line-height: 1;\n}\n"],"mappings":";"}
+{"version":3,"file":"SegmentedControl.module.cjs","names":[],"sources":["../../../src/components/SegmentedControl/SegmentedControl.module.css"],"sourcesContent":[".group {\n    display: inline-flex;\n    background: var(--tempest-surface-2);\n    border-radius: var(--tempest-radius-md);\n    padding: 2px;\n    font-family: var(--tempest-font-sans);\n    gap: 0;\n}\n\n.group.fullWidth {\n    display: flex;\n    width: 100%;\n}\n\n.segment {\n    flex: 1 1 0;\n    display: inline-flex;\n    align-items: center;\n    justify-content: center;\n    gap: var(--tempest-space-1);\n    padding: 6px 12px;\n    border: 0;\n    background: transparent;\n    color: var(--tempest-text-muted);\n    cursor: pointer;\n    border-radius: calc(var(--tempest-radius-md) - 2px);\n    font-weight: var(--tempest-weight-medium);\n    transition:\n        background var(--tempest-duration-fast, 120ms),\n        color var(--tempest-duration-fast, 120ms);\n    white-space: nowrap;\n}\n\n.group.sm .segment {\n    padding: 4px 10px;\n    font-size: var(--tempest-text-xs);\n    min-height: 24px;\n}\n\n.group.md .segment {\n    padding: 6px 12px;\n    font-size: var(--tempest-text-sm);\n    min-height: 32px;\n}\n\n.group.lg .segment {\n    padding: 8px 14px;\n    font-size: var(--tempest-text-md);\n    min-height: 40px;\n}\n\n.segment:hover {\n    color: var(--tempest-text);\n}\n\n.segment.active {\n    background: var(--tempest-primary-soft);\n    color: var(--tempest-primary-on-soft);\n    box-shadow:\n        inset 0 0 0 2px var(--tempest-selected-indicator),\n        var(--tempest-shadow-xs, 0 1px 2px rgb(0 0 0 / 0.08));\n}\n\n.segment:disabled {\n    opacity: 0.4;\n    cursor: not-allowed;\n}\n\n.icon {\n    display: inline-flex;\n    align-items: center;\n}\n\n.label {\n    line-height: 1;\n}\n"],"mappings":";"}

package/dist/components/SegmentedControl/SegmentedControl.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"SegmentedControl.module.js","names":[],"sources":["../../../src/components/SegmentedControl/SegmentedControl.module.css"],"sourcesContent":[".group {\n    display: inline-flex;\n    background: var(--tempest-surface-2);\n    border-radius: var(--tempest-radius-md);\n    padding: 2px;\n    font-family: var(--tempest-font-sans);\n    gap: 0;\n}\n\n.group.fullWidth {\n    display: flex;\n    width: 100%;\n}\n\n.segment {\n    flex: 1 1 0;\n    display: inline-flex;\n    align-items: center;\n    justify-content: center;\n    gap: var(--tempest-space-1);\n    padding: 6px 12px;\n    border: 0;\n    background: transparent;\n    color: var(--tempest-text-muted);\n    cursor: pointer;\n    border-radius: calc(var(--tempest-radius-md) - 2px);\n    font-weight: var(--tempest-weight-medium);\n    transition:\n        background var(--tempest-duration-fast, 120ms),\n        color var(--tempest-duration-fast, 120ms);\n    white-space: nowrap;\n}\n\n.group.sm .segment {\n    padding: 4px 10px;\n    font-size: var(--tempest-text-xs);\n    min-height: 24px;\n}\n\n.group.md .segment {\n    padding: 6px 12px;\n    font-size: var(--tempest-text-sm);\n    min-height: 32px;\n}\n\n.group.lg .segment {\n    padding: 8px 14px;\n    font-size: var(--tempest-text-md);\n    min-height: 40px;\n}\n\n.segment:hover {\n    color: var(--tempest-text);\n}\n\n.segment.active {\n    background: var(--tempest-surface);\n    color: var(--tempest-text);\n    box-shadow: var(--tempest-shadow-xs, 0 1px 2px rgb(0 0 0 / 0.08));\n}\n\n.segment:disabled {\n    opacity: 0.4;\n    cursor: not-allowed;\n}\n\n.icon {\n    display: inline-flex;\n    align-items: center;\n}\n\n.label {\n    line-height: 1;\n}\n"],"mappings":";"}
+{"version":3,"file":"SegmentedControl.module.js","names":[],"sources":["../../../src/components/SegmentedControl/SegmentedControl.module.css"],"sourcesContent":[".group {\n    display: inline-flex;\n    background: var(--tempest-surface-2);\n    border-radius: var(--tempest-radius-md);\n    padding: 2px;\n    font-family: var(--tempest-font-sans);\n    gap: 0;\n}\n\n.group.fullWidth {\n    display: flex;\n    width: 100%;\n}\n\n.segment {\n    flex: 1 1 0;\n    display: inline-flex;\n    align-items: center;\n    justify-content: center;\n    gap: var(--tempest-space-1);\n    padding: 6px 12px;\n    border: 0;\n    background: transparent;\n    color: var(--tempest-text-muted);\n    cursor: pointer;\n    border-radius: calc(var(--tempest-radius-md) - 2px);\n    font-weight: var(--tempest-weight-medium);\n    transition:\n        background var(--tempest-duration-fast, 120ms),\n        color var(--tempest-duration-fast, 120ms);\n    white-space: nowrap;\n}\n\n.group.sm .segment {\n    padding: 4px 10px;\n    font-size: var(--tempest-text-xs);\n    min-height: 24px;\n}\n\n.group.md .segment {\n    padding: 6px 12px;\n    font-size: var(--tempest-text-sm);\n    min-height: 32px;\n}\n\n.group.lg .segment {\n    padding: 8px 14px;\n    font-size: var(--tempest-text-md);\n    min-height: 40px;\n}\n\n.segment:hover {\n    color: var(--tempest-text);\n}\n\n.segment.active {\n    background: var(--tempest-primary-soft);\n    color: var(--tempest-primary-on-soft);\n    box-shadow:\n        inset 0 0 0 2px var(--tempest-selected-indicator),\n        var(--tempest-shadow-xs, 0 1px 2px rgb(0 0 0 / 0.08));\n}\n\n.segment:disabled {\n    opacity: 0.4;\n    cursor: not-allowed;\n}\n\n.icon {\n    display: inline-flex;\n    align-items: center;\n}\n\n.label {\n    line-height: 1;\n}\n"],"mappings":";"}

package/dist/components/Select/Select.cjs

@@ -1,2 +1,2 @@
-const e=require("../../utils/cn.cjs"),t=require("./Select.module.cjs");let n=require("react"),r=require("react/jsx-runtime");var i=(0,n.forwardRef)(function({label:i,helperText:o,error:s,options:c,placeholder:l,wrapperClassName:u,className:d,children:f,id:p,required:m,...h},g){let _=(0,n.useId)(),v=p??_;return(0,r.jsxs)(`div`,{className:e.cn(t.default.wrapper,s&&t.default.error,u),children:[i&&(0,r.jsxs)(`label`,{htmlFor:v,className:t.default.label,children:[i,m&&(0,r.jsx)(`span`,{className:t.default.required,children:`*`})]}),(0,r.jsxs)(`div`,{className:t.default.field,children:[(0,r.jsxs)(`select`,{ref:g,id:v,"aria-invalid":!!s,required:m,className:e.cn(t.default.select,d),...h,children:[l&&(0,r.jsx)(`option`,{value:``,disabled:!0,hidden:!0,children:l}),c?.map(e=>(0,r.jsx)(`option`,{value:e.value,disabled:e.disabled,children:e.label},e.value)),f]}),(0,r.jsx)(`span`,{className:t.default.caret,"aria-hidden":!0,children:(0,r.jsx)(a,{})})]}),s?(0,r.jsx)(`span`,{className:t.default.errorText,children:s}):o?(0,r.jsx)(`span`,{className:t.default.helper,children:o}):null]})});function a(){return(0,r.jsx)(`svg`,{width:`14`,height:`14`,viewBox:`0 0 24 24`,fill:`none`,children:(0,r.jsx)(`path`,{d:`M6 9l6 6 6-6`,stroke:`currentColor`,strokeWidth:`2`,strokeLinecap:`round`,strokeLinejoin:`round`})})}exports.Select=i;
+const e=require("../../utils/cn.cjs"),t=require("./Select.module.cjs");let n=require("react"),r=require("react/jsx-runtime");var i=(0,n.forwardRef)(function(i,o){let{options:s,placeholder:c,wrapperClassName:l,className:u,children:d,id:f,required:p,variant:m=`field`,label:h,helperText:g,error:_,...v}=i,y=m===`chip`,b=(0,n.useId)(),x=f??b,S=(0,r.jsxs)(`div`,{className:e.cn(t.default.field,y&&t.default.chip),children:[(0,r.jsxs)(`select`,{ref:o,id:x,"aria-invalid":!!_,required:p,className:e.cn(t.default.select,u),...v,children:[c&&(0,r.jsx)(`option`,{value:``,disabled:!0,hidden:!0,children:c}),s?.map(e=>(0,r.jsx)(`option`,{value:e.value,disabled:e.disabled,children:e.label},e.value)),d]}),(0,r.jsx)(`span`,{className:t.default.caret,"aria-hidden":!0,children:(0,r.jsx)(a,{})})]});return y?(0,r.jsx)(`div`,{className:e.cn(t.default.chipWrapper,l),children:S}):(0,r.jsxs)(`div`,{className:e.cn(t.default.wrapper,_&&t.default.error,l),children:[h&&(0,r.jsxs)(`label`,{htmlFor:x,className:t.default.label,children:[h,p&&(0,r.jsx)(`span`,{className:t.default.required,children:`*`})]}),S,_?(0,r.jsx)(`span`,{className:t.default.errorText,children:_}):g?(0,r.jsx)(`span`,{className:t.default.helper,children:g}):null]})});function a(){return(0,r.jsx)(`svg`,{width:`14`,height:`14`,viewBox:`0 0 24 24`,fill:`none`,children:(0,r.jsx)(`path`,{d:`M6 9l6 6 6-6`,stroke:`currentColor`,strokeWidth:`2`,strokeLinecap:`round`,strokeLinejoin:`round`})})}exports.Select=i;
 //# sourceMappingURL=Select.cjs.map

package/dist/components/Select/Select.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"Select.cjs","names":[],"sources":["../../../src/components/Select/Select.tsx"],"sourcesContent":["import { forwardRef, useId } from \"react\";\nimport type { SelectHTMLAttributes } from \"react\";\nimport { cn } from \"@/utils/cn\";\nimport styles from \"./Select.module.css\";\n\nexport interface SelectOption {\n    value: string | number;\n    label: string;\n    disabled?: boolean;\n}\n\nexport interface SelectProps extends SelectHTMLAttributes<HTMLSelectElement> {\n    label?: string;\n    helperText?: string;\n    error?: string;\n    options?: SelectOption[];\n    placeholder?: string;\n    wrapperClassName?: string;\n}\n\n/**\n * Native `<select>` wrapper with label/helper/error slots. Either provide\n * `options` for a quick render, or pass `<option>` children directly.\n */\nexport const Select = forwardRef<HTMLSelectElement, SelectProps>(function Select(\n    {\n        label,\n        helperText,\n        error,\n        options,\n        placeholder,\n        wrapperClassName,\n        className,\n        children,\n        id,\n        required,\n        ...props\n    },\n    ref,\n) {\n    const generatedId = useId();\n    const selectId = id ?? generatedId;\n\n    return (\n        <div className={cn(styles.wrapper, error && styles.error, wrapperClassName)}>\n            {label && (\n                <label htmlFor={selectId} className={styles.label}>\n                    {label}\n                    {required && <span className={styles.required}>*</span>}\n                </label>\n            )}\n            <div className={styles.field}>\n                <select\n                    ref={ref}\n                    id={selectId}\n                    aria-invalid={!!error}\n                    required={required}\n                    className={cn(styles.select, className)}\n                    {...props}\n                >\n                    {placeholder && (\n                        <option value=\"\" disabled hidden>\n                            {placeholder}\n                        </option>\n                    )}\n                    {options?.map((opt) => (\n                        <option key={opt.value} value={opt.value} disabled={opt.disabled}>\n                            {opt.label}\n                        </option>\n                    ))}\n                    {children}\n                </select>\n                <span className={styles.caret} aria-hidden>\n                    <CaretIcon />\n                </span>\n            </div>\n            {error ? (\n                <span className={styles.errorText}>{error}</span>\n            ) : helperText ? (\n                <span className={styles.helper}>{helperText}</span>\n            ) : null}\n        </div>\n    );\n});\n\nfunction CaretIcon() {\n    return (\n        <svg width=\"14\" height=\"14\" viewBox=\"0 0 24 24\" fill=\"none\">\n            <path\n                d=\"M6 9l6 6 6-6\"\n                stroke=\"currentColor\"\n                strokeWidth=\"2\"\n                strokeLinecap=\"round\"\n                strokeLinejoin=\"round\"\n            />\n        </svg>\n    );\n}\n"],"mappings":"6HAwBA,IAAa,GAAA,EAAS,EAAA,WAAA,CAA2C,SAC7D,CACI,QACA,aACA,QACA,UACA,cACA,mBACA,YACA,WACA,KACA,WACA,GAAG,GAEP,EACF,CACE,IAAM,GAAA,EAAc,EAAA,MAAA,CAAM,EACpB,EAAW,GAAM,EAEvB,OACI,EAAA,EAAA,KAAA,CAAC,MAAD,CAAK,UAAW,EAAA,GAAG,EAAA,QAAO,QAAS,GAAS,EAAA,QAAO,MAAO,CAAgB,EAA1E,SAAA,CACK,IACG,EAAA,EAAA,KAAA,CAAC,QAAD,CAAO,QAAS,EAAU,UAAW,EAAA,QAAO,MAA5C,SAAA,CACK,EACA,IAAY,EAAA,EAAA,IAAA,CAAC,OAAD,CAAM,UAAW,EAAA,QAAO,SAAU,SAAA,GAAO,CAAA,CACnD,KAEX,EAAA,EAAA,KAAA,CAAC,MAAD,CAAK,UAAW,EAAA,QAAO,MAAvB,SAAA,EACI,EAAA,EAAA,KAAA,CAAC,SAAD,CACS,MACL,GAAI,EACJ,eAAc,CAAC,CAAC,EACN,WACV,UAAW,EAAA,GAAG,EAAA,QAAO,OAAQ,CAAS,EACtC,GAAI,EANR,SAAA,CAQK,IACG,EAAA,EAAA,IAAA,CAAC,SAAD,CAAQ,MAAM,GAAG,SAAA,GAAS,OAAA,GACrB,SAAA,CACG,CAAA,EAEX,GAAS,IAAK,IACX,EAAA,EAAA,IAAA,CAAC,SAAD,CAAwB,MAAO,EAAI,MAAO,SAAU,EAAI,SACnD,SAAA,EAAI,KACD,EAFK,EAAI,KAET,CACX,EACA,CACG,CACR,CAAA,GAAA,EAAA,EAAA,IAAA,CAAC,OAAD,CAAM,UAAW,EAAA,QAAO,MAAO,cAAA,GAC3B,UAAA,EAAA,EAAA,IAAA,CAAC,EAAD,CAAY,CAAA,CACV,CAAA,CACL,IACJ,GACG,EAAA,EAAA,IAAA,CAAC,OAAD,CAAM,UAAW,EAAA,QAAO,UAAY,SAAA,CAAY,CAAA,EAChD,GACA,EAAA,EAAA,IAAA,CAAC,OAAD,CAAM,UAAW,EAAA,QAAO,OAAS,SAAA,CAAiB,CAAA,EAClD,IACH,GAEb,CAAC,EAED,SAAS,GAAY,CACjB,OACI,EAAA,EAAA,IAAA,CAAC,MAAD,CAAK,MAAM,KAAK,OAAO,KAAK,QAAQ,YAAY,KAAK,OACjD,UAAA,EAAA,EAAA,IAAA,CAAC,OAAD,CACI,EAAE,eACF,OAAO,eACP,YAAY,IACZ,cAAc,QACd,eAAe,OAClB,CAAA,CACA,CAAA,CAEb"}
+{"version":3,"file":"Select.cjs","names":[],"sources":["../../../src/components/Select/Select.tsx"],"sourcesContent":["import { forwardRef, useId } from \"react\";\nimport type { SelectHTMLAttributes } from \"react\";\nimport { cn } from \"@/utils/cn\";\nimport styles from \"./Select.module.css\";\n\nexport interface SelectOption {\n    value: string | number;\n    label: string;\n    disabled?: boolean;\n}\n\n/** What both variants of {@link Select} accept. */\nexport interface SelectBaseProps extends SelectHTMLAttributes<HTMLSelectElement> {\n    options?: SelectOption[];\n    placeholder?: string;\n    wrapperClassName?: string;\n}\n\n/** The full form field: label, control, helper text and error slot. */\nexport interface SelectFieldProps extends SelectBaseProps {\n    variant?: \"field\";\n    label?: string;\n    helperText?: string;\n    error?: string;\n}\n\n/**\n * The bare control, sized to its content.\n *\n * `aria-label` is required rather than optional, because the variant removes the\n * only visible label the component had. A settings row names the control in the\n * row's own text, which the `<select>` has no relationship to — so without this\n * the screen reader announces a combobox with no name at all.\n */\nexport interface SelectChipProps extends SelectBaseProps {\n    variant: \"chip\";\n    \"aria-label\": string;\n}\n\nexport type SelectProps = SelectFieldProps | SelectChipProps;\n\n/**\n * Native `<select>` wrapper. Either provide `options` for a quick render, or\n * pass `<option>` children directly.\n *\n * Two variants:\n *\n * - `\"field\"` (default) — label, control, helper text and error slot, for a form.\n * - `\"chip\"` — the control alone, sized to its content, for a settings row where\n *   the icon and the label are already on the left and the control belongs on the\n *   right. Rendering the full field there stacks two labelled fields inside one\n *   list item, which is why every app ended up hand-rolling a native `<select>`\n *   with `appearance: none` — and hand-rolling it loses the focus ring, the\n *   disabled styling and the caret this component already solves.\n *\n * @example\n * <Select label=\"Estado\" options={states} placeholder=\"Selecione\" />\n *\n * @example\n * <ListTile title=\"Idioma\" trailing={<Select variant=\"chip\" aria-label=\"Idioma\" options={langs} />} />\n */\nexport const Select = forwardRef<HTMLSelectElement, SelectProps>(function Select(props, ref) {\n    const {\n        options,\n        placeholder,\n        wrapperClassName,\n        className,\n        children,\n        id,\n        required,\n        variant = \"field\",\n        label,\n        helperText,\n        error,\n        ...rest\n    } = props as SelectBaseProps & {\n        variant?: \"field\" | \"chip\";\n        label?: string;\n        helperText?: string;\n        error?: string;\n    };\n    const isChip = variant === \"chip\";\n    const generatedId = useId();\n    const selectId = id ?? generatedId;\n\n    const control = (\n        <div className={cn(styles.field, isChip && styles.chip)}>\n            <select\n                ref={ref}\n                id={selectId}\n                aria-invalid={!!error}\n                required={required}\n                className={cn(styles.select, className)}\n                {...rest}\n            >\n                {placeholder && (\n                    <option value=\"\" disabled hidden>\n                        {placeholder}\n                    </option>\n                )}\n                {options?.map((opt) => (\n                    <option key={opt.value} value={opt.value} disabled={opt.disabled}>\n                        {opt.label}\n                    </option>\n                ))}\n                {children}\n            </select>\n            <span className={styles.caret} aria-hidden>\n                <CaretIcon />\n            </span>\n        </div>\n    );\n\n    if (isChip) {\n        return <div className={cn(styles.chipWrapper, wrapperClassName)}>{control}</div>;\n    }\n\n    return (\n        <div className={cn(styles.wrapper, error && styles.error, wrapperClassName)}>\n            {label && (\n                <label htmlFor={selectId} className={styles.label}>\n                    {label}\n                    {required && <span className={styles.required}>*</span>}\n                </label>\n            )}\n            {control}\n            {error ? (\n                <span className={styles.errorText}>{error}</span>\n            ) : helperText ? (\n                <span className={styles.helper}>{helperText}</span>\n            ) : null}\n        </div>\n    );\n});\n\nfunction CaretIcon() {\n    return (\n        <svg width=\"14\" height=\"14\" viewBox=\"0 0 24 24\" fill=\"none\">\n            <path\n                d=\"M6 9l6 6 6-6\"\n                stroke=\"currentColor\"\n                strokeWidth=\"2\"\n                strokeLinecap=\"round\"\n                strokeLinejoin=\"round\"\n            />\n        </svg>\n    );\n}\n"],"mappings":"6HA6DA,IAAa,GAAA,EAAS,EAAA,WAAA,CAA2C,SAAgB,EAAO,EAAK,CACzF,GAAM,CACF,UACA,cACA,mBACA,YACA,WACA,KACA,WACA,UAAU,QACV,QACA,aACA,QACA,GAAG,GACH,EAME,EAAS,IAAY,OACrB,GAAA,EAAc,EAAA,MAAA,CAAM,EACpB,EAAW,GAAM,EAEjB,GACF,EAAA,EAAA,KAAA,CAAC,MAAD,CAAK,UAAW,EAAA,GAAG,EAAA,QAAO,MAAO,GAAU,EAAA,QAAO,IAAI,EAAtD,SAAA,EACI,EAAA,EAAA,KAAA,CAAC,SAAD,CACS,MACL,GAAI,EACJ,eAAc,CAAC,CAAC,EACN,WACV,UAAW,EAAA,GAAG,EAAA,QAAO,OAAQ,CAAS,EACtC,GAAI,EANR,SAAA,CAQK,IACG,EAAA,EAAA,IAAA,CAAC,SAAD,CAAQ,MAAM,GAAG,SAAA,GAAS,OAAA,GACrB,SAAA,CACG,CAAA,EAEX,GAAS,IAAK,IACX,EAAA,EAAA,IAAA,CAAC,SAAD,CAAwB,MAAO,EAAI,MAAO,SAAU,EAAI,SACnD,SAAA,EAAI,KACD,EAFK,EAAI,KAET,CACX,EACA,CACG,CACR,CAAA,GAAA,EAAA,EAAA,IAAA,CAAC,OAAD,CAAM,UAAW,EAAA,QAAO,MAAO,cAAA,GAC3B,UAAA,EAAA,EAAA,IAAA,CAAC,EAAD,CAAY,CAAA,CACV,CAAA,CACL,IAOT,OAJI,GACO,EAAA,EAAA,IAAA,CAAC,MAAD,CAAK,UAAW,EAAA,GAAG,EAAA,QAAO,YAAa,CAAgB,EAAI,SAAA,CAAa,CAAA,GAI/E,EAAA,EAAA,KAAA,CAAC,MAAD,CAAK,UAAW,EAAA,GAAG,EAAA,QAAO,QAAS,GAAS,EAAA,QAAO,MAAO,CAAgB,EAA1E,SAAA,CACK,IACG,EAAA,EAAA,KAAA,CAAC,QAAD,CAAO,QAAS,EAAU,UAAW,EAAA,QAAO,MAA5C,SAAA,CACK,EACA,IAAY,EAAA,EAAA,IAAA,CAAC,OAAD,CAAM,UAAW,EAAA,QAAO,SAAU,SAAA,GAAO,CAAA,CACnD,IAEV,EACA,GACG,EAAA,EAAA,IAAA,CAAC,OAAD,CAAM,UAAW,EAAA,QAAO,UAAY,SAAA,CAAY,CAAA,EAChD,GACA,EAAA,EAAA,IAAA,CAAC,OAAD,CAAM,UAAW,EAAA,QAAO,OAAS,SAAA,CAAiB,CAAA,EAClD,IACH,GAEb,CAAC,EAED,SAAS,GAAY,CACjB,OACI,EAAA,EAAA,IAAA,CAAC,MAAD,CAAK,MAAM,KAAK,OAAO,KAAK,QAAQ,YAAY,KAAK,OACjD,UAAA,EAAA,EAAA,IAAA,CAAC,OAAD,CACI,EAAE,eACF,OAAO,eACP,YAAY,IACZ,cAAc,QACd,eAAe,OAClB,CAAA,CACA,CAAA,CAEb"}

package/dist/components/Select/Select.js

@@ -3,54 +3,57 @@ import t from "./Select.module.js";
 import { forwardRef as n, useId as r } from "react";
 import { jsx as i, jsxs as a } from "react/jsx-runtime";
 //#region src/components/Select/Select.tsx
-var o = n(function({ label: n, helperText: o, error: c, options: l, placeholder: u, wrapperClassName: d, className: f, children: p, id: m, required: h, ...g }, _) {
-	let v = r(), y = m ?? v;
-	return /* @__PURE__ */ a("div", {
-		className: e(t.wrapper, c && t.error, d),
+var o = n(function(n, o) {
+	let { options: c, placeholder: l, wrapperClassName: u, className: d, children: f, id: p, required: m, variant: h = "field", label: g, helperText: _, error: v, ...y } = n, b = h === "chip", x = r(), S = p ?? x, C = /* @__PURE__ */ a("div", {
+		className: e(t.field, b && t.chip),
+		children: [/* @__PURE__ */ a("select", {
+			ref: o,
+			id: S,
+			"aria-invalid": !!v,
+			required: m,
+			className: e(t.select, d),
+			...y,
+			children: [
+				l && /* @__PURE__ */ i("option", {
+					value: "",
+					disabled: !0,
+					hidden: !0,
+					children: l
+				}),
+				c?.map((e) => /* @__PURE__ */ i("option", {
+					value: e.value,
+					disabled: e.disabled,
+					children: e.label
+				}, e.value)),
+				f
+			]
+		}), /* @__PURE__ */ i("span", {
+			className: t.caret,
+			"aria-hidden": !0,
+			children: /* @__PURE__ */ i(s, {})
+		})]
+	});
+	return b ? /* @__PURE__ */ i("div", {
+		className: e(t.chipWrapper, u),
+		children: C
+	}) : /* @__PURE__ */ a("div", {
+		className: e(t.wrapper, v && t.error, u),
 		children: [
-			n && /* @__PURE__ */ a("label", {
-				htmlFor: y,
+			g && /* @__PURE__ */ a("label", {
+				htmlFor: S,
 				className: t.label,
-				children: [n, h && /* @__PURE__ */ i("span", {
+				children: [g, m && /* @__PURE__ */ i("span", {
 					className: t.required,
 					children: "*"
 				})]
 			}),
-			/* @__PURE__ */ a("div", {
-				className: t.field,
-				children: [/* @__PURE__ */ a("select", {
-					ref: _,
-					id: y,
-					"aria-invalid": !!c,
-					required: h,
-					className: e(t.select, f),
-					...g,
-					children: [
-						u && /* @__PURE__ */ i("option", {
-							value: "",
-							disabled: !0,
-							hidden: !0,
-							children: u
-						}),
-						l?.map((e) => /* @__PURE__ */ i("option", {
-							value: e.value,
-							disabled: e.disabled,
-							children: e.label
-						}, e.value)),
-						p
-					]
-				}), /* @__PURE__ */ i("span", {
-					className: t.caret,
-					"aria-hidden": !0,
-					children: /* @__PURE__ */ i(s, {})
-				})]
-			}),
-			c ? /* @__PURE__ */ i("span", {
+			C,
+			v ? /* @__PURE__ */ i("span", {
 				className: t.errorText,
-				children: c
-			}) : o ? /* @__PURE__ */ i("span", {
+				children: v
+			}) : _ ? /* @__PURE__ */ i("span", {
 				className: t.helper,
-				children: o
+				children: _
 			}) : null
 		]
 	});