@itwin/appui-react 4.17.1 → 5.0.0-dev.2

package/lib/appui-react/popup/PositionPopup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PositionPopup.js","sourceRoot":"","sources":["../../../src/appui-react/popup/PositionPopup.tsx"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG;AAEH,OAAO,sBAAsB,CAAC;AAC9B,OAAO,UAAU,MAAM,YAAY,CAAC;AACpC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAexC;WACW;AACX,MAAM,OAAO,aAAc,SAAQ,KAAK,CAAC,aAAiC;IACxE,YAAY,KAAyB;QACnC,KAAK,CAAC,KAAK,CAAC,CAAC;IACf,CAAC;IAEe,MAAM;QACpB,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QAEtE,MAAM,QAAQ,GAAwB;YACpC,GAAG,KAAK;YACR,GAAG,EAAE,KAAK,CAAC,CAAC;YACZ,IAAI,EAAE,KAAK,CAAC,CAAC;SACd,CAAC;QAEF,OAAO,CACL,gCACM,KAAK,EACT,SAAS,EAAE,UAAU,CAAC,qBAAqB,EAAE,SAAS,CAAC,EACvD,KAAK,EAAE,QAAQ,EACf,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAE5B,IAAI,CAAC,KAAK,CAAC,QAAQ,CAChB,CACP,CAAC;IACJ,CAAC;IAEO,SAAS,CAAC,GAA0B;QAC1C,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,IAAI,GAAG,GAAG,CAAC,qBAAqB,EAAE,CAAC;YACzC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;gBACvB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,mDAAmD;AACnD,MAAM,UAAU,oBAAoB,CAAC,KAAqB;IACxD,mDAAmD;IACnD,OAAO,oBAAC,GAAG,OAAK,KAAK,EAAE,aAAa,EAAC,6BAA6B,GAAG,CAAC;AACxE,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Popup\n */\n\nimport \"./PositionPopup.scss\";\nimport classnames from \"classnames\";\nimport * as React from \"react\";\nimport type { XAndY } from \"@itwin/core-geometry\";\nimport type { CommonDivProps, CommonProps } from \"@itwin/core-react\";\nimport { Div } from \"@itwin/core-react\";\nimport type { SizeProps } from \"../utils/SizeProps.js\";\n\n/** Props for popup at screen position\n * @beta */\n// eslint-disable-next-line deprecation/deprecation\nexport interface PositionPopupProps extends CommonProps {\n  /** Center point */\n  point: XAndY;\n  /** Function called when size is known. */\n  onSizeKnown?: (size: SizeProps) => void;\n  /** Content */\n  children?: React.ReactNode;\n}\n\n/** Popup component at screen position\n * @beta */\nexport class PositionPopup extends React.PureComponent<PositionPopupProps> {\n  constructor(props: PositionPopupProps) {\n    super(props);\n  }\n\n  public override render() {\n    const { point, className, style, onSizeKnown, ...props } = this.props;\n\n    const divStyle: React.CSSProperties = {\n      ...style,\n      top: point.y,\n      left: point.x,\n    };\n\n    return (\n      <div\n        {...props}\n        className={classnames(\"uifw-position-popup\", className)}\n        style={divStyle}\n        ref={(e) => this.setDivRef(e)}\n      >\n        {this.props.children}\n      </div>\n    );\n  }\n\n  private setDivRef(div: HTMLDivElement | null) {\n    if (div) {\n      const rect = div.getBoundingClientRect();\n      this.props.onSizeKnown?.({\n        width: rect.width,\n        height: rect.height,\n      });\n    }\n  }\n}\n\n/** PositionPopup content with padding\n * @beta\n */\n// eslint-disable-next-line deprecation/deprecation\nexport function PositionPopupContent(props: CommonDivProps) {\n  // eslint-disable-next-line deprecation/deprecation\n  return <Div {...props} mainClassName=\"uifw-position-popup-content\" />;\n}\n"]}

package/lib/appui-react/popup/PositionPopup.scss

@@ -0,0 +1,27 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+@use "../variables" as *;
+
+.uifw-position-popup {
+  border: {
+    color: $uifw-popup-border-color;
+    radius: $uifw-popup-border-radius;
+    style: solid;
+    width: $uifw-popup-border-width;
+  }
+
+  background-color: hsl(var(--iui-color-background-hsl) / $uifw-popup-opacity);
+  position: fixed;
+  height: fit-content;
+  width: fit-content;
+
+  .uifw-position-popup-content {
+    padding: $uifw-popup-content-padding;
+  }
+
+  &.uifw-no-border {
+    border-width: 0;
+  }
+}

package/lib/appui-react/popup/ToolSettingsPopup.d.ts

@@ -0,0 +1,36 @@
+/** @packageDocumentation
+ * @module Popup
+ */
+import * as React from "react";
+import type { DialogLayoutDataProvider, OnCancelFunc, RelativePosition } from "@itwin/appui-abstract";
+import type { Orientation } from "@itwin/components-react";
+import type { PopupPropsBase } from "./PopupManager.js";
+import type { SizeProps } from "../utils/SizeProps.js";
+/** Props for defining a popup tool settings component
+ * @beta */
+export interface ToolSettingsPopupProps extends PopupPropsBase {
+    dataProvider: DialogLayoutDataProvider;
+    relativePosition: RelativePosition;
+    orientation: Orientation;
+    onCancel: OnCancelFunc;
+}
+interface ToolSettingsPopupState {
+    size: SizeProps;
+}
+/** Popup component for Tool Settings
+ * @beta
+ */
+export declare class ToolSettingsPopup extends React.PureComponent<ToolSettingsPopupProps, ToolSettingsPopupState> {
+    readonly state: {
+        size: {
+            width: number;
+            height: number;
+        };
+    };
+    constructor(props: ToolSettingsPopupProps);
+    private _onSizeKnown;
+    private _handleKeyDown;
+    render(): React.JSX.Element;
+}
+export {};
+//# sourceMappingURL=ToolSettingsPopup.d.ts.map

