svelte-fluentui 1.3.1 → 1.3.2

package/README.md

@@ -2,6 +2,12 @@
 
 A comprehensive Svelte wrapper library for Microsoft FluentUI web components (v2.6.x), providing a seamless way to use FluentUI components in Svelte applications.
 
+## What's New in v1.3.2
+
+- **`TopNav` — hamburger flexibility via `menuToggleSize` + `menuToggleTemplate`** — `menuToggleSize` (default `42`) flows through a `--topnav-toggle-size` CSS variable so the glyph and close-icon scale proportionally with the box. `menuToggleTemplate: Snippet<[{open, toggle}]>` lets consumers render any button shape — text + chevron, brand-styled accent button, custom SVG — and still wire up state correctly. Both paths render inside a wrapper that owns the visibility/order/collapse rules, so custom templates automatically inherit hide-when-wide / show-when-narrow / stay-visible-when-pinned behavior.
+- **`TopNav` — default hamburger is now a plain `<button>` instead of a fluent-button** — the previous default rendered `<Button appearance="stealth">` which still carried button chrome (hover background fill, boxed visual weight). Replaced with a vanilla `<button>` styled `background: transparent; border: none; padding: 0`, with `opacity: 0.7` on hover and a `:focus-visible` accent outline for keyboard nav. Reads as just the icon, not a button containing an icon. Click target still fills the full `menuToggleSize` box for touch reachability.
+- **`Badge` — new `radius` prop overrides the binary rounded-rect / pill shape with an arbitrary border-radius** — Badge had exactly two shape modes (default 4px corner / `circular={true}` pill) mirroring Microsoft's FluentUI Badge `shape` prop. The new `radius?: string` accepts any CSS length (`8px`, `0.5rem`, `var(--my-radius)`) and emits inline `border-radius`, winning over both class rules via CSS specificity. Plays nicely with `circular={true}` — the circular sizing wins, the radius wins, so you get pill-sized badges with non-pill corners if you want.
+
 ## What's New in v1.3.1
 
 - **`Panel` — new `pinned` prop renders the panel as an inline `<aside>` instead of a portal'd overlay** — flips the rendering entirely: no portal, no backdrop, no transforms, no escape/outside-click handlers, `position: relative` so it participates in the parent's flex/grid layout, `align-self: stretch` so it fills its grid cell vertically. `open` is still respected so the panel can hide and let its grid cell collapse. Explicit z-index forms its own stacking context so overlay Panels opened on top still layer above as expected.
