@miragon/modeler-shell 0.0.0-stage → 0.1.0

package/dist/types-B6NfkiUG.d.ts

@@ -0,0 +1,66 @@
+/** 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 islands (guide §5.2, §13.4). `primary` is reserved for the web app. */
+type ChromeIsland = "menu" | "palette" | "primary" | "zoom" | "problems" | "legend" | "inspector" | "status";
+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;
+}
+
+export { type Bounds as B, CHROME_ISLANDS as C, type Insets as I, type PaletteRow as P, type ScaledViewbox as S, type ViewportState as V, type ZoomTarget as Z, type ChromeIsland as a, type Point as b, type ShellHost as c, type Size as d };

package/dist/types-DnZn9CPw.d.ts

@@ -0,0 +1,284 @@
+import { c as ShellHost, Z as ZoomTarget, I as Insets } from './types-B6NfkiUG.js';
+import { P as Platform, d as ShellMessages, S as ShellMessageOverrides } from './keymap-DORzHnK-.js';
+import { T as Theme } from './appearance-D3FUcbu6.js';
+
+/*! @miragon/modeler-shell icon geometry
+ * Lucide (lucide-static 1.59.0) @license ISC
+ * Copyright (c) 2026 Lucide Icons and Contributors
+ * Derived from Feather, as Lucide's LICENSE lists them: check, circle-x (x-circle), maximize,
+ * minus, plus, triangle-alert (alert-triangle) and x. Feather @license MIT
+ * Copyright (c) 2013-present Cole Bemis
+ * Full notices: THIRD_PARTY_NOTICES.md of @miragon/modeler-shell */
+/** One Lucide icon: its SVG child elements on the 24 × 24 grid. */
+type IconNode = ReadonlyArray<readonly [tag: string, attributes: Readonly<Record<string, string>>]>;
+type ShellIconName = "menu" | "minus" | "plus" | "maximize" | "check" | "x" | "file-plus" | "folder-open" | "import" | "file-image" | "file-code-corner" | "keyboard" | "share-2" | "circle-x" | "triangle-alert" | "square-dashed-mouse-pointer" | "hand" | "line-segment" | "unfold-horizontal" | "workflow";
+declare const ICONS: Readonly<Record<ShellIconName, IconNode>>;
+interface IconOptions {
+    /** Rendered width and height in px; default 16 (chrome). */
+    size?: number;
+    /** Stroke width on the 24 grid; default 2.5. */
+    strokeWidth?: number;
+    className?: string;
+}
+/** Palette tool icons: 20px with stroke 2 (guide §5.5), as heavy as the 16px chrome icons. */
+declare const PALETTE_TOOL_ICON: Readonly<IconOptions>;
+/**
+ * Decorative inline SVG markup (`aria-hidden="true"`, `focusable="false"`, `fill="none"`,
+ * `stroke="currentColor"`, round caps and joins). Only Lucide's elements and geometry attributes
+ * pass, so the result is safe for `innerHTML` (palette entry `html`).
+ */
+declare function iconMarkup(icon: ShellIconName | IconNode, options?: IconOptions): string;
+/** The same icon as an `SVGSVGElement`. */
+declare function iconElement(icon: ShellIconName | IconNode, options?: IconOptions): SVGSVGElement;
+
+interface ShellOptions {
+    /** The host column of guide §5.2. */
+    host: ShellHost;
+    /**
+     * The element diagram-js renders into (for example a renderer's `modeler.container`). The shell
+     * moves it into its canvas slot and adds `cd-shell-canvas`. Omitted: the shell creates the slot,
+     * and the modeler is constructed with `container: handle.canvas`.
+     */
+    canvas?: HTMLElement | undefined;
+    /**
+     * The tool's UI language (BCP 47) for `Intl` and `<html lang>` (guide §2: one language per tool).
+     * Default in an own document (`ide`, `web`): the closest `[lang]` of the root, else `"en"`. In the
+     * `embedded` host the page's language is not the tool's, so the default is the root's own `lang`
+     * attribute, else `"en"`, and the root carries `lang` itself.
+     */
+    lang?: string | undefined;
+    messages?: ShellMessageOverrides | undefined;
+    /** Platform of the shortcut labels; default `detectPlatform(navigator)`. */
+    platform?: Platform | undefined;
+    /** Where the one `keydown` listener sits; default `document`, `root` in the `embedded` host. */
+    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>`.
+     */
+    themes?: readonly Theme[] | undefined;
+    /** The fixed menu groups this modeler fills (guide §5.4); omitted groups and empty ones collapse. */
+    menu?: MenuGroups | undefined;
+    /** The problems pill; omitted = the modeler has no diagnostics. */
+    problems?: ProblemsOptions | undefined;
+    /** The legend card; omitted = the notation has no legend. */
+    legend?: LegendOptions | undefined;
+    /** The inspector slot; omitted = the modeler has no inspector. */
+    inspector?: InspectorOptions | undefined;
+    /** The empty-file hint of IDE and embedded hosts (guide §13.5); omitted = no hint. */
+    emptyHint?: EmptyHintOptions | undefined;
+}
+/** Rendered in this order, separated by separators: Model, Export, Help (guide §5.4). */
+interface MenuGroups {
+    model?: readonly MenuEntry[] | undefined;
+    export?: readonly MenuEntry[] | undefined;
+    help?: readonly MenuEntry[] | undefined;
+}
+type MenuEntry = MenuActionEntry | MenuDialogEntry | MenuCheckboxEntry | MenuRadioGroup;
+interface MenuItemBase {
+    /** Stable id, rendered as `data-menu-id`. */
+    id: string;
+    label: string;
+    /** Only the entries the guide gives an icon (the common set, guide §5.14). */
+    icon?: ShellIconName | undefined;
+    /** Read whenever the menu opens or `refresh()` runs; disabled entries stay focusable. */
+    disabled?: (() => boolean) | undefined;
+    /**
+     * A Model entry that stays enabled on a read-only canvas: a view-only toggle that never touches
+     * the document (Legend, Type captions). Default `false`: the entry is aria-disabled while the
+     * canvas is read-only (guide §13.5). The shell's own Legend checkbox sets it.
+     */
+    keepEnabledWhenReadOnly?: boolean | undefined;
+}
+/** `menuitem`: closes the menu, returns focus to the trigger, then runs `onSelect`. */
+interface MenuActionEntry extends MenuItemBase {
+    kind: "action";
+    /** Shortcut chip text shown on the right, verbatim. */
+    shortcut?: string | undefined;
+    /**
+     * `aria-keyshortcuts` (WAI-ARIA names, guide §5.6); default `ariaKeyShortcutsFromLabel(shortcut)`.
+     * An empty string sets none.
+     */
+    ariaKeyShortcuts?: string | undefined;
+    /** Destructive: icon in `--cd-ui-danger` (confirm per guide §9 in `onSelect`). */
+    danger?: boolean | undefined;
+    onSelect(): void;
+}
+/**
+ * `menuitem` with `aria-haspopup="dialog"`; its label ends with "…" (U+2026). Behaves like an
+ * action: the menu closes and focus returns to the trigger before `onSelect` opens the dialog.
+ */
+interface MenuDialogEntry extends MenuItemBase {
+    kind: "dialog";
+    onSelect(): void;
+}
+/** `menuitemcheckbox`: toggles and keeps the menu open; the check mark carries the state. */
+interface MenuCheckboxEntry extends MenuItemBase {
+    kind: "checkbox";
+    checked(): boolean;
+    onToggle(checked: boolean): void;
+}
+/** A `role="group"` with a heading and `menuitemradio` entries; keeps the menu open. */
+interface MenuRadioGroup {
+    kind: "radio";
+    id: string;
+    /** Heading and group `aria-label`. */
+    label: string;
+    options: readonly MenuRadioOption[];
+    value(): string | undefined;
+    onSelect(value: string): void;
+    disabled?: (() => boolean) | undefined;
+    /** As `MenuItemBase.keepEnabledWhenReadOnly`. */
+    keepEnabledWhenReadOnly?: boolean | undefined;
+}
+interface MenuRadioOption {
+    value: string;
+    label: string;
+}
+interface ProblemsOptions {
+    /** A click on the pill: the IDE host opens its Problems view. */
+    onActivate(): void;
+}
+interface LegendOptions {
+    /** Renders the legend rows into `body` once (classes `cd-shell-legend-*`, see API.md). */
+    render(body: HTMLElement): void;
+    /** Start state the host remembered; default (also `undefined`) `legendStartsOpen(container height)`. */
+    open?: boolean | undefined;
+    /**
+     * Every change of the open state (close button, menu checkbox, `setOpen`, `toggle`), so the host
+     * can persist it; not the automatic start decision.
+     */
+    onToggle?: ((open: boolean) => void) | undefined;
+    /** Append the "Legend" checkbox to the Model group; default `true`. */
+    menuEntry?: boolean | undefined;
+}
+interface InspectorOptions {
+    /** `aria-label` of the inspector `<aside>`. */
+    label: string;
+}
+interface EmptyHintOptions {
+    /** Shows the "Insert example" button; the modeler writes the example as one document change. */
+    onInsertExample?: (() => void) | undefined;
+}
+interface ShellHandle {
+    /** The element passed to `mountShell`, now `.cd-shell`. */
+    readonly root: HTMLElement;
+    /** The canvas slot (`.cd-shell-canvas`), diagram-js's container. */
+    readonly canvas: HTMLElement;
+    readonly host: ShellHost;
+    readonly lang: string;
+    readonly platform: Platform;
+    /** The resolved messages table. */
+    readonly messages: ShellMessages;
+    readonly menu: MenuHandle;
+    readonly tooltip: TooltipHandle;
+    readonly legend: LegendHandle | undefined;
+    readonly inspector: InspectorHandle | 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). */
+    fitInsets(): Insets;
+    /** Adapter API: the diagram-js palette island; returns the unregister function. */
+    registerPalette(palette: PaletteRegistration): () => void;
+    /** Shows the pill for `count > 0`, hides it at 0. */
+    setProblems(summary: ProblemSummary): void;
+    /** Shows (after `delayMs`, default 0) or hides (at once) the status box under the palette. */
+    setStatus(status: StatusMessage | null, options?: {
+        delayMs?: number | undefined;
+    }): void;
+    /**
+     * Shows or hides the empty-file hint. `connectDiagramJs` keeps it in sync with the diagram
+     * (`ConnectOptions.isEmpty`). Hiding it while it holds the focus moves the focus to the canvas.
+     */
+    setEmptyHint(visible: boolean): void;
+    /**
+     * Read-only canvas (invalid file, guide §13.5). `true` locks at once: `isReadOnly()`, the palette
+     * veto (every entry but Lasso and Hand) and the Model entries of the menu without
+     * `keepEnabledWhenReadOnly`; the legend and its Legend checkbox stay usable. `data-readonly` and the
+     * `aria-disabled` palette entries show after `delayMs` (default 0; an invalid file passes
+     * `INVALID_STATUS_DELAY_MS`, as for `setStatus`), so typing in the text editor does not flicker.
+     * Repeated calls while the delay runs keep the first timer; `false` unlocks and hides at once.
+     */
+    setReadOnly(readOnly: boolean, options?: {
+        delayMs?: number | undefined;
+    }): void;
+    /** The lock, true from the first `setReadOnly(true)` on, also while its marks are still delayed. */
+    isReadOnly(): boolean;
+    /** Removes every element, attribute, listener, observer and timer the shell added. Idempotent. */
+    destroy(): void;
+}
+interface MenuHandle {
+    readonly trigger: HTMLButtonElement;
+    readonly dropdown: HTMLElement;
+    isOpen(): boolean;
+    /** Opens on the first (default) or last entry. */
+    open(focus?: "first" | "last"): void;
+    /** Closes; `restoreFocus` moves focus back to the trigger (default `false`). */
+    close(options?: {
+        restoreFocus?: boolean | undefined;
+    }): void;
+    /** Re-reads `checked`, `value` and `disabled` (call after an external state change). */
+    refresh(): void;
+    setGroups(groups: MenuGroups): void;
+}
+interface TooltipContent {
+    label: string;
+    /** Shortcut chip text, verbatim (`⌘+`). */
+    shortcut?: string | undefined;
+}
+interface TooltipHandle {
+    /**
+     * The chrome tooltip for `control`: after `TOOLTIP_DELAY_MS` hover, at once on keyboard focus,
+     * hidden on click, Escape, leave and menu open. Returns the detach function.
+     */
+    attach(control: HTMLElement, content: TooltipContent | (() => TooltipContent | null)): () => void;
+    hide(): void;
+}
+interface LegendHandle {
+    /** The legend card (`[data-chrome="legend"]`). */
+    readonly element: HTMLElement;
+    /** Where `render` put the rows. */
+    readonly body: HTMLElement;
+    isOpen(): boolean;
+    setOpen(open: boolean): void;
+    toggle(): void;
+}
+interface InspectorHandle {
+    /** The `<aside data-chrome="inspector">`; the modeler renders its fields into it. */
+    readonly element: HTMLElement;
+    isOpen(): boolean;
+    open(): void;
+    /** Closes; a focus inside it moves to the canvas. */
+    close(): void;
+}
+/** What the diagram-js adapter hands the shell about the palette. */
+interface PaletteRegistration {
+    /** The `.djs-palette` element (already carrying `data-chrome="palette"`). */
+    element: HTMLElement;
+    /** Tooltip of an entry element (`.entry`), from `palette.getEntries()` title and shortcut. */
+    entryTooltip(entry: HTMLElement): TooltipContent | null;
+    /** The read-only state, on registration and on every `setReadOnly` and its delayed marks. */
+    setReadOnly(state: PaletteReadOnlyState): void;
+}
+/** The read-only canvas as the palette sees it (guide §13.5). */
+interface PaletteReadOnlyState {
+    /** Veto every entry but Lasso and Hand on `palette.trigger`, from the invalid import on. */
+    locked: boolean;
+    /** Mark those entries `aria-disabled` and muted, once the shell's delay has passed. */
+    shown: boolean;
+}
+interface ProblemSummary {
+    count: number;
+    /** How many of them are errors; decides icon and wording. */
+    errors: number;
+}
+type StatusSeverity = "danger" | "warning";
+interface StatusMessage {
+    severity: StatusSeverity;
+    text: string;
+}
+
+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 };

package/dist/types-OuFlqZp0.d.cts

@@ -0,0 +1,284 @@
+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 { T as Theme } from './appearance-D3FUcbu6.cjs';
+
+/*! @miragon/modeler-shell icon geometry
+ * Lucide (lucide-static 1.59.0) @license ISC
+ * Copyright (c) 2026 Lucide Icons and Contributors
+ * Derived from Feather, as Lucide's LICENSE lists them: check, circle-x (x-circle), maximize,
+ * minus, plus, triangle-alert (alert-triangle) and x. Feather @license MIT
+ * Copyright (c) 2013-present Cole Bemis
+ * Full notices: THIRD_PARTY_NOTICES.md of @miragon/modeler-shell */
+/** One Lucide icon: its SVG child elements on the 24 × 24 grid. */
+type IconNode = ReadonlyArray<readonly [tag: string, attributes: Readonly<Record<string, string>>]>;
+type ShellIconName = "menu" | "minus" | "plus" | "maximize" | "check" | "x" | "file-plus" | "folder-open" | "import" | "file-image" | "file-code-corner" | "keyboard" | "share-2" | "circle-x" | "triangle-alert" | "square-dashed-mouse-pointer" | "hand" | "line-segment" | "unfold-horizontal" | "workflow";
+declare const ICONS: Readonly<Record<ShellIconName, IconNode>>;
+interface IconOptions {
+    /** Rendered width and height in px; default 16 (chrome). */
+    size?: number;
+    /** Stroke width on the 24 grid; default 2.5. */
+    strokeWidth?: number;
+    className?: string;
+}
+/** Palette tool icons: 20px with stroke 2 (guide §5.5), as heavy as the 16px chrome icons. */
+declare const PALETTE_TOOL_ICON: Readonly<IconOptions>;
+/**
+ * Decorative inline SVG markup (`aria-hidden="true"`, `focusable="false"`, `fill="none"`,
+ * `stroke="currentColor"`, round caps and joins). Only Lucide's elements and geometry attributes
+ * pass, so the result is safe for `innerHTML` (palette entry `html`).
+ */
+declare function iconMarkup(icon: ShellIconName | IconNode, options?: IconOptions): string;
+/** The same icon as an `SVGSVGElement`. */
+declare function iconElement(icon: ShellIconName | IconNode, options?: IconOptions): SVGSVGElement;
+
+interface ShellOptions {
+    /** The host column of guide §5.2. */
+    host: ShellHost;
+    /**
+     * The element diagram-js renders into (for example a renderer's `modeler.container`). The shell
+     * moves it into its canvas slot and adds `cd-shell-canvas`. Omitted: the shell creates the slot,
+     * and the modeler is constructed with `container: handle.canvas`.
+     */
+    canvas?: HTMLElement | undefined;
+    /**
+     * The tool's UI language (BCP 47) for `Intl` and `<html lang>` (guide §2: one language per tool).
+     * Default in an own document (`ide`, `web`): the closest `[lang]` of the root, else `"en"`. In the
+     * `embedded` host the page's language is not the tool's, so the default is the root's own `lang`
+     * attribute, else `"en"`, and the root carries `lang` itself.
+     */
+    lang?: string | undefined;
+    messages?: ShellMessageOverrides | undefined;
+    /** Platform of the shortcut labels; default `detectPlatform(navigator)`. */
+    platform?: Platform | undefined;
+    /** Where the one `keydown` listener sits; default `document`, `root` in the `embedded` host. */
+    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>`.
+     */
+    themes?: readonly Theme[] | undefined;
+    /** The fixed menu groups this modeler fills (guide §5.4); omitted groups and empty ones collapse. */
+    menu?: MenuGroups | undefined;
+    /** The problems pill; omitted = the modeler has no diagnostics. */
+    problems?: ProblemsOptions | undefined;
+    /** The legend card; omitted = the notation has no legend. */
+    legend?: LegendOptions | undefined;
+    /** The inspector slot; omitted = the modeler has no inspector. */
+    inspector?: InspectorOptions | undefined;
+    /** The empty-file hint of IDE and embedded hosts (guide §13.5); omitted = no hint. */
+    emptyHint?: EmptyHintOptions | undefined;
+}
+/** Rendered in this order, separated by separators: Model, Export, Help (guide §5.4). */
+interface MenuGroups {
+    model?: readonly MenuEntry[] | undefined;
+    export?: readonly MenuEntry[] | undefined;
+    help?: readonly MenuEntry[] | undefined;
+}
+type MenuEntry = MenuActionEntry | MenuDialogEntry | MenuCheckboxEntry | MenuRadioGroup;
+interface MenuItemBase {
+    /** Stable id, rendered as `data-menu-id`. */
+    id: string;
+    label: string;
+    /** Only the entries the guide gives an icon (the common set, guide §5.14). */
+    icon?: ShellIconName | undefined;
+    /** Read whenever the menu opens or `refresh()` runs; disabled entries stay focusable. */
+    disabled?: (() => boolean) | undefined;
+    /**
+     * A Model entry that stays enabled on a read-only canvas: a view-only toggle that never touches
+     * the document (Legend, Type captions). Default `false`: the entry is aria-disabled while the
+     * canvas is read-only (guide §13.5). The shell's own Legend checkbox sets it.
+     */
+    keepEnabledWhenReadOnly?: boolean | undefined;
+}
+/** `menuitem`: closes the menu, returns focus to the trigger, then runs `onSelect`. */
+interface MenuActionEntry extends MenuItemBase {
+    kind: "action";
+    /** Shortcut chip text shown on the right, verbatim. */
+    shortcut?: string | undefined;
+    /**
+     * `aria-keyshortcuts` (WAI-ARIA names, guide §5.6); default `ariaKeyShortcutsFromLabel(shortcut)`.
+     * An empty string sets none.
+     */
+    ariaKeyShortcuts?: string | undefined;
+    /** Destructive: icon in `--cd-ui-danger` (confirm per guide §9 in `onSelect`). */
+    danger?: boolean | undefined;
+    onSelect(): void;
+}
+/**
+ * `menuitem` with `aria-haspopup="dialog"`; its label ends with "…" (U+2026). Behaves like an
+ * action: the menu closes and focus returns to the trigger before `onSelect` opens the dialog.
+ */
+interface MenuDialogEntry extends MenuItemBase {
+    kind: "dialog";
+    onSelect(): void;
+}
+/** `menuitemcheckbox`: toggles and keeps the menu open; the check mark carries the state. */
+interface MenuCheckboxEntry extends MenuItemBase {
+    kind: "checkbox";
+    checked(): boolean;
+    onToggle(checked: boolean): void;
+}
+/** A `role="group"` with a heading and `menuitemradio` entries; keeps the menu open. */
+interface MenuRadioGroup {
+    kind: "radio";
+    id: string;
+    /** Heading and group `aria-label`. */
+    label: string;
+    options: readonly MenuRadioOption[];
+    value(): string | undefined;
+    onSelect(value: string): void;
+    disabled?: (() => boolean) | undefined;
+    /** As `MenuItemBase.keepEnabledWhenReadOnly`. */
+    keepEnabledWhenReadOnly?: boolean | undefined;
+}
+interface MenuRadioOption {
+    value: string;
+    label: string;
+}
+interface ProblemsOptions {
+    /** A click on the pill: the IDE host opens its Problems view. */
+    onActivate(): void;
+}
+interface LegendOptions {
+    /** Renders the legend rows into `body` once (classes `cd-shell-legend-*`, see API.md). */
+    render(body: HTMLElement): void;
+    /** Start state the host remembered; default (also `undefined`) `legendStartsOpen(container height)`. */
+    open?: boolean | undefined;
+    /**
+     * Every change of the open state (close button, menu checkbox, `setOpen`, `toggle`), so the host
+     * can persist it; not the automatic start decision.
+     */
+    onToggle?: ((open: boolean) => void) | undefined;
+    /** Append the "Legend" checkbox to the Model group; default `true`. */
+    menuEntry?: boolean | undefined;
+}
+interface InspectorOptions {
+    /** `aria-label` of the inspector `<aside>`. */
+    label: string;
+}
+interface EmptyHintOptions {
+    /** Shows the "Insert example" button; the modeler writes the example as one document change. */
+    onInsertExample?: (() => void) | undefined;
+}
+interface ShellHandle {
+    /** The element passed to `mountShell`, now `.cd-shell`. */
+    readonly root: HTMLElement;
+    /** The canvas slot (`.cd-shell-canvas`), diagram-js's container. */
+    readonly canvas: HTMLElement;
+    readonly host: ShellHost;
+    readonly lang: string;
+    readonly platform: Platform;
+    /** The resolved messages table. */
+    readonly messages: ShellMessages;
+    readonly menu: MenuHandle;
+    readonly tooltip: TooltipHandle;
+    readonly legend: LegendHandle | undefined;
+    readonly inspector: InspectorHandle | 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). */
+    fitInsets(): Insets;
+    /** Adapter API: the diagram-js palette island; returns the unregister function. */
+    registerPalette(palette: PaletteRegistration): () => void;
+    /** Shows the pill for `count > 0`, hides it at 0. */
+    setProblems(summary: ProblemSummary): void;
+    /** Shows (after `delayMs`, default 0) or hides (at once) the status box under the palette. */
+    setStatus(status: StatusMessage | null, options?: {
+        delayMs?: number | undefined;
+    }): void;
+    /**
+     * Shows or hides the empty-file hint. `connectDiagramJs` keeps it in sync with the diagram
+     * (`ConnectOptions.isEmpty`). Hiding it while it holds the focus moves the focus to the canvas.
+     */
+    setEmptyHint(visible: boolean): void;
+    /**
+     * Read-only canvas (invalid file, guide §13.5). `true` locks at once: `isReadOnly()`, the palette
+     * veto (every entry but Lasso and Hand) and the Model entries of the menu without
+     * `keepEnabledWhenReadOnly`; the legend and its Legend checkbox stay usable. `data-readonly` and the
+     * `aria-disabled` palette entries show after `delayMs` (default 0; an invalid file passes
+     * `INVALID_STATUS_DELAY_MS`, as for `setStatus`), so typing in the text editor does not flicker.
+     * Repeated calls while the delay runs keep the first timer; `false` unlocks and hides at once.
+     */
+    setReadOnly(readOnly: boolean, options?: {
+        delayMs?: number | undefined;
+    }): void;
+    /** The lock, true from the first `setReadOnly(true)` on, also while its marks are still delayed. */
+    isReadOnly(): boolean;
+    /** Removes every element, attribute, listener, observer and timer the shell added. Idempotent. */
+    destroy(): void;
+}
+interface MenuHandle {
+    readonly trigger: HTMLButtonElement;
+    readonly dropdown: HTMLElement;
+    isOpen(): boolean;
+    /** Opens on the first (default) or last entry. */
+    open(focus?: "first" | "last"): void;
+    /** Closes; `restoreFocus` moves focus back to the trigger (default `false`). */
+    close(options?: {
+        restoreFocus?: boolean | undefined;
+    }): void;
+    /** Re-reads `checked`, `value` and `disabled` (call after an external state change). */
+    refresh(): void;
+    setGroups(groups: MenuGroups): void;
+}
+interface TooltipContent {
+    label: string;
+    /** Shortcut chip text, verbatim (`⌘+`). */
+    shortcut?: string | undefined;
+}
+interface TooltipHandle {
+    /**
+     * The chrome tooltip for `control`: after `TOOLTIP_DELAY_MS` hover, at once on keyboard focus,
+     * hidden on click, Escape, leave and menu open. Returns the detach function.
+     */
+    attach(control: HTMLElement, content: TooltipContent | (() => TooltipContent | null)): () => void;
+    hide(): void;
+}
+interface LegendHandle {
+    /** The legend card (`[data-chrome="legend"]`). */
+    readonly element: HTMLElement;
+    /** Where `render` put the rows. */
+    readonly body: HTMLElement;
+    isOpen(): boolean;
+    setOpen(open: boolean): void;
+    toggle(): void;
+}
+interface InspectorHandle {
+    /** The `<aside data-chrome="inspector">`; the modeler renders its fields into it. */
+    readonly element: HTMLElement;
+    isOpen(): boolean;
+    open(): void;
+    /** Closes; a focus inside it moves to the canvas. */
+    close(): void;
+}
+/** What the diagram-js adapter hands the shell about the palette. */
+interface PaletteRegistration {
+    /** The `.djs-palette` element (already carrying `data-chrome="palette"`). */
+    element: HTMLElement;
+    /** Tooltip of an entry element (`.entry`), from `palette.getEntries()` title and shortcut. */
+    entryTooltip(entry: HTMLElement): TooltipContent | null;
+    /** The read-only state, on registration and on every `setReadOnly` and its delayed marks. */
+    setReadOnly(state: PaletteReadOnlyState): void;
+}
+/** The read-only canvas as the palette sees it (guide §13.5). */
+interface PaletteReadOnlyState {
+    /** Veto every entry but Lasso and Hand on `palette.trigger`, from the invalid import on. */
+    locked: boolean;
+    /** Mark those entries `aria-disabled` and muted, once the shell's delay has passed. */
+    shown: boolean;
+}
+interface ProblemSummary {
+    count: number;
+    /** How many of them are errors; decides icon and wording. */
+    errors: number;
+}
+type StatusSeverity = "danger" | "warning";
+interface StatusMessage {
+    severity: StatusSeverity;
+    text: string;
+}
+
+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 };