package/lib/appui-react/popup/ToolSettingsPopup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolSettingsPopup.d.ts","sourceRoot":"","sources":["../../../src/appui-react/popup/ToolSettingsPopup.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EACV,wBAAwB,EACxB,YAAY,EACZ,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAI3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAKxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD;WACW;AACX,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC5D,YAAY,EAAE,wBAAwB,CAAC;IACvC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED,UAAU,sBAAsB;IAC9B,IAAI,EAAE,SAAS,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,KAAK,CAAC,aAAa,CACxD,sBAAsB,EACtB,sBAAsB,CACvB;IACC,SAAyB,KAAK;;;;;MAE5B;gBAEU,KAAK,EAAE,sBAAsB;IAIzC,OAAO,CAAC,YAAY,CAOlB;IAEF,OAAO,CAAC,cAAc,CAMpB;IAEc,MAAM;CAyCvB"}

package/lib/appui-react/popup/ToolSettingsPopup.js

@@ -0,0 +1,52 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Popup
+ */
+import * as React from "react";
+import { Key } from "ts-key-enum";
+import { DivWithOutsideClick } from "@itwin/core-react";
+import { FocusTrap, Point } from "@itwin/core-react/internal";
+import { CursorPopup } from "../cursor/cursorpopup/CursorPopup.js";
+import { PopupManager } from "./PopupManager.js";
+import { PositionPopup, PositionPopupContent } from "./PositionPopup.js";
+import { ComponentGenerator } from "../uiprovider/ComponentGenerator.js";
+import { DialogGridContainer } from "../uiprovider/DefaultDialogGridContainer.js";
+/** Popup component for Tool Settings
+ * @beta
+ */
+export class ToolSettingsPopup extends React.PureComponent {
+    constructor(props) {
+        super(props);
+        this.state = {
+            size: { width: -1, height: -1 },
+        };
+        this._onSizeKnown = (newSize) => {
+            if (newSize.height === this.state.size.height &&
+                newSize.width === this.state.size.width)
+                return;
+            this.setState({ size: newSize });
+        };
+        this._handleKeyDown = (e) => {
+            switch (e.key) {
+                case Key.Escape.valueOf():
+                    if (this.props.onCancel)
+                        this.props.onCancel();
+                    break;
+            }
+        };
+    }
+    render() {
+        const componentGenerator = new ComponentGenerator(this.props.dataProvider, this.props.onCancel);
+        let point = PopupManager.getPopupPosition(this.props.el, this.props.pt, new Point(), this.state.size);
+        const popupRect = CursorPopup.getPopupRect(point, this.props.offset, this.state.size, this.props.relativePosition);
+        point = new Point(popupRect.left, popupRect.top);
+        return (React.createElement(PositionPopup, { key: this.props.id, point: point, onSizeKnown: this._onSizeKnown },
+            React.createElement(DivWithOutsideClick, { onOutsideClick: this.props.onCancel, onKeyDown: this._handleKeyDown },
+                React.createElement(PositionPopupContent, null,
+                    React.createElement(FocusTrap, { active: true, returnFocusOnDeactivate: true }, componentGenerator && (React.createElement(DialogGridContainer, { componentGenerator: componentGenerator })))))));
+    }
+}
+//# sourceMappingURL=ToolSettingsPopup.js.map

package/lib/appui-react/popup/ToolSettingsPopup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolSettingsPopup.js","sourceRoot":"","sources":["../../../src/appui-react/popup/ToolSettingsPopup.tsx"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Popup\n */\n\nimport * as React from \"react\";\nimport { Key } from \"ts-key-enum\";\nimport type {\n  DialogLayoutDataProvider,\n  OnCancelFunc,\n  RelativePosition,\n} from \"@itwin/appui-abstract\";\nimport type { Orientation } from \"@itwin/components-react\";\nimport { DivWithOutsideClick } from \"@itwin/core-react\";\nimport { FocusTrap, Point } from \"@itwin/core-react/internal\";\nimport { CursorPopup } from \"../cursor/cursorpopup/CursorPopup.js\";\nimport type { PopupPropsBase } from \"./PopupManager.js\";\nimport { PopupManager } from \"./PopupManager.js\";\nimport { PositionPopup, PositionPopupContent } from \"./PositionPopup.js\";\nimport { ComponentGenerator } from \"../uiprovider/ComponentGenerator.js\";\nimport { DialogGridContainer } from \"../uiprovider/DefaultDialogGridContainer.js\";\nimport type { SizeProps } from \"../utils/SizeProps.js\";\n\n/** Props for defining a popup tool settings component\n * @beta */\nexport interface ToolSettingsPopupProps extends PopupPropsBase {\n  dataProvider: DialogLayoutDataProvider;\n  relativePosition: RelativePosition;\n  orientation: Orientation;\n  onCancel: OnCancelFunc;\n}\n\ninterface ToolSettingsPopupState {\n  size: SizeProps;\n}\n\n/** Popup component for Tool Settings\n * @beta\n */\nexport class ToolSettingsPopup extends React.PureComponent<\n  ToolSettingsPopupProps,\n  ToolSettingsPopupState\n> {\n  public override readonly state = {\n    size: { width: -1, height: -1 },\n  };\n\n  constructor(props: ToolSettingsPopupProps) {\n    super(props);\n  }\n\n  private _onSizeKnown = (newSize: SizeProps) => {\n    if (\n      newSize.height === this.state.size.height &&\n      newSize.width === this.state.size.width\n    )\n      return;\n    this.setState({ size: newSize });\n  };\n\n  private _handleKeyDown = (e: React.KeyboardEvent) => {\n    switch (e.key) {\n      case Key.Escape.valueOf():\n        if (this.props.onCancel) this.props.onCancel();\n        break;\n    }\n  };\n\n  public override render() {\n    const componentGenerator = new ComponentGenerator(\n      this.props.dataProvider,\n      this.props.onCancel\n    );\n    let point = PopupManager.getPopupPosition(\n      this.props.el,\n      this.props.pt,\n      new Point(),\n      this.state.size\n    );\n    const popupRect = CursorPopup.getPopupRect(\n      point,\n      this.props.offset,\n      this.state.size,\n      this.props.relativePosition\n    );\n    point = new Point(popupRect.left, popupRect.top);\n\n    return (\n      <PositionPopup\n        key={this.props.id}\n        point={point}\n        onSizeKnown={this._onSizeKnown}\n      >\n        {/* eslint-disable-next-line deprecation/deprecation */}\n        <DivWithOutsideClick\n          onOutsideClick={this.props.onCancel}\n          onKeyDown={this._handleKeyDown}\n        >\n          <PositionPopupContent>\n            <FocusTrap active={true} returnFocusOnDeactivate={true}>\n              {componentGenerator && (\n                <DialogGridContainer componentGenerator={componentGenerator} />\n              )}\n            </FocusTrap>\n          </PositionPopupContent>\n        </DivWithOutsideClick>\n      </PositionPopup>\n    );\n  }\n}\n"]}

