@fichap/icons-react 1.0.8 → 1.0.9

package/README.md

@@ -28,6 +28,12 @@ export function Demo() {
       <ArrowLeftIcon size={24} className='text-white' />
       <Icon name='arrowLeft' size={24} className='text-red-500' />
       <Icon name='arrowLeft' variant='bold' size={24} />
+      <Icon
+        name='warning'
+        decorative={false}
+        aria-label='Advertencia'
+        size={20}
+      />
       <p>Regular icons: {iconNamesByVariant.regular.length}</p>
     </>
   );
@@ -38,6 +44,9 @@ export function Demo() {
 
 - For app consumers, prefer the `Icon` wrapper plus `name` when you want a single stable import.
 - `variant` is optional and defaults to `regular`.
+- `Icon` applies accessibility defaults automatically:
+  - Decorative icon (default): `aria-hidden={true}` + `focusable={false}`.
+  - Meaningful icon (`decorative={false}` or when `aria-label`/`aria-labelledby` is present): `role="img"` + `focusable={false}`.
 - For bold icons, keep the same canonical `name` and pass `variant="bold"`.
 - Do not append `Bold` to the `name` prop unless that exact canonical icon name exists in the catalog.
 - Use direct icon imports when you explicitly want component-level imports, custom wrappers, or tighter control over what is imported.
@@ -51,11 +60,35 @@ export function Demo() {
   - `height?: number | string`
   - `className?: string`
   - plus all standard SVG props
+- `Icon` wrapper extras:
+  - `decorative?: boolean`
+  - `name: IconName`
+  - `variant?: 'regular' | 'bold'`
 - `size` applies to `width` and `height`.
 - Si pasás `width`/`height`, tienen prioridad sobre `size`.
 - Hardcoded black colors are normalized to `currentColor` during generation.
 - Kebab-case SVG attributes are converted to React-compatible props.
 
+## Accessibility quick guide
+
+Use these patterns with `Icon`:
+
+```tsx
+import { Icon } from "@fichap/icons-react";
+
+// Decorative icon (default): hidden from screen readers
+<Icon name='arrowLeft' size={20} />;
+
+// Meaningful icon: exposed with accessible name
+<Icon name='dangerTriangle' decorative={false} aria-label='Error' size={20} />;
+```
+
+Notes:
+
+- If you use `decorative={false}`, pass an accessible name with `aria-label` or `aria-labelledby`.
+- If you pass `decorative`, that value takes precedence over auto behavior.
+- Dev-only warnings are emitted for conflicting setups (for example, `decorative={false}` without accessible name).
+
 ## Build
 
 ```bash

package/dist/index.d.mts

@@ -2231,10 +2231,15 @@ type FichapIconProps = IconSvgProps & {
     name: IconName;
     /** Defaults to 'regular' when omitted. */
     variant?: IconVariant;
+    /**
+     * Defaults to true when no accessible name is provided.
+     * Set to false for meaningful icons and pass aria-label or aria-labelledby.
+     */
+    decorative?: boolean;
 };
 /**
  * Resolves a generated icon by name and variant while preserving the shared SVG props contract.
  */
-declare function Icon({ name, variant, ...props }: FichapIconProps): React.JSX.Element | null;
+declare function Icon({ name, variant, decorative, ...props }: FichapIconProps): React.JSX.Element | null;
 
 export { AccidentRegular, Activity2Regular, ActivityBold, ActivityRegular, AddUserBold, AddUserRegular, AiBrainIdeaRegular, AiBrainLikeRegular, AlarmSpeakerRegular, AlignLeftRegular, AnthropicRegular, ArrowDown2Bold, ArrowDown2Regular, ArrowDown3Bold, ArrowDown3Regular, ArrowDownBold, ArrowDownCircleBold, ArrowDownCircleRegular, ArrowDownRegular, ArrowDownRightsmRegular, ArrowDownSquareBold, ArrowDownSquareRegular, ArrowLeft22Regular, ArrowLeft2Bold, ArrowLeft2Regular, ArrowLeft3Bold, ArrowLeft3Regular, ArrowLeftBold, ArrowLeftCircleBold, ArrowLeftCircleRegular, ArrowLeftRegular, ArrowLeftSquareBold, ArrowLeftSquareRegular, ArrowRight22Regular, ArrowRight2Bold, ArrowRight2Regular, ArrowRight3Bold, ArrowRight3Regular, ArrowRightBold, ArrowRightCircleBold, ArrowRightCircleRegular, ArrowRightRegular, ArrowRightSmRegular, ArrowRightSquareBold, ArrowRightSquareRegular, ArrowUp2Bold, ArrowUp2Regular, ArrowUp3Bold, ArrowUp3Regular, ArrowUpBold, ArrowUpCircleBold, ArrowUpCircleRegular, ArrowUpRegular, ArrowUpRightsmRegular, ArrowUpSquareBold, ArrowUpSquareRegular, ArrowsDiagonalContractRegular, AttachRegular, Bag2Bold, Bag3Regular, Bag4Regular, BagBold, BagRegular, BankCardInformationRegular, BoardTasksRegular, BoldRegular, BookBold, BookRegular, BookmarkBold, BookmarkRegular, BotRegular, BuildingOffice2Regular, BuildingOffice3Regular, BuildingOfficeRegular, BuildingRegular, BulletedListRegular, BuyBold, BuyRegular, Calendar2Bold, Calendar2Regular, CalendarAddRegular, CalendarArrowRightRegular, CalendarBold, CalendarCheckBold, CalendarCheckRegular, CalendarDashRegular, CalendarDone2Regular, CalendarDoneRegular, CalendarEditBold, CalendarEditRegular, CalendarForwardBold, CalendarHourglassRegular, CalendarPinRegular, CalendarRegular, CalendarSettingsRegular, CalendarTickRegular, CalendarTimeBold, CalendarTimeBoldRegular, CalendarTimeRegular, CalendarUsersRegular, CallBold, CallMissedBold, CallMissedRegular, CallRegular, CallSilentBold, CallSilentRegular, CallingBold, CallingRegular, CameraAutoRegular, CameraBold, CameraPlusRegular, CameraRegular, CaptchaDiamondStarBold, CaptchaQuestionMarkSquareBold, CarCrashRegular, CatSquareRegular, CategoriesRegular, CategoryBold, CategoryRegular, CenterLayoutRegular, Chart3BarRefreshRegular, Chart3BarTimeRegular, ChartAnalysishRegular, ChartBold, ChartInformationRegular, ChartRegular, ChatBold, ChatQuoteBold, ChatQuoteRegular, ChatRegular, CheckCircleBold, CheckCircleRegular, CheckmarkRegular, ChevronExpandVericalRegular, CircleGridInterfaceRegular, CircleMessage2TextRegular, CircleMessage2UpRegular, ClockAddPlusBold, ClockAddPlusRegular, ClockCloseRegular, ClockFireRegular, ClockOffSleepBold, CloseRegular, CloseSquare2Regular, CloseSquareBold, CloseSquareRegular, CloudRemoveBold, CloudUploadRegular, Code2Regular, CodeBold, CodeRegular, ColorPaletteBold, CommentRegular, CommentsRegular, CopyLineEditRegular, CounterClockwiseUndoBold, CreativeQuoteOpenSquareRegular, CrecimientoRegular, DangerBold, DangerCircleRegular, DangerTriangleRegular, DarkAndLight2Regular, DarkAndLightRegular, Dashboardcustomize24Dp000000Fill1Wght400Grad0Opsz241Bold, Dcoument3LinesRegular, DcoumentAnalyzeBold, DecrecimientoRegular, DeleteBold, DeleteRegular, DiscountBold, DiscountRegular, DiscoveryBold, DiscoveryRegular, Docuemtn2LineEditRegular, DocumentBadgePlusBold, DocumentBold, DocumentCheckRegular, DocumentErrorRegular, DocumentExploreRegular, DocumentPdfBold, DocumentPdfRegular, DocumentPencilBold, DocumentPin2LinesBold, DocumentPinRegular, DocumentRegular, DocumentRemoveRegular, DocumentStarRegular, DocumentVerifiedRegular, DollarAddRegular, DollarCircle3Bold, DollarDocumentRegular, DoubleHeart3Regular, DownLineRegular, DownSquareLineRegular, DownloadBold, DownloadRegular, DraghorizontalRegular, EarthRegular, EditBold, EditRegular, EditSquareBold, EditSquareRegular, ExpandRegular, Eye2Bold, FaceIdFailRegular, FaceIdSuccesRegular, FacebookBold, type FichapIconProps, Film2Regular, Filter2Bold, Filter3Regular, FilterBold, FilterRegular, FlagBold, FlagRegular, FlashBold, FlashRegular, FlipBackwardRegular, FlipForwardRegular, FlipcalendarBlankRegular, FlipcalendarPercentRegular, FlipcalendarTimeRegular, FlowChartRegular, FolderBold, FolderFileAddPlusRegular, FolderFileBold, FolderFileSearchBold, FolderFileUpRegular, FolderRegular, ForwardClockTimer10Bold, FrameRegular, GalleryViewRegular, GameBold, GameRegular, GgiftRegular, GiftRegular, GiveDocumentRegular, GraphBold, GraphRegular, GridInterface2Regular, GridInterface3Regular, GridInterface4Regular, GridInterfaceAddPlusRegular, GridInterfaceRegular, GridInterfaceTickRegular, HappyDateRegular, HashtagRegular, HealthClipboardRegular, Heart2Bold, HeartBold, HeartPlusBold, HeartRegular, HideBold, HideRegular, Home2Regular, HomeBold, HomeRegular, HomeStarRegular, HospitalRegular, HotDrinkBold, HotDrinkRegular, HourglassRegular, Icon, Icon2UserBold, Icon2UserRegular, Icon3UserBold, Icon3UserRegular, type IconComponent, type IconName, IconSeparateRegular, type IconSvgProps, type IconVariant, IconlyRegularBoldArrowsDiagonalMaximizeRegular, IconlyRegularBoldBoardPinRegular, IconlyRegularBoldCharityCoinsRegular, IconlyRegularBoldChevronExpandVericalRegular, IconlyRegularBoldCircleGridInterface2Regular, IconlyRegularBoldCircleGridInterfaceRegular, IconlyRegularBoldContacts2Regular, IconlyRegularBoldController1Regular, IconlyRegularBoldCupRegular, IconlyRegularBoldDocumentPencilRegular, IconlyRegularBoldExitRegular, IconlyRegularBoldExpandLeftStopRegular, IconlyRegularBoldEye2Regular, IconlyRegularBoldHamburgerMenuRegular, IconlyRegularBoldHashtagSquareRegular, IconlyRegularBoldSalaryRegular, IconlyRegularBoldServersConnect7Regular, IconlyRegularBoldSidebarClose2Regular, IconlyRegularBoldSidebarCloseRegular, IconlyRegularBoldThumbLikeRegular, IconlyRegularBoldUserCheckedRegular, IconlyRegularBoldUserSearchRegular, IconlyRegularBoldVectoruserCheckedRegular, IconlyRegularLighExternalLinkRegular, Image2Bold, Image3Regular, ImageAi2Regular, ImageAiRegular, ImageBold, ImageDownRegular, ImageRecognitionRegular, ImageRegular, ImageUp2Regular, ImageUpRegular, InboxRegular, IndentRegular, InfoCircle2Bold, InfoCircleBold, InfoCircleRegular, InfoSquareBold, InfoSquareRegular, InformationRegular, InstagramBold, InsuranceHand2Regular, InsuranceHandRegular, ItalicRegular, JourneyRegular, LeavesRegular, LessRegular, LineChartUpwardRegular, Link2Regular, LinkRegular, LinkedinBold, ListCheckRegular, Loading2Regular, LoadingCircle3Regular, LoadingRegular, LocationBold, LocationRegular, LockBold, LockRegular, LoginBold, LoginRegular, LoginUserRegular, LogoutBold, LogoutRegular, MacNotebookBold, MacNotebookRegular, MagicWandRegular, MapCloseBold, MapCloseRegular, MapRegular, Marker2Regular, MarkerRegular, MedalRegular, MediumBold, Menu2Regular, MenuCloseLeft2Regular, MenuCloseLeftRegular, MenuRegular, MenuhorizontalRegular, MessageBold, MessageRegular, MessagesBold, MicrosoftExelRegular, MicrosoftWordRegular, Minus1Regular, Minus2Bold, Minus2Regular, Minus2VectorRegular, Minus3Bold, Minus4Regular, Monitor2Regular, MoonBold, MoonvectorRegular, MoreCircleBold, MoreCircleRegular, MoreSquareBold, MoreSquareRegular, MoveRegular, MovieTime2Regular, MovieTimeRegular, NewNotificationRegular, NoteLockRegular, NotificationBold, NotificationRegular, NumberedlistRegular, OfficechairRegular, OpenaiRegular, OrderedListRegular, OutdentRegular, PaintingPaletteRegular, PaperBold, PaperDownloadBold, PaperDownloadRegular, PaperFailBold, PaperFailRegular, PaperNegativeBold, PaperNegativeRegular, PaperPlus2Regular, PaperPlusBold, PaperPlusRegular, PaperRegular, PaperUploadBold, PaperUploadRegular, PasswordBold, PasswordRegular, PauseCircleRegular, Pen2Regular, PenRegular, PhotoRegular, PinMapRegular, PlaneCheckBold, PlaneCheckRegular, PlayBold, PlayRegular, Plus1Regular, Plus2Regular, Plus4Regular, PlusBold, PlusRegular, PowerButtonRegular, PrinterRegular, ProfileBold, ProfileRegular, QuestionMarkCircleRegular, QuestionMarkSquareRegular, QuestionsRegular, Refresh2Regular, RefreshRegular, RemoveCircleBold, RemoveUserBold, RemoveUserRegular, ReverseLeftRegular, ReverseRightRegular, RightUpSquareRegular, RoadmapRegular, RocketRegular, RotationRegular, SadDateRegular, SaveRegular, ScaleRegular, ScanBold, ScanRegular, ScreenSizeRegular, SearchBold, SearchDiscountPercentRegular, SearchRegular, Send2Bold, SendBold, SendRegular, SettingBold, SettingRegular, SettingSquareRegular, SettingToolCircleRegular, Share2Regular, ShareRegular, ShieldDoneBold, ShieldDoneRegular, ShieldFailBold, ShieldFailRegular, ShowBold, ShowRegular, Sign1Regular, Sign2Regular, SlightlyFrowningBold, SmilingAddRegular, SmilingRegular, SortDownRegular, SortRegular, SoundWaveRegular, SpeakerMegaphone5Bold, SpeakerMegaphone5Regular, SpeakerMegaphoneRegular, SquareBold, StarBold, StarRegular, StarRemoveRegular, StarsCircleRegular, StickerAddBold, StopCircleRegular, StopwatchPlayBold, StopwatchSpeedRegular, StopwatchStopBold, StrikethroughRegular, SuccessDocumentsRegular, Sun2Bold, SunBold, SunRegular, SunvectorRegular, SwapBold, SwapHorizontalRegular, SwapRegular, SwitchListRegular, SymbolpngRegular, TableRegular, TagBold, TagRegular, TargetRegular, TextAlignCenterRegular, TextAlignLeftRegular, TextAlignRightRegular, TextColorRegular, TextFieldRegular, ThumbDislikeBold, ThumbDislikeRegular, ThumbLikeBold, TickSquareBold, TickSquareRegular, TicketBold, TicketRegular, TicketStarBold, TicketStarRegular, TiktokBold, TimeCircle2Bold, TimeCircleBold, TimeCircleRegular, TimeSquareBold, TimeSquareRegular, TimerPlusBold, TimerRegular, TiredBold, TiredRegular, ToggleRegular, ToolsRegular, TranslateLanguageBold, TranslateLanguageRegular, TranslateVectorRegular, Triangle2Regular, TwitterBold, TypeRegular, UnderlineRegular, UniversityRegular, UnlockBold, UnlockRegular, UnorderedListRegular, UpLineRegular, UpSquareLineRegular, UpdateRight2Regular, UpdateRightRegular, UploadBold, UploadRegular, UserBadgeBold, UserBadgeRegular, UserBoardRegular, UserCheckedBold, UserContactRegular, UserDeleteBold, UserInformation2Regular, UserInformationRegular, UserLockRegular, UserRegular, UserSearchBold, UsersGroupRegular, UsersRegular, VectorcalendarRegular, VectorhomeRegular, VectorinfoSquareRegular, VectorprofileRegular, VectorsettingRegular, VectorstarRegular, VectorworkRegular, VerticalBarChart2Regular, VideoBold, VideoRegular, Voice2Bold, Voice3Regular, VoiceBold, VoiceRegular, VolumeDownBold, VolumeDownRegular, VolumeOffBold, VolumeOffRegular, VolumeUpBold, VolumeUpRegular, WalletBold, WalletRegular, WebPage2Regular, WebPage4Regular, WebPageEdit2Regular, WebPageEditRegular, Weight1Regular, WhatsappRegular, Wheelchair2Regular, WheelchairRegular, WorkBold, WorldRegular, WrenchRegular, XcomBold, XcomRegular, YoutubeBold, ZoomInRegular, ZoomOutRegular, iconNames, iconNamesByVariant, icons, iconsByVariant };

package/dist/index.d.ts

@@ -2231,10 +2231,15 @@ type FichapIconProps = IconSvgProps & {
     name: IconName;
     /** Defaults to 'regular' when omitted. */
     variant?: IconVariant;
+    /**
+     * Defaults to true when no accessible name is provided.
+     * Set to false for meaningful icons and pass aria-label or aria-labelledby.
+     */
+    decorative?: boolean;
 };
 /**
  * Resolves a generated icon by name and variant while preserving the shared SVG props contract.
  */
-declare function Icon({ name, variant, ...props }: FichapIconProps): React.JSX.Element | null;
+declare function Icon({ name, variant, decorative, ...props }: FichapIconProps): React.JSX.Element | null;
 
 export { AccidentRegular, Activity2Regular, ActivityBold, ActivityRegular, AddUserBold, AddUserRegular, AiBrainIdeaRegular, AiBrainLikeRegular, AlarmSpeakerRegular, AlignLeftRegular, AnthropicRegular, ArrowDown2Bold, ArrowDown2Regular, ArrowDown3Bold, ArrowDown3Regular, ArrowDownBold, ArrowDownCircleBold, ArrowDownCircleRegular, ArrowDownRegular, ArrowDownRightsmRegular, ArrowDownSquareBold, ArrowDownSquareRegular, ArrowLeft22Regular, ArrowLeft2Bold, ArrowLeft2Regular, ArrowLeft3Bold, ArrowLeft3Regular, ArrowLeftBold, ArrowLeftCircleBold, ArrowLeftCircleRegular, ArrowLeftRegular, ArrowLeftSquareBold, ArrowLeftSquareRegular, ArrowRight22Regular, ArrowRight2Bold, ArrowRight2Regular, ArrowRight3Bold, ArrowRight3Regular, ArrowRightBold, ArrowRightCircleBold, ArrowRightCircleRegular, ArrowRightRegular, ArrowRightSmRegular, ArrowRightSquareBold, ArrowRightSquareRegular, ArrowUp2Bold, ArrowUp2Regular, ArrowUp3Bold, ArrowUp3Regular, ArrowUpBold, ArrowUpCircleBold, ArrowUpCircleRegular, ArrowUpRegular, ArrowUpRightsmRegular, ArrowUpSquareBold, ArrowUpSquareRegular, ArrowsDiagonalContractRegular, AttachRegular, Bag2Bold, Bag3Regular, Bag4Regular, BagBold, BagRegular, BankCardInformationRegular, BoardTasksRegular, BoldRegular, BookBold, BookRegular, BookmarkBold, BookmarkRegular, BotRegular, BuildingOffice2Regular, BuildingOffice3Regular, BuildingOfficeRegular, BuildingRegular, BulletedListRegular, BuyBold, BuyRegular, Calendar2Bold, Calendar2Regular, CalendarAddRegular, CalendarArrowRightRegular, CalendarBold, CalendarCheckBold, CalendarCheckRegular, CalendarDashRegular, CalendarDone2Regular, CalendarDoneRegular, CalendarEditBold, CalendarEditRegular, CalendarForwardBold, CalendarHourglassRegular, CalendarPinRegular, CalendarRegular, CalendarSettingsRegular, CalendarTickRegular, CalendarTimeBold, CalendarTimeBoldRegular, CalendarTimeRegular, CalendarUsersRegular, CallBold, CallMissedBold, CallMissedRegular, CallRegular, CallSilentBold, CallSilentRegular, CallingBold, CallingRegular, CameraAutoRegular, CameraBold, CameraPlusRegular, CameraRegular, CaptchaDiamondStarBold, CaptchaQuestionMarkSquareBold, CarCrashRegular, CatSquareRegular, CategoriesRegular, CategoryBold, CategoryRegular, CenterLayoutRegular, Chart3BarRefreshRegular, Chart3BarTimeRegular, ChartAnalysishRegular, ChartBold, ChartInformationRegular, ChartRegular, ChatBold, ChatQuoteBold, ChatQuoteRegular, ChatRegular, CheckCircleBold, CheckCircleRegular, CheckmarkRegular, ChevronExpandVericalRegular, CircleGridInterfaceRegular, CircleMessage2TextRegular, CircleMessage2UpRegular, ClockAddPlusBold, ClockAddPlusRegular, ClockCloseRegular, ClockFireRegular, ClockOffSleepBold, CloseRegular, CloseSquare2Regular, CloseSquareBold, CloseSquareRegular, CloudRemoveBold, CloudUploadRegular, Code2Regular, CodeBold, CodeRegular, ColorPaletteBold, CommentRegular, CommentsRegular, CopyLineEditRegular, CounterClockwiseUndoBold, CreativeQuoteOpenSquareRegular, CrecimientoRegular, DangerBold, DangerCircleRegular, DangerTriangleRegular, DarkAndLight2Regular, DarkAndLightRegular, Dashboardcustomize24Dp000000Fill1Wght400Grad0Opsz241Bold, Dcoument3LinesRegular, DcoumentAnalyzeBold, DecrecimientoRegular, DeleteBold, DeleteRegular, DiscountBold, DiscountRegular, DiscoveryBold, DiscoveryRegular, Docuemtn2LineEditRegular, DocumentBadgePlusBold, DocumentBold, DocumentCheckRegular, DocumentErrorRegular, DocumentExploreRegular, DocumentPdfBold, DocumentPdfRegular, DocumentPencilBold, DocumentPin2LinesBold, DocumentPinRegular, DocumentRegular, DocumentRemoveRegular, DocumentStarRegular, DocumentVerifiedRegular, DollarAddRegular, DollarCircle3Bold, DollarDocumentRegular, DoubleHeart3Regular, DownLineRegular, DownSquareLineRegular, DownloadBold, DownloadRegular, DraghorizontalRegular, EarthRegular, EditBold, EditRegular, EditSquareBold, EditSquareRegular, ExpandRegular, Eye2Bold, FaceIdFailRegular, FaceIdSuccesRegular, FacebookBold, type FichapIconProps, Film2Regular, Filter2Bold, Filter3Regular, FilterBold, FilterRegular, FlagBold, FlagRegular, FlashBold, FlashRegular, FlipBackwardRegular, FlipForwardRegular, FlipcalendarBlankRegular, FlipcalendarPercentRegular, FlipcalendarTimeRegular, FlowChartRegular, FolderBold, FolderFileAddPlusRegular, FolderFileBold, FolderFileSearchBold, FolderFileUpRegular, FolderRegular, ForwardClockTimer10Bold, FrameRegular, GalleryViewRegular, GameBold, GameRegular, GgiftRegular, GiftRegular, GiveDocumentRegular, GraphBold, GraphRegular, GridInterface2Regular, GridInterface3Regular, GridInterface4Regular, GridInterfaceAddPlusRegular, GridInterfaceRegular, GridInterfaceTickRegular, HappyDateRegular, HashtagRegular, HealthClipboardRegular, Heart2Bold, HeartBold, HeartPlusBold, HeartRegular, HideBold, HideRegular, Home2Regular, HomeBold, HomeRegular, HomeStarRegular, HospitalRegular, HotDrinkBold, HotDrinkRegular, HourglassRegular, Icon, Icon2UserBold, Icon2UserRegular, Icon3UserBold, Icon3UserRegular, type IconComponent, type IconName, IconSeparateRegular, type IconSvgProps, type IconVariant, IconlyRegularBoldArrowsDiagonalMaximizeRegular, IconlyRegularBoldBoardPinRegular, IconlyRegularBoldCharityCoinsRegular, IconlyRegularBoldChevronExpandVericalRegular, IconlyRegularBoldCircleGridInterface2Regular, IconlyRegularBoldCircleGridInterfaceRegular, IconlyRegularBoldContacts2Regular, IconlyRegularBoldController1Regular, IconlyRegularBoldCupRegular, IconlyRegularBoldDocumentPencilRegular, IconlyRegularBoldExitRegular, IconlyRegularBoldExpandLeftStopRegular, IconlyRegularBoldEye2Regular, IconlyRegularBoldHamburgerMenuRegular, IconlyRegularBoldHashtagSquareRegular, IconlyRegularBoldSalaryRegular, IconlyRegularBoldServersConnect7Regular, IconlyRegularBoldSidebarClose2Regular, IconlyRegularBoldSidebarCloseRegular, IconlyRegularBoldThumbLikeRegular, IconlyRegularBoldUserCheckedRegular, IconlyRegularBoldUserSearchRegular, IconlyRegularBoldVectoruserCheckedRegular, IconlyRegularLighExternalLinkRegular, Image2Bold, Image3Regular, ImageAi2Regular, ImageAiRegular, ImageBold, ImageDownRegular, ImageRecognitionRegular, ImageRegular, ImageUp2Regular, ImageUpRegular, InboxRegular, IndentRegular, InfoCircle2Bold, InfoCircleBold, InfoCircleRegular, InfoSquareBold, InfoSquareRegular, InformationRegular, InstagramBold, InsuranceHand2Regular, InsuranceHandRegular, ItalicRegular, JourneyRegular, LeavesRegular, LessRegular, LineChartUpwardRegular, Link2Regular, LinkRegular, LinkedinBold, ListCheckRegular, Loading2Regular, LoadingCircle3Regular, LoadingRegular, LocationBold, LocationRegular, LockBold, LockRegular, LoginBold, LoginRegular, LoginUserRegular, LogoutBold, LogoutRegular, MacNotebookBold, MacNotebookRegular, MagicWandRegular, MapCloseBold, MapCloseRegular, MapRegular, Marker2Regular, MarkerRegular, MedalRegular, MediumBold, Menu2Regular, MenuCloseLeft2Regular, MenuCloseLeftRegular, MenuRegular, MenuhorizontalRegular, MessageBold, MessageRegular, MessagesBold, MicrosoftExelRegular, MicrosoftWordRegular, Minus1Regular, Minus2Bold, Minus2Regular, Minus2VectorRegular, Minus3Bold, Minus4Regular, Monitor2Regular, MoonBold, MoonvectorRegular, MoreCircleBold, MoreCircleRegular, MoreSquareBold, MoreSquareRegular, MoveRegular, MovieTime2Regular, MovieTimeRegular, NewNotificationRegular, NoteLockRegular, NotificationBold, NotificationRegular, NumberedlistRegular, OfficechairRegular, OpenaiRegular, OrderedListRegular, OutdentRegular, PaintingPaletteRegular, PaperBold, PaperDownloadBold, PaperDownloadRegular, PaperFailBold, PaperFailRegular, PaperNegativeBold, PaperNegativeRegular, PaperPlus2Regular, PaperPlusBold, PaperPlusRegular, PaperRegular, PaperUploadBold, PaperUploadRegular, PasswordBold, PasswordRegular, PauseCircleRegular, Pen2Regular, PenRegular, PhotoRegular, PinMapRegular, PlaneCheckBold, PlaneCheckRegular, PlayBold, PlayRegular, Plus1Regular, Plus2Regular, Plus4Regular, PlusBold, PlusRegular, PowerButtonRegular, PrinterRegular, ProfileBold, ProfileRegular, QuestionMarkCircleRegular, QuestionMarkSquareRegular, QuestionsRegular, Refresh2Regular, RefreshRegular, RemoveCircleBold, RemoveUserBold, RemoveUserRegular, ReverseLeftRegular, ReverseRightRegular, RightUpSquareRegular, RoadmapRegular, RocketRegular, RotationRegular, SadDateRegular, SaveRegular, ScaleRegular, ScanBold, ScanRegular, ScreenSizeRegular, SearchBold, SearchDiscountPercentRegular, SearchRegular, Send2Bold, SendBold, SendRegular, SettingBold, SettingRegular, SettingSquareRegular, SettingToolCircleRegular, Share2Regular, ShareRegular, ShieldDoneBold, ShieldDoneRegular, ShieldFailBold, ShieldFailRegular, ShowBold, ShowRegular, Sign1Regular, Sign2Regular, SlightlyFrowningBold, SmilingAddRegular, SmilingRegular, SortDownRegular, SortRegular, SoundWaveRegular, SpeakerMegaphone5Bold, SpeakerMegaphone5Regular, SpeakerMegaphoneRegular, SquareBold, StarBold, StarRegular, StarRemoveRegular, StarsCircleRegular, StickerAddBold, StopCircleRegular, StopwatchPlayBold, StopwatchSpeedRegular, StopwatchStopBold, StrikethroughRegular, SuccessDocumentsRegular, Sun2Bold, SunBold, SunRegular, SunvectorRegular, SwapBold, SwapHorizontalRegular, SwapRegular, SwitchListRegular, SymbolpngRegular, TableRegular, TagBold, TagRegular, TargetRegular, TextAlignCenterRegular, TextAlignLeftRegular, TextAlignRightRegular, TextColorRegular, TextFieldRegular, ThumbDislikeBold, ThumbDislikeRegular, ThumbLikeBold, TickSquareBold, TickSquareRegular, TicketBold, TicketRegular, TicketStarBold, TicketStarRegular, TiktokBold, TimeCircle2Bold, TimeCircleBold, TimeCircleRegular, TimeSquareBold, TimeSquareRegular, TimerPlusBold, TimerRegular, TiredBold, TiredRegular, ToggleRegular, ToolsRegular, TranslateLanguageBold, TranslateLanguageRegular, TranslateVectorRegular, Triangle2Regular, TwitterBold, TypeRegular, UnderlineRegular, UniversityRegular, UnlockBold, UnlockRegular, UnorderedListRegular, UpLineRegular, UpSquareLineRegular, UpdateRight2Regular, UpdateRightRegular, UploadBold, UploadRegular, UserBadgeBold, UserBadgeRegular, UserBoardRegular, UserCheckedBold, UserContactRegular, UserDeleteBold, UserInformation2Regular, UserInformationRegular, UserLockRegular, UserRegular, UserSearchBold, UsersGroupRegular, UsersRegular, VectorcalendarRegular, VectorhomeRegular, VectorinfoSquareRegular, VectorprofileRegular, VectorsettingRegular, VectorstarRegular, VectorworkRegular, VerticalBarChart2Regular, VideoBold, VideoRegular, Voice2Bold, Voice3Regular, VoiceBold, VoiceRegular, VolumeDownBold, VolumeDownRegular, VolumeOffBold, VolumeOffRegular, VolumeUpBold, VolumeUpRegular, WalletBold, WalletRegular, WebPage2Regular, WebPage4Regular, WebPageEdit2Regular, WebPageEditRegular, Weight1Regular, WhatsappRegular, Wheelchair2Regular, WheelchairRegular, WorkBold, WorldRegular, WrenchRegular, XcomBold, XcomRegular, YoutubeBold, ZoomInRegular, ZoomOutRegular, iconNames, iconNamesByVariant, icons, iconsByVariant };

package/dist/index.js

@@ -15024,6 +15024,57 @@ var icons = __spreadValues(__spreadValues({}, iconsByVariant.regular), iconsByVa
 
 // src/Icon.tsx
 var warnedMissingIcons = /* @__PURE__ */ new Set();
+var warnedA11y = /* @__PURE__ */ new Set();
+function isDevEnvironment() {
+  var _a, _b;
+  const nodeEnv = (_b = (_a = globalThis.process) == null ? void 0 : _a.env) == null ? void 0 : _b.NODE_ENV;
+  return nodeEnv !== "production" && typeof console !== "undefined";
+}
+function warnA11y(message, cacheKey) {
+  if (!isDevEnvironment() || warnedA11y.has(cacheKey)) {
+    return;
+  }
+  warnedA11y.add(cacheKey);
+  console.warn(message);
+}
+function hasAccessibleName(props) {
+  const ariaLabel = props["aria-label"];
+  const ariaLabelledBy = props["aria-labelledby"];
+  return typeof ariaLabel === "string" && ariaLabel.trim().length > 0 || typeof ariaLabelledBy === "string" && ariaLabelledBy.trim().length > 0;
+}
+function resolveA11yProps(name, variant, decorative, props) {
+  const hasName = hasAccessibleName(props);
+  const isDecorative = decorative != null ? decorative : !hasName;
+  const resolvedProps = __spreadValues({}, props);
+  if (decorative === false && !hasName) {
+    warnA11y(
+      '[fichap/icons-react] Icon "' + name + '" with variant "' + variant + '" is marked as decorative={false} but has no accessible name. Pass aria-label or aria-labelledby.',
+      variant + ":" + name + ":missing-accessible-name"
+    );
+  }
+  if (decorative === true && hasName) {
+    warnA11y(
+      '[fichap/icons-react] Icon "' + name + '" with variant "' + variant + '" has decorative={true} and an accessible name. The accessible name may be ignored by assistive technologies.',
+      variant + ":" + name + ":decorative-with-name"
+    );
+  }
+  if (isDecorative) {
+    if (resolvedProps["aria-hidden"] === void 0) {
+      resolvedProps["aria-hidden"] = true;
+    }
+    if (resolvedProps.focusable === void 0) {
+      resolvedProps.focusable = false;
+    }
+    return resolvedProps;
+  }
+  if (resolvedProps.role === void 0) {
+    resolvedProps.role = "img";
+  }
+  if (resolvedProps.focusable === void 0) {
+    resolvedProps.focusable = false;
+  }
+  return resolvedProps;
+}
 function getMissingIconHint(name, variant, regularIcons, boldIcons) {
   if (variant !== "regular" || !name.endsWith("Bold")) {
     return "";
@@ -15035,9 +15086,7 @@ function getMissingIconHint(name, variant, regularIcons, boldIcons) {
   return ' Did you mean <Icon name="' + canonicalName + '" variant="bold" />?';
 }
 function warnMissingIcon(name, variant, regularIcons, boldIcons) {
-  var _a, _b;
-  const nodeEnv = (_b = (_a = globalThis.process) == null ? void 0 : _a.env) == null ? void 0 : _b.NODE_ENV;
-  if (nodeEnv === "production" || typeof console === "undefined") {
+  if (!isDevEnvironment()) {
     return;
   }
   const cacheKey = variant + ":" + name;
@@ -15050,17 +15099,18 @@ function warnMissingIcon(name, variant, regularIcons, boldIcons) {
   );
 }
 function Icon(_a) {
-  var _b = _a, { name, variant = "regular" } = _b, props = __objRest(_b, ["name", "variant"]);
+  var _b = _a, { name, variant = "regular", decorative } = _b, props = __objRest(_b, ["name", "variant", "decorative"]);
   var _a2, _b2;
   const selectedIcons = iconsByVariant[variant];
   const regularIcons = iconsByVariant.regular;
   const boldIcons = iconsByVariant.bold;
+  const resolvedA11yProps = resolveA11yProps(name, variant, decorative, props);
   const Component = (_b2 = (_a2 = selectedIcons[name]) != null ? _a2 : regularIcons[name]) != null ? _b2 : boldIcons[name];
   if (!Component) {
     warnMissingIcon(name, variant, regularIcons, boldIcons);
     return null;
   }
-  return /* @__PURE__ */ React580.createElement(Component, __spreadValues({}, props));
+  return /* @__PURE__ */ React580.createElement(Component, __spreadValues({}, resolvedA11yProps));
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.mjs

@@ -14408,6 +14408,57 @@ var icons = __spreadValues(__spreadValues({}, iconsByVariant.regular), iconsByVa
 
 // src/Icon.tsx
 var warnedMissingIcons = /* @__PURE__ */ new Set();
+var warnedA11y = /* @__PURE__ */ new Set();
+function isDevEnvironment() {
+  var _a, _b;
+  const nodeEnv = (_b = (_a = globalThis.process) == null ? void 0 : _a.env) == null ? void 0 : _b.NODE_ENV;
+  return nodeEnv !== "production" && typeof console !== "undefined";
+}
+function warnA11y(message, cacheKey) {
+  if (!isDevEnvironment() || warnedA11y.has(cacheKey)) {
+    return;
+  }
+  warnedA11y.add(cacheKey);
+  console.warn(message);
+}
+function hasAccessibleName(props) {
+  const ariaLabel = props["aria-label"];
+  const ariaLabelledBy = props["aria-labelledby"];
+  return typeof ariaLabel === "string" && ariaLabel.trim().length > 0 || typeof ariaLabelledBy === "string" && ariaLabelledBy.trim().length > 0;
+}
+function resolveA11yProps(name, variant, decorative, props) {
+  const hasName = hasAccessibleName(props);
+  const isDecorative = decorative != null ? decorative : !hasName;
+  const resolvedProps = __spreadValues({}, props);
+  if (decorative === false && !hasName) {
+    warnA11y(
+      '[fichap/icons-react] Icon "' + name + '" with variant "' + variant + '" is marked as decorative={false} but has no accessible name. Pass aria-label or aria-labelledby.',
+      variant + ":" + name + ":missing-accessible-name"
+    );
+  }
+  if (decorative === true && hasName) {
+    warnA11y(
+      '[fichap/icons-react] Icon "' + name + '" with variant "' + variant + '" has decorative={true} and an accessible name. The accessible name may be ignored by assistive technologies.',
+      variant + ":" + name + ":decorative-with-name"
+    );
+  }
+  if (isDecorative) {
+    if (resolvedProps["aria-hidden"] === void 0) {
+      resolvedProps["aria-hidden"] = true;
+    }
+    if (resolvedProps.focusable === void 0) {
+      resolvedProps.focusable = false;
+    }
+    return resolvedProps;
+  }
+  if (resolvedProps.role === void 0) {
+    resolvedProps.role = "img";
+  }
+  if (resolvedProps.focusable === void 0) {
+    resolvedProps.focusable = false;
+  }
+  return resolvedProps;
+}
 function getMissingIconHint(name, variant, regularIcons, boldIcons) {
   if (variant !== "regular" || !name.endsWith("Bold")) {
     return "";
@@ -14419,9 +14470,7 @@ function getMissingIconHint(name, variant, regularIcons, boldIcons) {
   return ' Did you mean <Icon name="' + canonicalName + '" variant="bold" />?';
 }
 function warnMissingIcon(name, variant, regularIcons, boldIcons) {
-  var _a, _b;
-  const nodeEnv = (_b = (_a = globalThis.process) == null ? void 0 : _a.env) == null ? void 0 : _b.NODE_ENV;
-  if (nodeEnv === "production" || typeof console === "undefined") {
+  if (!isDevEnvironment()) {
     return;
   }
   const cacheKey = variant + ":" + name;
@@ -14434,17 +14483,18 @@ function warnMissingIcon(name, variant, regularIcons, boldIcons) {
   );
 }
 function Icon(_a) {
-  var _b = _a, { name, variant = "regular" } = _b, props = __objRest(_b, ["name", "variant"]);
+  var _b = _a, { name, variant = "regular", decorative } = _b, props = __objRest(_b, ["name", "variant", "decorative"]);
   var _a2, _b2;
   const selectedIcons = iconsByVariant[variant];
   const regularIcons = iconsByVariant.regular;
   const boldIcons = iconsByVariant.bold;
+  const resolvedA11yProps = resolveA11yProps(name, variant, decorative, props);
   const Component = (_b2 = (_a2 = selectedIcons[name]) != null ? _a2 : regularIcons[name]) != null ? _b2 : boldIcons[name];
   if (!Component) {
     warnMissingIcon(name, variant, regularIcons, boldIcons);
     return null;
   }
-  return /* @__PURE__ */ React580.createElement(Component, __spreadValues({}, props));
+  return /* @__PURE__ */ React580.createElement(Component, __spreadValues({}, resolvedA11yProps));
 }
 export {
   AccidentRegular_default as AccidentRegular,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fichap/icons-react",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "description": "Fichap Iconly-based icon library for React.",
   "license": "MIT",
   "keywords": [