@imfusion/web-ui 0.6.0 → 0.6.1-dev.12.ge86ac0a1

package/README.md

@@ -123,23 +123,24 @@ npm run git:config   # hooks path + rebase-only pull/merge
 Web UI development skills use a `/web-ui-dev-*` prefix. `documentation-writer` comes from `npx skills`; it is not a native
 Web UI skill.
 
-| Skill                                     | What it does                                                                                                            |
-| ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
-| `/documentation-writer`                   | External `npx skills` workflow for Diátaxis documentation.                                                              |
-| `/web-ui-dev-getting-started`             | Interactive intro — gauges your experience, works out your goal, routes you.                                            |
-| `/web-ui-dev-start`                       | Starting ritual for any task: Jira context, `master` vs. a worktree, context summary.                                   |
-| `/web-ui-dev-new-component`               | Scaffolds an architecture-compliant primitive (adapted or absorbed).                                                    |
-| `/web-ui-dev-update-component`            | Pointers to every file a prop, variant, or sub-component change touches.                                                |
-| `/web-ui-dev-design-component`            | Brand design pass for a component that works but isn't styled yet.                                                      |
-| `/web-ui-dev-story`                       | Author or update a Storybook story.                                                                                     |
-| `/web-ui-dev-commit`                      | Commit workflow: changelog skill, staged docs audit, CI-parity checks, house commit format.                             |
-| `/web-ui-dev-release`                     | Prepare release highlights, commit release notes, verify, and create an annotated local tag.                            |
-| `/web-ui-dev-changelog`                   | Generate and validate the required one-line CHANGELOG.md entry for a web-ui change, including direct commits to master. |
-| `/web-ui-dev-audit-docs`                  | Audit docs against staged or recent changes for staleness, gaps, and drift.                                             |
-| `/web-ui-dev-audit-pass-through-defaults` | Check `@default` annotations on pass-through props against Base UI upstream.                                            |
-| `/web-ui-dev-teardown-worktree`           | Tear down a worktree, wherever it lives — merging its branch first or dropping it.                                      |
-| `/web-ui-dev-refresh-design-reference`    | Refresh the committed brand snapshots in `design/` from the Figma styleguide.                                           |
-| `/web-ui-dev-mcp`                         | Set up or recover Storybook, DevTools, Atlassian, or Figma MCP access.                                                  |
+| Skill                                     | What it does                                                                                                                                |
+| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
+| `/documentation-writer`                   | [External `npx skills` workflow for writing high quality documentation.](https://www.skills.sh/github/awesome-copilot/documentation-writer) |
+| `/skill-creator`                          | [External `npx skills` workflow for writing and improving skills.](https://www.skills.sh/anthropics/skills/skill-creator)                   |
+| `/web-ui-dev-getting-started`             | Interactive intro — gauges your experience, works out your goal, routes you.                                                                |
+| `/web-ui-dev-start`                       | Starting ritual for any task: Jira context, `master` vs. a worktree, context summary.                                                       |
+| `/web-ui-dev-new-component`               | Scaffolds an architecture-compliant primitive (adapted or absorbed).                                                                        |
+| `/web-ui-dev-update-component`            | Pointers to every file a prop, variant, or sub-component change touches.                                                                    |
+| `/web-ui-dev-design-component`            | Brand design pass for a component that works but isn't styled yet.                                                                          |
+| `/web-ui-dev-story`                       | Author or update a Storybook story.                                                                                                         |
+| `/web-ui-dev-commit`                      | Commit workflow: changelog skill, staged docs audit, CI-parity checks, house commit format.                                                 |
+| `/web-ui-dev-release`                     | Prepare release notes, commit them, and ship the approved release.                                                                          |
+| `/web-ui-dev-changelog`                   | Generate and validate the required one-line CHANGELOG.md entry for a web-ui change, including direct commits to master.                     |
+| `/web-ui-dev-audit-docs`                  | Audit docs against staged or recent changes for staleness, gaps, and drift.                                                                 |
+| `/web-ui-dev-audit-pass-through-defaults` | Check `@default` annotations on pass-through props against Base UI upstream.                                                                |
+| `/web-ui-dev-teardown-worktree`           | Tear down a worktree, wherever it lives — merging its branch first or dropping it.                                                          |
+| `/web-ui-dev-refresh-design-reference`    | Refresh the committed brand snapshots in `design/` from the Figma styleguide.                                                               |
+| `/web-ui-dev-mcp`                         | Set up or recover Storybook, DevTools, Atlassian, or Figma MCP access.                                                                      |
 
 ## Releasing
 
@@ -184,26 +185,37 @@ npx tsx scripts/version.ts        # prints, changes nothing
 
 ### Cutting a release
 
-The detailed Unreleased entries are the release record. Before cutting a version, add one to three titled `Highlights` blocks
-at the top for people deciding whether to update. Start each with the outcome; include a small usage example or link when it
-helps someone explore the feature. Then prepare the dated release section:
+The release skill prepares the dated release section from detailed Unreleased entries and commits it through the normal
+approval gate. Then ship that prepared commit:
 
 ```bash
-npm run release:prepare -- --version 0.5.1
+npm run release
 ```
 
-Commit that change through `/web-ui-dev-release`, then create the local annotated tag:
+The command reads the prepared version from `CHANGELOG.md`, requires a clean working tree, runs full verification, creates a
+version (e.g. `web-ui/v0.5.1`), and pushes the tag. TeamCity builds that tag, publishes the version as `latest`, and points
+`dev` at the same version. The release skill uses the optional `teamcity` CLI when it is installed and authenticated to check
+the tagged build and publish log; otherwise it directs you to the same checks in TeamCity.
+
+The tag name must match `web-ui/vX.Y.Z` exactly. Both the version script's `--match` and the TeamCity branch filter in
+[`.teamcity/settings.kts`](./.teamcity/settings.kts) key off that shape; a tag in any other form publishes nothing.
+
+### Optional TeamCity CLI
+
+The release skill can verify the tagged build and npm publish with the
+[official TeamCity CLI](https://www.jetbrains.com/help/teamcity/2026.1/teamcity-cli.html#installing). It is optional:
+TeamCity still builds and publishes releases when the CLI is absent.
 
 ```bash
-npm run release:tag -- --version 0.5.1
-```
+brew install jetbrains/utils/teamcity
+# or: npm install -g @jetbrains/teamcity-cli
 
-The tag command requires a clean working tree, runs full verification, and creates `web-ui/v0.5.1`. It never pushes. Push
-that tag only after explicit approval. The tag triggers a build that publishes `0.5.1` as `latest` and repoints the `dev`
-dist-tag at the same version.
+teamcity auth login --server https://ci.imfusion.com
+teamcity auth status
+```
 
-The tag name must match `web-ui/vX.Y.Z` exactly. Both the version script's `--match` and the TeamCity branch filter in
-[`.teamcity/settings.kts`](./.teamcity/settings.kts) key off that shape; a tag in any other form publishes nothing.
+`teamcity auth login` opens the browser for TeamCity's PKCE authorization flow and stores the resulting token in the system
+keyring. Use `teamcity auth login --no-browser` when browser login is unavailable.
 
 ### Building locally with a real version
 

package/dist/components/toast/index.d.ts

@@ -0,0 +1,2 @@
+export * as Toast from './toast';
+export { toastMeta } from './toast.meta';

package/dist/components/toast/toast.d.ts

@@ -0,0 +1,197 @@
+import { Toast as ToastPrimitive } from '@base-ui/react/toast';
+import { VariantProps } from 'class-variance-authority';
+type UpstreamProvider = React.ComponentProps<typeof ToastPrimitive.Provider>;
+type UpstreamPortal = React.ComponentProps<typeof ToastPrimitive.Portal>;
+type UpstreamViewport = React.ComponentProps<typeof ToastPrimitive.Viewport>;
+type UpstreamRoot = React.ComponentProps<typeof ToastPrimitive.Root>;
+type UpstreamContent = React.ComponentProps<typeof ToastPrimitive.Content>;
+type UpstreamTitle = React.ComponentProps<typeof ToastPrimitive.Title>;
+type UpstreamDescription = React.ComponentProps<typeof ToastPrimitive.Description>;
+type UpstreamClose = React.ComponentProps<typeof ToastPrimitive.Close>;
+type UpstreamAction = React.ComponentProps<typeof ToastPrimitive.Action>;
+type UpstreamPositioner = React.ComponentProps<typeof ToastPrimitive.Positioner>;
+type UpstreamArrow = React.ComponentProps<typeof ToastPrimitive.Arrow>;
+declare const toastViewport: (props?: ({
+    position?: "top-left" | "top-center" | "top-right" | "bottom-left" | "bottom-center" | "bottom-right" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+declare const toastRoot: (props?: ({
+    variant?: "warning" | "info" | "neutral" | "success" | "error" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+/**
+ * Toast.useToastManager — reads the queue and the add/close/update/promise
+ * methods from the surrounding provider. Must run inside a provider; the one
+ * `WebUIProvider` mounts satisfies that for the standard setup.
+ */
+export declare const useToastManager: typeof ToastPrimitive.useToastManager;
+/**
+ * Toast.createToastManager — creates a manager that lives outside React so
+ * non-component code can add toasts. Pass it to a `Toast.Provider` via
+ * `toastManager`.
+ */
+export declare const createToastManager: typeof ToastPrimitive.createToastManager;
+type ProviderProps = {
+    timeout?: UpstreamProvider["timeout"];
+    limit?: UpstreamProvider["limit"];
+    toastManager?: UpstreamProvider["toastManager"];
+    children?: UpstreamProvider["children"];
+};
+/**
+ * Toast.Provider — owns the toast queue for its subtree. Renders no DOM element.
+ *
+ * `WebUIProvider` already mounts one, so most applications never write this
+ * part. Use it for a scoped queue or to attach an external manager.
+ *
+ * @see https://base-ui.com/react/components/toast
+ * @llm https://base-ui.com/react/components/toast.md
+ */
+export declare function Provider({ timeout, limit, ...props }: ProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace Provider {
+    var displayName: string;
+}
+type PortalProps = Omit<React.HTMLAttributes<HTMLDivElement>, "className"> & {
+    container?: UpstreamPortal["container"];
+    className?: UpstreamPortal["className"];
+    render?: UpstreamPortal["render"];
+    children?: UpstreamPortal["children"];
+};
+/** Toast.Portal — moves the viewport out of the page flow so toasts float above the app. */
+export declare function Portal({ className, ...props }: PortalProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace Portal {
+    var displayName: string;
+}
+type ViewportProps = Omit<React.HTMLAttributes<HTMLDivElement>, "className"> & {
+    /** Which edge or corner of the screen the stack anchors to. */
+    position?: VariantProps<typeof toastViewport>["position"];
+    className?: UpstreamViewport["className"];
+    render?: UpstreamViewport["render"];
+};
+/**
+ * Toast.Viewport — the fixed layer that holds the stack. Hovering or focusing it
+ * expands the collapsed toasts; it ignores pointer events except on the toasts
+ * themselves so the app underneath stays clickable.
+ */
+export declare function Viewport({ className, position, ...props }: ViewportProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace Viewport {
+    var displayName: string;
+}
+type RootProps = Omit<React.HTMLAttributes<HTMLDivElement>, "className"> & {
+    /** Semantic treatment for the toast surface. */
+    variant?: VariantProps<typeof toastRoot>["variant"];
+    /** The toast object from the manager's `toasts` array. */
+    toast: UpstreamRoot["toast"];
+    /** @default ['down', 'right'] */
+    swipeDirection?: UpstreamRoot["swipeDirection"];
+    className?: UpstreamRoot["className"];
+    render?: UpstreamRoot["render"];
+};
+/**
+ * Toast.Root — one toast surface. Carries the upstream state as data attributes
+ * (`data-starting-style`, `data-ending-style`, `data-expanded`, `data-limited`,
+ * `data-swiping`) which the stylesheet uses for stack and exit motion.
+ */
+export declare function Root({ className, variant, ...props }: RootProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace Root {
+    var displayName: string;
+}
+type ContentProps = Omit<React.HTMLAttributes<HTMLDivElement>, "className"> & {
+    className?: UpstreamContent["className"];
+    render?: UpstreamContent["render"];
+};
+/**
+ * Toast.Content — lays out title, description, action, and close. Fades out on
+ * the toasts stacked behind the frontmost one via `data-behind`.
+ */
+export declare function Content({ className, ...props }: ContentProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace Content {
+    var displayName: string;
+}
+type TitleProps = Omit<React.HTMLAttributes<HTMLHeadingElement>, "className"> & {
+    className?: UpstreamTitle["className"];
+    render?: UpstreamTitle["render"];
+};
+/** Toast.Title — the message heading. Falls back to the toast object's `title` when given no children. */
+export declare function Title({ className, ...props }: TitleProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace Title {
+    var displayName: string;
+}
+type DescriptionProps = Omit<React.HTMLAttributes<HTMLParagraphElement>, "className"> & {
+    className?: UpstreamDescription["className"];
+    render?: UpstreamDescription["render"];
+};
+/** Toast.Description — supporting copy. Falls back to the toast object's `description` when given no children. */
+export declare function Description({ className, ...props }: DescriptionProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace Description {
+    var displayName: string;
+}
+type CloseProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "className"> & {
+    /** @default true */
+    nativeButton?: UpstreamClose["nativeButton"];
+    className?: UpstreamClose["className"];
+    render?: UpstreamClose["render"];
+};
+/** Toast.Close — dismisses the toast it sits in. */
+export declare function Close({ className, ...props }: CloseProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace Close {
+    var displayName: string;
+}
+type ActionProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "className"> & {
+    /** @default true */
+    nativeButton?: UpstreamAction["nativeButton"];
+    className?: UpstreamAction["className"];
+    render?: UpstreamAction["render"];
+};
+/**
+ * Toast.Action — the toast's single affordance, typically an undo. Its behavior
+ * comes from `actionProps` on the toast object passed to the manager.
+ */
+export declare function Action({ className, ...props }: ActionProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace Action {
+    var displayName: string;
+}
+type PositionerProps = Omit<React.HTMLAttributes<HTMLDivElement>, "className"> & {
+    /** The toast object from the manager's `toasts` array. */
+    toast: UpstreamPositioner["toast"];
+    /** @default 'top' */
+    side?: UpstreamPositioner["side"];
+    /** @default 'center' */
+    align?: UpstreamPositioner["align"];
+    /** @default 0 */
+    sideOffset?: UpstreamPositioner["sideOffset"];
+    /** @default 0 */
+    alignOffset?: UpstreamPositioner["alignOffset"];
+    /** @default 5 */
+    arrowPadding?: UpstreamPositioner["arrowPadding"];
+    anchor?: UpstreamPositioner["anchor"];
+    collisionAvoidance?: UpstreamPositioner["collisionAvoidance"];
+    /** @default 'clipping-ancestors' */
+    collisionBoundary?: UpstreamPositioner["collisionBoundary"];
+    /** @default 5 */
+    collisionPadding?: UpstreamPositioner["collisionPadding"];
+    /** @default 'absolute' */
+    positionMethod?: UpstreamPositioner["positionMethod"];
+    /** @default false */
+    sticky?: UpstreamPositioner["sticky"];
+    /** @default false */
+    disableAnchorTracking?: UpstreamPositioner["disableAnchorTracking"];
+    className?: UpstreamPositioner["className"];
+    render?: UpstreamPositioner["render"];
+};
+/**
+ * Toast.Positioner — anchors a toast to an element instead of the stack, for
+ * feedback that belongs next to the control that caused it. Wrap a `Root` in it
+ * and the root switches to the compact content-sized surface.
+ */
+export declare function Positioner({ className, ...props }: PositionerProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace Positioner {
+    var displayName: string;
+}
+type ArrowProps = Omit<React.HTMLAttributes<HTMLDivElement>, "className"> & {
+    className?: UpstreamArrow["className"];
+    render?: UpstreamArrow["render"];
+};
+/** Toast.Arrow — pointer joining an anchored toast to its anchor. Receives `data-side` for orientation. */
+export declare function Arrow({ className, ...props }: ArrowProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace Arrow {
+    var displayName: string;
+}
+export {};

package/dist/components/toast/toast.meta.d.ts

@@ -0,0 +1,2 @@
+import { ComponentMeta } from '../../types/meta';
+export declare const toastMeta: ComponentMeta;

package/dist/icons/icon-config.d.ts

@@ -0,0 +1,12 @@
+import { ReactNode, SVGProps } from 'react';
+type IconConfig = Omit<SVGProps<SVGSVGElement>, "children" | "ref">;
+interface ProviderProps {
+    children: ReactNode;
+    value?: IconConfig;
+}
+/** IconConfig.Provider — sets SVG defaults (color, size, stroke width) for icons in its subtree. Providers shallow-merge with the closest parent's config. */
+export declare function Provider({ children, value }: ProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace Provider {
+    var displayName: string;
+}
+export {};

package/dist/index.d.ts

@@ -27,6 +27,7 @@ export { NavigationMenu, navigationMenuMeta } from './components/navigation-menu
 export { Spinner, spinnerMeta } from './components/spinner';
 export { Table, tableMeta } from './components/table';
 export { Tabs, tabsMeta } from './components/tabs';
+export { Toast, toastMeta } from './components/toast';
 export { Tooltip, tooltipMeta } from './components/tooltip';
 export { Typo, typoMeta } from './components/typo';
 export { ImFusionLogo } from './components/logo';