package/lib/appui-react/popup/ToolbarPopup.d.ts

@@ -0,0 +1,50 @@
+/** @packageDocumentation
+ * @module Popup
+ */
+import * as React from "react";
+import type { RelativePosition } from "@itwin/appui-abstract";
+import type { RequireAtLeastOne } from "@itwin/core-bentley";
+import type { Orientation } from "@itwin/components-react";
+import type { PopupPropsBase } from "./PopupManager.js";
+import type { ToolbarItem } from "../toolbar/ToolbarItem.js";
+import { WrapperContext } from "../configurableui/ConfigurableUiContent.js";
+import { type Placement } from "../utils/Placement.js";
+import type { SizeProps } from "../utils/SizeProps.js";
+/** Props for a popup toolbar
+ * @beta
+ */
+export type ToolbarPopupProps = Omit<PopupPropsBase, "el"> & {
+    items: ToolbarItem[];
+    orientation: Orientation;
+    onCancel: () => void;
+    onItemExecuted: (item: any) => void;
+    el?: HTMLElement;
+} & RequireAtLeastOne<{
+    /** @deprecated in 4.16.0. Use `placement` property instead. */
+    relativePosition: RelativePosition;
+    placement: Placement;
+}>;
+interface ToolbarPopupState {
+    size: SizeProps;
+}
+/** Popup component for Toolbar
+ * @beta
+ */
+export declare class ToolbarPopup extends React.PureComponent<ToolbarPopupProps, ToolbarPopupState> {
+    /** @internal */
+    static contextType: React.Context<HTMLElement>;
+    /** @internal */
+    context: React.ContextType<typeof WrapperContext>;
+    readonly state: {
+        size: {
+            width: number;
+            height: number;
+        };
+    };
+    private _onSizeKnown;
+    private _handleKeyDown;
+    private _cancel;
+    render(): React.JSX.Element;
+}
+export {};
+//# sourceMappingURL=ToolbarPopup.d.ts.map

package/lib/appui-react/popup/ToolbarPopup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolbarPopup.d.ts","sourceRoot":"","sources":["../../../src/appui-react/popup/ToolbarPopup.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAO3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,OAAO,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAC5E,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,GAAG;IAC3D,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,cAAc,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;IACpC,EAAE,CAAC,EAAE,WAAW,CAAC;CAClB,GAAG,iBAAiB,CAAC;IAClB,+DAA+D;IAC/D,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,SAAS,EAAE,SAAS,CAAC;CACtB,CAAC,CAAC;AAEL,UAAU,iBAAiB;IACzB,IAAI,EAAE,SAAS,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK,CAAC,aAAa,CACnD,iBAAiB,EACjB,iBAAiB,CAClB;IACC,gBAAgB;IAChB,OAAuB,WAAW,6BAAkB;IACpD,gBAAgB;IACD,OAAO,EAAE,KAAK,CAAC,WAAW,CAAC,OAAO,cAAc,CAAC,CAAC;IAEjE,SAAyB,KAAK;;;;;MAE5B;IAEF,OAAO,CAAC,YAAY,CAOlB;IAEF,OAAO,CAAC,cAAc,CAQpB;IAEF,OAAO,CAAC,OAAO;IAMC,MAAM;CAyCvB"}

package/lib/appui-react/popup/ToolbarPopup.js

@@ -0,0 +1,61 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Popup
+ */
+import * as React from "react";
+import { Key } from "ts-key-enum";
+import { DivWithOutsideClick } from "@itwin/core-react";
+import { FocusTrap, Point } from "@itwin/core-react/internal";
+import { Direction, ToolbarOpacitySetting, ToolbarPanelAlignment, } from "@itwin/components-react";
+import { CursorPopup } from "../cursor/cursorpopup/CursorPopup.js";
+import { PopupManager } from "./PopupManager.js";
+import { PositionPopup } from "./PositionPopup.js";
+import { Toolbar } from "../toolbar/Toolbar.js";
+import { WrapperContext } from "../configurableui/ConfigurableUiContent.js";
+import { mapToPlacement } from "../utils/Placement.js";
+/** Popup component for Toolbar
+ * @beta
+ */
+export class ToolbarPopup extends React.PureComponent {
+    constructor() {
+        super(...arguments);
+        this.state = {
+            size: { width: -1, height: -1 },
+        };
+        this._onSizeKnown = (newSize) => {
+            if (this.state.size.width === newSize.width &&
+                this.state.size.height === newSize.height)
+                return;
+            this.setState({ size: newSize });
+        };
+        this._handleKeyDown = (event) => {
+            switch (event.key) {
+                case Key.Escape.valueOf():
+                    this._cancel();
+                    break;
+            }
+        };
+    }
+    _cancel() {
+        if (this.props.onCancel) {
+            this.props.onCancel();
+        }
+    }
+    render() {
+        let point = PopupManager.getPopupPosition(this.props.el ?? this.context, this.props.pt, new Point(), this.state.size);
+        const popupRect = CursorPopup.getPopupRect(point, this.props.offset, this.state.size, 
+        // eslint-disable-next-line deprecation/deprecation
+        this.props.placement ?? mapToPlacement(this.props.relativePosition));
+        point = new Point(popupRect.left, popupRect.top);
+        return (React.createElement(PositionPopup, { key: this.props.id, className: "uifw-no-border", point: point, onSizeKnown: this._onSizeKnown },
+            React.createElement(DivWithOutsideClick, { onOutsideClick: this.props.onCancel, onKeyDown: this._handleKeyDown },
+                React.createElement(FocusTrap, { active: true, returnFocusOnDeactivate: true },
+                    React.createElement(Toolbar, { expandsTo: Direction.Bottom, panelAlignment: ToolbarPanelAlignment.Start, items: this.props.items, useDragInteraction: true, toolbarOpacitySetting: ToolbarOpacitySetting.Defaults, onItemExecuted: this.props.onItemExecuted })))));
+    }
+}
+/** @internal */
+ToolbarPopup.contextType = WrapperContext;
+//# sourceMappingURL=ToolbarPopup.js.map

