@imfusion/web-ui 0.6.1-dev.1.g23386714 → 0.6.1-dev.14.g8fac1dfb

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imfusion/web-ui",
-  "version": "0.6.1-dev.1.g23386714",
+  "version": "0.6.1-dev.14.g8fac1dfb",
   "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,7 +77,7 @@
     "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",
+    "verify:full": "tsx scripts/verify/full.ts",
     "release": "tsx scripts/release.ts",
     "format": "prettier --write .",
     "lint": "eslint . --cache --fix",

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/install-templates/AGENTS.md

@@ -1,34 +1,31 @@
-# AGENTS.md
+# Agent instructions
 
-<Keep this file lean — target ~50 lines. Decision test for every line: would the agent make a costly mistake without it? If
-it would just need to read a file first, cut it. Dev commands, path aliases, and tool config are discoverable from the files
-themselves.>
+<Keep this file short. Include only rules that prevent a costly mistake. Point to the repository's own docs for everything
+else.>
 
-<One paragraph: what the app is and the stack in one line.>
+<One paragraph describing the app, its package, and its stack.>
 
-Scripts, deps, and setup: [`README.md`](./README.md) and [`package.json`](./package.json) are the source of truth. Check the
-`package.json` scripts before running or suggesting a command — don't infer one exists by pattern-matching a sibling.
+Setup and commands: [`README.md`](./README.md) and [`package.json`](./package.json). Read the package scripts before running
+or suggesting a command.
 
-## Read before you write
+## Read before writing
 
-<One bullet per doc in docs/, each with when to read it, e.g.:>
+<Add one pointer for each repository-specific document.>
 
-- [`docs/<topic>.md`](./docs/<topic>.md) — <what it covers>. Read before <the change it governs>.
+- [`docs/<topic>.md`](./docs/<topic>.md) — <what it covers and when to read it>.
 
-[`docs/index.md`](./docs/index.md) registers all of them.
+[`docs/index.md`](./docs/index.md) lists the documents.
 
 ## Working here
 
-<The fenced block below is the only part of this file `npx web-ui-install` touches: its content comes from this template and
-is refreshed on every skills install. Everything else in the file is scaffolded once by the setup skill and then owned by the
-repo.>
+<The installer owns only the fenced block below. It refreshes that block on every install; the rest belongs to the project.>
 
 <!-- imf-web-ui:begin — managed by `npx web-ui-install`; edits inside the fence are overwritten -->
 
-`.agents/skills/imf-web-ui-*` is vendored from `@imfusion/web-ui` and resynced with `npx web-ui-install`. Don't edit it and
-don't put repo conventions there. Load the matching `imf-web-ui-*` skill before writing code, styles, data fetching, or docs;
-repo docs hold only what is unique to this repo.
+`.agents/skills/imf-web-ui-*` is vendored from `@imfusion/web-ui` and resynced with `npx web-ui-install`. Do not edit the
+vendored copy or put project-specific conventions there. Load the matching skill before changing UI, styles, data, tests, or
+docs.
 
 <!-- imf-web-ui:end -->
 
-<Repo-specific agent guidance: generated files that are committed, tools to verify APIs against, things never to touch.>
+<Add project-specific rules here: generated files, API lookup tools, and paths the agent must not touch.>