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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imfusion/web-ui",
-  "version": "0.6.0",
+  "version": "0.6.1-dev.12.ge86ac0a1",
   "description": "The official Web UI component library for ImFusion web apps",
   "author": "ImFusion GmbH",
   "license": "UNLICENSED",
@@ -59,6 +59,7 @@
     "dev:lib": "concurrently -n codegen,lib -c yellow,blue \"npm run codegen:watch\" \"vite build --watch\"",
     "build": "npm run codegen && rm -rf dist && vite build && npm run codegen:docgen && npm run codegen:llms && npm run codegen:tokens",
     "build:storybook": "npm run codegen:storybook && storybook build",
+    "ci:status": "teamcity run list --job WebSDK_WebUI_BuildTest --limit 3",
     "storybook": "npm run codegen:storybook && storybook dev -p 6006 --no-open",
     "storybook:free-ports": "tsx scripts/free-storybook-ports.ts",
     "codegen": "tsx src/codegen/run.ts",
@@ -76,9 +77,8 @@
     "verify:icons": "tsx scripts/verify/icons-public-api.ts",
     "verify:changelog": "tsx scripts/verify/changelog.ts",
     "verify:staged": "tsx scripts/verify/staged.ts",
-    "verify:full": "tsx scripts/verify/full.ts && npm run verify:tests",
-    "release:prepare": "tsx scripts/release.ts prepare",
-    "release:tag": "tsx scripts/release.ts tag",
+    "verify:full": "tsx scripts/verify/full.ts",
+    "release": "tsx scripts/release.ts",
     "format": "prettier --write .",
     "lint": "eslint . --cache --fix",
     "lint:inspect": "npx @eslint/config-inspector@latest",

package/src/docgen/doc.gen.json

@@ -4180,6 +4180,387 @@
       }
     ]
   },