package/lib/appui-react/popup/ToolbarPopup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolbarPopup.js","sourceRoot":"","sources":["../../../src/appui-react/popup/ToolbarPopup.tsx"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Popup\n */\n\nimport * as React from \"react\";\nimport { Key } from \"ts-key-enum\";\nimport type { RelativePosition } from \"@itwin/appui-abstract\";\nimport type { RequireAtLeastOne } from \"@itwin/core-bentley\";\nimport { DivWithOutsideClick } from \"@itwin/core-react\";\nimport { FocusTrap, Point } from \"@itwin/core-react/internal\";\nimport type { Orientation } from \"@itwin/components-react\";\nimport {\n  Direction,\n  ToolbarOpacitySetting,\n  ToolbarPanelAlignment,\n} from \"@itwin/components-react\";\nimport { CursorPopup } from \"../cursor/cursorpopup/CursorPopup.js\";\nimport type { PopupPropsBase } from \"./PopupManager.js\";\nimport { PopupManager } from \"./PopupManager.js\";\nimport { PositionPopup } from \"./PositionPopup.js\";\nimport type { ToolbarItem } from \"../toolbar/ToolbarItem.js\";\nimport { Toolbar } from \"../toolbar/Toolbar.js\";\nimport { WrapperContext } from \"../configurableui/ConfigurableUiContent.js\";\nimport { mapToPlacement, type Placement } from \"../utils/Placement.js\";\nimport type { SizeProps } from \"../utils/SizeProps.js\";\n\n/** Props for a popup toolbar\n * @beta\n */\nexport type ToolbarPopupProps = Omit<PopupPropsBase, \"el\"> & {\n  items: ToolbarItem[];\n  orientation: Orientation;\n  onCancel: () => void;\n  onItemExecuted: (item: any) => void;\n  el?: HTMLElement;\n} & RequireAtLeastOne<{\n    /** @deprecated in 4.16.0. Use `placement` property instead. */\n    relativePosition: RelativePosition;\n    placement: Placement;\n  }>;\n\ninterface ToolbarPopupState {\n  size: SizeProps;\n}\n\n/** Popup component for Toolbar\n * @beta\n */\nexport class ToolbarPopup extends React.PureComponent<\n  ToolbarPopupProps,\n  ToolbarPopupState\n> {\n  /** @internal */\n  public static override contextType = WrapperContext;\n  /** @internal */\n  public declare context: React.ContextType<typeof WrapperContext>;\n\n  public override readonly state = {\n    size: { width: -1, height: -1 },\n  };\n\n  private _onSizeKnown = (newSize: SizeProps) => {\n    if (\n      this.state.size.width === newSize.width &&\n      this.state.size.height === newSize.height\n    )\n      return;\n    this.setState({ size: newSize });\n  };\n\n  private _handleKeyDown = (\n    event: React.KeyboardEvent<HTMLDivElement>\n  ): void => {\n    switch (event.key) {\n      case Key.Escape.valueOf():\n        this._cancel();\n        break;\n    }\n  };\n\n  private _cancel() {\n    if (this.props.onCancel) {\n      this.props.onCancel();\n    }\n  }\n\n  public override render() {\n    let point = PopupManager.getPopupPosition(\n      this.props.el ?? this.context,\n      this.props.pt,\n      new Point(),\n      this.state.size\n    );\n    const popupRect = CursorPopup.getPopupRect(\n      point,\n      this.props.offset,\n      this.state.size,\n      // eslint-disable-next-line deprecation/deprecation\n      this.props.placement ?? mapToPlacement(this.props.relativePosition)\n    );\n    point = new Point(popupRect.left, popupRect.top);\n    return (\n      <PositionPopup\n        key={this.props.id}\n        className=\"uifw-no-border\"\n        point={point}\n        onSizeKnown={this._onSizeKnown}\n      >\n        {/* eslint-disable-next-line deprecation/deprecation */}\n        <DivWithOutsideClick\n          onOutsideClick={this.props.onCancel}\n          onKeyDown={this._handleKeyDown}\n        >\n          <FocusTrap active={true} returnFocusOnDeactivate={true}>\n            <Toolbar\n              expandsTo={Direction.Bottom}\n              panelAlignment={ToolbarPanelAlignment.Start}\n              items={this.props.items}\n              useDragInteraction={true}\n              toolbarOpacitySetting={ToolbarOpacitySetting.Defaults}\n              onItemExecuted={this.props.onItemExecuted}\n            />\n          </FocusTrap>\n        </DivWithOutsideClick>\n      </PositionPopup>\n    );\n  }\n}\n"]}

package/lib/appui-react/preview/PreviewFeatures.d.ts

