Nemcio/SCM-Manager
1
0
Fork 0
mirror of https://github.com/scm-manager/scm-manager.git synced 2025-11-10 15:35:49 +01:00
Code Issues Packages Projects Releases Activity

Implement api for extension point typings (#1638)

Browse Source 
Currently, the only way to explore available extension points is through our documentation or by browsing the source code. Once you find them, there is no guard rails and the usage is prone to user errors. This new api allows the declaration of extension points as types in code. This way, exposing an extension point is as easy as exporting it from a module. Both the implementation and the developer who uses the extension point work with the same shared type that allows auto-completion and type-checks for safety. This feature is backwards-compatible as the generic methods all have sensible defaults for the type parameters.

Co-authored-by: Sebastian Sdorra <sebastian.sdorra@cloudogu.com>
Co-authored-by: Eduard Heimbuch <eduard.heimbuch@cloudogu.com>
This commit is contained in:
Konstantin Schaper
2021-05-12 16:05:30 +02:00
committed by GitHub
parent b6b304f338
commit 7286a62a80
18 changed files with 5335 additions and 7317 deletions
Download Patch File Download Diff File Expand all files Collapse all files

68
scm-ui/ui-extensions/src/binder.ts
View File

@@ -22,14 +22,22 @@
* SOFTWARE.
*/
type Predicate = (props: any) => boolean;
type Predicate<P extends Record<any, any> = Record<any, any>> = (props: P) => boolean;
type ExtensionRegistration = {
predicate: Predicate;
extension: any;
type ExtensionRegistration<P, T> = {
predicate: Predicate<P>;
extension: T;
extensionName: string;
};
export type ExtensionPointDefinition<N extends string, T, P> = {
name: N;
type: T;
props: P;
};
export type SimpleDynamicExtensionPointDefinition<P extends string, T, Props, S extends string | undefined> = ExtensionPointDefinition<S extends string ? `${P}${S}` : `${P}${string}`, T, Props>;
/**
* Binder is responsible for binding plugin extensions to their corresponding extension points.
* The Binder class is mainly exported for testing, plugins should only use the default export.
@@ -37,7 +45,7 @@ type ExtensionRegistration = {
export class Binder {
name: string;
extensionPoints: {
[key: string]: Array<ExtensionRegistration>;
[key: string]: Array<ExtensionRegistration<unknown, unknown>>;
};
constructor(name: string) {
@@ -52,7 +60,22 @@ export class Binder {
* @param extension provided extension
* @param predicate to decide if the extension gets rendered for the given props
*/
bind(extensionPoint: string, extension: any, predicate?: Predicate, extensionName?: string) {
bind<E extends ExtensionPointDefinition<string, unknown, undefined>>(
extensionPoint: E["name"],
extension: E["type"]
): void;
bind<E extends ExtensionPointDefinition<string, unknown, any>>(
extensionPoint: E["name"],
extension: E["type"],
predicate?: Predicate<E["props"]>,
extensionName?: string
): void;
bind<E extends ExtensionPointDefinition<string, unknown, any>>(
extensionPoint: E["name"],
extension: E["type"],
predicate?: Predicate<E["props"]>,
extensionName?: string
) {
if (!this.extensionPoints[extensionPoint]) {
this.extensionPoints[extensionPoint] = [];
}
@@ -70,7 +93,15 @@ export class Binder {
* @param extensionPoint name of extension point
* @param props of the extension point
*/
getExtension(extensionPoint: string, props?: object) {
getExtension<E extends ExtensionPointDefinition<string, any, undefined>>(extensionPoint: E["name"]): E["type"] | null;
getExtension<E extends ExtensionPointDefinition<string, any, any>>(
extensionPoint: E["name"],
props: E["props"]
): E["type"] | null;
getExtension<E extends ExtensionPointDefinition<any, unknown, any>>(
extensionPoint: E["name"],
props?: E["props"]
): E["type"] | null {
const extensions = this.getExtensions(extensionPoint, props);
if (extensions.length > 0) {
return extensions[0];
@@ -84,10 +115,20 @@ export class Binder {
* @param extensionPoint name of extension point
* @param props of the extension point
*/
getExtensions(extensionPoint: string, props?: object): Array<any> {
getExtensions<E extends ExtensionPointDefinition<string, any, undefined>>(
extensionPoint: E["name"]
): Array<E["type"]>;
getExtensions<E extends ExtensionPointDefinition<string, any, any>>(
extensionPoint: E["name"],
props: E["props"]
): Array<E["type"]>;
getExtensions<E extends ExtensionPointDefinition<string, unknown, any>>(
extensionPoint: E["name"],
props?: E["props"]
): Array<E["type"]> {
let registrations = this.extensionPoints[extensionPoint] || [];
if (props) {
registrations = registrations.filter(reg => reg.predicate(props || {}));
registrations = registrations.filter(reg => reg.predicate(props));
}
registrations.sort(this.sortExtensions);
return registrations.map(reg => reg.extension);
@@ -96,14 +137,17 @@ export class Binder {
/**
* Returns true if at least one extension is bound to the extension point and its props.
*/
hasExtension(extensionPoint: string, props?: object): boolean {
return this.getExtensions(extensionPoint, props).length > 0;
hasExtension<E extends ExtensionPointDefinition<any, unknown, any>>(
extensionPoint: E["name"],
props?: E["props"]
): boolean {
return this.getExtensions<E>(extensionPoint, props).length > 0;
}
/**
* Sort extensions in ascending order, starting with entries with specified extensionName.
*/
sortExtensions = (a: ExtensionRegistration, b: ExtensionRegistration) => {
sortExtensions = (a: ExtensionRegistration<unknown, unknown>, b: ExtensionRegistration<unknown, unknown>) => {
const regA = a.extensionName ? a.extensionName.toUpperCase() : "";
const regB = b.extensionName ? b.extensionName.toUpperCase() : "";