@oracle/oraclejet-core-pack 14.0.0

package/oj-c/split-menu-button/component.json

@@ -0,0 +1,205 @@
+{
+  "name": "split-menu-button",
+  "version": "1.0.0",
+  "jetVersion": "^14.0.0",
+  "type": "composite",
+  "pack": "oj-c",
+  "implements": [
+    "CSplitMenuButtonElement"
+  ],
+  "description": "A Split Menu Button combines a push button and menu button.",
+  "displayName": "Split Menu Button",
+  "help": "oj-c.SplitMenuButton.html",
+  "main": "oj-c/split-menu-button",
+  "extension": {
+    "vbdt": {
+      "module": "oj-c/split-menu-button"
+    },
+    "oracle": {
+      "icon": "oj-ux-ico-menu-button",
+      "uxSpecs": [
+        "menubutton"
+      ]
+    }
+  },
+  "propertyLayout": [
+    {
+      "propertyGroup": "common",
+      "items": [
+        "label",
+        "disabled",
+        "width",
+        "chroming",
+        "size",
+        "items"
+      ]
+    }
+  ],
+  "since": "14.0.0",
+  "properties": {
+    "label": {
+      "type": "string",
+      "description": "Text to show in the button.",
+      "displayName": "label",
+      "help": "#label",
+      "translatable": true,
+      "value": ""
+    },
+    "items": {
+      "type": "Array<object>",
+      "description": "Items describe the menu items rendered by the menu button.",
+      "displayName": "items",
+      "help": "#items",
+      "extension": {
+        "vbdt": {
+          "itemProperties": {
+            "type": {
+              "type": "string",
+              "enumValues": [
+                "item",
+                "divider"
+              ]
+            },
+            "label": {
+              "type": "string"
+            },
+            "disabled": {
+              "type": "boolean"
+            },
+            "onAction": {
+              "type": "function"
+            }
+          }
+        }
+      },
+      "value": []
+    },
+    "disabled": {
+      "type": "boolean",
+      "description": "Specifies that the button element should be disabled.",
+      "displayName": "disabled",
+      "help": "#disabled",
+      "value": false
+    },
+    "size": {
+      "type": "string",
+      "description": "Size of button",
+      "displayName": "size",
+      "help": "#size",
+      "propertyEditorValues": {
+        "sm": {
+          "description": "Display a small button.",
+          "displayName": "Small"
+        },
+        "md": {
+          "description": "Display a default size button.",
+          "displayName": "Medium"
+        },
+        "lg": {
+          "description": "Display a large button.",
+          "displayName": "Large"
+        }
+      },
+      "translatable": true,
+      "enumValues": [
+        "sm",
+        "md",
+        "lg"
+      ],
+      "value": "md"
+    },
+    "width": {
+      "type": "number|string",
+      "description": "Specifies that the button style width",
+      "displayName": "width",
+      "help": "#width"
+    },
+    "chroming": {
+      "type": "string",
+      "description": "Indicates in what states the button has chromings in background and border.",
+      "displayName": "chroming",
+      "help": "#chroming",
+      "propertyEditorValues": {
+        "outlined": {
+          "description": "Outlined buttons are salient, but lighter weight than solid buttons. Outlined buttons are useful for secondary actions.",
+          "displayName": "Outlined"
+        },
+        "solid": {
+          "description": "Solid buttons stand out, and direct the user's attention to the most important actions in the UI.",
+          "displayName": "Solid"
+        },
+        "callToAction": {
+          "description": "A Call To Action (CTA) button guides the user to take or complete the action that is the main goal of the page or page section. There should only be one CTA button on a page at any given time.",
+          "displayName": "Call To Action"
+        }
+      },
+      "enumValues": [
+        "outlined",
+        "solid",
+        "callToAction"
+      ],
+      "value": "outlined"
+    }
+  },
+  "events": {
+    "ojAction": {
+      "bubbles": true,
+      "description": "Triggered when a button is clicked, whether by keyboard, mouse, or touch events. To meet accessibility requirements, the only supported way to react to the click of a button is to listen for this event.",
+      "eventGroup": "common",
+      "displayName": "onOjAction",
+      "help": "#event:action"
+    }
+  },
+  "methods": {
+    "blur": {
+      "return": "any"
+    },
+    "focus": {
+      "return": "any"
+    },
+    "doAction": {
+      "return": "any"
+    },
+    "setProperty": {
+      "description": "Sets a property or a single subproperty for complex properties and notifies the component of the change, triggering a corresponding event.",
+      "help": "#setProperty",
+      "params": [
+        {
+          "name": "property",
+          "description": "The property name to set. Supports dot notation for subproperty access.",
+          "type": "string"
+        },
+        {
+          "name": "value",
+          "description": "The new value to set the property to.",
+          "type": "any"
+        }
+      ],
+      "return": "void"
+    },
+    "getProperty": {
+      "description": "Retrieves the value of a property or a subproperty.",
+      "help": "#getProperty",
+      "params": [
+        {
+          "name": "property",
+          "description": "The property name to get. Supports dot notation for subproperty access.",
+          "type": "string"
+        }
+      ],
+      "return": "any"
+    },
+    "setProperties": {
+      "description": "Performs a batch set of properties.",
+      "help": "#setProperties",
+      "params": [
+        {
+          "name": "properties",
+          "description": "An object containing the property and value pairs to set.",
+          "type": "object"
+        }
+      ],
+      "return": "void"
+    }
+  }
+}