@@ -0,0 +1,98 @@
+/** @packageDocumentation
+ * @module Utilities
+ */
+import * as React from "react";
+import type { WidgetDef } from "../widgets/WidgetDef.js";
+/** List of known preview features. */
+interface KnownPreviewFeatures {
+    /** If `true`, the panels and tool settings will always be rendered over the content.
+     * The content will never change size.
+     *
+     * Discuss or upvote this feature: https://github.com/iTwin/appui/discussions/672
+     */
+    contentAlwaysMaxSize: boolean;
+    /** If `true`, the floating widget will have a "maximize" button. Use `enableMaximizedPanelWidget` to enable the feature for panel widgets.
+     *
+     * Discuss or upvote this feature: https://github.com/iTwin/appui/discussions/673
+     */
+    enableMaximizedFloatingWidget: boolean;
+    /** If `true`, the panel widget will have a "maximize" button. Use `enableMaximizedFloatingWidget` to enable the feature for floating widgets.
+     *
+     * Discuss or upvote this feature: https://github.com/iTwin/appui/discussions/673
+     */
+    enableMaximizedPanelWidget: boolean;
+    /** If `true`, the horizontal panels will have an additional "Align" button.
+     *
+     * Discuss or upvote this feature: https://github.com/iTwin/appui/discussions/706
+     */
+    horizontalPanelAlignment: boolean;
+    /** If enabled, a dropdown menu will be rendered for widgets that exceed the specified threshold of title bar buttons.
+     *
+     * Discuss or upvote this feature: https://github.com/iTwin/appui/discussions/723
+     */
+    widgetActionDropdown: {
+        threshold: number;
+    };
+    /** If `true`, the accudraw input field will accept letters. Defaults to `false`.
+     *
+     * This allows to type in units like meters, feet, inches, bearings and more.
+     */
+    allowLettersInAccuDrawInputFields: boolean;
+    /** If `true`, the accudraw input field will not have colors for the X, Y, Z axis. Defaults to `false`.*/
+    enableColorlessAccuDrawInputFields: boolean;
+    /** If `true`, popout widgets will not be rendered in a separate element tree, instead widget content will be re-parented to a popout content container.
+     * Alternatively, an array of widget ids can be specified to only re-parent specific widgets.
+     * @note Use {@link useTransientState} to save and restore DOM transient state when re-parenting widgets.
+     * @note There is a known limitation where iTwinUI v2 popover elements will be rendered in the main window. Prefer using iTwinUI v3 when using this feature.
+     *
+     * Discuss or upvote this feature: https://github.com/iTwin/appui/discussions/925
+     */
+    reparentPopoutWidgets: boolean | WidgetDef["id"][];
+    /** If `true`, additional UI elements are rendered to allow the end user of the layout to control widget visibility.
+     * Alternatively, an array of widget ids can be specified to only control specific widgets.
+     * @note Use {@link UiItemsManager} APIs to manage what widgets are available to the end-user.
+     *
+     * Discuss or upvote this feature: https://github.com/iTwin/appui/discussions/859
+     */
+    controlWidgetVisibility: boolean | WidgetDef["id"][];
+}
+/** List of preview features that can be enabled/disabled.
+ * This list is expected to change over time, the interface is made
+ * so that new features can be added or removed without breaking existing code.
+ * A console warning will simply appear if unknown features are passed.
+ * @beta
+ */
+export interface PreviewFeatures extends Partial<KnownPreviewFeatures> {
+    [featureName: string]: any;
+}
+/** Hook to access the preview features set.
+ * @internal
+ */
+export declare function usePreviewFeatures(): PreviewFeatures;
+/** Props for PreviewFeaturesProvider.
+ * @beta
+ */
+export interface PreviewFeaturesProviderProps {
+    children?: React.ReactNode;
+    features?: PreviewFeatures;
+}
+/** Set which preview features are enabled. These features are not yet ready for production use nor have
+ * a proper API defined yet.
+ * The available set of features are defined in the [[PreviewFeatures]] interface.
+ *
+ * This component should wrap the Provider component.
+ *
+ * ```tsx
+ * <PreviewFeaturesProvider features={{ enableMaximizedFloatingWidget: true }}>
+ *   <Provider store={UiFramework.store}>
+ *    [...]
+ *     <ConfigurableUIContent />
+ *    [/...]
+ *   </Provider>
+ * </PreviewFeaturesProvider>
+ * ```
+ * @beta
+ */
+export declare function PreviewFeaturesProvider({ children, features, }: PreviewFeaturesProviderProps): React.JSX.Element;
+export {};
+//# sourceMappingURL=PreviewFeatures.d.ts.map

package/lib/appui-react/preview/PreviewFeatures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PreviewFeatures.d.ts","sourceRoot":"","sources":["../../../src/appui-react/preview/PreviewFeatures.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAGzD,sCAAsC;AACtC,UAAU,oBAAoB;IAC5B;;;;OAIG;IACH,oBAAoB,EAAE,OAAO,CAAC;IAC9B;;;OAGG;IACH,6BAA6B,EAAE,OAAO,CAAC;IACvC;;;OAGG;IACH,0BAA0B,EAAE,OAAO,CAAC;IACpC;;;OAGG;IACH,wBAAwB,EAAE,OAAO,CAAC;IAClC;;;OAGG;IACH,oBAAoB,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C;;;OAGG;IACH,iCAAiC,EAAE,OAAO,CAAC;IAC3C,yGAAyG;IACzG,kCAAkC,EAAE,OAAO,CAAC;IAC5C;;;;;;OAMG;IACH,qBAAqB,EAAE,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;IACnD;;;;;OAKG;IACH,uBAAuB,EAAE,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;CACtD;AAiBD;;;;;GAKG;AACH,MAAM,WAAW,eAAgB,SAAQ,OAAO,CAAC,oBAAoB,CAAC;IACpE,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC;CAC5B;AAuDD;;GAEG;AACH,wBAAgB,kBAAkB,oBAEjC;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,QAAQ,EACR,QAAQ,GACT,EAAE,4BAA4B,qBAgB9B"}

