@miragon/modeler-shell 0.1.0 → 0.2.0

package/dist/toasts-Bp0REqdq.d.cts

@@ -0,0 +1,142 @@
+/** A point in pixels or diagram coordinates, as the context says. */
+interface Point {
+    x: number;
+    y: number;
+}
+interface Size {
+    width: number;
+    height: number;
+}
+/** A rectangle; content bounds and viewboxes are in diagram coordinates. */
+interface Bounds {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** A viewbox together with the scale diagram-js shows it at (`canvas.viewbox().scale`). */
+interface ScaledViewbox extends Bounds {
+    scale: number;
+}
+/** Distances in pixels from the edges of the modeler's container. */
+interface Insets {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+/**
+ * The host column of guide §5.2: `ide` is a VS Code webview (later IntelliJ), `web` a Miragon web
+ * app that owns its page, `embedded` a modeler inside a foreign page (designIQ, modeler-api hosts).
+ */
+type ShellHost = "ide" | "web" | "embedded";
+/**
+ * The `data-chrome` names of the chrome (guide §5.2, §13.4). The web column adds `primary`, `legal`,
+ * `toasts`, `empty-state`, `drop-zone` and `problems-popover` (0.2); IDE and embedded hosts never
+ * show `primary`, `legal`, `empty-state` and `drop-zone`, the IDE host never `toasts` and
+ * `problems-popover`.
+ */
+type ChromeIsland = "menu" | "palette" | "primary" | "zoom" | "problems" | "legend" | "inspector" | "status" | "legal" | "toasts" | "empty-state" | "drop-zone" | "problems-popover";
+declare const CHROME_ISLANDS: readonly ChromeIsland[];
+/** Where the palette sits: in the top row, or in the second row below it (guide §5.15). */
+type PaletteRow = "top" | "second-row";
+/**
+ * What the zoom panel and the chrome keys act on. The diagram-js viewport implements it; the DOM
+ * shell only talks to this interface.
+ */
+interface ZoomTarget {
+    /** The current zoom, 1 = 100 % (diagram-js `canvas.zoom()`, rounded to three decimals). */
+    zoom(): number;
+    /** One step on the zoom raster around the container centre (diagram-js `zoomScroll.stepZoom`). */
+    stepZoom(direction: 1 | -1): void;
+    /** 100 % around the container centre. Counts as a user move. */
+    zoomToActual(): void;
+    /** Explicit fit (button, Shift+1, command): animated unless reduced motion, makes the view automatic. */
+    fit(): void;
+    /** False while there is nothing to fit (the content bounds are empty). */
+    canFit(): boolean;
+    /**
+     * Calls `listener` after every viewbox change and whenever `canFit()` may have changed, possibly
+     * several times per frame. Returns the unsubscribe function.
+     */
+    onChange(listener: () => void): () => void;
+}
+/** The persisted view (VS Code `setState`): JSON-serializable. */
+interface ViewportState {
+    viewbox: Bounds;
+    /** The user zoomed or panned since the last fit; a resize no longer refits. */
+    userMoved: boolean;
+}
+
+/** The statuses of guide §3.3 and §9; each colours bar and dot through `--cd-ui-<status>`. */
+type ToastStatus = "success" | "info" | "warning" | "danger";
+/** A ghost button before Close (guide §8); the toast then never closes by itself. */
+interface ToastAction {
+    label: string;
+    /** Runs after the toast closed. */
+    onSelect(): void;
+}
+interface ToastRequest {
+    status: ToastStatus;
+    /** What happened and what you can do (guide §2): "Link copied", "Couldn't read this file. …". */
+    text: string;
+    action?: ToastAction | undefined;
+    /** Only to give a long text more time than `TOAST_DURATION_MS`; ignored with an `action`. */
+    durationMs?: number | undefined;
+}
+/** At most three toasts at once, the newest at the bottom (guide §8). */
+declare const MAX_TOASTS = 3;
+/**
+ * How long a toast stays without hover or focus (guide §8: about 2.8 s, errors about 5 s). A
+ * warning asks you to read a sentence and act on it like an error, so it gets the error's 5 s.
+ */
+declare const TOAST_DURATION_MS: Readonly<Record<ToastStatus, number>>;
+/** The stack's widest toast: `min(480px, 100cqw − 24px)` (guide §8). */
+declare const TOAST_MAX_WIDTH = 480;
+/**
+ * Milliseconds until the toast closes by itself: `undefined` with an `action` (it never closes by
+ * itself, guide §8), else `max(TOAST_DURATION_MS[status], durationMs ?? 0)`.
+ */
+declare function toastLifetime(request: ToastRequest): number | undefined;
+/** A toast in the stack as the eviction sees it, oldest first. */
+interface ToastSlot {
+    id: number;
+    hasAction: boolean;
+    /** Hovered or holding the focus. */
+    engaged: boolean;
+}
+/**
+ * Which toast leaves when a fourth arrives (`MAX_TOASTS`): the oldest that is neither engaged nor
+ * has an action, else the oldest that is not engaged, else the oldest. `undefined` while the
+ * stack has room.
+ */
+declare function toastToEvict(stack: readonly ToastSlot[]): number | undefined;
+/** Something in the bottom row the toast stack must clear, relative to the shell root. */
+interface BottomObstacle {
+    left: number;
+    right: number;
+    /** Distance of its top edge from the container's bottom edge. */
+    top: number;
+}
+interface ToastStackInput {
+    containerWidth: number;
+    /** The visible zoom panel, legal line and problems pill (not the legend card). */
+    obstacles: readonly BottomObstacle[];
+    /**
+     * Measured width of the widest toast in the stack. The cards are sized to their text and centred
+     * in the stack, so only this column can touch an obstacle; absent = the whole `toastStackWidth`.
+     */
+    cardWidth?: number | undefined;
+}
+/** `min(TOAST_MAX_WIDTH, containerWidth − 2 · SHELL.edge)`. */
+declare function toastStackWidth(containerWidth: number): number;
+/**
+ * The stack's `bottom` in px. Guide §8 anchors it at `bottom: 12px`, centred; where the column of
+ * its widest card (`cardWidth`, at most `toastStackWidth`, centred) comes closer than `SHELL.gap`
+ * horizontally to an obstacle, the stack stands `SHELL.gap` above the highest such obstacle instead
+ * (above the legal line 40, above the zoom panel 60, above a raised zoom panel or the web pill 88).
+ * Guide §8 does not settle this collision of a narrow container; it is the shell's rule until it does.
+ */
+declare function toastStackBottom(input: ToastStackInput): number;
+
+export { type BottomObstacle as B, CHROME_ISLANDS as C, type Insets as I, MAX_TOASTS as M, type PaletteRow as P, type ScaledViewbox as S, TOAST_DURATION_MS as T, type ViewportState as V, type ZoomTarget as Z, type Bounds as a, type ChromeIsland as b, type Point as c, type ShellHost as d, type Size as e, TOAST_MAX_WIDTH as f, type ToastAction as g, type ToastRequest as h, type ToastSlot as i, type ToastStackInput as j, type ToastStatus as k, toastStackBottom as l, toastStackWidth as m, toastToEvict as n, toastLifetime as t };

package/dist/toasts-Bp0REqdq.d.ts

@@ -0,0 +1,142 @@
+/** A point in pixels or diagram coordinates, as the context says. */
+interface Point {
+    x: number;
+    y: number;
+}
+interface Size {
+    width: number;
+    height: number;
+}
+/** A rectangle; content bounds and viewboxes are in diagram coordinates. */
+interface Bounds {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** A viewbox together with the scale diagram-js shows it at (`canvas.viewbox().scale`). */
+interface ScaledViewbox extends Bounds {
+    scale: number;
+}
+/** Distances in pixels from the edges of the modeler's container. */
+interface Insets {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+/**
+ * The host column of guide §5.2: `ide` is a VS Code webview (later IntelliJ), `web` a Miragon web
+ * app that owns its page, `embedded` a modeler inside a foreign page (designIQ, modeler-api hosts).
+ */
+type ShellHost = "ide" | "web" | "embedded";
+/**
+ * The `data-chrome` names of the chrome (guide §5.2, §13.4). The web column adds `primary`, `legal`,
+ * `toasts`, `empty-state`, `drop-zone` and `problems-popover` (0.2); IDE and embedded hosts never
+ * show `primary`, `legal`, `empty-state` and `drop-zone`, the IDE host never `toasts` and
+ * `problems-popover`.
+ */
+type ChromeIsland = "menu" | "palette" | "primary" | "zoom" | "problems" | "legend" | "inspector" | "status" | "legal" | "toasts" | "empty-state" | "drop-zone" | "problems-popover";
+declare const CHROME_ISLANDS: readonly ChromeIsland[];
+/** Where the palette sits: in the top row, or in the second row below it (guide §5.15). */
+type PaletteRow = "top" | "second-row";
+/**
+ * What the zoom panel and the chrome keys act on. The diagram-js viewport implements it; the DOM
+ * shell only talks to this interface.
+ */
+interface ZoomTarget {
+    /** The current zoom, 1 = 100 % (diagram-js `canvas.zoom()`, rounded to three decimals). */
+    zoom(): number;
+    /** One step on the zoom raster around the container centre (diagram-js `zoomScroll.stepZoom`). */
+    stepZoom(direction: 1 | -1): void;
+    /** 100 % around the container centre. Counts as a user move. */
+    zoomToActual(): void;
+    /** Explicit fit (button, Shift+1, command): animated unless reduced motion, makes the view automatic. */
+    fit(): void;
+    /** False while there is nothing to fit (the content bounds are empty). */
+    canFit(): boolean;
+    /**
+     * Calls `listener` after every viewbox change and whenever `canFit()` may have changed, possibly
+     * several times per frame. Returns the unsubscribe function.
+     */
+    onChange(listener: () => void): () => void;
+}
+/** The persisted view (VS Code `setState`): JSON-serializable. */
+interface ViewportState {
+    viewbox: Bounds;
+    /** The user zoomed or panned since the last fit; a resize no longer refits. */
+    userMoved: boolean;
+}
+
+/** The statuses of guide §3.3 and §9; each colours bar and dot through `--cd-ui-<status>`. */
+type ToastStatus = "success" | "info" | "warning" | "danger";
+/** A ghost button before Close (guide §8); the toast then never closes by itself. */
+interface ToastAction {
+    label: string;
+    /** Runs after the toast closed. */
+    onSelect(): void;
+}
+interface ToastRequest {
+    status: ToastStatus;
+    /** What happened and what you can do (guide §2): "Link copied", "Couldn't read this file. …". */
+    text: string;
+    action?: ToastAction | undefined;
+    /** Only to give a long text more time than `TOAST_DURATION_MS`; ignored with an `action`. */
+    durationMs?: number | undefined;
+}
+/** At most three toasts at once, the newest at the bottom (guide §8). */
+declare const MAX_TOASTS = 3;
+/**
+ * How long a toast stays without hover or focus (guide §8: about 2.8 s, errors about 5 s). A
+ * warning asks you to read a sentence and act on it like an error, so it gets the error's 5 s.
+ */
+declare const TOAST_DURATION_MS: Readonly<Record<ToastStatus, number>>;
+/** The stack's widest toast: `min(480px, 100cqw − 24px)` (guide §8). */
+declare const TOAST_MAX_WIDTH = 480;
+/**
+ * Milliseconds until the toast closes by itself: `undefined` with an `action` (it never closes by
+ * itself, guide §8), else `max(TOAST_DURATION_MS[status], durationMs ?? 0)`.
+ */
+declare function toastLifetime(request: ToastRequest): number | undefined;
+/** A toast in the stack as the eviction sees it, oldest first. */
+interface ToastSlot {
+    id: number;
+    hasAction: boolean;
+    /** Hovered or holding the focus. */
+    engaged: boolean;
+}
+/**
+ * Which toast leaves when a fourth arrives (`MAX_TOASTS`): the oldest that is neither engaged nor
+ * has an action, else the oldest that is not engaged, else the oldest. `undefined` while the
+ * stack has room.
+ */
+declare function toastToEvict(stack: readonly ToastSlot[]): number | undefined;
+/** Something in the bottom row the toast stack must clear, relative to the shell root. */
+interface BottomObstacle {
+    left: number;
+    right: number;
+    /** Distance of its top edge from the container's bottom edge. */
+    top: number;
+}
+interface ToastStackInput {
+    containerWidth: number;
+    /** The visible zoom panel, legal line and problems pill (not the legend card). */
+    obstacles: readonly BottomObstacle[];
+    /**
+     * Measured width of the widest toast in the stack. The cards are sized to their text and centred
+     * in the stack, so only this column can touch an obstacle; absent = the whole `toastStackWidth`.
+     */
+    cardWidth?: number | undefined;
+}
+/** `min(TOAST_MAX_WIDTH, containerWidth − 2 · SHELL.edge)`. */
+declare function toastStackWidth(containerWidth: number): number;
+/**
+ * The stack's `bottom` in px. Guide §8 anchors it at `bottom: 12px`, centred; where the column of
+ * its widest card (`cardWidth`, at most `toastStackWidth`, centred) comes closer than `SHELL.gap`
+ * horizontally to an obstacle, the stack stands `SHELL.gap` above the highest such obstacle instead
+ * (above the legal line 40, above the zoom panel 60, above a raised zoom panel or the web pill 88).
+ * Guide §8 does not settle this collision of a narrow container; it is the shell's rule until it does.
+ */
+declare function toastStackBottom(input: ToastStackInput): number;
+
+export { type BottomObstacle as B, CHROME_ISLANDS as C, type Insets as I, MAX_TOASTS as M, type PaletteRow as P, type ScaledViewbox as S, TOAST_DURATION_MS as T, type ViewportState as V, type ZoomTarget as Z, type Bounds as a, type ChromeIsland as b, type Point as c, type ShellHost as d, type Size as e, TOAST_MAX_WIDTH as f, type ToastAction as g, type ToastRequest as h, type ToastSlot as i, type ToastStackInput as j, type ToastStatus as k, toastStackBottom as l, toastStackWidth as m, toastToEvict as n, toastLifetime as t };

package/dist/{types-OuFlqZp0.d.cts → types-CnRrINRs.d.cts}

@@ -1,5 +1,5 @@
-import { c as ShellHost, Z as ZoomTarget, I as Insets } from './types-B6NfkiUG.cjs';
-import { P as Platform, d as ShellMessages, S as ShellMessageOverrides } from './keymap-CObQE6q6.cjs';
+import { d as ShellHost, Z as ZoomTarget, I as Insets, h as ToastRequest } from './toasts-Bp0REqdq.cjs';
+import { P as Platform, k as ShellMessages, a as AppearanceChoice, i as ProblemItem, S as ShellMessageOverrides, l as ThemeColors } from './appearance-XX3JC3pI.cjs';
 import { T as Theme } from './appearance-D3FUcbu6.cjs';
 
 /*! @miragon/modeler-shell icon geometry
@@ -54,10 +54,11 @@ interface ShellOptions {
     keyScope?: "document" | "root" | undefined;
     /**
      * The modes the modeler can show (a static value of the modeler package), default `["light"]`.
-     * Read in the `embedded` host only: there the root carries `data-cd-theme="<themes[0]>"` itself
-     * (until the contract's `appearance` surface an embedded modeler stays in its first mode,
-     * whatever the page shows) and mirrors the host's `data-cd-kontrast` (guide §13.3). In an own
-     * document the host writes the mode on `<html>`.
+     * Read in the `embedded` and `web` hosts. Embedded: the root carries `data-cd-theme="<themes[0]>"`
+     * itself (until the contract's `appearance` surface an embedded modeler stays in its first mode,
+     * whatever the page shows) and mirrors the host's `data-cd-kontrast` (guide §13.3). Web: with
+     * `"dark"` the shell renders the Appearance group and applies the choice on `<html>` (needs
+     * `appearance`); light-only it renders no group. In the `ide` host the host writes the mode.
      */
     themes?: readonly Theme[] | undefined;
     /** The fixed menu groups this modeler fills (guide §5.4); omitted groups and empty ones collapse. */
@@ -70,6 +71,21 @@ interface ShellOptions {
     inspector?: InspectorOptions | undefined;
     /** The empty-file hint of IDE and embedded hosts (guide §13.5); omitted = no hint. */
     emptyHint?: EmptyHintOptions | undefined;
+    /** The primary action at the top right (guide §5.7); omitted = the top right stays empty. */
+    primary?: PrimaryActionOptions | undefined;
+    /**
+     * The legal line at the bottom left (guide §5.10), always rendered in the web host: copyright,
+     * Impressum and Datenschutz (`lang="de"`), then `links`.
+     */
+    legal?: LegalLineOptions | undefined;
+    /** The File group, first in the menu (guide §5.4); omitted = no File group. */
+    file?: FileMenuOptions | undefined;
+    /** The mode choice of a dark-capable modeler (guide §13.3); required when `themes` includes `"dark"`. */
+    appearance?: WebAppearanceOptions | undefined;
+    /** The start screen (guide §8 Empty State); omitted = none. Shown by `setEmptyState(true)`. */
+    emptyState?: EmptyStateOptions | undefined;
+    /** Files dropped anywhere on the page (guide §9 Drag-over, Drop forbidden); omitted = none. */
+    dropZone?: DropZoneOptions | undefined;
 }
 /** Rendered in this order, separated by separators: Model, Export, Help (guide §5.4). */
 interface MenuGroups {
@@ -113,6 +129,10 @@ interface MenuActionEntry extends MenuItemBase {
  */
 interface MenuDialogEntry extends MenuItemBase {
     kind: "dialog";
+    /** Shortcut chip text shown on the right, verbatim ("?" for "Keyboard shortcuts…"). */
+    shortcut?: string | undefined;
+    /** As for `MenuActionEntry`: default `ariaKeyShortcutsFromLabel(shortcut)`, `""` sets none. */
+    ariaKeyShortcuts?: string | undefined;
     onSelect(): void;
 }
 /** `menuitemcheckbox`: toggles and keeps the menu open; the check mark carries the state. */
@@ -139,8 +159,17 @@ interface MenuRadioOption {
     label: string;
 }
 interface ProblemsOptions {
-    /** A click on the pill: the IDE host opens its Problems view. */
-    onActivate(): void;
+    /**
+     * A click on the pill where the host has a problems view of its own: the IDE host opens its
+     * Problems view (give it there), an embedding host its own list. Ignored in the web host, where
+     * the pill opens the problems popover; an embedded shell without it opens the popover as well.
+     */
+    onActivate?: (() => void) | undefined;
+    /**
+     * A click on a row of the problems popover, after the popover closed (guide §5.10): select the
+     * element the item names, where there is one.
+     */
+    onSelectItem?: ((item: ProblemItem) => void) | undefined;
 }
 interface LegendOptions {
     /** Renders the legend rows into `body` once (classes `cd-shell-legend-*`, see API.md). */
@@ -177,6 +206,10 @@ interface ShellHandle {
     readonly tooltip: TooltipHandle;
     readonly legend: LegendHandle | undefined;
     readonly inspector: InspectorHandle | undefined;
+    /** The web app's primary action; `undefined` without `primary` and outside the web host. */
+    readonly primary: PrimaryActionHandle | undefined;
+    /** The web app's mode choice; `undefined` outside the web host and for a light-only modeler. */
+    readonly appearance: AppearanceHandle | undefined;
     /** Binds zoom panel, readout and chrome keys; `null` unbinds (buttons disabled). */
     setZoomTarget(target: ZoomTarget | null): void;
     /** The fit insets for what is open right now (palette row, legend, inspector, pill). */
@@ -207,6 +240,21 @@ interface ShellHandle {
     }): void;
     /** The lock, true from the first `setReadOnly(true)` on, also while its marks are still delayed. */
     isReadOnly(): boolean;
+    /**
+     * Shows or hides the web app's start screen (guide §8): while it shows, menu trigger, primary
+     * action, palette, zoom panel, pill, legend, status box, hint and inspector are hidden, the canvas
+     * slot is `inert` and the chrome keys do nothing; the legal line, toasts and the drop zone stay.
+     * A no-op without `emptyState`. Hiding it while it holds the focus moves the focus to the canvas.
+     */
+    setEmptyState(shown: boolean): void;
+    isEmptyStateShown(): boolean;
+    /**
+     * Shows a toast (guide §8, §9) in the web and embedded hosts: bottom centre, at most three, the
+     * newest at the bottom, closing by itself after `toastLifetime` unless hovered or focused. In the
+     * `ide` host it shows nothing and returns an inert handle: there the extension shows the host's
+     * notification (§13.5).
+     */
+    toast(request: ToastRequest): ToastHandle;
     /** Removes every element, attribute, listener, observer and timer the shell added. Idempotent. */
     destroy(): void;
 }
@@ -274,11 +322,124 @@ interface ProblemSummary {
     count: number;
     /** How many of them are errors; decides icon and wording. */
     errors: number;
+    /**
+     * The rows of the problems popover (web, embedded without `onActivate`), in this order; the IDE
+     * host ignores them. `problemSummary(items)` builds the whole summary from them.
+     */
+    items?: readonly ProblemItem[] | undefined;
 }
 type StatusSeverity = "danger" | "warning";
 interface StatusMessage {
     severity: StatusSeverity;
     text: string;
 }
+/** The web app's primary action (guide §5.7): a blue primary button, icon and label, at the top right. */
+interface PrimaryActionOptions {
+    /** Label and `aria-label`; default `messages.share` ("Share"). */
+    label?: string | undefined;
+    /** Default `"share-2"`. */
+    icon?: ShellIconName | undefined;
+    onSelect(): void;
+    /** Read on mount and on `primary.refresh()`; disabled stays focusable (`aria-disabled`). */
+    disabled?: (() => boolean) | undefined;
+}
+interface PrimaryActionHandle {
+    /** The `<button data-chrome="primary">`. */
+    readonly element: HTMLButtonElement;
+    /** True while the label is collapsed to the icon (guide §5.15); the root then carries `data-primary="collapsed"`. */
+    isCollapsed(): boolean;
+    /** Re-reads `disabled()`. */
+    refresh(): void;
+}
+/** A link of the legal line after Impressum and Datenschutz. */
+interface LegalLink {
+    label: string;
+    href: string;
+    /** For a label in another language than the tool's. */
+    lang?: string | undefined;
+}
+interface LegalLineOptions {
+    /** After Impressum and Datenschutz: `{ label: "GitHub", href: "https://github.com/Miragon/…" }`. */
+    links?: readonly LegalLink[] | undefined;
+    /** The copyright year; default the current year at mount. */
+    year?: number | undefined;
+}
+/** One entry of the File group; label and icon come from the shell (guide §2, §5.4). */
+interface FileMenuAction {
+    onSelect(): void;
+    /** Shortcut chip, e.g. "⌘O"; the web app binds the key itself. */
+    shortcut?: string | undefined;
+    /** `kind: "dialog"` (`aria-haspopup="dialog"`) when it opens an in-page dialog, not the browser's file picker. */
+    dialog?: boolean | undefined;
+    disabled?: (() => boolean) | undefined;
+}
+/**
+ * The File group of the web app (guide §5.4), in this order, as far as the modeler has them:
+ * "New diagram" (`file-plus`), "Open…" (`folder-open`), "Show example", "Import…" (`import`).
+ * Menu ids `new-diagram`, `open`, `show-example`, `import`, `data-menu-group="file"`.
+ */
+interface FileMenuOptions {
+    newDiagram?: FileMenuAction | undefined;
+    open?: FileMenuAction | undefined;
+    showExample?: FileMenuAction | undefined;
+    import?: FileMenuAction | undefined;
+}
+/** What `localStorage` offers; a blocked storage throws, the shell catches it. */
+interface StorageLike {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+}
+interface WebAppearanceOptions {
+    /** The two `theme-color` values from the vendored token JSON (see `ThemeColors`). */
+    themeColors: ThemeColors;
+    /** Default `globalThis.localStorage`. */
+    storage?: StorageLike | undefined;
+}
+/** The mode choice of a dark-capable web app (guide §13.3), as the Appearance group drives it. */
+interface AppearanceHandle {
+    /** The stored choice, `"system"` without one. */
+    choice(): AppearanceChoice;
+    /**
+     * Stores the choice (`"system"` removes `APPEARANCE_STORAGE_KEY`) and applies `documentMode` on
+     * `<html>` and the metas in one step, with `cd-shell-no-transition` for one frame (guide §7).
+     */
+    setChoice(choice: AppearanceChoice): void;
+}
+/** The web app's start screen (guide §8): a centred glass card with the Komet and two actions. */
+interface EmptyStateOptions {
+    /** The card's title (h1, 21px/600), the modeler's name: "Event Storming Modeler". */
+    title: string;
+    /** One line of help (16px/1.6, `--cd-ui-text-leise`): "Start a new diagram, or explore the example." */
+    text: string;
+    /**
+     * URL of the official Miragon icon `miragon-komet-blau.svg`, vendored unchanged from
+     * `Miragon/corporate-identity` (guide §2, §11), shown at 64px with `alt=""`.
+     */
+    komet: string;
+    /** "New diagram", the blue primary button. The shell hides the card first. */
+    onNewDiagram(): void;
+    /** "Show example", the ghost button; omitted = no example button. The shell hides the card first. */
+    onShowExample?: (() => void) | undefined;
+    /** The drag-and-drop hint (13px, `--cd-ui-text-leise`), shown with a `dropZone` only; default `messages.dropHint`. */
+    dropHint?: string | undefined;
+}
+interface DropZoneOptions {
+    /**
+     * Like `<input accept>`: extensions (".storm") and MIME types ("application/json", "text/*").
+     * List the MIME types too, so a drag can already show a foreign type as forbidden. Empty = any file.
+     */
+    accept: readonly string[];
+    /** Default `false`: a drag with more than one file is forbidden. */
+    multiple?: boolean | undefined;
+    /** The dropped files that match `accept` (one unless `multiple`). */
+    onDrop(files: readonly File[]): void;
+    /** The dropped files outside `accept`; default a danger toast `messages.cannotOpenFile`. */
+    onReject?: ((files: readonly File[]) => void) | undefined;
+}
+interface ToastHandle {
+    /** Closes the toast (slide and fade out); a second call does nothing. */
+    dismiss(): void;
+}
 
-export { type EmptyHintOptions as E, ICONS as I, type LegendHandle as L, type MenuActionEntry as M, PALETTE_TOOL_ICON as P, type ShellOptions as S, type TooltipContent as T, type ShellHandle as a, type IconNode as b, type IconOptions as c, type InspectorHandle as d, type InspectorOptions as e, type LegendOptions as f, type MenuCheckboxEntry as g, type MenuDialogEntry as h, type MenuEntry as i, type MenuGroups as j, type MenuHandle as k, type MenuRadioGroup as l, type MenuRadioOption as m, type PaletteReadOnlyState as n, type PaletteRegistration as o, type ProblemSummary as p, type ProblemsOptions as q, type ShellIconName as r, type StatusMessage as s, type StatusSeverity as t, type TooltipHandle as u, iconElement as v, iconMarkup as w };
+export { type AppearanceHandle as A, type StorageLike as B, type TooltipContent as C, type DropZoneOptions as D, type EmptyHintOptions as E, type FileMenuAction as F, type TooltipHandle as G, iconElement as H, ICONS as I, iconMarkup as J, type LegalLineOptions as L, type MenuActionEntry as M, PALETTE_TOOL_ICON as P, type ShellOptions as S, type ToastHandle as T, type WebAppearanceOptions as W, type ShellHandle as a, type EmptyStateOptions as b, type FileMenuOptions as c, type IconNode as d, type IconOptions as e, type InspectorHandle as f, type InspectorOptions as g, type LegalLink as h, type LegendHandle as i, type LegendOptions as j, type MenuCheckboxEntry as k, type MenuDialogEntry as l, type MenuEntry as m, type MenuGroups as n, type MenuHandle as o, type MenuRadioGroup as p, type MenuRadioOption as q, type PaletteReadOnlyState as r, type PaletteRegistration as s, type PrimaryActionHandle as t, type PrimaryActionOptions as u, type ProblemSummary as v, type ProblemsOptions as w, type ShellIconName as x, type StatusMessage as y, type StatusSeverity as z };