Skip to main content

Functions


Functions

lazy(p, [props])open in new window

Returns: function

Arguments:

p: LazyPlugin<T>

props: T

IntentProvider(props)open in new window

Returns: ReactNode

Arguments:

props: ProviderProps<IntentContext>

PluginHost(options)open in new window

Bootstraps an application by initializing plugins and rendering root components.

Returns: PluginDefinition<PluginHostProvides>

Arguments:

options: BootstrapPluginsParams

PluginProvider(props)open in new window

Returns: ReactNode

Arguments:

props: ProviderProps<PluginContext>

Surface(props)open in new window

A surface is a named region of the screen that can be populated by plugins.

Returns: ReactNode

Arguments:

props: Omit<SurfaceProps, "ref"> & RefAttributes<HTMLElement>

SurfaceProvider(props)open in new window

Returns: ReactNode

Arguments:

props: ProviderProps<SurfaceRootContext>

createApp(options)open in new window

Expected usage is for this to be the entrypoint of the application. Initializes plugins and renders the root components.

Returns: function

Arguments:

options: BootstrapPluginsParams

definePlugin(plugin)open in new window

Define a plugin

Returns: Plugin<TProvides>

Arguments:

plugin: Plugin<TProvides>

filterPlugins(plugins, predicate)open in new window

Filter a list of plugins to only those that match a predicate.

Returns: Plugin<T>[]

Arguments:

plugins: Plugin[]

predicate: function

findPlugin(plugins, id)open in new window

Find a plugin by ID.

Returns: undefined | Plugin<T>

Arguments:

plugins: Plugin[]

id: string

firstIdInPart(layout, part)open in new window

Returns: undefined | string

Arguments:

layout: undefined | object

part: "main" | "solo" | "sidebar" | "complementary" | "fullScreen"

getPlugin(plugins, id)open in new window

Find a plugin by ID, or raise an error if not found.

Returns: Plugin<T>

Arguments:

plugins: Plugin[]

id: string

indexInPart(layout, layoutCoordinate)open in new window

Returns: undefined | number

Arguments:

layout: undefined | object

layoutCoordinate: undefined | object

initializePlugin(pluginDefinition)open in new window

Resolve a PluginDefinition into a fully initialized Plugin .

Returns: Promise<Plugin<T & U>>

Arguments:

pluginDefinition: PluginDefinition<T, U>

isLayoutAdjustment(value)open in new window

Returns: value is object

Arguments:

value: unknown

isLayoutMode(value)open in new window

Returns: value is "deck" | "solo" | "fullscreen"

Arguments:

value: any

isLayoutParts(value)open in new window

Type guard for layout plugins.

Returns: value is object

Arguments:

value: unknown

isObject(data)open in new window

Checks if the given data is an object and not null.

Useful inside surface component resolvers as a type guard.

Returns: data is object

Arguments:

data: unknown

openIds(layout)open in new window

Extracts all unique IDs from the layout parts.

Returns: string[]

Arguments:

layout: object

parseFileManagerPlugin(plugin)open in new window

Returns: undefined | Plugin<FileManagerProvides>

Arguments:

plugin: Plugin

parseGraphBuilderPlugin(plugin)open in new window

Type guard for graph builder plugins.

Returns: undefined | Plugin<GraphBuilderProvides>

Arguments:

plugin: Plugin

parseGraphPlugin(plugin)open in new window

Type guard for graph plugins.

Returns: undefined | Plugin<GraphProvides>

Arguments:

plugin: Plugin

parseGraphSerializerPlugin(plugin)open in new window

Type guard for graph serializer plugins.

Returns: undefined | Plugin<GraphSerializerProvides>

Arguments:

plugin: Plugin

parseIntentPlugin(plugin)open in new window

Returns: undefined | Plugin<IntentPluginProvides>

Arguments:

plugin: Plugin

parseIntentResolverPlugin(plugin)open in new window

Returns: undefined | Plugin<IntentResolverProvides>

Arguments:

plugin: Plugin

parseLayoutPlugin(plugin)open in new window

Type guard for layout plugins.

Returns: undefined | Plugin<LayoutProvides>

Arguments:

plugin: Plugin

parseMetadataRecordsPlugin(plugin)open in new window

Returns: undefined | Plugin<MetadataRecordsProvides>

Arguments:

plugin: Plugin

parseMetadataResolverPlugin(plugin)open in new window

Returns: undefined | Plugin<MetadataResolverProvides>

Arguments:

plugin: Plugin

parseNavigationPlugin(plugin)open in new window

Returns: undefined | Plugin<object>

Arguments:

plugin: Plugin

parsePluginHost(plugin)open in new window

Returns: undefined | Plugin<PluginHostProvides>

Arguments:

plugin: Plugin

parseRootSurfacePlugin([plugin])open in new window

Returns: undefined | Plugin<SurfacePluginProvides>

Arguments:

plugin: Plugin

parseSettingsPlugin(plugin)open in new window

Returns: undefined | Plugin<SettingsProvides<Record<string, any>>>

Arguments:

plugin: Plugin

parseSurfacePlugin([plugin])open in new window

Returns: undefined | Plugin<SurfaceProvides>

Arguments:

plugin: Plugin

parseTranslationsPlugin(plugin)open in new window

Type guard for translation plugins.

Returns: undefined | Plugin<TranslationsProvides>

Arguments:

plugin: Plugin

partLength(layout, part)open in new window

Returns: number

Arguments:

layout: undefined | object

part: undefined | "main" | "solo" | "sidebar" | "complementary" | "fullScreen"

pluginMeta(meta)open in new window

Returns: object

Arguments:

meta: object

resolvePlugin(plugins, predicate)open in new window

Resolves a plugin by predicate.

Returns: undefined | Plugin<T>

Arguments:

plugins: Plugin[]

predicate: function

useIntent()open in new window

Returns: IntentContext

Arguments: none

useIntentDispatcher()open in new window

Returns: IntentDispatcher

Arguments: none

useIntentResolver(plugin, resolver)open in new window

Returns: void

Arguments:

plugin: string

resolver: IntentResolver

usePlugin(id)open in new window

Get a plugin by ID.

Returns: undefined | Plugin<T>

Arguments:

id: string

usePlugins()open in new window

Get all plugins.

Returns: PluginContext

Arguments: none

useResolvePlugin(predicate)open in new window

Resolve a plugin by predicate.

Returns: undefined | Plugin<T>

Arguments:

predicate: function

useResolvePlugins(predicate)open in new window

Resolve a collection of plugins by predicate.

Returns: Plugin<T>[]

Arguments:

predicate: function

useSurface()open in new window

Returns: SurfaceProps

Arguments: none

useSurfaceRoot()open in new window

Returns: SurfaceRootContext

Arguments: none