@marwes-ui/core 1.4.1 → 1.5.1

package/README.md

@@ -152,10 +152,10 @@ Use these helpers when custom styling needs to stay connected to the active prov
 - `mwThemeVars` is the default custom styling API. It returns CSS `var(...)` references such as `"var(--mw-spacing-sp-24)"`.
 - `mwThemeVarNames` returns raw custom property names such as `"--mw-spacing-sp-24"` for assignment, inspection, tests, and bridge packages.
 - `mwVar()` wraps a custom `--mw-*` property name in `var(...)`, with optional fallback support.
-- `mwStyledTheme` mirrors `mwThemeVars` as a plain object for styled-components and Emotion theme providers.
+- `mwTheme` mirrors `mwThemeVars` as a plain object for styled-components and Emotion theme providers. `mwStyledTheme` remains as a deprecated compatibility alias.
 
 ```ts
-import { mwStyledTheme, mwThemeVarNames, mwThemeVars, mwVar } from "@marwes-ui/core"
+import { mwTheme, mwThemeVarNames, mwThemeVars, mwVar } from "@marwes-ui/core"
 
 mwThemeVars.spacing.sp24 // "var(--mw-spacing-sp-24)"
 mwThemeVars.color.text // "var(--mw-color-text)"
@@ -164,11 +164,13 @@ mwThemeVars.ui.radius // "var(--mw-ui-radius)"
 
 mwThemeVarNames.spacing.sp24 // "--mw-spacing-sp-24"
 mwVar("--mw-color-text", "#141414") // "var(--mw-color-text, #141414)"
-mwStyledTheme.spacing.sp24 // "var(--mw-spacing-sp-24)"
+mwTheme.spacing.sp24 // "var(--mw-spacing-sp-24)"
 ```
 
 This enables one theme contract across plain CSS, CSS Modules, CSS-in-JS, vanilla-extract, Tailwind-style config files, inline style objects, React, Vue, Svelte, and future adapters. Because the helpers only expose CSS variable references and names, they remain framework-agnostic and follow any `ThemeInput` resolved by the provider.
 
+`mwTheme`, `mwStyledTheme`, and `mwThemeVars` are CSS-reference objects, not resolved runtime themes. Values such as `"var(--mw-color-primary-base)"` are intended for CSS evaluation inside the provider scope and can be empty when JavaScript tries to resolve them from `:root`. Never use these helpers as the source for JavaScript color calculations, aliases, charts, or design-tool bridges. Use the adapter's `useTheme()` hook when logic needs concrete values such as `"#2457FF"`.
+
 Keep the APIs separate:
 - `Spacings.sp24` returns `"sp-24"` for Marwes component props.
 - `mwThemeVars.spacing.sp24` returns `"var(--mw-spacing-sp-24)"` for custom styling.
@@ -264,7 +266,8 @@ Theme:
 - `createMarwesThemeStyle`
 - `mwThemeVars`
 - `mwThemeVarNames`
-- `mwStyledTheme`
+- `mwTheme`
+- `mwStyledTheme` (deprecated compatibility alias)
 - `mwVar`
 - `lightThemeDefaults`
 - `darkThemeDefaults`

package/dist/index.d.ts

@@ -3737,6 +3737,11 @@ declare const storybookButtonGeneralArgTypes: {
         readonly control: "select";
         readonly options: readonly ["primary", "secondary", "neutral", "text", "success", "danger"];
     };
