winui-svelte 0.0.4 → 0.0.5

package/README.md

@@ -1,6 +1,6 @@
 # winui-svelte
 
-![The winui-svelte logo](https://raw.githubusercontent.com/avi12/winui-svelte/main/ide/icon.svg)
+<img src="https://raw.githubusercontent.com/avi12/winui-svelte/main/ide/icon.svg" alt="The winui-svelte logo" width="96" height="96">
 
 [![npm version](https://img.shields.io/npm/v/winui-svelte)](https://www.npmjs.com/package/winui-svelte)
 
@@ -68,6 +68,10 @@ signature
   puts a window against a corner of the active display's work area; the window's
   own `outerWidth`, `screenX`, `resizeTo` and `moveBy` are on `handle.geometry`
   ([API.md](https://github.com/avi12/winui-svelte/blob/main/API.md))
+- **Window place:** `stateKey` on `<Window>` saves its bounds, maximized state
+  and presentation under that name and restores them on the next run, inside
+  the nearest display so a disconnected monitor never strands it
+  ([API.md](https://github.com/avi12/winui-svelte/blob/main/API.md))
 - **Errors** thrown in an event handler or a prop are caught on the UI thread,
   written to stderr with their stack and handed to `runWindow({ onerror })`;
   the app goes on ([API.md](https://github.com/avi12/winui-svelte/blob/main/API.md))
@@ -162,8 +166,8 @@ Two optional add-ons for `.svelte` files, one for each editor:
 
 | Editor | Download | Install |
 | --- | --- | --- |
-| VS Code | `winui-svelte-vscode-<version>.vsix` | `code --install-extension winui-svelte-vscode-0.0.1.vsix`, or the Extensions view, the `...` menu, Install from VSIX |
-| WebStorm | `winui-svelte-webstorm-<version>.zip` | Settings, Plugins, the gear, Install Plugin from Disk |
+| VS Code | `winui-svelte-vscode-<version>.vsix`, or [the Visual Studio Marketplace page](https://marketplace.visualstudio.com/items?itemName=Avi.winui-svelte-vscode) | `code --install-extension winui-svelte-vscode-0.0.1.vsix`, or the Extensions view, the `...` menu, Install from VSIX |
+| WebStorm | `winui-svelte-webstorm-<version>.zip`, or [the JetBrains Marketplace page](https://plugins.jetbrains.com/plugin/35835-winui-svelte) | Settings, Plugins, the gear, Install Plugin from Disk |
 
 Both files are assets of the `editors-v*` releases, on their own tags apart
 from the package's: [open the editors releases](https://github.com/avi12/winui-svelte/releases?q=editors-v)
@@ -523,6 +527,7 @@ build error with its file and line; nothing is silently ignored
 | `background-image` or `background` with `linear-gradient()` or `radial-gradient()` | a `LinearGradientBrush` or `RadialGradientBrush` Background (a sheet that uses one carries the parser; one that does not, does not) |
 | `width`, `height`, `min-*`, `max-*` | `Width`, `Height`, `MinWidth`... |
 | `font-size`, `font-weight`, `font-family`, `font-style`, `line-height`, `letter-spacing`, `text-align`, `text-wrap`, `text-overflow`, `text-decoration` | the `TextBlock` and `Control` font and text properties |
+| `font-variant-*`, `font-kerning`, `font-feature-settings`, `font: var(--type-body)` | the `Typography` attached properties of a TextBlock (small caps, numerals, ligatures, stylistic sets), and a step of WinUI's type ramp as the font size resource and weight of its style (`font-variation-settings` has no WinUI counterpart; see [`src/css/API.md`](https://github.com/avi12/winui-svelte/blob/main/src/css/API.md#typography-opentype-features-and-the-type-ramp)) |
 | `font-stretch`, `direction`, `background-clip`, `tab-index` | `FontStretch` (`ultra-condensed` to `ultra-expanded`), `FlowDirection` (`ltr`, `rtl`), `BackgroundSizing` (`border-box` is `OuterBorderEdge`, `padding-box` is `InnerBorderEdge`), `TabIndex` (a negative value sets `IsTabStop` to false) |
 | `gap`, `row-gap`, `column-gap` | `Spacing` (a stack), `RowSpacing` and `ColumnSpacing` (a grid) |
 | `flex-direction`, `display: flex` on a stack, `align-self`, `justify-self` | `Orientation`, `VerticalAlignment`, `HorizontalAlignment` |
@@ -530,14 +535,16 @@ build error with its file and line; nothing is silently ignored
 | `display: none`, `visibility`, `pointer-events`, `z-index`, `overflow` | `Visibility`, `IsHitTestVisible`, `Canvas.ZIndex`, the scroll bar visibilities |
 | `outline`, `outline-offset` | the focus visual: `FocusVisualPrimaryBrush`, `FocusVisualPrimaryThickness`, `FocusVisualMargin` |
 | `animation`, `@keyframes` | `Storyboard`s of key frames (opacity, size, colors, translate, scale, rotate, transform, and every keyword property such as `font-style` or `text-align`, which steps at the middle of an interval; `display` and `visibility` hold the visible value instead: a hide lands at the end of the animation and a show at its start), begun with the class |
+| `animation-timeline` (`scroll()`, `view()`, a name), `animation-range`, `scroll-timeline`, `view-timeline` | an `ExpressionAnimation` over the scroll viewer's manipulation property set that drives opacity, translate, scale and rotate on the compositor, so a header that collapses or a parallax runs while the UI thread is idle |
 | `box-shadow`, `aspect-ratio`, `user-select`, `object-fit`, `line-clamp`, `word-break` | a `ThemeShadow` of the blur's depth, a Height that follows the Width, `IsTextSelectionEnabled`, `Stretch`, `MaxLines`, `TextWrapping` |
 | `-winui-elevation` | a `ThemeShadow` lifted by its depth |
+| `-winui-shadow: composition`, `-winui-shadow-receiver`, `-winui-shadow-cast-on` | `box-shadow` drawn by a Composition `DropShadow` that keeps its colour, offset, blur and spread, and the Receivers of a `ThemeShadow` named by a group |
 | `filter`, `backdrop-filter`, `mix-blend-mode`, `mask-image` | an effect graph of Win2D effects (Gaussian blur, colour matrix, blend, alpha mask) that the element's Composition visual is drawn through; `backdrop-filter` samples a real backdrop brush |
 | `clip-path`: `inset()` (with `round`), `circle()`, `ellipse()`, `polygon()`, `path()` | a `CompositionGeometricClip` on the element's visual |
 | `translate`, `scale`, `rotate`, `transform-origin`, `transition`; `transform` (translate, scale, rotate, skew, matrix) | the UIElement transforms, their pivot (`CenterPoint`, 50% 50% as in CSS) and their implicit transitions; `transition` also runs a Storyboard for `width`, `height`, `min-` and `max-` sizes, `font-size`, `color` and `border-color` between values written out, and `allow-discrete` steps any keyword property: `display 200ms allow-discrete` keeps a hidden element shown until the transition ends, `text-align 200ms allow-discrete` changes it at the middle |
 | `var(--card-background-fill-color-default)` | `{ThemeResource CardBackgroundFillColorDefault}`: WinUI's own resources, so light and dark follow Windows |
 | `--name: value` on `:root`, or on a class | an app-wide resource, or one only the elements with that class (and their templates) see: `.danger { --button-background-pointer-over: red }` |
-| `.class`, `type`, `:hover`, `:focus`, `:active`, `:root`, `:where()` | class and type matching, the control's events, custom properties |
+| `.class`, `type`, `:hover`, `:focus`, `:active`, `:root`, `:where()` | class and type matching, the control's events (a Button's `:hover`, `:active` and `:disabled` brushes as the visual states of its template, see [`src/css/API.md`](https://github.com/avi12/winui-svelte/blob/main/src/css/API.md#pseudo-classes-on-a-templated-control-visual-states)), custom properties |
 
 </details>
 
@@ -552,6 +559,44 @@ is an error too, in the build and the editor, at the rule and naming the element
 that uses it, instead of a failure when the window opens
 The table of every unit is in [`src/css/API.md`](https://github.com/avi12/winui-svelte/blob/main/src/css/API.md#length-units)
 
+### Fonts
+
+A font file of the app is used by its family name: an `@font-face` whose `src`
+is a `url()` of the file, then the family in `font-family`
+
+```svelte
+<style>
+  @font-face {
+    font-family: "Material Symbols Rounded";
+    src: url("./fonts/MaterialSymbolsRounded.ttf");
+  }
+
+  .icon {
+    font-family: "Material Symbols Rounded";
+  }
+</style>
+```
+
+- The family must be the name written inside the font file; WinUI finds the
+  file by that name, and a different name falls back to the default font
+  without an error
+- A relative `url()` is relative to the stylesheet; in a built app the sheet is
+  part of the bundle, so the file is also looked for by its name beside the
+  bundle (copy the fonts there); a file that is not found is an error naming the
+  places looked
+- Only `font-family` and `src` mean something: WinUI takes the weight, style and
+  width from the font file itself, so `font-weight`, `font-style`,
+  `font-stretch` and `unicode-range` are a warning; the first `url()` of `src`
+  is used, and a web address is an error (a font is a file next to the app)
+- One file per family name; registering a name again replaces its file
+- It works in a plain Node process, the case that is tested (a packaged app is
+  not): the file is handed to WinUI as `ms-appx:///` and its absolute path, with
+  the family name after a `#`; nothing is installed on the machine
+- The same from code: `registerFont({ family, source })` from
+  `winui-svelte/css`, or the web `FontFace` and `document.fonts.add(face)` once
+  `installFontFaces()` from `winui-svelte/web-apis/fonts` has run; a family
+  added later is used by the controls created after it
+
 ### Scoping
 
 A rule in a component's `<style>` reaches only the elements and the component
@@ -691,6 +736,37 @@ The animation moves the control's `Opacity`, `Translation`, `Scale`,
 See
 [API.md](https://github.com/avi12/winui-svelte/blob/main/API.md) for the details and what WinUI cannot do
 
+A card whose content grows or shrinks glides to its new height with
+`@attach glideHeight()` (WinUI cannot animate `Height="Auto"`; this is a
+`ResizeObserver` plus `element.animate({ height })` in one attachment, and
+needs `enableElementAnimation()` once)
+
+</details>
+
+## Wrapping chips
+
+<details>
+<summary>A row that wraps onto further lines</summary>
+
+WinUI has no `flex-wrap`; a `RichTextBlock` wraps its inline children like
+words, and an `InlineUIContainer` makes a chip one of them, so chips of any width
+wrap (`VariableSizedWrapGrid` wraps too, with one cell size for all):
+
+```svelte
+<RichTextBlock>
+  <Paragraph>
+    {#each links as link (link.href)}
+      <InlineUIContainer>
+        <HyperlinkButton navigateUri={link.href}>{link.label}</HyperlinkButton>
+      </InlineUIContainer>
+    {/each}
+  </Paragraph>
+</RichTextBlock>
+```
+
+See
+[API.md](https://github.com/avi12/winui-svelte/blob/main/API.md) for the measured comparison
+
 </details>
 
 ## Accessibility and theming
@@ -777,6 +853,8 @@ conditions on `exports`), which your Vite compiles (`winuiSvelte()`)
 | `winui-svelte/state` | the window's side of host state |
 | `winui-svelte/state/host` | a JavaScript host's side: `diff`, transports, message types |
 | `winui-svelte/messaging` | `defineMessaging`: typed request and response messages over a transport, loadable in plain Node |
+| `winui-svelte/messaging/web-view2`, `/messaging/page` | `webView2Transport` and the `WebView2` helpers (scripts, cookies, downloads, permissions); the web page's end of the link, free of WinUI (both opt-in) |
+| `winui-svelte/messaging/web-view2`, `/messaging/page` | `webView2Transport` and the `WebView2` helpers (scripts, cookies, downloads, permissions); the web page's end of the link, free of WinUI (both opt-in) |
 | `winui-svelte/vite` | `winuiSvelte()` for `vite.config.ts`; `startModuleServer()` for hot reload; `buildApp()` for the production bundle |
 | `winui-svelte/dev` | `startDev()`, one call that opens a component in a window and keeps it live as the files are saved |
 | `winui-svelte/runner` | `createWindowModuleRunner()`, the window thread's side of the module server |
@@ -788,16 +866,29 @@ conditions on `exports`), which your Vite compiles (`winuiSvelte()`)
 | `winui-svelte/element-animation` | `enableElementAnimation` (the Vite plugin calls it for you; Svelte's `transition:` and `animate:` run on WinUI) |
 | `winui-svelte/attached-owners` | `preloadAttachedOwners` (the Vite plugin calls it for a component that names `canvasLeft`, `gridRow` and the like, so a placed control has its place at its first layout; a prop named nowhere needs the call by hand) |
 | `winui-svelte/element-effects` | `enableElementEffects` (the Vite plugin calls it from a component that imports `blur` or `draw`): the blur transition blurs for real and `draw` measures a `path`, with Composition and Win2D |
-| `winui-svelte/app` | single-instance handling over a named pipe, and app notifications |
+| `winui-svelte/app` | single-instance handling over a named pipe, app notifications, `activateOrLaunch` to signal or start the app from another process, `relaunch` and restart after a crash |
+| `winui-svelte/app/activation` | `navigator.registerProtocolHandler`, `registerFileTypes`, `launchAtLogin` for the current user, and every start (link, file, sign-in, a later copy) as one typed `ActivationEvent` (opt-in; [`API.md`](https://github.com/avi12/winui-svelte/blob/main/API.md#activation-winui-svelteappactivation)) |
 | `winui-svelte/bindings/*` | Every bound WinRT and Windows App SDK class as it is named there, for the as-is kind (`winui-svelte/bindings/windows/storage/StorageFolder`) |
 | `winui-svelte/web-apis`, `/web-apis/notification`, `/web-apis/media-devices`, `/web-apis/speech`, `/web-apis/media-session` | `installWebApis`, `installPermissions` and the Web APIs as opt-in installers: `Notification` over app notifications, media devices, speech and the media session (opt-in; [`API.md`](https://github.com/avi12/winui-svelte/blob/main/API.md#web-apis-winui-svelteweb-apis)) |
 | `winui-svelte/data-transfer` | web-shaped drag and drop, `NativeFile`, pickers, the clipboard and the launcher (opt-in) |
+| `winui-svelte/input` | the web's pointer, wheel, key and focus events on any element (`enableInputEvents`), pointer capture, `activeElement`, `moveFocus`, `trapFocus` (opt-in; [`API.md`](https://github.com/avi12/winui-svelte/blob/main/API.md#input-events-and-focus-winui-svelteinput)) |
 | `winui-svelte/media` | `bitmapImageOf`, `svgImageSourceOf`, `createMediaPlayer`: image sources and a windowless `MediaPlayer` (opt-in; [`API.md`](https://github.com/avi12/winui-svelte/blob/main/API.md#media-winui-sveltemedia)) |
+| `winui-svelte/app/hotkeys` | `registerHotkey`: a system-wide key combination, heard in any app (opt-in; [`API.md`](https://github.com/avi12/winui-svelte/blob/main/API.md#global-hotkeys-winui-svelteapphotkeys)) |
 | `winui-svelte/tray` | `TrayIcon`, `createTrayIcon`, `hideToTray`: a notification-area icon (opt-in; [`API.md`](https://github.com/avi12/winui-svelte/blob/main/API.md#system-tray-winui-sveltetray)) |
+| `winui-svelte/tray/standalone` | `createStandaloneTray`: a notification-area icon and a native popup menu in a plain Node process, with no window, no WinUI and no components, that starts or signals the full app (opt-in; [`API.md`](https://github.com/avi12/winui-svelte/blob/main/API.md#tray-with-no-window-winui-sveltetraystandalone)) |
+| `winui-svelte/notice` | `showNotice`: a message box with no window or app, for a check that ends a run before it starts (opt-in; [`API.md`](https://github.com/avi12/winui-svelte/blob/main/API.md#notice-with-no-app-winui-sveltenotice)) |
+| `winui-svelte/window/taskbar` | `handle.taskbar`: a progress bar, an overlay icon or badge and flashing on the window's taskbar button, and the unpackaged `setAppBadge` fallback (opt-in; [`API.md`](https://github.com/avi12/winui-svelte/blob/main/API.md#taskbar-button-winui-sveltewindowtaskbar)) |
 | `winui-svelte/forms` | `Form`, `FormField` and the attachments that join a control to a form by name, with HTML's constraint validation and zod (opt-in; [`API.md`](https://github.com/avi12/winui-svelte/blob/main/API.md#forms-winui-svelteforms)) |
+| `winui-svelte/store` | `getAppLicense`, `watchLicense`, `checkForUpdates`, `watchPackages`, `getStartupTask`: the Store licence, updates, package events and startup task, answering `hasPackage: false` outside a package (opt-in; [`API.md`](https://github.com/avi12/winui-svelte/blob/main/API.md#store-and-package-winui-sveltestore)) |
+| `winui-svelte/accessibility`, `/accessibility/audit` | `announce` and `liveRegion` say a change to a screen reader (`aria-live`, `role="alert"`) over UI Automation notifications; `auditAccessibility` checks a window for unnamed buttons, unlabeled inputs, duplicate access keys and low contrast (opt-in; [`API.md`](https://github.com/avi12/winui-svelte/blob/main/API.md#accessibility-winui-svelteaccessibility)) |
 | `winui-svelte/devices`, `/devices/enumeration`, `/devices/input`, `/devices/bluetooth`, `/devices/printers`, `/devices/power`, `/devices/network`, `/devices/audio`, `/devices/display`, `/devices/gamepad`, `/devices/sensors` | device enumeration, input devices, Bluetooth, printers, power, network, displays, audio, gamepads, sensors: Windows' own device APIs as runes (opt-in; [`API.md`](https://github.com/avi12/winui-svelte/blob/main/API.md#windows-devices-winui-sveltedevices)) |
+| `winui-svelte/implicit-layout-animation` | `implicitLayoutAnimation`, `LayoutEasing`: the children of a panel slide to their new places when the layout moves them |
+| `winui-svelte/settings` | `SettingsCard`, `SettingsExpander`: Fluent settings cards after the Community Toolkit's |
+| `winui-svelte/scroll-timeline` | `installScrollTimeline`: `ScrollTimeline`, `ViewTimeline` and `element.animate(keyframes, { timeline })` over Composition (opt-in) |
+| `winui-svelte/view-transitions` | `installViewTransitions`: `document.startViewTransition` over WinUI's connected animations, paired by `view-transition-name` (opt-in) |
 | `winui-svelte/connected-animation` | `connectElement` and `startConnected`, WinUI's connected animation between pages |
-| `winui-svelte/css/transform`, `/css/animation`, `/css/effects`, `/css/filter`, `/css/clip`, `/css/focus`, `/css/surface`, `/css/position`, `/css/container`, `/css/queries`, `/css/environment`, `/css/compat`, `/css/resources` | the opt-in CSS groups: 2D transform, animations, aspect ratio, filters and masks, clip shapes, focus visuals, surfaces, position and inset, media and container queries, media preferences and display features, browser-stylesheet properties, theme resources ([`src/css/API.md`](https://github.com/avi12/winui-svelte/blob/main/src/css/API.md)) |
+| `winui-svelte/composition` | `animateOnCompositor`, `compositorAnimation`, `visualReference`, `createPropertySet` and springs: typed expression and spring animations the compositor runs off the UI thread (opt-in; [`API.md`](https://github.com/avi12/winui-svelte/blob/main/API.md#composition-animations-winui-sveltecomposition)) |
+| `winui-svelte/css/transform`, `/css/animation`, `/css/scroll-timeline`, `/css/typography`, `/css/visual-states`, `/css/effects`, `/css/filter`, `/css/clip`, `/css/focus`, `/css/surface`, `/css/shadow`, `/css/position`, `/css/container`, `/css/queries`, `/css/environment`, `/css/compat`, `/css/resources`, `/css/view-transition` | the opt-in CSS groups: 2D transform, animations, OpenType typography, the state brushes of a Button, aspect ratio, filters and masks, clip shapes, focus visuals, surfaces and Composition shadows, position and inset, media and container queries, media preferences and display features, browser-stylesheet properties, theme resources, view transition names ([`src/css/API.md`](https://github.com/avi12/winui-svelte/blob/main/src/css/API.md)) |
 | `winui-svelte/css`, `/css/vite`, `/css/sheet-module`, `/css/gradients`, `/css/shape`, `/css/control`, `/css/stylesheet` | the CSS runtime, its Vite plugin, the sheet module compiler, the gradient parser a sheet with a gradient imports and the type declaration for a `.css` import ([`src/css/API.md`](https://github.com/avi12/winui-svelte/blob/main/src/css/API.md)) |
 | `winui-svelte/preprocess`, `winui-svelte/stylelint`, `winui-svelte/vscode-css-data.json` | the editor side of the CSS: a Svelte preprocessor, a stylelint rule and VS Code custom data, all from the same validator and tables, so the editor, the linter and the build say the same thing ([`src/css/API.md`](https://github.com/avi12/winui-svelte/blob/main/src/css/API.md#diagnostics-in-the-editor-the-linter-and-the-build)) |
 
@@ -880,10 +971,13 @@ Stated plainly, so nobody finds them by surprise:
   `acrylicThin` put WinUI's `DesktopAcrylicController` behind the window, so
   `window.systemBackdrop` reads null for them (the controller holds the
   material)
-- **Transparent windows are a composition brush.** `backdrop="transparent"`
-  puts a fully clear brush behind the content, since the Windows App SDK's
-  `TransparentTintBackdrop` is not in the metadata of the releases restored;
-  `window.systemBackdrop` reads null for it, and the window wants `isBorderless`
+- **Transparent windows are a composition brush and a window frame.**
+  `backdrop="transparent"` puts a fully clear brush behind the content, since
+  the Windows App SDK's `TransparentTintBackdrop` is in no runtime from 2.3 to
+  2.6.5 and not in the metadata restored, and makes the whole window the window
+  manager's frame with square corners, which is what makes the clear pixels
+  show the desktop; `window.systemBackdrop` reads null for it, and the window
+  wants `isBorderless`
 - **Svelte is held to the releases checked.** The package reads a few spots of
   Svelte's runtime with edits, so the peer range is the span of releases the
   matrix (`pnpm check:svelte-matrix`) runs the tests against, and it widens
@@ -898,13 +992,16 @@ Stated plainly, so nobody finds them by surprise:
 - **A property whose name starts with "on"** (`ToggleSwitch.OnContent`) is a
   prop on components, but on a raw element Svelte takes the attribute for an
   event: write it as `On-content="On"` or `on-content={() => "On"}`
-- **No `:hover` or `:active` miracles on templated controls.** A pseudo-class
-  applies a Style when the control reports the event, but WinUI's own template
-  states (a Button's pointer-over and pressed brushes) take over from a Style's
-  setters while they are active, and a control that handles an event itself (a
-  Button handles `PointerPressed`) never reports it, so `:active` does nothing
-  there
-  Override the control's theme resources instead
+- **`:hover`, `:active` and `:disabled` reach a templated control as visual
+  states for a Button, not for every control.** On a `button`,
+  `repeat-button`, `hyperlink-button` and `drop-down-button` a rule's
+  `background-color`, `background-image`, `color` and `border-color` become
+  the `PointerOver`, `Pressed` and `Disabled` states of its template, so
+  `:active` works where the control handles the pointer itself
+  Any other control, any other property, `:checked` and a Button's `:focus`
+  stay a Style when the control reports the event, which WinUI's template
+  states take over from while they are active; override the control's theme
+  resources there ([`src/css/API.md`](https://github.com/avi12/winui-svelte/blob/main/src/css/API.md#pseudo-classes-on-a-templated-control-visual-states))
 - **Transitions on a raw element.** `blur` and `draw` need
   `winui-svelte/element-effects` (the Vite plugin turns it on for a component
   that imports either), and without it `blur` only fades; a directive goes on a
@@ -941,7 +1038,7 @@ Stated plainly, so nobody finds them by surprise:
   against the component's markup at build time
   A Style cannot reach an element's parent, children or siblings, so these are
   build errors that say what to write instead: `float`, `position: sticky`,
-  `right` and `bottom`, `flex-wrap` (WinUI has no wrapping panel), a % size other than
+  `right` and `bottom`, `flex-wrap` (WinUI has no wrapping panel; see "Wrapping chips"), a % size other than
   100%, `calc()` with a % or a variable, any unit but px, deg, s, ms, fr, auto and unitless numbers (the compiler and
   stylelint both refuse it), container style queries, `:has()`, `:focus-within`,
   `clip-path` as

package/dist/accessibility/announce.d.ts

@@ -0,0 +1,22 @@
+import { LivePriority } from "./live-priority.js";
+import { UIElement } from "#winui/microsoft/ui/xaml/UIElement";
+/** What `announce` takes. */
+export interface AnnounceOptions {
+    /** The text a screen reader speaks. */
+    readonly message: string;
+    /** An element of the window the message is raised from (an `elementRef`'s `current`). */
+    readonly element: UIElement;
+    /** `POLITE` queues behind speech; `ASSERTIVE` interrupts; `OFF` says nothing. Polite by default. */
+    readonly priority?: LivePriority | undefined;
+}
+/**
+ * Says something to a screen reader without moving focus: a UI Automation
+ * notification (`AutomationPeer.RaiseNotificationEvent`), as writing to an
+ * `aria-live` region, `role="status"` (polite) or `role="alert"` (assertive).
+ * A layout panel has no automation peer, so the notification is raised from
+ * the nearest element above it that has one.
+ *
+ * @param options - The message, the element to raise it from and the priority.
+ */
+export declare function announce({ message, element, priority }: AnnounceOptions): void;
+//# sourceMappingURL=announce.d.ts.map

package/dist/accessibility/announce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"announce.d.ts","sourceRoot":"","sources":["../../src/accessibility/announce.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOlD,OAAO,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAE/D,6BAA6B;AAC7B,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yFAAyF;IACzF,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,oGAAoG;IACpG,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;CAC9C;AAkCD;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,QAA8B,EAAE,EAAE,eAAe,QAM7F"}

package/dist/accessibility/announce.js

@@ -0,0 +1,52 @@
+import { LivePriority } from "./live-priority.js";
+import { raiseAnnouncement } from "./notification.js";
+import { projectAs, releaseProjected } from "#winui/lifetime";
+import { FrameworkElementAutomationPeer } from "#winui/microsoft/ui/xaml/automation/peers/FrameworkElementAutomationPeer";
+import { VisualTreeHelper } from "#winui/microsoft/ui/xaml/media/VisualTreeHelper";
+import { UIElement } from "#winui/microsoft/ui/xaml/UIElement";
+function peerOf(element) {
+    const existing = FrameworkElementAutomationPeer.fromElement(element);
+    return existing ?? FrameworkElementAutomationPeer.createPeerForElement(element);
+}
+// A layout panel has no automation peer; the notification is raised from the
+// nearest element above it that has one.
+function nearestPeer(element) {
+    const projected = [];
+    try {
+        for (let current = element;; current = projected[projected.length - 1] ?? current) {
+            const peer = peerOf(current);
+            const isFound = peer != null;
+            if (isFound) {
+                return peer;
+            }
+            const parent = VisualTreeHelper.getParent(current);
+            const isRoot = parent == null;
+            if (isRoot) {
+                throw new Error("announce needs an element in a window, with an automation peer or under one");
+            }
+            projected.push(projectAs(parent, UIElement));
+        }
+    }
+    finally {
+        for (const parent of projected) {
+            releaseProjected(parent);
+        }
+    }
+}
+/**
+ * Says something to a screen reader without moving focus: a UI Automation
+ * notification (`AutomationPeer.RaiseNotificationEvent`), as writing to an
+ * `aria-live` region, `role="status"` (polite) or `role="alert"` (assertive).
+ * A layout panel has no automation peer, so the notification is raised from
+ * the nearest element above it that has one.
+ *
+ * @param options - The message, the element to raise it from and the priority.
+ */
+export function announce({ message, element, priority = LivePriority.POLITE }) {
+    raiseAnnouncement({
+        peer: nearestPeer(element),
+        message,
+        priority
+    });
+}
+//# sourceMappingURL=announce.js.map

package/dist/accessibility/announce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"announce.js","sourceRoot":"","sources":["../../src/accessibility/announce.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EACL,8BAA8B,EAC/B,MAAM,0EAA0E,CAAC;AAClF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iDAAiD,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAY/D,SAAS,MAAM,CAAC,OAAkB;IAChC,MAAM,QAAQ,GAAG,8BAA8B,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACrE,OAAO,QAAQ,IAAI,8BAA8B,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAClF,CAAC;AAED,6EAA6E;AAC7E,yCAAyC;AACzC,SAAS,WAAW,CAAC,OAAkB;IACrC,MAAM,SAAS,GAAgB,EAAE,CAAC;IAClC,IAAI,CAAC;QACH,KAAK,IAAI,OAAO,GAAG,OAAO,GAAI,OAAO,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;YACnF,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;YAC7B,MAAM,OAAO,GAAG,IAAI,IAAI,IAAI,CAAC;YAC7B,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACnD,MAAM,MAAM,GAAG,MAAM,IAAI,IAAI,CAAC;YAC9B,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;YACjG,CAAC;YAED,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;YAAS,CAAC;QACT,KAAK,MAAM,MAAM,IAAI,SAAS,EAAE,CAAC;YAC/B,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,GAAG,YAAY,CAAC,MAAM,EAAmB;IAC5F,iBAAiB,CAAC;QAChB,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC;QAC1B,OAAO;QACP,QAAQ;KACT,CAAC,CAAC;AACL,CAAC"}

package/dist/accessibility/audit/accessibility-rules.json

@@ -0,0 +1,100 @@
+[
+  {
+    "id": "unnamed-button",
+    "appliesTo": [
+      "Button",
+      "SplitButton"
+    ],
+    "message": "The button has no accessible name: a screen reader says only \"button\" (an icon-only button has no text to fall back on)",
+    "suggestion": "Set automationName, or give the button text or a label"
+  },
+  {
+    "id": "unlabeled-input",
+    "appliesTo": [
+      "Edit",
+      "ComboBox",
+      "Slider",
+      "Spinner",
+      "CheckBox",
+      "RadioButton"
+    ],
+    "message": "The input has no label: a screen reader cannot say what to enter",
+    "suggestion": "Set a header, automationName or automationLabeledBy (an elementRef of the label)"
+  },
+  {
+    "id": "duplicate-access-key",
+    "appliesTo": [
+      "Button",
+      "SplitButton",
+      "Edit",
+      "ComboBox",
+      "Slider",
+      "Spinner",
+      "CheckBox",
+      "RadioButton",
+      "Hyperlink",
+      "MenuItem",
+      "TabItem",
+      "ListItem",
+      "TreeItem"
+    ],
+    "message": "Another element has the same access key: Alt shortcuts reach only one of them",
+    "suggestion": "Give each element in the window its own accessKey"
+  },
+  {
+    "id": "zero-size-focusable",
+    "appliesTo": [
+      "Button",
+      "SplitButton",
+      "Edit",
+      "ComboBox",
+      "Slider",
+      "Spinner",
+      "CheckBox",
+      "RadioButton",
+      "Hyperlink",
+      "MenuItem",
+      "TabItem",
+      "ListItem",
+      "TreeItem"
+    ],
+    "message": "The element takes focus but has no size: keyboard focus lands on nothing visible",
+    "suggestion": "Give it a width and height, collapse it, or set isTabStop to false"
+  },
+  {
+    "id": "unreachable-by-keyboard",
+    "appliesTo": [
+      "Button",
+      "SplitButton",
+      "Edit",
+      "ComboBox",
+      "Slider",
+      "Spinner",
+      "CheckBox",
+      "RadioButton",
+      "Hyperlink",
+      "MenuItem",
+      "TabItem",
+      "ListItem",
+      "TreeItem"
+    ],
+    "message": "The control is no tab stop and has no access key or keyboard accelerator: a keyboard user cannot reach it",
+    "suggestion": "Set isTabStop to true, or give it an accessKey or a keyboardAccelerator"
+  },
+  {
+    "id": "low-contrast-text",
+    "appliesTo": [
+      "Text",
+      "Button",
+      "SplitButton",
+      "Edit",
+      "ComboBox",
+      "Slider",
+      "Spinner",
+      "CheckBox",
+      "RadioButton"
+    ],
+    "message": "The text is below the WCAG AA contrast (4.5 to 1, or 3 to 1 for large text) against its background",
+    "suggestion": "Use a darker or lighter foreground, or a theme brush"
+  }
+]

package/dist/accessibility/audit/audit-tree.d.ts

@@ -0,0 +1,48 @@
+import type { Rgba } from "./contrast.js";
+import type { AccessibilityRuleId } from "./rules.js";
+/** What a host (the real visual tree, or a test's stand-in) tells the audit of one element. */
+export interface ElementFacts {
+    readonly className: string;
+    readonly controlType: string;
+    readonly name: string;
+    readonly automationId: string;
+    readonly hasLabeledBy: boolean;
+    readonly accessKey: string;
+    readonly isEnabled: boolean;
+    readonly isTabStop: boolean;
+    readonly isKeyboardFocusable: boolean;
+    readonly hasAccelerator: boolean;
+    readonly width: number;
+    readonly height: number;
+    readonly foreground: Rgba | null;
+    readonly background: Rgba | null;
+    readonly fontSize: number;
+    readonly fontWeight: number;
+}
+/** A visual tree the audit can walk; `null` from `describe` skips the element and what is under it. */
+export interface AuditHost<Element extends object> {
+    childrenOf(element: Element): readonly Element[];
+    describe(element: Element): ElementFacts | null;
+}
+/** One problem the audit found, with where it is and what to do. */
+export interface AccessibilityFinding {
+    readonly ruleId: AccessibilityRuleId;
+    readonly message: string;
+    readonly suggestion: string;
+    /** The classes from the root, each with its index among its siblings: `Grid[0]/Button[1]`. */
+    readonly path: string;
+    readonly className: string;
+    readonly automationId: string;
+    readonly name: string;
+}
+/**
+ * Checks a visual tree against the table of rules.
+ *
+ * @param options - The tree's root and the host that reads it.
+ * @returns The findings, in tree order.
+ */
+export declare function auditTree<Element extends object>({ root, host }: {
+    root: Element;
+    host: AuditHost<Element>;
+}): AccessibilityFinding[];
+//# sourceMappingURL=audit-tree.d.ts.map

package/dist/accessibility/audit/audit-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-tree.d.ts","sourceRoot":"","sources":["../../../src/accessibility/audit/audit-tree.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAE1C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAOtD,+FAA+F;AAC/F,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,uGAAuG;AACvG,MAAM,WAAW,SAAS,CAAC,OAAO,SAAS,MAAM;IAC/C,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,OAAO,EAAE,CAAC;IACjD,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAAC;CACjD;AAED,oEAAoE;AACpE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,8FAA8F;IAC9F,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AA6GD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,OAAO,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;IAChE,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;CAC1B,0BAkCA"}

package/dist/accessibility/audit/audit-tree.js

@@ -0,0 +1,125 @@
+import { composite, contrastRatio } from "./contrast.js";
+import { accessibilityRules } from "./rules.js";
+const OPAQUE = 255;
+const LARGE_TEXT_SIZE = 24;
+const LARGE_BOLD_TEXT_SIZE = 18.66;
+const BOLD_WEIGHT = 700;
+function isOpaque(color) {
+    return color !== null && color.alpha === OPAQUE;
+}
+function isLargeText({ fontSize, fontWeight }) {
+    const isLargeBold = fontWeight >= BOLD_WEIGHT && fontSize >= LARGE_BOLD_TEXT_SIZE;
+    return fontSize >= LARGE_TEXT_SIZE || isLargeBold;
+}
+// A translucent background shows as it falls on the one behind it; none is known without a solid one under it.
+function backgroundOver({ layer, inherited }) {
+    const isTransparent = layer === null || layer.alpha === 0;
+    if (isTransparent) {
+        return inherited;
+    }
+    if (isOpaque(layer)) {
+        return layer;
+    }
+    return inherited === null ? null : composite({
+        top: layer,
+        bottom: inherited
+    });
+}
+function contrastOf({ facts, background }) {
+    const { foreground } = facts;
+    const isResolvable = isOpaque(foreground) && background !== null;
+    return isResolvable ? contrastRatio({
+        foreground,
+        background
+    }) : null;
+}
+function walk({ host, element, parent, index, visited }) {
+    const facts = host.describe(element);
+    const isSkipped = facts === null;
+    if (isSkipped) {
+        return;
+    }
+    const inherited = parent?.background ?? null;
+    const own = backgroundOver({
+        layer: facts.background,
+        inherited
+    });
+    const prefix = parent === null ? "" : `${parent.path}/`;
+    const here = {
+        path: `${prefix}${facts.className}[${index}]`,
+        facts,
+        background: own
+    };
+    visited.push(here);
+    for (const [iChild, child] of host.childrenOf(element).entries()) {
+        walk({
+            host,
+            element: child,
+            parent: here,
+            index: iChild,
+            visited
+        });
+    }
+}
+function accessKeyCounts(visited) {
+    const counts = new Map();
+    for (const { facts } of visited) {
+        const key = facts.accessKey.toLowerCase();
+        const isKeyed = key !== "";
+        if (isKeyed) {
+            counts.set(key, (counts.get(key) ?? 0) + 1);
+        }
+    }
+    return counts;
+}
+function nodeOf({ visited, counts }) {
+    const { facts } = visited;
+    const keyCount = counts.get(facts.accessKey.toLowerCase()) ?? 0;
+    return {
+        ...facts,
+        isAccessKeyDuplicated: keyCount > 1,
+        contrast: contrastOf(visited),
+        isLargeText: isLargeText(facts)
+    };
+}
+/**
+ * Checks a visual tree against the table of rules.
+ *
+ * @param options - The tree's root and the host that reads it.
+ * @returns The findings, in tree order.
+ */
+export function auditTree({ root, host }) {
+    const visited = [];
+    walk({
+        host,
+        element: root,
+        parent: null,
+        index: 0,
+        visited
+    });
+    const counts = accessKeyCounts(visited);
+    const findings = [];
+    for (const here of visited) {
+        const node = nodeOf({
+            visited: here,
+            counts
+        });
+        for (const rule of accessibilityRules) {
+            const isApplicable = rule.appliesTo.includes(node.controlType);
+            const isViolated = isApplicable && rule.isViolated(node);
+            if (isViolated) {
+                findings.push({
+                    ruleId: rule.id,
+                    message: rule.message,
+                    suggestion: rule.suggestion,
+                    path: here.path,
+                    className: node.className,
+                    automationId: here.facts.automationId,
+                    name: node.name
+                });
+            }
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=audit-tree.js.map

package/dist/accessibility/audit/audit-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-tree.js","sourceRoot":"","sources":["../../../src/accessibility/audit/audit-tree.ts"],"names":[],"mappings":"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"}