package/oj-c/split-menu-button/index.js

@@ -0,0 +1,6 @@
+define(["require", "exports", "./split-menu-button"], function (require, exports, split_menu_button_1) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.SplitMenuButton = void 0;
+    Object.defineProperty(exports, "SplitMenuButton", { enumerable: true, get: function () { return split_menu_button_1.SplitMenuButton; } });
+});

package/oj-c/split-menu-button/split-menu-button-styles.css

@@ -0,0 +1,11 @@
+oj-c-split-menu-button:not(.oj-complete) {
+  visibility: hidden;
+}
+
+oj-c-split-menu-button {
+  display: inline-block;
+}
+
+oj-c-split-menu-button [hidden] {
+  display: none;
+}

package/oj-c/split-menu-button/split-menu-button.js

@@ -0,0 +1,76 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+define(["require", "exports", "preact/jsx-runtime", '@oracle/oraclejet-preact/translationBundle', "@oracle/oraclejet-preact/UNSAFE_SplitMenuButton", "@oracle/oraclejet-preact/UNSAFE_Menu", "@oracle/oraclejet-preact/hooks/UNSAFE_useTabbableMode", "preact", "preact/hooks", "preact/compat", "ojs/ojvcomponent", "css!oj-c/split-menu-button/split-menu-button-styles.css"], function (require, exports, jsx_runtime_1, translationBundle_1, UNSAFE_SplitMenuButton_1, UNSAFE_Menu_1, UNSAFE_useTabbableMode_1, preact_1, hooks_1, compat_1, ojvcomponent_1) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.SplitMenuButton = void 0;
+    translationBundle_1 = __importDefault(translationBundle_1);
+    const FunctionalSplitMenuButton = (0, compat_1.forwardRef)((props, ref) => {
+        const buttonRef = (0, hooks_1.useRef)(null);
+        (0, hooks_1.useImperativeHandle)(ref, () => ({
+            focus: () => { var _a; return (_a = buttonRef.current) === null || _a === void 0 ? void 0 : _a.focus(); },
+            blur: () => { var _a; return (_a = buttonRef.current) === null || _a === void 0 ? void 0 : _a.blur(); },
+            doAction: () => { var _a; return (_a = buttonRef.current) === null || _a === void 0 ? void 0 : _a.dispatchEvent(new Event('ojAction', { bubbles: true })); }
+        }), []);
+        return (0, jsx_runtime_1.jsx)(UNSAFE_SplitMenuButton_1.SplitMenuButton, Object.assign({ ref: buttonRef }, props));
+    });
+    let SplitMenuButton = class SplitMenuButton extends preact_1.Component {
+        constructor() {
+            super(...arguments);
+            this.buttonRef = (0, preact_1.createRef)();
+            this.renderMenu = (items) => {
+                return items.map((item) => {
+                    if (item && item.type === 'divider') {
+                        return (0, jsx_runtime_1.jsx)(UNSAFE_Menu_1.MenuDivider, {});
+                    }
+                    else if (item.label) {
+                        return ((0, jsx_runtime_1.jsx)(UNSAFE_Menu_1.MenuItem, { label: item.label, isDisabled: item.disabled, onAction: item.onAction }));
+                    }
+                    else {
+                        return;
+                    }
+                });
+            };
+        }
+        render(props) {
+            const { chroming, label, disabled, size, onOjAction: onAction, items } = Object.assign({}, props);
+            const widthSize = { width: props.width };
+            return props.width ? ((0, jsx_runtime_1.jsx)(ojvcomponent_1.Root, Object.assign({ style: widthSize }, { children: (0, jsx_runtime_1.jsx)(FunctionalSplitMenuButton, Object.assign({ label: label, ref: this.buttonRef, variant: chroming, size: size, width: '100%', isDisabled: disabled, onAction: onAction }, { children: this.renderMenu(items) })) }))) : ((0, jsx_runtime_1.jsx)(ojvcomponent_1.Root, { children: (0, jsx_runtime_1.jsx)(FunctionalSplitMenuButton, Object.assign({ label: label, ref: this.buttonRef, variant: chroming, size: size, width: '100%', isDisabled: disabled, onAction: onAction }, { children: this.renderMenu(items) })) }));
+        }
+        blur() {
+            var _a;
+            (_a = this.buttonRef.current) === null || _a === void 0 ? void 0 : _a.blur();
+        }
+        focus() {
+            var _a;
+            (_a = this.buttonRef.current) === null || _a === void 0 ? void 0 : _a.focus();
+        }
+        doAction() {
+            var _a;
+            (_a = this.buttonRef.current) === null || _a === void 0 ? void 0 : _a.doAction();
+        }
+    };
+    SplitMenuButton.defaultProps = {
+        label: '',
+        chroming: 'outlined',
+        disabled: false,
+        size: 'md',
+        items: []
+    };
+    SplitMenuButton._metadata = { "properties": { "label": { "type": "string" }, "items": { "type": "Array<object>" }, "disabled": { "type": "boolean" }, "size": { "type": "string", "enumValues": ["sm", "md", "lg"] }, "width": { "type": "number|string" }, "chroming": { "type": "string", "enumValues": ["outlined", "solid", "callToAction"] } }, "events": { "ojAction": { "bubbles": true } }, "extension": { "_OBSERVED_GLOBAL_PROPS": ["title"] }, "methods": { "blur": {}, "focus": {}, "doAction": {} } };
+    SplitMenuButton._translationBundleMap = {
+        '@oracle/oraclejet-preact': translationBundle_1.default
+    };
+    SplitMenuButton._consumedContexts = [UNSAFE_useTabbableMode_1.TabbableModeContext];
+    SplitMenuButton = __decorate([
+        (0, ojvcomponent_1.customElement)('oj-c-split-menu-button')
+    ], SplitMenuButton);
+    exports.SplitMenuButton = SplitMenuButton;
+});