package/lib/appui-react/preview/PreviewFeatures.js

@@ -0,0 +1,98 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Utilities
+ */
+import * as React from "react";
+import { create } from "zustand";
+import { Logger } from "@itwin/core-bentley";
+import { UiFramework } from "../UiFramework.js";
+/** Object used trim to only known features at runtime.
+ * @internal
+ */
+const knownFeaturesObject = {
+    contentAlwaysMaxSize: undefined,
+    enableMaximizedFloatingWidget: undefined,
+    enableMaximizedPanelWidget: undefined,
+    horizontalPanelAlignment: undefined,
+    widgetActionDropdown: undefined,
+    allowLettersInAccuDrawInputFields: undefined,
+    enableColorlessAccuDrawInputFields: undefined,
+    reparentPopoutWidgets: undefined,
+    controlWidgetVisibility: undefined,
+};
+/** Trim an object to only contain known feature keys.
+ * @param previewFeatures object potentially containing unknown features
+ * @returns object containing only known features
+ * @internal
+ */
+function trimToKnownFeaturesOnly(previewFeatures) {
+    const knownFeatureKeys = Object.keys(knownFeaturesObject);
+    const [knownFeatures, unknownFeatures] = Object.entries(previewFeatures).reduce(([known, unknown], [key, value]) => {
+        if (knownFeatureKeys.includes(key)) {
+            known[key] = value;
+        }
+        else {
+            unknown.push(key);
+        }
+        return [known, unknown];
+    }, [{}, []]);
+    if (Object.keys(unknownFeatures).length > 0) {
+        Logger.logWarning(UiFramework.loggerCategory("trimToKnownFeaturesOnly"), `Features used in "setPreviewFeatures" are unknown or no longer in preview`, {
+            unknownFeatures,
+        });
+    }
+    return knownFeatures;
+}
+/** Preview features store used by `UiFramework.previewFeatures` and `UiFramework.setPreviewFeatures()` APIs to manage the preview features.
+ * Use `usePreviewFeatures` hook to access the preview features set from a react component.
+ * Use `usePreviewFeaturesStore.getState().previewFeatures` to access the preview features set from a non-react component.
+ * Use `usePreviewFeaturesStore.subscribe()` to subscribe to changes to the preview features set from a non-react component.
+ * @internal
+ */
+const usePreviewFeaturesStore = create((set) => {
+    return {
+        previewFeatures: {},
+        setPreviewFeatures: (newPreviewFeatures) => {
+            const previewFeatures = trimToKnownFeaturesOnly(newPreviewFeatures);
+            set({ previewFeatures });
+        },
+    };
+});
+/** Hook to access the preview features set.
+ * @internal
+ */
+export function usePreviewFeatures() {
+    return usePreviewFeaturesStore((state) => state.previewFeatures);
+}
+/** Set which preview features are enabled. These features are not yet ready for production use nor have
+ * a proper API defined yet.
+ * The available set of features are defined in the [[PreviewFeatures]] interface.
+ *
+ * This component should wrap the Provider component.
+ *
+ * ```tsx
+ * <PreviewFeaturesProvider features={{ enableMaximizedFloatingWidget: true }}>
+ *   <Provider store={UiFramework.store}>
+ *    [...]
+ *     <ConfigurableUIContent />
+ *    [/...]
+ *   </Provider>
+ * </PreviewFeaturesProvider>
+ * ```
+ * @beta
+ */
+export function PreviewFeaturesProvider({ children, features, }) {
+    const setPreviewFeatures = usePreviewFeaturesStore((state) => state.setPreviewFeatures);
+    React.useEffect(() => {
+        setPreviewFeatures(features ?? {});
+    }, [features, setPreviewFeatures]);
+    // Clear preview features when unmounting.
+    React.useEffect(() => () => {
+        setPreviewFeatures({});
+    }, [setPreviewFeatures]);
+    return React.createElement(React.Fragment, null, children);
+}
+//# sourceMappingURL=PreviewFeatures.js.map