+  "toast": {
+    "root": {
+      "name": "Toast.Root",
+      "description": "Toast.Root — one toast surface. Carries the upstream state as data attributes\n(`data-starting-style`, `data-ending-style`, `data-expanded`, `data-limited`,\n`data-swiping`) which the stylesheet uses for stack and exit motion.",
+      "props": [
+        {
+          "name": "className",
+          "required": false,
+          "type": "string | ((state: ToastRootState) => string)",
+          "defaultValue": null,
+          "description": ""
+        },
+        {
+          "name": "render",
+          "required": false,
+          "type": "| ReactElement<\n    unknown,\n    string | JSXElementConstructor<any>\n  >\n| ComponentRenderFn<HTMLProps, ToastRootState>",
+          "defaultValue": null,
+          "description": ""
+        },
+        {
+          "name": "swipeDirection",
+          "required": false,
+          "type": "| \"up\"\n| \"down\"\n| \"left\"\n| \"right\"\n| (\"up\" | \"down\" | \"left\" | \"right\")[]",
+          "defaultValue": "['down', 'right']",
+          "description": ""
+        },
+        {
+          "name": "toast",
+          "required": true,
+          "type": "ToastRootToastObject<any>",
+          "defaultValue": null,
+          "description": "The toast object from the manager's `toasts` array."
+        },
+        {
+          "name": "variant",
+          "required": false,
+          "type": "| \"neutral\"\n| \"info\"\n| \"success\"\n| \"warning\"\n| \"error\"\n| null",
+          "defaultValue": "neutral",
+          "description": "Semantic treatment for the toast surface."
+        }
+      ]
+    },
+    "subComponents": [
+      {
+        "name": "Toast.Action",
+        "description": "Toast.Action — the toast's single affordance, typically an undo. Its behavior\ncomes from `actionProps` on the toast object passed to the manager.",
+        "props": [
+          {
+            "name": "className",
+            "required": false,
+            "type": "string | ((state: ToastActionState) => string)",
+            "defaultValue": null,
+            "description": ""
+          },
+          {
+            "name": "nativeButton",
+            "required": false,
+            "type": "boolean",
+            "defaultValue": "true",
+            "description": ""
+          },
+          {
+            "name": "render",
+            "required": false,
+            "type": "| ReactElement<\n    unknown,\n    string | JSXElementConstructor<any>\n  >\n| ComponentRenderFn<HTMLProps, ToastActionState>",
+            "defaultValue": null,
+            "description": ""
+          }
+        ]
+      },
+      {
+        "name": "Toast.Arrow",
+        "description": "Toast.Arrow — pointer joining an anchored toast to its anchor. Receives `data-side` for orientation.",
+        "props": [
+          {
+            "name": "className",
+            "required": false,
+            "type": "string | ((state: ToastArrowState) => string)",
+            "defaultValue": null,
+            "description": ""
+          },
+          {
+            "name": "render",
+            "required": false,
+            "type": "| ReactElement<\n    unknown,\n    string | JSXElementConstructor<any>\n  >\n| ComponentRenderFn<HTMLProps, ToastArrowState>",
+            "defaultValue": null,
+            "description": ""
+          }
+        ]
+      },
+      {
+        "name": "Toast.Close",
+        "description": "Toast.Close — dismisses the toast it sits in.",
+        "props": [
+          {
+            "name": "className",
+            "required": false,
+            "type": "string | ((state: ToastCloseState) => string)",
+            "defaultValue": null,
+            "description": ""
+          },
+          {
+            "name": "nativeButton",
+            "required": false,
+            "type": "boolean",
+            "defaultValue": "true",
+            "description": ""
+          },
+          {
+            "name": "render",
+            "required": false,
+            "type": "| ReactElement<\n    unknown,\n    string | JSXElementConstructor<any>\n  >\n| ComponentRenderFn<HTMLProps, ToastCloseState>",
+            "defaultValue": null,
+            "description": ""
+          }
+        ]
+      },
+      {
+        "name": "Toast.Content",
+        "description": "Toast.Content — lays out title, description, action, and close. Fades out on\nthe toasts stacked behind the frontmost one via `data-behind`.",
+        "props": [
+          {
+            "name": "className",
+            "required": false,
+            "type": "string | ((state: ToastContentState) => string)",
+            "defaultValue": null,
+            "description": ""
+          },
+          {
+            "name": "render",
+            "required": false,
+            "type": "| ReactElement<\n    unknown,\n    string | JSXElementConstructor<any>\n  >\n| ComponentRenderFn<HTMLProps, ToastContentState>",
+            "defaultValue": null,
+            "description": ""
+          }
+        ]
+      },
+      {
+        "name": "Toast.Description",
+        "description": "Toast.Description — supporting copy. Falls back to the toast object's `description` when given no children.",
+        "props": [
+          {
+            "name": "className",
+            "required": false,
+            "type": "| string\n| ((state: ToastDescriptionState) => string)",
+            "defaultValue": null,
+            "description": ""
+          },
+          {
+            "name": "render",
+            "required": false,
+            "type": "| ReactElement<\n    unknown,\n    string | JSXElementConstructor<any>\n  >\n| ComponentRenderFn<HTMLProps, ToastDescriptionState>",
+            "defaultValue": null,
+            "description": ""
+          }
+        ]
+      },
+      {
+        "name": "Toast.Portal",
+        "description": "Toast.Portal — moves the viewport out of the page flow so toasts float above the app.",
+        "props": [
+          {
+            "name": "className",
+            "required": false,
+            "type": "string | ((state: any) => string)",
+            "defaultValue": null,
+            "description": ""
+          },
+          {
+            "name": "container",
+            "required": false,
+            "type": "| HTMLElement\n| ShadowRoot\n| RefObject<HTMLElement | ShadowRoot | null>\n| null",
+            "defaultValue": null,
+            "description": ""
+          },
+          {
+            "name": "render",
+            "required": false,
+            "type": "| ReactElement<\n    unknown,\n    string | JSXElementConstructor<any>\n  >\n| ComponentRenderFn<HTMLProps, any>",
+            "defaultValue": null,
+            "description": ""
+          }
+        ]
+      },
+      {
+        "name": "Toast.Positioner",
+        "description": "Toast.Positioner — anchors a toast to an element instead of the stack, for\nfeedback that belongs next to the control that caused it. Wrap a `Root` in it\nand the root switches to the compact content-sized surface.",
+        "props": [
+          {
+            "name": "align",
+            "required": false,
+            "type": "Align",
+            "defaultValue": "'center'",
+            "description": ""
+          },
+          {
+            "name": "alignOffset",
+            "required": false,
+            "type": "number | OffsetFunction",
+            "defaultValue": "0",
+            "description": ""
+          },
+          {
+            "name": "anchor",
+            "required": false,
+            "type": "Element | null",
+            "defaultValue": null,
+            "description": ""
+          },
+          {
+            "name": "arrowPadding",
+            "required": false,
+            "type": "number",
+            "defaultValue": "5",
+            "description": ""
+          },
+          {
+            "name": "className",
+            "required": false,
+            "type": "| string\n| ((state: ToastPositionerState) => string)",
+            "defaultValue": null,
+            "description": ""
+          },
+          {
+            "name": "collisionAvoidance",
+            "required": false,
+            "type": "CollisionAvoidance",
+            "defaultValue": null,
+            "description": ""
+          },
+          {
+            "name": "collisionBoundary",
+            "required": false,
+            "type": "Boundary",
+            "defaultValue": "'clipping-ancestors'",
+            "description": ""
+          },
+          {
+            "name": "collisionPadding",
+            "required": false,
+            "type": "Padding",
+            "defaultValue": "5",
+            "description": ""
+          },
+          {
+            "name": "disableAnchorTracking",
+            "required": false,
+            "type": "boolean",
+            "defaultValue": "false",
+            "description": ""
+          },
+          {
+            "name": "positionMethod",
+            "required": false,
+            "type": "\"absolute\" | \"fixed\"",
+            "defaultValue": "'absolute'",
+            "description": ""
+          },
+          {
+            "name": "render",
+            "required": false,
+            "type": "| ReactElement<\n    unknown,\n    string | JSXElementConstructor<any>\n  >\n| ComponentRenderFn<HTMLProps, ToastPositionerState>",
+            "defaultValue": null,
+            "description": ""
+          },
+          {
+            "name": "side",
+            "required": false,
+            "type": "Side",
+            "defaultValue": "'top'",
+            "description": ""
+          },
+          {
+            "name": "sideOffset",
+            "required": false,
+            "type": "number | OffsetFunction",
+            "defaultValue": "0",
+            "description": ""
+          },
+          {
+            "name": "sticky",
+            "required": false,
+            "type": "boolean",
+            "defaultValue": "false",
+            "description": ""
+          },
+          {
+            "name": "toast",
+            "required": true,
+            "type": "ToastObject<any>",
+            "defaultValue": null,
+            "description": "The toast object from the manager's `toasts` array."
+          }
+        ]
+      },
+      {
+        "name": "Toast.Provider",
+        "description": "Toast.Provider — owns the toast queue for its subtree. Renders no DOM element.\n\n`WebUIProvider` already mounts one, so most applications never write this\npart. Use it for a scoped queue or to attach an external manager.",
+        "props": [
+          {
+            "name": "limit",
+            "required": false,
+            "type": "number",
+            "defaultValue": "3",
+            "description": ""
+          },
+          {
+            "name": "timeout",
+            "required": false,
+            "type": "number",
+            "defaultValue": "5000",
+            "description": ""
+          },
+          {
+            "name": "toastManager",
+            "required": false,
+            "type": "ToastManager<any>",
+            "defaultValue": null,
+            "description": ""
+          }
+        ]
+      },
+      {
+        "name": "Toast.Title",
+        "description": "Toast.Title — the message heading. Falls back to the toast object's `title` when given no children.",
+        "props": [
+          {
+            "name": "className",
+            "required": false,
+            "type": "string | ((state: ToastTitleState) => string)",
+            "defaultValue": null,
+            "description": ""
+          },
+          {
+            "name": "render",
+            "required": false,
+            "type": "| ReactElement<\n    unknown,\n    string | JSXElementConstructor<any>\n  >\n| ComponentRenderFn<HTMLProps, ToastTitleState>",
+            "defaultValue": null,
+            "description": ""
+          }
+        ]
+      },
+      {
+        "name": "Toast.Provider",
+        "description": "Toast.createToastManager — creates a manager that lives outside React so\nnon-component code can add toasts. Pass it to a `Toast.Provider` via\n`toastManager`.",
+        "props": []
+      },
+      {
+        "name": "Toast.useToastManager",
+        "description": "Toast.useToastManager — reads the queue and the add/close/update/promise\nmethods from the surrounding provider. Must run inside a provider; the one\n`WebUIProvider` mounts satisfies that for the standard setup.",
+        "props": []
+      },
+      {
+        "name": "Toast.Viewport",
+        "description": "Toast.Viewport — the fixed layer that holds the stack. Hovering or focusing it\nexpands the collapsed toasts; it ignores pointer events except on the toasts\nthemselves so the app underneath stays clickable.",
+        "props": [
+          {
+            "name": "className",
+            "required": false,
+            "type": "string | ((state: ToastViewportState) => string)",
+            "defaultValue": null,
+            "description": ""
+          },
+          {
+            "name": "position",
+            "required": false,
+            "type": "| \"top-left\"\n| \"top-center\"\n| \"top-right\"\n| \"bottom-left\"\n| \"bottom-center\"\n| \"bottom-right\"\n| null",
+            "defaultValue": "bottom-center",
+            "description": "Which edge or corner of the screen the stack anchors to."
+          },
+          {
+            "name": "render",
+            "required": false,
+            "type": "| ReactElement<\n    unknown,\n    string | JSXElementConstructor<any>\n  >\n| ComponentRenderFn<HTMLProps, ToastViewportState>",
+            "defaultValue": null,
+            "description": ""
+          }
+        ]
+      }
+    ]
+  },
   "toggle": {
     "root": {
       "name": "Toggle",

package/src/llms/llms.gen.txt

@@ -169,6 +169,12 @@ Tabbed navigation — switches between panels of content within one view via a h
 - props: node_modules/@imfusion/web-ui/src/docgen/doc.gen.json -> .tabs (jq: jq '.tabs' node_modules/@imfusion/web-ui/src/docgen/doc.gen.json)
 - further reading (usage/anatomy, not props): https://base-ui.com/react/components/tabs.md
 
+## Toast
+- category: Display, status: experimental
+Transient message stack that reports the outcome of a background action without interrupting the page. Use for save confirmations, undo offers, and async progress; attach one to an element for contextual feedback like a copy confirmation. Also called a snackbar, notification, or flash message; for a message that stays inline in the page use Callout instead.
+- props: node_modules/@imfusion/web-ui/src/docgen/doc.gen.json -> .toast (jq: jq '.toast' node_modules/@imfusion/web-ui/src/docgen/doc.gen.json)
+- further reading (usage/anatomy, not props): https://base-ui.com/react/components/toast.md
+
 ## Toggle
 - category: Inputs, status: experimental
 A two-state button that can be on or off. Compose several inside a ToggleGroup for a segmented control.

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

@@ -1,8 +0,0 @@
-import { ReactNode } from 'react';
-import { IconConfig } from './icon-context';
-interface IconConfigProviderProps {
-    children: ReactNode;
-    value?: IconConfig;
-}
-export declare function IconConfigProvider({ children, value }: IconConfigProviderProps): import("react/jsx-runtime").JSX.Element;
-export {};

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

@@ -1,4 +0,0 @@
-import { SVGProps } from 'react';
-type IconConfig = Omit<SVGProps<SVGSVGElement>, "children" | "ref">;
-export declare const IconConfigContext: import('react').Context<IconConfig>;
-export type { IconConfig };