package/oj-c/split-menu-button.js

@@ -0,0 +1,6 @@
+define(["require", "exports", "./split-menu-button/split-menu-button"], function (require, exports, split_menu_button_1) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.SplitMenuButton = void 0;
+    Object.defineProperty(exports, "SplitMenuButton", { enumerable: true, get: function () { return split_menu_button_1.SplitMenuButton; } });
+});

package/oj-c/text-area/__webdriver__/TextAreaWebElement.js

@@ -0,0 +1,32 @@
+"use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+exports.__esModule = true;
+exports.TextAreaWebElement = void 0;
+var TextAreaWebElementBase_1 = require("./TextAreaWebElementBase");
+/**
+ * The component WebElement for [oj-c-text-area](../../../oj-c/docs/oj.TextArea.html).
+ * Do not instantiate this class directly, instead, use
+ * [findTextArea](../modules.html#findTextArea).
+ */
+var TextAreaWebElement = /** @class */ (function (_super) {
+    __extends(TextAreaWebElement, _super);
+    function TextAreaWebElement() {
+        return _super !== null && _super.apply(this, arguments) || this;
+    }
+    return TextAreaWebElement;
+}(TextAreaWebElementBase_1.TextAreaWebElementBase));
+exports.TextAreaWebElement = TextAreaWebElement;

package/oj-c/text-area/__webdriver__/TextAreaWebElementBase.js