package/lib/appui-react/preview/PreviewFeatures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PreviewFeatures.js","sourceRoot":"","sources":["../../../src/appui-react/preview/PreviewFeatures.tsx"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Utilities\n */\n\nimport * as React from \"react\";\nimport { create } from \"zustand\";\nimport { Logger } from \"@itwin/core-bentley\";\nimport { UiFramework } from \"../UiFramework.js\";\nimport type { useTransientState } from \"../widget-panels/useTransientState.js\";\nimport type { WidgetDef } from \"../widgets/WidgetDef.js\";\nimport type { UiItemsManager } from \"../ui-items-provider/UiItemsManager.js\";\n\n/** List of known preview features. */\ninterface KnownPreviewFeatures {\n  /** If `true`, the panels and tool settings will always be rendered over the content.\n   * The content will never change size.\n   *\n   * Discuss or upvote this feature: https://github.com/iTwin/appui/discussions/672\n   */\n  contentAlwaysMaxSize: boolean;\n  /** If `true`, the floating widget will have a \"maximize\" button. Use `enableMaximizedPanelWidget` to enable the feature for panel widgets.\n   *\n   * Discuss or upvote this feature: https://github.com/iTwin/appui/discussions/673\n   */\n  enableMaximizedFloatingWidget: boolean;\n  /** If `true`, the panel widget will have a \"maximize\" button. Use `enableMaximizedFloatingWidget` to enable the feature for floating widgets.\n   *\n   * Discuss or upvote this feature: https://github.com/iTwin/appui/discussions/673\n   */\n  enableMaximizedPanelWidget: boolean;\n  /** If `true`, the horizontal panels will have an additional \"Align\" button.\n   *\n   * Discuss or upvote this feature: https://github.com/iTwin/appui/discussions/706\n   */\n  horizontalPanelAlignment: boolean;\n  /** If enabled, a dropdown menu will be rendered for widgets that exceed the specified threshold of title bar buttons.\n   *\n   * Discuss or upvote this feature: https://github.com/iTwin/appui/discussions/723\n   */\n  widgetActionDropdown: { threshold: number };\n  /** If `true`, the accudraw input field will accept letters. Defaults to `false`.\n   *\n   * This allows to type in units like meters, feet, inches, bearings and more.\n   */\n  allowLettersInAccuDrawInputFields: boolean;\n  /** If `true`, the accudraw input field will not have colors for the X, Y, Z axis. Defaults to `false`.*/\n  enableColorlessAccuDrawInputFields: boolean;\n  /** If `true`, popout widgets will not be rendered in a separate element tree, instead widget content will be re-parented to a popout content container.\n   * Alternatively, an array of widget ids can be specified to only re-parent specific widgets.\n   * @note Use {@link useTransientState} to save and restore DOM transient state when re-parenting widgets.\n   * @note There is a known limitation where iTwinUI v2 popover elements will be rendered in the main window. Prefer using iTwinUI v3 when using this feature.\n   *\n   * Discuss or upvote this feature: https://github.com/iTwin/appui/discussions/925\n   */\n  reparentPopoutWidgets: boolean | WidgetDef[\"id\"][];\n  /** If `true`, additional UI elements are rendered to allow the end user of the layout to control widget visibility.\n   * Alternatively, an array of widget ids can be specified to only control specific widgets.\n   * @note Use {@link UiItemsManager} APIs to manage what widgets are available to the end-user.\n   *\n   * Discuss or upvote this feature: https://github.com/iTwin/appui/discussions/859\n   */\n  controlWidgetVisibility: boolean | WidgetDef[\"id\"][];\n}\n\n/** Object used trim to only known features at runtime.\n * @internal\n */\nconst knownFeaturesObject: Record<keyof KnownPreviewFeatures, undefined> = {\n  contentAlwaysMaxSize: undefined,\n  enableMaximizedFloatingWidget: undefined,\n  enableMaximizedPanelWidget: undefined,\n  horizontalPanelAlignment: undefined,\n  widgetActionDropdown: undefined,\n  allowLettersInAccuDrawInputFields: undefined,\n  enableColorlessAccuDrawInputFields: undefined,\n  reparentPopoutWidgets: undefined,\n  controlWidgetVisibility: undefined,\n};\n\n/** List of preview features that can be enabled/disabled.\n * This list is expected to change over time, the interface is made\n * so that new features can be added or removed without breaking existing code.\n * A console warning will simply appear if unknown features are passed.\n * @beta\n */\nexport interface PreviewFeatures extends Partial<KnownPreviewFeatures> {\n  [featureName: string]: any;\n}\n\n/** Trim an object to only contain known feature keys.\n * @param previewFeatures object potentially containing unknown features\n * @returns object containing only known features\n * @internal\n */\nfunction trimToKnownFeaturesOnly(previewFeatures: PreviewFeatures) {\n  const knownFeatureKeys = Object.keys(knownFeaturesObject);\n  const [knownFeatures, unknownFeatures] = Object.entries(\n    previewFeatures\n  ).reduce(\n    ([known, unknown], [key, value]) => {\n      if (knownFeatureKeys.includes(key)) {\n        known[key] = value;\n      } else {\n        unknown.push(key);\n      }\n      return [known, unknown];\n    },\n    [{}, []] as [PreviewFeatures, string[]]\n  );\n  if (Object.keys(unknownFeatures).length > 0) {\n    Logger.logWarning(\n      UiFramework.loggerCategory(\"trimToKnownFeaturesOnly\"),\n      `Features used in \"setPreviewFeatures\" are unknown or no longer in preview`,\n      {\n        unknownFeatures,\n      }\n    );\n  }\n  return knownFeatures;\n}\n\ninterface PreviewFeaturesState {\n  previewFeatures: PreviewFeatures;\n  setPreviewFeatures: (previewFeatures: PreviewFeatures) => void;\n}\n\n/** Preview features store used by `UiFramework.previewFeatures` and `UiFramework.setPreviewFeatures()` APIs to manage the preview features.\n * Use `usePreviewFeatures` hook to access the preview features set from a react component.\n * Use `usePreviewFeaturesStore.getState().previewFeatures` to access the preview features set from a non-react component.\n * Use `usePreviewFeaturesStore.subscribe()` to subscribe to changes to the preview features set from a non-react component.\n * @internal\n */\nconst usePreviewFeaturesStore = create<PreviewFeaturesState>((set) => {\n  return {\n    previewFeatures: {},\n    setPreviewFeatures: (newPreviewFeatures: PreviewFeatures) => {\n      const previewFeatures = trimToKnownFeaturesOnly(newPreviewFeatures);\n      set({ previewFeatures });\n    },\n  };\n});\n\n/** Hook to access the preview features set.\n * @internal\n */\nexport function usePreviewFeatures() {\n  return usePreviewFeaturesStore((state) => state.previewFeatures);\n}\n\n/** Props for PreviewFeaturesProvider.\n * @beta\n */\nexport interface PreviewFeaturesProviderProps {\n  children?: React.ReactNode;\n  features?: PreviewFeatures;\n}\n\n/** Set which preview features are enabled. These features are not yet ready for production use nor have\n * a proper API defined yet.\n * The available set of features are defined in the [[PreviewFeatures]] interface.\n *\n * This component should wrap the Provider component.\n *\n * ```tsx\n * <PreviewFeaturesProvider features={{ enableMaximizedFloatingWidget: true }}>\n *   <Provider store={UiFramework.store}>\n *    [...]\n *     <ConfigurableUIContent />\n *    [/...]\n *   </Provider>\n * </PreviewFeaturesProvider>\n * ```\n * @beta\n */\nexport function PreviewFeaturesProvider({\n  children,\n  features,\n}: PreviewFeaturesProviderProps) {\n  const setPreviewFeatures = usePreviewFeaturesStore(\n    (state) => state.setPreviewFeatures\n  );\n  React.useEffect(() => {\n    setPreviewFeatures(features ?? {});\n  }, [features, setPreviewFeatures]);\n\n  // Clear preview features when unmounting.\n  React.useEffect(\n    () => () => {\n      setPreviewFeatures({});\n    },\n    [setPreviewFeatures]\n  );\n  return <>{children}</>;\n}\n"]}

