tempest-react-sdk 0.53.0 → 0.54.0

package/dist/br/BrazilStateCitySelect.js.map

@@ -1 +1 @@
-{"version":3,"file":"BrazilStateCitySelect.js","names":[],"sources":["../../src/br/BrazilStateCitySelect.tsx"],"sourcesContent":["/**\n * @tempest-limits props-count — two dependent selects in one control, so every knob\n * comes in pairs: stateLabel and cityLabel, statePlaceholder and cityPlaceholder,\n * defaultUf and defaultCity. The pairing is the feature — the city list is derived\n * from the chosen UF, which is exactly what a caller wiring two separate selects has\n * to reimplement.\n */\nimport { useMemo, useState, type ReactElement } from \"react\";\nimport { Select } from \"@/components/Select\";\nimport { cityChoices, listStates, normalizeUf, type UF } from \"./locations\";\n\n/** Current selection emitted by {@link BrazilStateCitySelect}. */\nexport interface BrazilStateCitySelection {\n    /** Selected federative unit, or `null` when none. */\n    uf: UF | null;\n    /** Selected city, or `null` when none. */\n    city: string | null;\n}\n\nexport interface BrazilStateCitySelectProps {\n    /** Pre-selected UF (uncontrolled initial value). */\n    defaultUf?: UF;\n    /** Pre-selected city (uncontrolled initial value). */\n    defaultCity?: string;\n    /** Fired whenever the state or city changes. */\n    onChange?: (selection: BrazilStateCitySelection) => void;\n    /** Label for the state select. Default: `\"Estado\"`. */\n    stateLabel?: string;\n    /** Label for the city select. Default: `\"Cidade\"`. */\n    cityLabel?: string;\n    /** Placeholder for the state select. Default: `\"Selecione o estado\"`. */\n    statePlaceholder?: string;\n    /** Placeholder for the city select. Default: `\"Selecione a cidade\"`. */\n    cityPlaceholder?: string;\n    /** Disable both selects. */\n    disabled?: boolean;\n    /** Layout of the two selects. Default: `\"row\"`. */\n    layout?: \"row\" | \"column\";\n}\n\n/**\n * Cascading Estado → Cidade selector backed by the bundled BR locations data —\n * pick a state and the city list narrows to that UF's municipalities. No\n * network, no external API. Complements {@link BrazilMap} (wire the map's\n * `onSelect` to drive the same UF).\n *\n * @example\n * <BrazilStateCitySelect onChange={({ uf, city }) => console.log(uf, city)} />\n */\nexport function BrazilStateCitySelect({\n    defaultUf,\n    defaultCity,\n    onChange,\n    stateLabel = \"Estado\",\n    cityLabel = \"Cidade\",\n    statePlaceholder = \"Selecione o estado\",\n    cityPlaceholder = \"Selecione a cidade\",\n    disabled = false,\n    layout = \"row\",\n}: BrazilStateCitySelectProps): ReactElement {\n    const [uf, setUf] = useState<UF | null>(defaultUf ?? null);\n    const [city, setCity] = useState<string | null>(defaultCity ?? null);\n\n    const stateOptions = useMemo(\n        () => listStates().map((s) => ({ value: s.uf, label: s.name })),\n        [],\n    );\n    const cityOptions = useMemo(() => (uf ? cityChoices(uf) : []), [uf]);\n\n    function handleUf(next: string): void {\n        const nextUf = normalizeUf(next);\n        setUf(nextUf);\n        setCity(null);\n        onChange?.({ uf: nextUf, city: null });\n    }\n\n    function handleCity(next: string): void {\n        const nextCity = next || null;\n        setCity(nextCity);\n        onChange?.({ uf, city: nextCity });\n    }\n\n    return (\n        <div\n            style={{\n                display: \"flex\",\n                flexDirection: layout === \"row\" ? \"row\" : \"column\",\n                gap: \"var(--tempest-space-3, 12px)\",\n                flexWrap: \"wrap\",\n            }}\n        >\n            <Select\n                label={stateLabel}\n                placeholder={statePlaceholder}\n                options={stateOptions}\n                value={uf ?? \"\"}\n                disabled={disabled}\n                onChange={(e) => handleUf(e.target.value)}\n                style={{ minWidth: 0 }}\n            />\n            <Select\n                label={cityLabel}\n                placeholder={cityPlaceholder}\n                options={cityOptions}\n                value={city ?? \"\"}\n                disabled={disabled || !uf}\n                onChange={(e) => handleCity(e.target.value)}\n                style={{ minWidth: 0 }}\n            />\n        </div>\n    );\n}\n"],"mappings":";;;;;AAiDA,SAAgB,EAAsB,EAClC,cACA,gBACA,aACA,gBAAa,UACb,eAAY,UACZ,sBAAmB,sBACnB,qBAAkB,sBAClB,cAAW,IACX,YAAS,SACgC;CACzC,IAAM,CAAC,GAAI,KAAS,EAAoB,KAAa,IAAI,GACnD,CAAC,GAAM,KAAW,EAAwB,KAAe,IAAI,GAE7D,IAAe,QACX,EAAW,CAAC,CAAC,KAAK,OAAO;EAAE,OAAO,EAAE;EAAI,OAAO,EAAE;CAAK,EAAE,GAC9D,CAAC,CACL,GACM,IAAc,QAAe,IAAK,EAAY,CAAE,IAAI,CAAC,GAAI,CAAC,CAAE,CAAC;CAEnE,SAAS,EAAS,GAAoB;EAClC,IAAM,IAAS,EAAY,CAAI;EAG/B,AAFA,EAAM,CAAM,GACZ,EAAQ,IAAI,GACZ,IAAW;GAAE,IAAI;GAAQ,MAAM;EAAK,CAAC;CACzC;CAEA,SAAS,EAAW,GAAoB;EACpC,IAAM,IAAW,KAAQ;EAEzB,AADA,EAAQ,CAAQ,GAChB,IAAW;GAAE;GAAI,MAAM;EAAS,CAAC;CACrC;CAEA,OACI,kBAAC,OAAD;EACI,OAAO;GACH,SAAS;GACT,eAAe,MAAW,QAAQ,QAAQ;GAC1C,KAAK;GACL,UAAU;EACd;EANJ,UAAA,CAQI,kBAAC,GAAD;GACI,OAAO;GACP,aAAa;GACb,SAAS;GACT,OAAO,KAAM;GACH;GACV,WAAW,MAAM,EAAS,EAAE,OAAO,KAAK;GACxC,OAAO,EAAE,UAAU,EAAE;EACxB,CAAA,GACD,kBAAC,GAAD;GACI,OAAO;GACP,aAAa;GACb,SAAS;GACT,OAAO,KAAQ;GACf,UAAU,KAAY,CAAC;GACvB,WAAW,MAAM,EAAW,EAAE,OAAO,KAAK;GAC1C,OAAO,EAAE,UAAU,EAAE;EACxB,CAAA,CACA;;AAEb"}
+{"version":3,"file":"BrazilStateCitySelect.js","names":[],"sources":["../../src/br/BrazilStateCitySelect.tsx"],"sourcesContent":["/**\n * @tempest-limits props-count — two dependent selects in one control, so every knob\n * comes in pairs: stateLabel and cityLabel, statePlaceholder and cityPlaceholder,\n * defaultUf and defaultCity. The pairing is the feature — the city list is derived\n * from the chosen UF, which is exactly what a caller wiring two separate selects has\n * to reimplement.\n */\nimport { useMemo, useState, type ReactElement } from \"react\";\nimport { Select } from \"@/components/Select\";\nimport {\n    administrativeRegionsByUf,\n    listStates,\n    municipalitiesByUf,\n    normalizeUf,\n    resolveMunicipality,\n    type Choice,\n    type UF,\n} from \"./locations\";\n\n/** Current selection emitted by {@link BrazilStateCitySelect}. */\nexport interface BrazilStateCitySelection {\n    /** Selected federative unit, or `null` when none. */\n    uf: UF | null;\n    /** Selected city, or `null` when none. */\n    city: string | null;\n    /**\n     * IBGE code of the selected municipality, or `null` when none is selected.\n     *\n     * This is the value to store. It survives the renames `city` does not, and\n     * it is what `geocodeMunicipality` and every other dataset here join on. A\n     * DF administrative region carries Brasília's code, because that is the\n     * municipality it is part of.\n     */\n    municipalityId: string | null;\n}\n\nexport interface BrazilStateCitySelectProps {\n    /** Pre-selected UF (uncontrolled initial value). */\n    defaultUf?: UF;\n    /** Pre-selected city (uncontrolled initial value). */\n    defaultCity?: string;\n    /** Fired whenever the state or city changes. */\n    onChange?: (selection: BrazilStateCitySelection) => void;\n    /** Label for the state select. Default: `\"Estado\"`. */\n    stateLabel?: string;\n    /** Label for the city select. Default: `\"Cidade\"`. */\n    cityLabel?: string;\n    /** Placeholder for the state select. Default: `\"Selecione o estado\"`. */\n    statePlaceholder?: string;\n    /** Placeholder for the city select. Default: `\"Selecione a cidade\"`. */\n    cityPlaceholder?: string;\n    /** Disable both selects. */\n    disabled?: boolean;\n    /** Layout of the two selects. Default: `\"row\"`. */\n    layout?: \"row\" | \"column\";\n}\n\n/**\n * Cascading Estado → Cidade selector backed by the bundled BR locations data —\n * pick a state and the city list narrows to that UF's municipalities. No\n * network, no external API. Complements {@link BrazilMap} (wire the map's\n * `onSelect` to drive the same UF).\n *\n * @example\n * <BrazilStateCitySelect onChange={({ uf, city }) => console.log(uf, city)} />\n */\n/**\n * The pickable places of a federative unit: its municipalities, plus the DF's\n * administrative regions.\n *\n * The DF has one municipality and nobody there writes \"Brasília\" in an address\n * field — they write Ceilândia, Taguatinga, Gama. Offering only the municipality\n * would be faithful to IBGE and useless in a form, so the 35 regions are listed\n * beside it and every one of them resolves to Brasília's code.\n *\n * @param uf - The selected federative unit.\n * @returns `{ value, label }` options, alphabetically, value === label.\n */\nfunction placeChoices(uf: UF): Choice[] {\n    const names = [\n        ...municipalitiesByUf(uf).map((m) => m.name),\n        ...administrativeRegionsByUf(uf).map((r) => r.name),\n    ].sort((a, b) => a.localeCompare(b, \"pt-BR\"));\n    return names.map((name) => ({ value: name, label: name }));\n}\n\nexport function BrazilStateCitySelect({\n    defaultUf,\n    defaultCity,\n    onChange,\n    stateLabel = \"Estado\",\n    cityLabel = \"Cidade\",\n    statePlaceholder = \"Selecione o estado\",\n    cityPlaceholder = \"Selecione a cidade\",\n    disabled = false,\n    layout = \"row\",\n}: BrazilStateCitySelectProps): ReactElement {\n    const [uf, setUf] = useState<UF | null>(defaultUf ?? null);\n    const [city, setCity] = useState<string | null>(defaultCity ?? null);\n\n    const stateOptions = useMemo(\n        () => listStates().map((s) => ({ value: s.uf, label: s.name })),\n        [],\n    );\n    const cityOptions = useMemo(() => (uf ? placeChoices(uf) : []), [uf]);\n\n    function handleUf(next: string): void {\n        const nextUf = normalizeUf(next);\n        setUf(nextUf);\n        setCity(null);\n        onChange?.({ uf: nextUf, city: null, municipalityId: null });\n    }\n\n    function handleCity(next: string): void {\n        const nextCity = next || null;\n        setCity(nextCity);\n        onChange?.({\n            uf,\n            city: nextCity,\n            municipalityId: uf && nextCity ? (resolveMunicipality(uf, nextCity)?.id ?? null) : null,\n        });\n    }\n\n    return (\n        <div\n            style={{\n                display: \"flex\",\n                flexDirection: layout === \"row\" ? \"row\" : \"column\",\n                gap: \"var(--tempest-space-3, 12px)\",\n                flexWrap: \"wrap\",\n            }}\n        >\n            <Select\n                label={stateLabel}\n                placeholder={statePlaceholder}\n                options={stateOptions}\n                value={uf ?? \"\"}\n                disabled={disabled}\n                onChange={(e) => handleUf(e.target.value)}\n                style={{ minWidth: 0 }}\n            />\n            <Select\n                label={cityLabel}\n                placeholder={cityPlaceholder}\n                options={cityOptions}\n                value={city ?? \"\"}\n                disabled={disabled || !uf}\n                onChange={(e) => handleCity(e.target.value)}\n                style={{ minWidth: 0 }}\n            />\n        </div>\n    );\n}\n"],"mappings":";;;;;AA8EA,SAAS,EAAa,GAAkB;CAKpC,OAJc,CACV,GAAG,EAAmB,CAAE,CAAC,CAAC,KAAK,MAAM,EAAE,IAAI,GAC3C,GAAG,EAA0B,CAAE,CAAC,CAAC,KAAK,MAAM,EAAE,IAAI,CACtD,CAAC,CAAC,MAAM,GAAG,MAAM,EAAE,cAAc,GAAG,OAAO,CACpC,CAAA,CAAM,KAAK,OAAU;EAAE,OAAO;EAAM,OAAO;CAAK,EAAE;AAC7D;AAEA,SAAgB,EAAsB,EAClC,cACA,gBACA,aACA,gBAAa,UACb,eAAY,UACZ,sBAAmB,sBACnB,qBAAkB,sBAClB,cAAW,IACX,YAAS,SACgC;CACzC,IAAM,CAAC,GAAI,KAAS,EAAoB,KAAa,IAAI,GACnD,CAAC,GAAM,KAAW,EAAwB,KAAe,IAAI,GAE7D,IAAe,QACX,EAAW,CAAC,CAAC,KAAK,OAAO;EAAE,OAAO,EAAE;EAAI,OAAO,EAAE;CAAK,EAAE,GAC9D,CAAC,CACL,GACM,IAAc,QAAe,IAAK,EAAa,CAAE,IAAI,CAAC,GAAI,CAAC,CAAE,CAAC;CAEpE,SAAS,EAAS,GAAoB;EAClC,IAAM,IAAS,EAAY,CAAI;EAG/B,AAFA,EAAM,CAAM,GACZ,EAAQ,IAAI,GACZ,IAAW;GAAE,IAAI;GAAQ,MAAM;GAAM,gBAAgB;EAAK,CAAC;CAC/D;CAEA,SAAS,EAAW,GAAoB;EACpC,IAAM,IAAW,KAAQ;EAEzB,AADA,EAAQ,CAAQ,GAChB,IAAW;GACP;GACA,MAAM;GACN,gBAAgB,KAAM,IAAY,EAAoB,GAAI,CAAQ,CAAC,EAAE,MAAM,OAAQ;EACvF,CAAC;CACL;CAEA,OACI,kBAAC,OAAD;EACI,OAAO;GACH,SAAS;GACT,eAAe,MAAW,QAAQ,QAAQ;GAC1C,KAAK;GACL,UAAU;EACd;EANJ,UAAA,CAQI,kBAAC,GAAD;GACI,OAAO;GACP,aAAa;GACb,SAAS;GACT,OAAO,KAAM;GACH;GACV,WAAW,MAAM,EAAS,EAAE,OAAO,KAAK;GACxC,OAAO,EAAE,UAAU,EAAE;EACxB,CAAA,GACD,kBAAC,GAAD;GACI,OAAO;GACP,aAAa;GACb,SAAS;GACT,OAAO,KAAQ;GACf,UAAU,KAAY,CAAC;GACvB,WAAW,MAAM,EAAW,EAAE,OAAO,KAAK;GAC1C,OAAO,EAAE,UAAU,EAAE;EACxB,CAAA,CACA;;AAEb"}