@@ -0,0 +1,285 @@
+"use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+exports.__esModule = true;
+exports.TextAreaWebElementBase = void 0;
+var elements_1 = require("@oracle/oraclejet-webdriver/elements");
+/**
+ * This is the base class for oj-c-text-area WebElement, and is generated from the
+ * component's metadata. Do not modify these contents since they'll be replaced
+ * during the next generation.
+ * Put overrides into the WebElements's subclass, TextAreaWebElement.ts.
+ */
+var TextAreaWebElementBase = /** @class */ (function (_super) {
+    __extends(TextAreaWebElementBase, _super);
+    function TextAreaWebElementBase() {
+        return _super !== null && _super.apply(this, arguments) || this;
+    }
+    /**
+     * Gets the value of <code>autocomplete</code> property.
+     * Dictates component's autocomplete state
+     * @return The value of <code>autocomplete</code> property.
+     *
+     */
+    TextAreaWebElementBase.prototype.getAutocomplete = function () {
+        return this.getProperty('autocomplete');
+    };
+    /**
+     * Gets the value of <code>containerReadonly</code> property.
+     * Specifies whether an ancestor container, like oj-form-layout, is readonly.
+     * @return The value of <code>containerReadonly</code> property.
+     *
+     */
+    TextAreaWebElementBase.prototype.getContainerReadonly = function () {
+        return this.getProperty('containerReadonly');
+    };
+    /**
+     * Gets the value of <code>converter</code> property.
+     * Specifies the converter instance.
+     * @return The value of <code>converter</code> property.
+     *
+     */
+    TextAreaWebElementBase.prototype.getConverter = function () {
+        return this.getProperty('converter');
+    };
+    /**
+     * Gets the value of <code>disabled</code> property.
+     * Specifies whether the component is disabled.
+     * @return The value of <code>disabled</code> property.
+     *
+     */
+    TextAreaWebElementBase.prototype.getDisabled = function () {
+        return this.getProperty('disabled');
+    };
+    /**
+     * Gets the value of <code>displayOptions</code> property.
+     * Display options for auxiliary content that determines whether or not it should be displayed.
+     * @return The value of <code>displayOptions</code> property.
+     *
+     */
+    TextAreaWebElementBase.prototype.getDisplayOptions = function () {
+        return this.getProperty('displayOptions');
+    };
+    /**
+     * Gets the value of <code>help</code> property.
+     * Form component help information.
+     * @return The value of <code>help</code> property.
+     *
+     */
+    TextAreaWebElementBase.prototype.getHelp = function () {
+        return this.getProperty('help');
+    };
+    /**
+     * Gets the value of <code>helpHints</code> property.
+     * The helpHints object contains a definition property and a source property.
+     * @return The value of <code>helpHints</code> property.
+     *
+     */
+    TextAreaWebElementBase.prototype.getHelpHints = function () {
+        return this.getProperty('helpHints');
+    };
+    /**
+     * Gets the value of <code>labelEdge</code> property.
+     * Specifies how the label is positioned for the component
+     * @return The value of <code>labelEdge</code> property.
+     *
+     */
+    TextAreaWebElementBase.prototype.getLabelEdge = function () {
+        return this.getProperty('labelEdge');
+    };
+    /**
+     * Gets the value of <code>labelHint</code> property.
+     * Represents a hint for rendering a label on the component.
+     * @return The value of <code>labelHint</code> property.
+     *
+     */
+    TextAreaWebElementBase.prototype.getLabelHint = function () {
+        return this.getProperty('labelHint');
+    };
+    /**
+     * Gets the value of <code>labelStartWidth</code> property.
+     * The width of the label when labelEdge is 'start'.
+     * @return The value of <code>labelStartWidth</code> property.
+     *
+     */
+    TextAreaWebElementBase.prototype.getLabelStartWidth = function () {
+        return this.getProperty('labelStartWidth');
+    };
+    /**
+     * Gets the value of <code>labelWrapping</code> property.
+     * Should the labels wrap or truncate when there is not enough available space.
+     * @return The value of <code>labelWrapping</code> property.
+     *
+     */
+    TextAreaWebElementBase.prototype.getLabelWrapping = function () {
+        return this.getProperty('labelWrapping');
+    };
+    /**
+     * Gets the value of <code>length</code> property.
+     * Defines the length limit for the field
+     * @return The value of <code>length</code> property.
+     *
+     */
+    TextAreaWebElementBase.prototype.getLength = function () {
+        return this.getProperty('length');
+    };
+    /**
+     * Gets the value of <code>maxRows</code> property.
+     * The maximum number of visible text lines of the textarea.
+     * @return The value of <code>maxRows</code> property.
+     *
+     */
+    TextAreaWebElementBase.prototype.getMaxRows = function () {
+        return this.getProperty('maxRows');
+    };
+    /**
+     * Sets the value of <code>messagesCustom</code> property.
+     * List of custom component messages
+     * @param messagesCustom The value to set for <code>messagesCustom</code>
+     *
+     */
+    TextAreaWebElementBase.prototype.changeMessagesCustom = function (messagesCustom) {
+        return this.setProperty('messagesCustom', messagesCustom);
+    };
+    /**
+     * Gets the value of <code>messagesCustom</code> property.
+     * List of custom component messages
+     * @return The value of <code>messagesCustom</code> property.
+     *
+     */
+    TextAreaWebElementBase.prototype.getMessagesCustom = function () {
+        return this.getProperty('messagesCustom');
+    };
+    /**
+     * Gets the value of <code>placeholder</code> property.
+     * The placeholder text to set on the element.
+     * @return The value of <code>placeholder</code> property.
+     *
+     */
+    TextAreaWebElementBase.prototype.getPlaceholder = function () {
+        return this.getProperty('placeholder');
+    };
+    /**
+     * Gets the value of <code>readonly</code> property.
+     * Whether the component is readonly
+     * @return The value of <code>readonly</code> property.
+     *
+     */
+    TextAreaWebElementBase.prototype.getReadonly = function () {
+        return this.getProperty('readonly');
+    };
+    /**
+     * Gets the value of <code>required</code> property.
+     * Specifies whether or not the component is required.
+     * @return The value of <code>required</code> property.
+     *
+     */
+    TextAreaWebElementBase.prototype.getRequired = function () {
+        return this.getProperty('required');
+    };
+    /**
+     * Gets the value of <code>requiredMessageDetail</code> property.
+     * Overrides the default Required error message.
+     * @return The value of <code>requiredMessageDetail</code> property.
+     *
+     */
+    TextAreaWebElementBase.prototype.getRequiredMessageDetail = function () {
+        return this.getProperty('requiredMessageDetail');
+    };
+    /**
+     * Gets the value of <code>resizeBehavior</code> property.
+     * Defines the resizeBehavior of the textarea.
+     * @return The value of <code>resizeBehavior</code> property.
+     *
+     */
+    TextAreaWebElementBase.prototype.getResizeBehavior = function () {
+        return this.getProperty('resizeBehavior');
+    };
+    /**
+     * Gets the value of <code>rows</code> property.
+     * The number of visible text lines in the textarea.
+     * @return The value of <code>rows</code> property.
+     *
+     */
+    TextAreaWebElementBase.prototype.getRows = function () {
+        return this.getProperty('rows');
+    };
+    /**
+     * Gets the value of <code>textAlign</code> property.
+     * Specifies how the text is aligned within the text field
+     * @return The value of <code>textAlign</code> property.
+     *
+     */
+    TextAreaWebElementBase.prototype.getTextAlign = function () {
+        return this.getProperty('textAlign');
+    };
+    /**
+     * Gets the value of <code>userAssistanceDensity</code> property.
+     * Specifies the density of the form component's user assistance presentation.
+     * @return The value of <code>userAssistanceDensity</code> property.
+     *
+     */
+    TextAreaWebElementBase.prototype.getUserAssistanceDensity = function () {
+        return this.getProperty('userAssistanceDensity');
+    };
+    /**
+     * Gets the value of <code>validators</code> property.
+     * Specifies the validators for the component.
+     * @return The value of <code>validators</code> property.
+     *
+     */
+    TextAreaWebElementBase.prototype.getValidators = function () {
+        return this.getProperty('validators');
+    };
+    /**
+     * Sets the value of <code>value</code> property.
+     * The value of the component.
+     * @param value The value to set for <code>value</code>
+     *
+     */
+    TextAreaWebElementBase.prototype.changeValue = function (value) {
+        return this.setProperty('value', value);
+    };
+    /**
+     * Gets the value of <code>value</code> property.
+     * The value of the component.
+     * @return The value of <code>value</code> property.
+     *
+     */
+    TextAreaWebElementBase.prototype.getValue = function () {
+        return this.getProperty('value');
+    };
+    /**
+     * Gets the value of <code>rawValue</code> property.
+     * Specifies how the raw value of the component
+     * @return The value of <code>rawValue</code> property.
+     *
+     */
+    TextAreaWebElementBase.prototype.getRawValue = function () {
+        return this.getProperty('rawValue');
+    };
+    /**
+     * Gets the value of <code>valid</code> property.
+     * Specifies how the valid state of the component
+     * @return The value of <code>valid</code> property.
+     *
+     */
+    TextAreaWebElementBase.prototype.getValid = function () {
+        return this.getProperty('valid');
+    };
+    return TextAreaWebElementBase;
+}(elements_1.OjWebElement));
+exports.TextAreaWebElementBase = TextAreaWebElementBase;