package/lib/appui-react/preview/allow-letters-in-accudraw-input-fields/useAllowLettersInAccuDrawInputFields.d.ts

@@ -0,0 +1,5 @@
+/**  If `true`, the accudraw input field will accept letters. Defaults to `false`.
+ * @internal
+ */
+export declare function useAllowLettersInAccuDrawInputFields(): boolean | undefined;
+//# sourceMappingURL=useAllowLettersInAccuDrawInputFields.d.ts.map

package/lib/appui-react/preview/allow-letters-in-accudraw-input-fields/useAllowLettersInAccuDrawInputFields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAllowLettersInAccuDrawInputFields.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/preview/allow-letters-in-accudraw-input-fields/useAllowLettersInAccuDrawInputFields.tsx"],"names":[],"mappings":"AAMA;;GAEG;AACH,wBAAgB,oCAAoC,wBAGnD"}

package/lib/appui-react/preview/allow-letters-in-accudraw-input-fields/useAllowLettersInAccuDrawInputFields.js

@@ -0,0 +1,13 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+import { usePreviewFeatures } from "../PreviewFeatures.js";
+/**  If `true`, the accudraw input field will accept letters. Defaults to `false`.
+ * @internal
+ */
+export function useAllowLettersInAccuDrawInputFields() {
+    const { allowLettersInAccuDrawInputFields } = usePreviewFeatures();
+    return allowLettersInAccuDrawInputFields;
+}
+//# sourceMappingURL=useAllowLettersInAccuDrawInputFields.js.map

package/lib/appui-react/preview/allow-letters-in-accudraw-input-fields/useAllowLettersInAccuDrawInputFields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAllowLettersInAccuDrawInputFields.js","sourceRoot":"","sources":["../../../../src/appui-react/preview/allow-letters-in-accudraw-input-fields/useAllowLettersInAccuDrawInputFields.tsx"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D;;GAEG;AACH,MAAM,UAAU,oCAAoC;IAClD,MAAM,EAAE,iCAAiC,EAAE,GAAG,kBAAkB,EAAE,CAAC;IACnE,OAAO,iCAAiC,CAAC;AAC3C,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\nimport { usePreviewFeatures } from \"../PreviewFeatures.js\";\n\n/**  If `true`, the accudraw input field will accept letters. Defaults to `false`.\n * @internal\n */\nexport function useAllowLettersInAccuDrawInputFields() {\n  const { allowLettersInAccuDrawInputFields } = usePreviewFeatures();\n  return allowLettersInAccuDrawInputFields;\n}\n"]}

package/lib/appui-react/preview/content-always-max-size/useContentAlwaysMaxSize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useContentAlwaysMaxSize.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/preview/content-always-max-size/useContentAlwaysMaxSize.tsx"],"names":[],"mappings":"AAIA,OAAO,gCAAgC,CAAC;AAGxC,gBAAgB;AAChB,wBAAgB,uBAAuB;;EAKtC"}

package/lib/appui-react/preview/content-always-max-size/useContentAlwaysMaxSize.js

@@ -0,0 +1,14 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+import "./useContentAlwaysMaxSize.scss";
+import { usePreviewFeatures } from "../PreviewFeatures.js";
+/** @internal */
+export function useContentAlwaysMaxSize() {
+    const { contentAlwaysMaxSize } = usePreviewFeatures();
+    return {
+        "uifw-preview-contentAlwaysMaxSize": contentAlwaysMaxSize,
+    };
+}
+//# sourceMappingURL=useContentAlwaysMaxSize.js.map

package/lib/appui-react/preview/content-always-max-size/useContentAlwaysMaxSize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useContentAlwaysMaxSize.js","sourceRoot":"","sources":["../../../../src/appui-react/preview/content-always-max-size/useContentAlwaysMaxSize.tsx"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG,OAAO,gCAAgC,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,gBAAgB;AAChB,MAAM,UAAU,uBAAuB;IACrC,MAAM,EAAE,oBAAoB,EAAE,GAAG,kBAAkB,EAAE,CAAC;IACtD,OAAO;QACL,mCAAmC,EAAE,oBAAoB;KAC1D,CAAC;AACJ,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\nimport \"./useContentAlwaysMaxSize.scss\";\nimport { usePreviewFeatures } from \"../PreviewFeatures.js\";\n\n/** @internal */\nexport function useContentAlwaysMaxSize() {\n  const { contentAlwaysMaxSize } = usePreviewFeatures();\n  return {\n    \"uifw-preview-contentAlwaysMaxSize\": contentAlwaysMaxSize,\n  };\n}\n"]}

package/lib/appui-react/preview/control-widget-visibility/AddWidgetButton.d.ts

@@ -0,0 +1,15 @@
+/** @packageDocumentation
+ * @module Widget
+ */
+import * as React from "react";
+/** @internal */
+export declare const label = "Add widget";
+/** @internal */
+export declare function AddWidgetButton(): React.JSX.Element | null;
+/** @internal */
+export declare function useAddTab(): boolean;
+/** Returns hidden tabs whose visibility can be manipulated by the end user.
+ * @internal
+ */
+export declare function useUserControlledHiddenTabs(): import("../../layout/state/TabState.js").TabState[];
+//# sourceMappingURL=AddWidgetButton.d.ts.map

package/lib/appui-react/preview/control-widget-visibility/AddWidgetButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AddWidgetButton.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/preview/control-widget-visibility/AddWidgetButton.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAW/B,gBAAgB;AAChB,eAAO,MAAM,KAAK,eAAe,CAAC;AAElC,gBAAgB;AAChB,wBAAgB,eAAe,6BA+C9B;AAED,gBAAgB;AAChB,wBAAgB,SAAS,YAKxB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,wDAuB1C"}