@@ -9,15 +15,6 @@ A comprehensive Svelte wrapper library for Microsoft FluentUI web components (v2
 - **Docs layout switched to a single nav surface at every width via `drawerPinned`** — the duplicate desktop sidebar `GridItem` is gone; TopNav's drawer now renders as a pinned `<aside>` at ≥1024px and collapses to the hamburger overlay below. The layout uses CSS Grid with `grid-template-areas` and a `matchMedia` listener to drive `drawerPinned`. The pinned rail is `position: sticky` below the topnav and the scrollbar sits flush with the rail's inside edge.
 - **`TopNav` — tightened horizontal padding from `1.5rem` to `0.5rem`** — the bar's inside edges felt cramped relative to the rest of the content. Brand + hamburger now sit closer to the inline-start edge and the action slot sits closer to the inline-end edge.
 
-## What's New in v1.3.0
-
-- **`Panel` — new slide-in side-panel primitive** — fixed-position, edge-anchored container with a single `children` slot and CSS-driven open/close transitions. Props cover physical sides (`left`/`right`), logical sides (`start`/`end` that follow RTL), `width`, `overlay`, `closeOnOutsideClick`, `closeOnEscape`, and a new `top` offset so the panel + overlay can sit below a sticky header (e.g. TopNav) and leave the trigger button clickable. Portals to `document.body` with direction captured before portal so locally-RTL wrappers still anchor correctly. First-class demo at `/components/navigation-layout/panel`.
-- **`TopNav` drawer rebuilt on `Panel`; container queries replace media queries** — the bespoke `.mobile-sidebar` div with hand-rolled `left: -280px` / `transition` CSS is gone, replaced with `<Panel side="start" width="280px" top="{height}px">` so Escape-close, portal, overlay outside-click, and `aria-modal` all come for free. The collapse breakpoint is now an `@container topnav (max-width: 960px)` query keyed on the nav's own width (aligns with Grid's `md`), so behavior is intrinsic to the bar regardless of where it's mounted. `items` auto-populate the drawer, the hamburger only renders when there's content to open, and the action slot now stays visible at every width.
-- **`TopNav` — `brandTemplate`, `drawerContent`, and `collapse` snippets/props** — `brandTemplate` replaces the default `<a>` brand rendering so consumers can compose logo + wordmark + version badge as one unit; `drawerContent: Snippet<[() => void]>` renders custom content inside the mobile drawer and receives a `closeDrawer` callback so link clicks can dismiss the drawer before navigation; `collapse: "auto" | "always" | "never"` overrides the container-query state when the consumer drives sidebar visibility from its own responsive breakpoint. First demo page added at `/components/navigation-layout/topnav`.
-- **`Footer` — `start` / `center` / `end` named snippets with a truly-centered grid layout** — Footer previously had a single `children` slot, so a "© left, brand center, version right" arrangement required inline `justify-content: space-between` and hoping the middle item floated where you wanted. The new snippets switch Footer into a CSS Grid (`1fr auto 1fr`) where the center column is genuinely centered regardless of side-section widths, with explicit `grid-column` placement so a missing section doesn't reflow the others. New `stack` prop (default `true`) collapses to a single inline-start column below 600px via a container query keyed on the footer itself. RTL flips `start` ↔ `end` automatically.
-- **`Footer` — class namespaced as `.fluent-footer`, wired to the dedicated theme tokens, thin-strip bug fixed** — the rendered class went from generic `.footer` (collided with anything else using that name) to `.fluent-footer`, the rule now reads from `--fluent-footer-bg/text/border` (which were defined in the theme system but unused) with the previous neutral-layer values as fallback, a duplicate Blazor-port `.footer` rule was deleted, and `min-height: 48px` + `padding: 0.75rem 1rem` replaces the original horizontal-only padding so a default Footer is no longer a ~24px thin strip. First dedicated demo page at `/components/navigation-layout/footer`.
-- **Docs site dogfoods the new primitives** — the hand-rolled `<div class="topnav">` with ~90 lines of parallel CSS is replaced with `<TopNav class="docs-topnav" collapse="always">` using `brandTemplate` for the brand+version pair and `drawerContent` for the mobile sidebar nav. The sidebar nav is extracted into a single `{#snippet sidebarNav(closeDrawer)}` rendered both as the desktop sidebar and inside the TopNav drawer, with the sidebar/hamburger handoff at `lg` (1280px) instead of `md` so laptops at 1280×800 stay roomy. The footer at the bottom of every page now uses the three-part layout (© + MIT / attribution / GitHub + npm + version chip).
-
 ## Features
 
 - 🎨 **Complete FluentUI Component Set** - Wraps all major FluentUI web components

package/dist/components/Badge.svelte

@@ -18,6 +18,7 @@
 		fill?: string
 		appearance?: BadgeAppearance
 		circular?: boolean
+		radius?: string
 		children?: SlotType
 		onclick?: (ev: MouseEvent) => void
 		class?: string
@@ -29,6 +30,7 @@
 		fill = undefined,
 		appearance = "lightweight",
 		circular = false,
+		radius = undefined,
 		children = undefined,
 		onclick = undefined,
 		class: className = "",
@@ -51,7 +53,9 @@
 		return styles
 	})
 