+    readonly type: {
+        readonly control: "select";
+        readonly options: readonly ["button", "submit", "reset"];
+        readonly description: "Native form behavior; defaults to \"button\". Form actions (submit/reset) take precedence. Ignored for anchors.";
+    };
     readonly iconLeft: {
         readonly control: "select";
         readonly options: ("tablet" | "info" | "search" | "repeat" | "bold" | "link" | "save" | "edit" | "upload" | "download" | "copy" | "delete" | "code" | "airplay" | "alertCircle" | "alertOctagon" | "alertTriangle" | "alignCenter" | "alignJustify" | "alignLeft" | "alignRight" | "arrowDown" | "arrowDownCircle" | "arrowDownLeft" | "arrowDownRight" | "arrowIn" | "arrowInCircle" | "arrowInSquare" | "arrowLeft" | "arrowLeftCircle" | "arrowOut" | "arrowOutCircle" | "arrowOutSquare" | "arrowRight" | "arrowRightCircle" | "arrowUp" | "arrowUpCircle" | "arrowUpLeft" | "arrowUpRight" | "atSign" | "barChart" | "barChart2" | "barChart3" | "barChart4" | "bell" | "bluetooth" | "bookmark" | "calendar" | "camera" | "cast" | "check" | "checkCircle" | "checkSquare" | "chevronDown" | "chevronLeft" | "chevronRight" | "chevronUp" | "chevronsDown" | "chevronsLeft" | "chevronsRight" | "chevronsUp" | "circle" | "clipboard" | "clock" | "command" | "compass" | "cornerDownLeft" | "cornerDownRight" | "cornerLeftDown" | "cornerLeftUp" | "cornerRightDown" | "cornerRightUp" | "cornerUpLeft" | "cornerUpRight" | "cpu" | "creditCard" | "database" | "disc" | "dollarSign" | "downloadCloud" | "edit2" | "edit3" | "expand" | "externalLink" | "eye" | "eyeOff" | "facebook" | "fastForward" | "file" | "fileMinus" | "fileMinus2" | "filePlus" | "filePlus2" | "fileText" | "fileX" | "fileX2" | "film" | "flag" | "folder" | "folderMinus" | "folderMinus2" | "folderPlus" | "folderPlus2" | "folderX" | "folderX2" | "grid" | "hardDrive" | "hash" | "headphones" | "heart" | "helpCircle" | "hexagon" | "home" | "home2" | "image" | "inbox" | "italic" | "layout" | "layout2" | "layout3" | "layout4" | "layout5" | "layout6" | "lineChart" | "lineChart2" | "list" | "loader" | "lock" | "mail" | "mapMarker1" | "mapMarker2" | "mapMarker3" | "maximize" | "maximize2" | "menu" | "messageCircle" | "messageSquare" | "mic" | "minimize" | "minimize3" | "minus" | "minusCircle" | "minusSquare" | "monitor" | "moon" | "moreHorizontal" | "moreVertical" | "move" | "music" | "octagon" | "paperclip" | "pause" | "pauseCircle" | "percent" | "phone" | "pieChart" | "pieChart2" | "pieChart3" | "pieChart4" | "pieChart5" | "play" | "playCircle" | "plus" | "plusCircle" | "plusSquare" | "power" | "printer" | "radio" | "refreshCcw" | "refreshCw" | "rewind" | "rotateLeft" | "rotateRight" | "rss" | "scissors" | "server" | "settings" | "share" | "shoppingBag" | "shoppingCart" | "shuffle" | "skipBack" | "skipForward" | "slash" | "sliders" | "smartphone" | "speaker" | "square" | "star" | "stopCircle" | "strikethrough" | "sun" | "table" | "table2" | "tag" | "thumbsDown" | "thumbsUp" | "trash" | "trendingDown" | "trendingUp" | "triangle" | "tv" | "twitter" | "type" | "underline" | "unlock" | "uploadCloud" | "user" | "userCheck" | "userCircle" | "userMinus" | "userPlus" | "userX" | "users" | "video" | "videoOff" | "volume" | "volume1" | "volume2" | "volumeX" | "watch" | "wifi" | "x" | "xCircle" | "xSquare" | "zoomIn" | "zoomOut" | undefined)[];
@@ -4106,6 +4111,7 @@ declare const storybookSliderArgTypes: {
     };
 };
 declare const storybookDocsDescription: {
+    readonly primaryButton: "PrimaryButton controls visual emphasis and defaults to type=\"button\". Set type=\"submit\" for a form, or use SubmitButton for a fixed submit purpose.";
     readonly linkButton: "LinkButton locks navigation semantics, renders as an anchor, and keeps the canonical text treatment. Use Button for intentional visual deviations.";
     readonly destructiveButton: "DestructiveButton locks destructive semantics, uses the canonical danger treatment, and requires confirmation by default. Use Button for intentional exceptions.";
     readonly submitButton: "SubmitButton locks form-submit semantics, always renders as a button, and keeps the canonical primary treatment.";
@@ -5139,9 +5145,25 @@ interface ResolvedButtonLoading {
     spinnerVariant: SpinnerVariant;
     loadingLabel?: string;
 }
+/** Accessible-name contract for controls that never render visible text. */
+type AccessibleButtonName = {
+    label: string;
+    ariaLabel?: string;
+    ariaLabelledBy?: string;
+} | {
+    label?: string;
+    ariaLabel: string;
+    ariaLabelledBy?: string;
+} | {
+    label?: string;
+    ariaLabel?: string;
+    ariaLabelledBy: string;
+};
 type ButtonOptions = {
     as?: "button" | "a";
     href?: string;
+    /** Native form behavior. Defaults to "button"; submit/reset actions take precedence. Ignored for anchors. */
+    type?: "button" | "submit" | "reset";
     size?: ButtonSize;
     variant?: ButtonVariant;
     disabled?: boolean;
@@ -10483,4 +10505,4 @@ interface SkipLinkRenderKit {
 
 declare function createSkipLinkRecipe(opts: SkipLinkOptions): SkipLinkRenderKit;
 
-export { type AccordionA11yProps, type AccordionOptions, type AccordionRenderKit, type AvatarA11yProps, type AvatarDataAttributes, type AvatarOptions, type AvatarRenderContent, type AvatarRenderKit, AvatarSize, AvatarType, type BadgeA11yProps, type BadgeOptions, type BadgeRenderKit, BadgeVariant, type BannerA11yProps, type BannerOptions, type BannerRenderKit, BannerVariant, type BreadcrumbA11yProps, type BreadcrumbEntryRenderKit, type BreadcrumbHomeA11yProps, type BreadcrumbHomeRenderKit, type BreadcrumbItem, type BreadcrumbItemA11yProps, type BreadcrumbItemRenderKit, type BreadcrumbListA11yProps, type BreadcrumbOptions, type BreadcrumbRenderKit, type BreadcrumbSeparatorA11yProps, type ButtonA11yProps, ButtonAction, type ButtonLoadingOptions, type ButtonOptions, type ButtonRenderKit, ButtonSize, ButtonVariant, type CardOptions, type CardRenderKit, type CheckboxA11y, type CheckboxProps, type CheckboxRenderKit, type CheckboxState, type ColorInput, type ColorRole, type ContextMenuA11yProps, type ContextMenuActionItem, type ContextMenuActionItemRenderKit, type ContextMenuDividerA11yProps, type ContextMenuDividerItem, type ContextMenuDividerRenderKit, type ContextMenuEntry, type ContextMenuEntryRenderKit, type ContextMenuItemA11yProps, type ContextMenuItemKind, type ContextMenuOptions, type ContextMenuRenderKit, type CssVars, type CurrencyCode, DEFAULT_PROGRESS_BAR_LABEL, DEFAULT_PROGRESS_BAR_MAX, DEFAULT_PROGRESS_BAR_MIN, DENSITY_SCALES, type DatePickerA11yProps, type DatePickerDataAttributes, type DatePickerDay, type DatePickerDayRenderKit, type DatePickerDayState, type DatePickerDevice, type DatePickerOptions, type DatePickerRenderKit, type Density, type DensityScale, type DialogA11yProps, type DialogOptions, type DialogRenderKit, type DialogSize, type DividerA11y, type DividerDataAttributes, type DividerOptions, type DividerOrientation, type DividerRenderKit, type DividerSize, type DrawerA11yProps, type DrawerOptions, type DrawerPanelRenderKit, type DrawerPlacement, type DrawerRenderKit, type DrawerScrimRenderKit, type DrawerSize, type FamilySemanticDefinition, type FieldComparisonRow, type FontLoadingConfig, type FontLoadingMode, type FontLoadingOptions, type HeadingA11y, type HeadingLevel, type HeadingOptions, type HeadingRenderKit, type HeadingSize, type IconA11yProps, type IconColor, IconName, IconName as IconNameType, type IconOptions, type IconPreset, type IconRenderKit, type IconSize, type IconSizeKey, type IconStrokeWidth, type IconStrokeWidthKey, type InputA11yProps, type InputOptions, type InputOtpA11yProps, type InputOtpOptions, type InputOtpRenderKit, type InputRenderKit, type InputTone, type LabeledCopy, type MarwesThemeScriptOptions, type MarwesThemeStyleOptions, type MwAvailableFont, type MwFontFallback, type MwGoogleFontFamily, type MwStyledTheme, type MwTheme, type MwThemeMedia, type MwThemeVarName, type MwThemeVarNames, type MwThemeVarReference, type MwThemeVars, type PaginationA11yProps, type PaginationAdaptiveMaxVisibleItemsOptions, type PaginationAdaptiveProfile, type PaginationAdaptiveProfileOptions, type PaginationControlA11yProps, type PaginationControlDirection, type PaginationControlDisplay, type PaginationControlOptions, type PaginationControlRenderKit, type PaginationEllipsisA11yProps, type PaginationEllipsisRenderKit, type PaginationGetItemAriaLabel, type PaginationItem, type PaginationItemAriaLabelOptions, type PaginationItemType, type PaginationListA11yProps, type PaginationListItemRenderKit, type PaginationListRenderKit, type PaginationOptions, type PaginationPageA11yProps, type PaginationPageOptions, type PaginationPageRenderKit, type PaginationRenderKit, type PaginationReservedItemCountOptions, type PaginationResolvedControlDisplay, type ParagraphA11y, type ParagraphOptions, type ParagraphRenderKit, type ParagraphSize, type PersonalityName, type ProgressBarA11yProps, type ProgressBarDataAttributes, type ProgressBarOptions, type ProgressBarRenderKit, ProgressBarSize, ProgressBarState, type PurposeSemanticDefinition, type RadioA11y, type RadioOptions, type RadioRenderKit, type ResolvedButtonLoading, type ResolvedTheme, type RichTextA11yProps, type RichTextFormat, type RichTextOptions, type RichTextRenderKit, type SecondaryColorRole, type SegmentedControlA11yProps, type SegmentedControlItemA11yProps, type SegmentedControlItemOptions, type SegmentedControlItemRenderKit, type SegmentedControlItemState, type SegmentedControlNavigationDirection, type SegmentedControlOptions, type SegmentedControlRenderKit, type SegmentedControlSize, type SegmentedControlVariant, type SelectA11yProps, type SelectAppearance, type SelectMode, type SelectOption, type SelectOptions, type SelectRenderKit, type SemanticAttributeDefinition, type SemanticAttributeName, type SemanticAttributeValue, type SemanticAttributes, type SemanticFamily, type SemanticHeadingLevel, type SemanticIntent, type SemanticLayer, type SemanticOrientation, type SemanticOutcome, type SemanticPurpose, type SkeletonA11yProps, SkeletonAnimation, type SkeletonDataAttributes, type SkeletonDimension, type SkeletonOptions, type SkeletonRenderKit, SkeletonVariant, type SkipLinkOptions, type SkipLinkRenderKit, type SliderA11yProps, type SliderDataAttributes, type SliderOptions, type SliderRenderKit, type SpacingA11y, type SpacingDataAttributes, type SpacingOptions, type SpacingRenderKit, type SpacingSize, Spacings, type SpinnerA11yProps, type SpinnerDataAttributes, type SpinnerOptions, type SpinnerRenderKit, type SpinnerSize, type SpinnerSvgDefinition, type SpinnerSvgElement, type SpinnerSvgNode, SpinnerVariant, SpinnerVariants, type StatTileA11yProps, type StatTileDataAttributes, type StatTileOptions, type StatTileRenderKit, type StatTileTone, type StatTileTrendDirection, type SvgElementType, type SvgNode, type SwitchA11yProps, type SwitchOptions, type SwitchRenderKit, SwitchSize, type SystemThemeMode, type TabA11yProps, type TabGroupA11yIds, type TabGroupItemState, type TabNavigationDirection, type TabOptions, type TabRenderKit, type TextA11y, type TextAs, type TextOptions, type TextRenderKit, type TextTransform, type TextTypographyStyle, TextVariant, type TextareaA11yProps, type TextareaOptions, type TextareaRenderKit, type TextareaResize, type Theme, type ThemeBreakpointName, type ThemeBreakpoints, type ThemeInput, type ThemeInputColor, ThemeMode, type ThemeModeAttribute, type ThemeModeCSSRulesOptions, type ThemeModeRootTarget, type ThemePreference, type ThemeVariableStrategy, type ToastA11yProps, type ToastContainerOptions, type ToastIntent, type ToastOptions, type ToastPlacement, type ToastRenderKit, type ToastVariant, type ToneName, type TooltipA11yProps, type TooltipDataAttributes, type TooltipOptions, type TooltipRenderKit, type TypographyStyle, accordionPurposeComponentReference, accordionWhyPurposeComponents, avatarPurposeSemantics, avatarPurposes, badgePurposeComponentReference, badgePurposeSemantics, badgePurposes, badgeWhyPurposeComponents, bannerPurposeSemantics, bannerPurposes, buildAccordionFieldA11yIds, buildCheckboxA11y, buildCheckboxFieldA11yIds, buildCheckboxGroupFieldA11yIds, buildCurrencyHelperText, buildGoogleFontsUrl, buildHeadingA11y, buildInputFieldA11yIds, buildRadioA11y, buildRadioGroupFieldA11yIds, buildRichTextFieldA11yIds, buildSliderFieldA11yIds, buildSwitchFieldA11yIds, buildTabGroupA11yIds, buttonActionSemanticPurposes, buttonPurposeSemantics, buttonPurposes, buttonVariantVisualStyles, buttonWhySemanticComponents, canonicalSemanticAttributeNames, canonicalSemanticAttributeRegistry, canonicalSemanticAttributes, cardPurposeComponentReference, cardWhyPurposeComponents, checkboxRecipe, clampPaginationPage, clampProgressBarValue, createAccordionRecipe, createAvatarRecipe, createBadgeRecipe, createBannerRecipe, createBreadcrumbRecipe, createButtonRecipe, createCardRecipe, createContextMenuRecipe, createDatePickerRecipe, createDialogRecipe, createDividerRecipe, createDrawerRecipe, createFamilySemanticAttributes, createFontStack, createIconRecipe, createInputOtpRecipe, createInputRecipe, createMarwesThemeScript, createMarwesThemeStyle, createMwTheme, createMwThemeMedia, createPaginationControlRecipe, createPaginationEllipsisRecipe, createPaginationItems, createPaginationListItemRecipe, createPaginationListRecipe, createPaginationPageRecipe, createPaginationRecipe, createProgressBarRecipe, createPurposeSemanticAttributes, createRichTextRecipe, createSegmentedControlItemRecipe, createSegmentedControlRecipe, createSelectRecipe, createSkeletonRecipe, createSkipLinkRecipe, createSliderRecipe, createSpacingRecipe, createSpinnerRecipe, createStatTileRecipe, createSwitchRecipe, createTabRecipe, createTextareaRecipe, createToastRecipe, createTooltipRecipe, currencyCodes, darkThemeDefaults, defaultThemeBreakpoints, densityToCSSVars, dialogPurposeComponentReference, dialogPurposeSemantics, dialogPurposes, dialogWhyPurposeComponents, emptySemanticAttributes, escapeRichTextHtml, extractFontFamilyName, extractUsedWeights, familySemanticsRegistry, fieldComparisonRows, fieldWhyPurposeComponents, filterUndefinedSemanticAttributes, getCurrencySymbol, headingRecipe, iconNames, iconNamesList, iconRegistry, iconSizeScale, iconStrokeWidthScale, isRichTextHtmlEmpty, isSystemFont, isThemeMode, isThemePreference, lightThemeDefaults, mergeIdRefs, mergeSemanticAttributes, moveSegmentedControlSelection, moveTabSelection, mwAvailableFonts, mwFontFallbacks, mwGoogleFontFamilies, mwStyledTheme, mwTheme, mwThemeVarNames, mwThemeVars, mwVar, nextThemeMode, normalizeRichTextHtml, paragraphRecipe, progressBarSizes, progressBarStates, purposeSemanticsRegistry, radioPurposeComponentReference, radioRecipe, radioWhyPurposeComponents, resolveAccordionA11y, resolveAvatarA11y, resolveBadgeA11y, resolveBannerA11y, resolveBreadcrumbA11y, resolveBreadcrumbHomeA11y, resolveBreadcrumbItemA11y, resolveBreadcrumbListA11y, resolveBreadcrumbSeparatorA11y, resolveButtonLoading, resolveContextMenuA11y, resolveContextMenuDividerA11y, resolveContextMenuItemA11y, resolveDatePickerDayLabel, resolveDialogA11y, resolveDrawerA11y, resolveIconA11y, resolveIconSize, resolveIconStrokeWidth, resolvePaginationA11y, resolvePaginationAdaptiveMaxVisibleItems, resolvePaginationAdaptiveProfile, resolvePaginationControlA11y, resolvePaginationEllipsisA11y, resolvePaginationItemAriaLabel, resolvePaginationListA11y, resolvePaginationPageA11y, resolvePaginationReservedItemCount, resolveProgressBarA11y, resolveProgressBarBounds, resolveRichTextAllowedFormats, resolveSegmentedControlA11y, resolveSegmentedControlItemA11y, resolveSegmentedControlValue, resolveSelectMode, resolveServerThemeMode, resolveSkeletonA11y, resolveSliderA11y, resolveSpinnerA11y, resolveSpinnerSize, resolveStatTileTrendLabel, resolveSwitchA11y, resolveTabA11y, resolveTabValue, resolveThemeInput, resolveThemePreference, resolveToastA11y, resolveTone, resolveTooltipA11y, richTextCommandByFormat, richTextFormattingReference, richTextWhyUseIt, sanitizeCurrencyValue, sanitizeInputOtpValue, semanticFamilies, semanticFrameworkSupport, semanticIntents, semanticLayers, semanticOrientations, semanticOutcomes, semanticPurposes, shouldLoadGoogleFont, skeletonAnimations, skeletonVariants, sliderPurposeComponentReference, sliderWhyPurposeComponents, spinnerSizeScale, spinnerSizes, spinnerVariants, storybookA11yPolicy, storybookButtonGeneralArgTypes, storybookButtonIconArgTypes, storybookButtonPurposeArgTypes, storybookCheckboxArgTypes, storybookDatePickerArgTypes, storybookDividerArgTypes, storybookDocsDescription, storybookIconButtonArgTypes, storybookIconGalleryArgTypes, storybookIconGalleryDefaults, storybookIconNames, storybookLayout, storybookOptionalIconNames, storybookProgressBarArgTypes, storybookRadioArgTypes, storybookSkeletonArgTypes, storybookSliderArgTypes, storybookSpacingArgTypes, storybookSpinnerArgTypes, storybookStatTileArgTypes, switchPurposeComponentReference, switchWhyPurposeComponents, tabPurposeComponentReference, tabWhyPurposeComponents, textRecipe, themeModesToCSSRules, themeToCSSRule, themeToCSSVars, toastPurposeComponentReference, toastPurposeSemantics, toastPurposes, toastWhyPurposeComponents, validateSemanticRegistry };
+export { type AccessibleButtonName, type AccordionA11yProps, type AccordionOptions, type AccordionRenderKit, type AvatarA11yProps, type AvatarDataAttributes, type AvatarOptions, type AvatarRenderContent, type AvatarRenderKit, AvatarSize, AvatarType, type BadgeA11yProps, type BadgeOptions, type BadgeRenderKit, BadgeVariant, type BannerA11yProps, type BannerOptions, type BannerRenderKit, BannerVariant, type BreadcrumbA11yProps, type BreadcrumbEntryRenderKit, type BreadcrumbHomeA11yProps, type BreadcrumbHomeRenderKit, type BreadcrumbItem, type BreadcrumbItemA11yProps, type BreadcrumbItemRenderKit, type BreadcrumbListA11yProps, type BreadcrumbOptions, type BreadcrumbRenderKit, type BreadcrumbSeparatorA11yProps, type ButtonA11yProps, ButtonAction, type ButtonLoadingOptions, type ButtonOptions, type ButtonRenderKit, ButtonSize, ButtonVariant, type CardOptions, type CardRenderKit, type CheckboxA11y, type CheckboxProps, type CheckboxRenderKit, type CheckboxState, type ColorInput, type ColorRole, type ContextMenuA11yProps, type ContextMenuActionItem, type ContextMenuActionItemRenderKit, type ContextMenuDividerA11yProps, type ContextMenuDividerItem, type ContextMenuDividerRenderKit, type ContextMenuEntry, type ContextMenuEntryRenderKit, type ContextMenuItemA11yProps, type ContextMenuItemKind, type ContextMenuOptions, type ContextMenuRenderKit, type CssVars, type CurrencyCode, DEFAULT_PROGRESS_BAR_LABEL, DEFAULT_PROGRESS_BAR_MAX, DEFAULT_PROGRESS_BAR_MIN, DENSITY_SCALES, type DatePickerA11yProps, type DatePickerDataAttributes, type DatePickerDay, type DatePickerDayRenderKit, type DatePickerDayState, type DatePickerDevice, type DatePickerOptions, type DatePickerRenderKit, type Density, type DensityScale, type DialogA11yProps, type DialogOptions, type DialogRenderKit, type DialogSize, type DividerA11y, type DividerDataAttributes, type DividerOptions, type DividerOrientation, type DividerRenderKit, type DividerSize, type DrawerA11yProps, type DrawerOptions, type DrawerPanelRenderKit, type DrawerPlacement, type DrawerRenderKit, type DrawerScrimRenderKit, type DrawerSize, type FamilySemanticDefinition, type FieldComparisonRow, type FontLoadingConfig, type FontLoadingMode, type FontLoadingOptions, type HeadingA11y, type HeadingLevel, type HeadingOptions, type HeadingRenderKit, type HeadingSize, type IconA11yProps, type IconColor, IconName, IconName as IconNameType, type IconOptions, type IconPreset, type IconRenderKit, type IconSize, type IconSizeKey, type IconStrokeWidth, type IconStrokeWidthKey, type InputA11yProps, type InputOptions, type InputOtpA11yProps, type InputOtpOptions, type InputOtpRenderKit, type InputRenderKit, type InputTone, type LabeledCopy, type MarwesThemeScriptOptions, type MarwesThemeStyleOptions, type MwAvailableFont, type MwFontFallback, type MwGoogleFontFamily, type MwStyledTheme, type MwTheme, type MwThemeMedia, type MwThemeVarName, type MwThemeVarNames, type MwThemeVarReference, type MwThemeVars, type PaginationA11yProps, type PaginationAdaptiveMaxVisibleItemsOptions, type PaginationAdaptiveProfile, type PaginationAdaptiveProfileOptions, type PaginationControlA11yProps, type PaginationControlDirection, type PaginationControlDisplay, type PaginationControlOptions, type PaginationControlRenderKit, type PaginationEllipsisA11yProps, type PaginationEllipsisRenderKit, type PaginationGetItemAriaLabel, type PaginationItem, type PaginationItemAriaLabelOptions, type PaginationItemType, type PaginationListA11yProps, type PaginationListItemRenderKit, type PaginationListRenderKit, type PaginationOptions, type PaginationPageA11yProps, type PaginationPageOptions, type PaginationPageRenderKit, type PaginationRenderKit, type PaginationReservedItemCountOptions, type PaginationResolvedControlDisplay, type ParagraphA11y, type ParagraphOptions, type ParagraphRenderKit, type ParagraphSize, type PersonalityName, type ProgressBarA11yProps, type ProgressBarDataAttributes, type ProgressBarOptions, type ProgressBarRenderKit, ProgressBarSize, ProgressBarState, type PurposeSemanticDefinition, type RadioA11y, type RadioOptions, type RadioRenderKit, type ResolvedButtonLoading, type ResolvedTheme, type RichTextA11yProps, type RichTextFormat, type RichTextOptions, type RichTextRenderKit, type SecondaryColorRole, type SegmentedControlA11yProps, type SegmentedControlItemA11yProps, type SegmentedControlItemOptions, type SegmentedControlItemRenderKit, type SegmentedControlItemState, type SegmentedControlNavigationDirection, type SegmentedControlOptions, type SegmentedControlRenderKit, type SegmentedControlSize, type SegmentedControlVariant, type SelectA11yProps, type SelectAppearance, type SelectMode, type SelectOption, type SelectOptions, type SelectRenderKit, type SemanticAttributeDefinition, type SemanticAttributeName, type SemanticAttributeValue, type SemanticAttributes, type SemanticFamily, type SemanticHeadingLevel, type SemanticIntent, type SemanticLayer, type SemanticOrientation, type SemanticOutcome, type SemanticPurpose, type SkeletonA11yProps, SkeletonAnimation, type SkeletonDataAttributes, type SkeletonDimension, type SkeletonOptions, type SkeletonRenderKit, SkeletonVariant, type SkipLinkOptions, type SkipLinkRenderKit, type SliderA11yProps, type SliderDataAttributes, type SliderOptions, type SliderRenderKit, type SpacingA11y, type SpacingDataAttributes, type SpacingOptions, type SpacingRenderKit, type SpacingSize, Spacings, type SpinnerA11yProps, type SpinnerDataAttributes, type SpinnerOptions, type SpinnerRenderKit, type SpinnerSize, type SpinnerSvgDefinition, type SpinnerSvgElement, type SpinnerSvgNode, SpinnerVariant, SpinnerVariants, type StatTileA11yProps, type StatTileDataAttributes, type StatTileOptions, type StatTileRenderKit, type StatTileTone, type StatTileTrendDirection, type SvgElementType, type SvgNode, type SwitchA11yProps, type SwitchOptions, type SwitchRenderKit, SwitchSize, type SystemThemeMode, type TabA11yProps, type TabGroupA11yIds, type TabGroupItemState, type TabNavigationDirection, type TabOptions, type TabRenderKit, type TextA11y, type TextAs, type TextOptions, type TextRenderKit, type TextTransform, type TextTypographyStyle, TextVariant, type TextareaA11yProps, type TextareaOptions, type TextareaRenderKit, type TextareaResize, type Theme, type ThemeBreakpointName, type ThemeBreakpoints, type ThemeInput, type ThemeInputColor, ThemeMode, type ThemeModeAttribute, type ThemeModeCSSRulesOptions, type ThemeModeRootTarget, type ThemePreference, type ThemeVariableStrategy, type ToastA11yProps, type ToastContainerOptions, type ToastIntent, type ToastOptions, type ToastPlacement, type ToastRenderKit, type ToastVariant, type ToneName, type TooltipA11yProps, type TooltipDataAttributes, type TooltipOptions, type TooltipRenderKit, type TypographyStyle, accordionPurposeComponentReference, accordionWhyPurposeComponents, avatarPurposeSemantics, avatarPurposes, badgePurposeComponentReference, badgePurposeSemantics, badgePurposes, badgeWhyPurposeComponents, bannerPurposeSemantics, bannerPurposes, buildAccordionFieldA11yIds, buildCheckboxA11y, buildCheckboxFieldA11yIds, buildCheckboxGroupFieldA11yIds, buildCurrencyHelperText, buildGoogleFontsUrl, buildHeadingA11y, buildInputFieldA11yIds, buildRadioA11y, buildRadioGroupFieldA11yIds, buildRichTextFieldA11yIds, buildSliderFieldA11yIds, buildSwitchFieldA11yIds, buildTabGroupA11yIds, buttonActionSemanticPurposes, buttonPurposeSemantics, buttonPurposes, buttonVariantVisualStyles, buttonWhySemanticComponents, canonicalSemanticAttributeNames, canonicalSemanticAttributeRegistry, canonicalSemanticAttributes, cardPurposeComponentReference, cardWhyPurposeComponents, checkboxRecipe, clampPaginationPage, clampProgressBarValue, createAccordionRecipe, createAvatarRecipe, createBadgeRecipe, createBannerRecipe, createBreadcrumbRecipe, createButtonRecipe, createCardRecipe, createContextMenuRecipe, createDatePickerRecipe, createDialogRecipe, createDividerRecipe, createDrawerRecipe, createFamilySemanticAttributes, createFontStack, createIconRecipe, createInputOtpRecipe, createInputRecipe, createMarwesThemeScript, createMarwesThemeStyle, createMwTheme, createMwThemeMedia, createPaginationControlRecipe, createPaginationEllipsisRecipe, createPaginationItems, createPaginationListItemRecipe, createPaginationListRecipe, createPaginationPageRecipe, createPaginationRecipe, createProgressBarRecipe, createPurposeSemanticAttributes, createRichTextRecipe, createSegmentedControlItemRecipe, createSegmentedControlRecipe, createSelectRecipe, createSkeletonRecipe, createSkipLinkRecipe, createSliderRecipe, createSpacingRecipe, createSpinnerRecipe, createStatTileRecipe, createSwitchRecipe, createTabRecipe, createTextareaRecipe, createToastRecipe, createTooltipRecipe, currencyCodes, darkThemeDefaults, defaultThemeBreakpoints, densityToCSSVars, dialogPurposeComponentReference, dialogPurposeSemantics, dialogPurposes, dialogWhyPurposeComponents, emptySemanticAttributes, escapeRichTextHtml, extractFontFamilyName, extractUsedWeights, familySemanticsRegistry, fieldComparisonRows, fieldWhyPurposeComponents, filterUndefinedSemanticAttributes, getCurrencySymbol, headingRecipe, iconNames, iconNamesList, iconRegistry, iconSizeScale, iconStrokeWidthScale, isRichTextHtmlEmpty, isSystemFont, isThemeMode, isThemePreference, lightThemeDefaults, mergeIdRefs, mergeSemanticAttributes, moveSegmentedControlSelection, moveTabSelection, mwAvailableFonts, mwFontFallbacks, mwGoogleFontFamilies, mwStyledTheme, mwTheme, mwThemeVarNames, mwThemeVars, mwVar, nextThemeMode, normalizeRichTextHtml, paragraphRecipe, progressBarSizes, progressBarStates, purposeSemanticsRegistry, radioPurposeComponentReference, radioRecipe, radioWhyPurposeComponents, resolveAccordionA11y, resolveAvatarA11y, resolveBadgeA11y, resolveBannerA11y, resolveBreadcrumbA11y, resolveBreadcrumbHomeA11y, resolveBreadcrumbItemA11y, resolveBreadcrumbListA11y, resolveBreadcrumbSeparatorA11y, resolveButtonLoading, resolveContextMenuA11y, resolveContextMenuDividerA11y, resolveContextMenuItemA11y, resolveDatePickerDayLabel, resolveDialogA11y, resolveDrawerA11y, resolveIconA11y, resolveIconSize, resolveIconStrokeWidth, resolvePaginationA11y, resolvePaginationAdaptiveMaxVisibleItems, resolvePaginationAdaptiveProfile, resolvePaginationControlA11y, resolvePaginationEllipsisA11y, resolvePaginationItemAriaLabel, resolvePaginationListA11y, resolvePaginationPageA11y, resolvePaginationReservedItemCount, resolveProgressBarA11y, resolveProgressBarBounds, resolveRichTextAllowedFormats, resolveSegmentedControlA11y, resolveSegmentedControlItemA11y, resolveSegmentedControlValue, resolveSelectMode, resolveServerThemeMode, resolveSkeletonA11y, resolveSliderA11y, resolveSpinnerA11y, resolveSpinnerSize, resolveStatTileTrendLabel, resolveSwitchA11y, resolveTabA11y, resolveTabValue, resolveThemeInput, resolveThemePreference, resolveToastA11y, resolveTone, resolveTooltipA11y, richTextCommandByFormat, richTextFormattingReference, richTextWhyUseIt, sanitizeCurrencyValue, sanitizeInputOtpValue, semanticFamilies, semanticFrameworkSupport, semanticIntents, semanticLayers, semanticOrientations, semanticOutcomes, semanticPurposes, shouldLoadGoogleFont, skeletonAnimations, skeletonVariants, sliderPurposeComponentReference, sliderWhyPurposeComponents, spinnerSizeScale, spinnerSizes, spinnerVariants, storybookA11yPolicy, storybookButtonGeneralArgTypes, storybookButtonIconArgTypes, storybookButtonPurposeArgTypes, storybookCheckboxArgTypes, storybookDatePickerArgTypes, storybookDividerArgTypes, storybookDocsDescription, storybookIconButtonArgTypes, storybookIconGalleryArgTypes, storybookIconGalleryDefaults, storybookIconNames, storybookLayout, storybookOptionalIconNames, storybookProgressBarArgTypes, storybookRadioArgTypes, storybookSkeletonArgTypes, storybookSliderArgTypes, storybookSpacingArgTypes, storybookSpinnerArgTypes, storybookStatTileArgTypes, switchPurposeComponentReference, switchWhyPurposeComponents, tabPurposeComponentReference, tabWhyPurposeComponents, textRecipe, themeModesToCSSRules, themeToCSSRule, themeToCSSVars, toastPurposeComponentReference, toastPurposeSemantics, toastPurposes, toastWhyPurposeComponents, validateSemanticRegistry };

package/dist/index.js

@@ -5478,33 +5478,34 @@ function isDev2() {
   return true;
 }
 var __DEV__2 = isDev2();
+function nonEmptyName(value) {
+  const normalized = value?.trim();
+  return normalized ? normalized : void 0;
+}
 function resolveButtonA11y(opts, resolvedLoading) {
   const tag = opts.as === "a" || !!opts.href ? "a" : "button";
   const isDisabled = !!opts.disabled || resolvedLoading.isLoading && resolvedLoading.disableWhileLoading;
+  const ariaLabelledBy = nonEmptyName(opts.ariaLabelledBy);
+  const ariaLabel = nonEmptyName(opts.ariaLabel) ?? nonEmptyName(opts.label);
+  const loadingAccessibleLabel = resolvedLoading.isLoading ? nonEmptyName(resolvedLoading.loadingLabel) : void 0;
   if (__DEV__2) {
     const iconOnly = opts.iconOnly || opts.hasVisibleText === false;
-    const accessibleLabel = opts.ariaLabel ?? opts.label;
-    const loadingAccessibleLabel = resolvedLoading.isLoading ? resolvedLoading.loadingLabel : void 0;
-    if (iconOnly && !accessibleLabel && !loadingAccessibleLabel) {
+    if (iconOnly && !ariaLabelledBy && !ariaLabel && !loadingAccessibleLabel) {
       console.warn(
-        "[marwes] Icon-only Button requires ariaLabel, label, or loadingLabel while loading."
+        "[marwes] Icon-only Button requires label, ariaLabel, ariaLabelledBy, or loadingLabel while loading."
       );
     }
   }
   const common = {};
-  if (opts.ariaLabelledBy) {
-    common.ariaLabelledBy = opts.ariaLabelledBy;
-  } else {
-    const accessibleLabel = opts.ariaLabel ?? opts.label;
-    if (accessibleLabel) common.ariaLabel = accessibleLabel;
-  }
+  if (ariaLabelledBy) common.ariaLabelledBy = ariaLabelledBy;
+  else if (ariaLabel) common.ariaLabel = ariaLabel;
   if (resolvedLoading.isLoading) common.ariaBusy = true;
   if (isDisabled) common.ariaDisabled = true;
   if (opts.toggle) common.ariaPressed = !!opts.pressed;
   if (opts.ariaExpanded !== void 0) common.ariaExpanded = opts.ariaExpanded;
   if (opts.ariaControls) common.ariaControls = opts.ariaControls;
   if (tag === "button") {
-    const nativeButtonType = opts.action === "submit" ? "submit" : opts.action === "reset" ? "reset" : "button";
+    const nativeButtonType = opts.action === "submit" ? "submit" : opts.action === "reset" ? "reset" : opts.type ?? "button";
     const a11y2 = { ...common, type: nativeButtonType };
     if (isDisabled) a11y2.disabled = true;
     return { tag, a11y: a11y2, blockClick: false };
@@ -5527,7 +5528,7 @@ function createButtonRecipe(opts) {
   const { tag, a11y, blockClick } = resolveButtonA11y(opts, resolvedLoading);
   const size = opts.size ?? "md";
   const variant = opts.variant ?? "primary";
-  const action = opts.action ?? (tag === "button" ? "button" : "navigate");
+  const action = opts.action ?? (tag === "button" ? a11y.type ?? "button" : "navigate");
   const hasAffordance = resolvedLoading.isLoading || Boolean(opts.iconLeft || opts.iconRight);
   return {
     tag,
@@ -12461,7 +12462,12 @@ var storybookButtonIconArgTypes = {
 };
 var storybookButtonGeneralArgTypes = {
   ...storybookButtonIconArgTypes,
-  variant: storybookButtonVariantArgType
+  variant: storybookButtonVariantArgType,
+  type: {
+    control: "select",
+    options: ["button", "submit", "reset"],
+    description: 'Native form behavior; defaults to "button". Form actions (submit/reset) take precedence. Ignored for anchors.'
+  }
 };
 var storybookIconButtonArgTypes = {
   icon: {
@@ -12680,6 +12686,7 @@ var storybookSliderArgTypes = {
   ariaValueText: { control: "text" }
 };
 var storybookDocsDescription = {
+  primaryButton: 'PrimaryButton controls visual emphasis and defaults to type="button". Set type="submit" for a form, or use SubmitButton for a fixed submit purpose.',
   linkButton: "LinkButton locks navigation semantics, renders as an anchor, and keeps the canonical text treatment. Use Button for intentional visual deviations.",
   destructiveButton: "DestructiveButton locks destructive semantics, uses the canonical danger treatment, and requires confirmation by default. Use Button for intentional exceptions.",
   submitButton: "SubmitButton locks form-submit semantics, always renders as a button, and keeps the canonical primary treatment.",