Jesse Mazzella 4ee68cccd6
docs: better docs and types for the API (#7796)
* docs: fix type imports in openmct.js

* docs: fix type imports

* docs: fix types for eventHelpers

* docs: types for TypeRegistry

* docs: types for StatusAPI

* docs: fix ObjectAPI types and docs

* docs: more types

* docs: improved types for main entry

* docs: improved types

* fix: unbreak the linting

* chore: remove EventEmitter webpack alias as it hide types

* fix: return type

* fix: parameter type

* fix: types for composables

* chore: add webpack consts to eslintrc

* fix: remove usage of deprecated timeAPI methods and add a ton of docs and types

* docs: update README.md

* lint: clean up API.md

* chore: upgrade eventemitter to v5.0.2

* refactor: update imports for EventEmitter to remove alias

* format: lint

* docs: update types for Views and ViewProviders

* docs: expose common types at the base import level

* docs(types): remove unnecessary tsconfig options

* docs: ActionAPI

* docs: AnnotationAPI

* docs: import common types from the same origin

* docs: FormsAPI & TelemetryAPI types

* docs: FormController, IndicatorAPI

* docs: MenuAPI, ActionsAPI

* docs: `@memberof` is not supported by `tsc` and JSDoc generation so remove it

* docs: RootRegistry and RootObjectProvider

* docs: Transaction + Overlay

* lint: words for the word god

* fix: review comments
2024-07-31 10:46:16 -07:00

232 lines
6.4 KiB
JavaScript

/*****************************************************************************
* Open MCT, Copyright (c) 2014-2024, United States Government
* as represented by the Administrator of the National Aeronautics and Space
* Administration. All rights reserved.
*
* Open MCT is licensed under the Apache License, Version 2.0 (the
* 'License'); you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
* http://www.apache.org/licenses/LICENSE-2.0.
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an 'AS IS' BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
* License for the specific language governing permissions and limitations
* under the License.
*
* Open MCT includes source code licensed under additional open source
* licenses. See the Open Source Licenses file (LICENSES.md) included with
* this source code distribution or the Licensing information page available
* at runtime from the About dialog for additional information.
*****************************************************************************/
import { EventEmitter } from 'eventemitter3';
import { createOpenMct, resetApplicationState } from 'utils/testing';
import { nextTick } from 'vue';
import FlexibleLayout from './plugin.js';
describe('the plugin', function () {
let element;
let child;
let openmct;
let flexibleLayoutDefinition;
let mockComposition;
const testViewObject = {
identifier: {
namespace: '',
key: 'test-object'
},
id: 'test-object',
type: 'flexible-layout',
configuration: {
rowsLayout: false,
containers: [
{
id: 'deb9f839-80ad-4ccf-a152-5c763ceb7d7e',
frames: [],
size: 50
},
{
id: 'deb9f839-80ad-4ccf-a152-5c763ceb7d7f',
frames: [],
size: 50
}
]
},
composition: []
};
beforeEach((done) => {
openmct = createOpenMct();
openmct.install(new FlexibleLayout());
flexibleLayoutDefinition = openmct.types.get('flexible-layout');
element = document.createElement('div');
child = document.createElement('div');
element.appendChild(child);
openmct.on('start', done);
openmct.start(child);
});
afterEach(() => {
return resetApplicationState(openmct);
});
it('defines a flexible layout object type with the correct key', () => {
expect(flexibleLayoutDefinition.definition.name).toEqual('Flexible Layout');
});
describe('the view', function () {
let flexibleLayoutViewProvider;
beforeEach(() => {
mockComposition = new EventEmitter();
// eslint-disable-next-line require-await
mockComposition.load = async () => {
return [];
};
spyOn(openmct.composition, 'get').and.returnValue(mockComposition);
const applicableViews = openmct.objectViews.get(testViewObject, [testViewObject]);
flexibleLayoutViewProvider = applicableViews.find(
(viewProvider) => viewProvider.key === 'flexible-layout'
);
});
it('provides a view', () => {
expect(flexibleLayoutViewProvider).toBeDefined();
});
it('renders a view', async () => {
const flexibleView = flexibleLayoutViewProvider.view(testViewObject, [testViewObject]);
flexibleView.show(child, false);
await nextTick();
const flexTitle = child.querySelector('.c-fl');
expect(flexTitle).not.toBeNull();
});
});
describe('the toolbar', () => {
let flexibleLayoutItem;
let flexibleLayoutToolbar;
let telemetryItem;
let selection;
beforeEach(() => {
flexibleLayoutItem = {
identifier: {
namespace: '',
key: 'test-object'
},
id: 'test-object',
type: 'flexible-layout',
configuration: {
rowsLayout: true,
containers: [
{
id: 'deb9f839-80ad-4ccf-a152-5c763ceb7d7e',
frames: [
{
id: '329bf482-d0dc-486a-aae0-6176276bd315',
domainObjectIdentifier: {
namespace: '',
key: '55122607-e65e-44d5-9c9d-9c31a914ca89'
},
size: 100,
noFrame: false
}
],
size: 61
},
{
id: 'deb9f839-80ad-4ccf-a152-5c763ceb7d7f',
frames: [
{
id: '329bf482-d0dc-486a-aae0-6176276bd316',
domainObjectIdentifier: {
namespace: '',
key: '55122607-e65e-44d5-9c9d-9c31a914ca90'
},
size: 100,
noFrame: false
}
],
size: 39
}
]
},
composition: [
{
identifier: {
namespace: '',
key: '55122607-e65e-44d5-9c9d-9c31a914ca89'
}
},
{
identifier: {
namespace: '',
key: '55122607-e65e-44d5-9c9d-9c31a914ca90'
}
}
]
};
telemetryItem = {
telemetry: {
period: 5,
amplitude: 5,
offset: 5,
dataRateInHz: 5,
phase: 5,
randomness: 0
},
name: 'Sine Wave Generator',
type: 'generator',
modified: 1592851063871,
location: 'mine',
persisted: 1592851063871,
id: '55122607-e65e-44d5-9c9d-9c31a914ca89',
identifier: {
namespace: '',
key: '55122607-e65e-44d5-9c9d-9c31a914ca89'
}
};
selection = [
[
{
context: {
frameId: '329bf482-d0dc-486a-aae0-6176276bd315',
item: telemetryItem,
type: 'frame'
}
},
{
context: {
containerId: 'deb9f839-80ad-4ccf-a152-5c763ceb7d7e',
item: flexibleLayoutItem,
type: 'container'
}
},
{
context: {
item: flexibleLayoutItem,
type: 'flexible-layout'
}
}
]
];
flexibleLayoutToolbar = openmct.toolbars.get(selection);
});
it('provides controls including separators', () => {
expect(flexibleLayoutToolbar.length).toBe(6);
});
});
});