-	let computedStyle = $derived([colorStyles, style].filter(Boolean).join(" "))
+	let radiusStyle = $derived(radius ? `border-radius: ${radius};` : "")
+
+	let computedStyle = $derived([colorStyles, radiusStyle, style].filter(Boolean).join(" "))
 
 	let classes = $derived.by(() => {
 		let cls = ["badge"]

package/dist/components/Badge.svelte.d.ts

@@ -15,6 +15,7 @@ type Props = {
     fill?: string;
     appearance?: BadgeAppearance;
     circular?: boolean;
+    radius?: string;
     children?: SlotType;
     onclick?: (ev: MouseEvent) => void;
     class?: string;

package/dist/components/QuickGrid.svelte.d.ts

@@ -764,7 +764,7 @@ declare function $$render<T>(): {
                     row: T;
                     rowIndex: number;
                 }) => void | Promise<void>) | undefined;
-            }, "title" | "group" | "icon" | "id" | "row">> & Omit<{
+            }, "group" | "title" | "icon" | "id" | "row">> & Omit<{
                 id: string;
                 icon: string;
                 title: string;
@@ -778,7 +778,7 @@ declare function $$render<T>(): {
                     row: T;
                     rowIndex: number;
                 }) => void | Promise<void>) | undefined;
-            }, "title" | "group" | "icon" | "id" | "row">;
+            }, "group" | "title" | "icon" | "id" | "row">;
             rowIndex: number;
             row: T;
         }) => void) | undefined;

package/dist/components/layout/TopNav.svelte

@@ -1,6 +1,5 @@
 <script lang="ts">
 	import type {SlotType} from "../../types/index.js"
-	import Button from "../Button.svelte"
 	import Panel from "./Panel.svelte"
 	import NavMenu from "../nav/NavMenu.svelte"
 	import NavGroup from "../nav/NavGroup.svelte"
@@ -34,6 +33,8 @@
 		drawerPinned?: boolean
 		drawerWidth?: string
 		height?: number
+		menuToggleSize?: number
+		menuToggleTemplate?: SlotType
 		class?: string
 		style?: string
 	}
@@ -50,6 +51,8 @@
 		drawerPinned = false,
 		drawerWidth = "280px",
 		height = 60,
+		menuToggleSize = 42,
+		menuToggleTemplate = undefined,
 		class: className = "",
 		style = ""
 	}: Props = $props()
@@ -92,25 +95,29 @@
 	class:topnav--force-collapse={collapse === "always"}
 	class:topnav--force-expand={collapse === "never"}
 	class:topnav--drawer-pinned={drawerPinned}
-	style="height: {height}px; {style}"
+	style="height: {height}px; --topnav-toggle-size: {menuToggleSize}px; {style}"
 >
 	<div class="topnav-container">
 		{#if hasDrawerContent}
-			<Button
-				appearance="stealth"
-				class="mobile-menu-toggle"
-				onclick={toggleMobileMenu}
-				aria-label={mobileMenuOpen ? "Close menu" : "Open menu"}
-				aria-expanded={mobileMenuOpen}
-			>
-				<span class="hamburger-icon">
-					{#if mobileMenuOpen}
-						<DismissIcon size={20} />
-					{:else}
-						☰
-					{/if}
-				</span>
-			</Button>
+			<div class="topnav-menu-toggle">
+				{#if menuToggleTemplate}
+					{@render menuToggleTemplate({open: mobileMenuOpen, toggle: toggleMobileMenu})}
+				{:else}
+					<button
+						type="button"
+						class="mobile-menu-toggle"
+						onclick={toggleMobileMenu}
+						aria-label={mobileMenuOpen ? "Close menu" : "Open menu"}
+						aria-expanded={mobileMenuOpen}
+					>
+						{#if mobileMenuOpen}
+							<DismissIcon size={Math.round(menuToggleSize * 0.48)} />
+						{:else}
+							<span class="hamburger-glyph">☰</span>
+						{/if}
+					</button>
+				{/if}
+			</div>
 		{/if}
 
 		{#if brandTemplate}
@@ -238,31 +245,46 @@
 		flex-shrink: 0;
 	}
 
-	/* Mobile menu toggle button — hidden by default, shown when container is narrow */
-	:global(.topnav .mobile-menu-toggle) {
+	/* Wrapper slot — owns visibility + position so a custom menuToggleTemplate
+	   gets the same collapse behavior as the default button without consumers
+	   needing to know about the internal rules. */
+	.topnav-menu-toggle {
 		display: none;
 		order: -1;
 		flex-shrink: 0;
-		width: 42px;
-		min-width: 42px;
-		height: 42px;
+		align-items: center;
 	}
 
-	/* Override fluent-button's internal control padding/min-height so the
-	   hamburger fills the fixed 42×42 box and the icon centers in it. */
-	:global(.topnav .mobile-menu-toggle::part(control)) {
-		width: 100%;
-		height: 100%;
-		min-width: 0;
-		min-height: 0;
+	/* Default toggle — plain icon target, no button chrome. Sized via
+	   --topnav-toggle-size (set inline from the menuToggleSize prop).
+	   Custom templates render at their natural size. */
+	.mobile-menu-toggle {
+		width: var(--topnav-toggle-size, 42px);
+		height: var(--topnav-toggle-size, 42px);
+		display: inline-flex;
+		align-items: center;
+		justify-content: center;
 		padding: 0;
+		background: transparent;
+		border: none;
+		color: inherit;
+		cursor: pointer;
+		border-radius: var(--fluent-border-radius-md, 4px);
+		transition: opacity 0.15s, background-color 0.15s;
+	}
+
+	.mobile-menu-toggle:hover {
+		opacity: 0.7;
 	}
 
-	.hamburger-icon {
-		font-size: 1.5rem;
+	.mobile-menu-toggle:focus-visible {
+		outline: 2px solid var(--accent-fill-rest, currentColor);
+		outline-offset: 2px;
+	}
+
+	.hamburger-glyph {
+		font-size: calc(var(--topnav-toggle-size, 42px) * 0.55);
 		line-height: 1;
-		display: flex;
-		align-items: center;
 	}
 
 	/* Trailing flex group: items + divider + actions. `margin-left: auto`
@@ -343,7 +365,7 @@
 	}
 
 	@container topnav (max-width: 960px) {
-		:global(.topnav .mobile-menu-toggle) {
+		.topnav-menu-toggle {
 			display: flex;
 		}
 
@@ -359,14 +381,14 @@
 		}
 	}
 
-	/* collapse="always" — force hamburger visible + items hidden regardless of width */
-	:global(.topnav.topnav--force-collapse .mobile-menu-toggle) {
+	/* collapse="always" — force toggle visible + items hidden regardless of width */
+	.topnav--force-collapse .topnav-menu-toggle {
 		display: flex;
 	}
 
-	/* When drawer is pinned the hamburger acts as a show/hide toggle for the
+	/* When drawer is pinned the toggle acts as a show/hide control for the
 	   pinned rail itself, so it must stay visible at every width. */
-	:global(.topnav.topnav--drawer-pinned .mobile-menu-toggle) {
+	.topnav--drawer-pinned .topnav-menu-toggle {
 		display: flex;
 	}
 
@@ -375,8 +397,8 @@
 		display: none;
 	}
 
-	/* collapse="never" — force items/divider visible + hamburger hidden regardless of width */
-	:global(.topnav.topnav--force-expand .mobile-menu-toggle) {
+	/* collapse="never" — force items/divider visible + toggle hidden regardless of width */
+	.topnav--force-expand .topnav-menu-toggle {
 		display: none;
 	}
 

package/dist/components/layout/TopNav.svelte.d.ts

@@ -26,6 +26,8 @@ type Props = {
     drawerPinned?: boolean;
     drawerWidth?: string;
     height?: number;
+    menuToggleSize?: number;
+    menuToggleTemplate?: SlotType;
     class?: string;
     style?: string;
 };

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "1.3.1";
+export declare const VERSION = "1.3.2";

package/dist/version.js

@@ -1,4 +1,4 @@
 // Auto-generated by scripts/pre-package.js — do NOT edit by hand.
 // In dev this file holds whatever value was committed last; on each `npm run package`
 // the pre-package script overwrites it with the current package.json version.
-export const VERSION = "1.3.1";
+export const VERSION = "1.3.2";

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "svelte-fluentui",
-	"version": "1.3.1",
+	"version": "1.3.2",
 	"description": "A Svelte wrapper library for Microsoft FluentUI web components",
 	"license": "MIT",
 	"author": "KeenMate",