@dxos/app-framework 0.8.1 → 0.8.2-main.2f9c567

package/src/common/layout.ts

@@ -2,7 +2,7 @@
 // Copyright 2023 DXOS.org
 //
 
-import { Schema as S } from 'effect';
+import { Schema } from 'effect';
 
 import { Label } from '../plugin-intent';
 
@@ -18,17 +18,17 @@ export namespace LayoutAction {
   /**
    * Generic layout action.
    */
-  export class UpdateLayout extends S.TaggedClass<UpdateLayout>()(UPDATE_LAYOUT, {
-    input: S.Struct({
-      part: S.String.annotations({ description: 'The part of the layout to mutate.' }),
-      subject: S.optional(S.Any.annotations({ description: 'The subject of the layout update.' })),
-      options: S.optional(
-        S.Record({ key: S.String, value: S.Any }).annotations({
+  export class UpdateLayout extends Schema.TaggedClass<UpdateLayout>()(UPDATE_LAYOUT, {
+    input: Schema.Struct({
+      part: Schema.String.annotations({ description: 'The part of the layout to mutate.' }),
+      subject: Schema.optional(Schema.Any.annotations({ description: 'The subject of the layout update.' })),
+      options: Schema.optional(
+        Schema.Record({ key: Schema.String, value: Schema.Any }).annotations({
           description: 'Additional options for the layout action.',
         }),
       ),
     }),
-    output: S.Void,
+    output: Schema.Void,
   }) {}
 
   //
@@ -41,199 +41,230 @@ export namespace LayoutAction {
   //  This allows for plugins to update the layout without depending on a specific layout plugin.
   //  The expectation is that other norms other than these will emerge over time.
 
-  export class SetLayoutMode extends S.TaggedClass<SetLayoutMode>()(UPDATE_LAYOUT, {
-    input: S.Struct({
-      part: S.Literal('mode').annotations({ description: 'Setting the layout mode.' }),
-      subject: S.optional(S.String.annotations({ description: 'Item which is the subject of the new layout mode.' })),
-      options: S.Union(
-        S.Struct({ mode: S.String.annotations({ description: 'The new layout mode.' }) }),
-        S.Struct({ revert: S.Boolean.annotations({ description: 'Revert to the previous layout mode.' }) }),
+  export class SetLayoutMode extends Schema.TaggedClass<SetLayoutMode>()(UPDATE_LAYOUT, {
+    input: Schema.Struct({
+      part: Schema.Literal('mode').annotations({ description: 'Setting the layout mode.' }),
+      subject: Schema.optional(
+        Schema.String.annotations({ description: 'Item which is the subject of the new layout mode.' }),
+      ),
+      options: Schema.Union(
+        Schema.Struct({ mode: Schema.String.annotations({ description: 'The new layout mode.' }) }),
+        Schema.Struct({ revert: Schema.Boolean.annotations({ description: 'Revert to the previous layout mode.' }) }),
       ),
     }),
-    output: S.Void,
+    output: Schema.Void,
   }) {}
 
-  export class UpdateSidebar extends S.TaggedClass<UpdateSidebar>()(UPDATE_LAYOUT, {
-    input: S.Struct({
-      part: S.Literal('sidebar').annotations({ description: 'Updating the sidebar.' }),
-      subject: S.optional(S.String.annotations({ description: 'URI of the component to display in the sidebar.' })),
-      options: S.optional(
-        S.Struct({
-          state: S.Literal('closed', 'collapsed', 'expanded').annotations({
+  export class UpdateSidebar extends Schema.TaggedClass<UpdateSidebar>()(UPDATE_LAYOUT, {
+    input: Schema.Struct({
+      part: Schema.Literal('sidebar').annotations({ description: 'Updating the sidebar.' }),
+      subject: Schema.optional(
+        Schema.String.annotations({ description: 'URI of the component to display in the sidebar.' }),
+      ),
+      options: Schema.optional(
+        Schema.Struct({
+          state: Schema.Literal('closed', 'collapsed', 'expanded').annotations({
             description: 'Whether the sidebar is closed, collapsed, or expanded.',
           }),
         }),
       ),
     }),
-    output: S.Void,
+    output: Schema.Void,
   }) {}
 
-  export class UpdateComplementary extends S.TaggedClass<UpdateComplementary>()(UPDATE_LAYOUT, {
-    input: S.Struct({
-      part: S.Literal('complementary').annotations({ description: 'Updating the complementary sidebar.' }),
-      subject: S.optional(
-        S.String.annotations({ description: 'URI of the component to display in the complementary area.' }),
+  export class UpdateComplementary extends Schema.TaggedClass<UpdateComplementary>()(UPDATE_LAYOUT, {
+    input: Schema.Struct({
+      part: Schema.Literal('complementary').annotations({ description: 'Updating the complementary sidebar.' }),
+      subject: Schema.optional(
+        Schema.String.annotations({ description: 'URI of the component to display in the complementary area.' }),
       ),
-      options: S.optional(
-        S.Struct({
-          state: S.Literal('closed', 'collapsed', 'expanded').annotations({
+      options: Schema.optional(
+        Schema.Struct({
+          state: Schema.Literal('closed', 'collapsed', 'expanded').annotations({
             description: 'Whether the complementary sidebar is closed, collapsed, or expanded.',
           }),
         }),
       ),
     }),
-    output: S.Void,
+    output: Schema.Void,
   }) {}
 
-  export class UpdateDialog extends S.TaggedClass<UpdateDialog>()(UPDATE_LAYOUT, {
-    input: S.Struct({
-      part: S.Literal('dialog').annotations({ description: 'Updating the dialog.' }),
-      subject: S.optional(S.String.annotations({ description: 'URI of the component to display in the dialog.' })),
-      options: S.Struct({
-        state: S.optional(S.Boolean.annotations({ description: 'Whether the dialog is open or closed.' })),
-        blockAlign: S.optional(
-          S.Literal('start', 'center', 'end').annotations({ description: 'The alignment of the dialog.' }),
+  export class UpdateDialog extends Schema.TaggedClass<UpdateDialog>()(UPDATE_LAYOUT, {
+    input: Schema.Struct({
+      part: Schema.Literal('dialog').annotations({ description: 'Updating the dialog.' }),
+      subject: Schema.optional(
+        Schema.String.annotations({ description: 'URI of the component to display in the dialog.' }),
+      ),
+      options: Schema.Struct({
+        state: Schema.optional(Schema.Boolean.annotations({ description: 'Whether the dialog is open or closed.' })),
+        blockAlign: Schema.optional(
+          Schema.Literal('start', 'center', 'end').annotations({ description: 'The alignment of the dialog.' }),
         ),
-        type: S.optional(S.Literal('default', 'alert').annotations({ description: 'The type of dialog.' })),
-        props: S.optional(
-          S.Record({ key: S.String, value: S.Any }).annotations({
+        type: Schema.optional(Schema.Literal('default', 'alert').annotations({ description: 'The type of dialog.' })),
+        props: Schema.optional(
+          Schema.Record({ key: Schema.String, value: Schema.Any }).annotations({
             description: 'Additional props for the dialog.',
           }),
         ),
       }),
     }),
-    output: S.Void,
+    output: Schema.Void,
   }) {}
 
-  export class UpdatePopover extends S.TaggedClass<UpdatePopover>()(UPDATE_LAYOUT, {
-    input: S.Struct({
-      part: S.Literal('popover').annotations({ description: 'Updating the popover.' }),
-      subject: S.optional(S.String.annotations({ description: 'URI of the component to display in the popover.' })),
-      options: S.Struct({
-        anchorId: S.String.annotations({ description: 'The id of the element to anchor the popover to.' }),
-        side: S.optional(
-          S.Literal('top', 'right', 'bottom', 'left').annotations({ description: 'The side of the anchor.' }),
+  export class UpdatePopover extends Schema.TaggedClass<UpdatePopover>()(UPDATE_LAYOUT, {
+    input: Schema.Struct({
+      part: Schema.Literal('popover').annotations({ description: 'Updating the popover.' }),
+      subject: Schema.optional(
+        Schema.Any.annotations({
+          description: 'URI of the component to display in the popover or data to pass to the popover.',
+        }),
+      ),
+      options: Schema.Struct({
+        side: Schema.optional(
+          Schema.Literal('top', 'right', 'bottom', 'left').annotations({ description: 'The side of the anchor.' }),
         ),
-        state: S.optional(S.Boolean.annotations({ description: 'Whether the popover is open or closed.' })),
-        props: S.optional(
-          S.Record({ key: S.String, value: S.Any }).annotations({
+        state: Schema.optional(Schema.Boolean.annotations({ description: 'Whether the popover is open or closed.' })),
+        props: Schema.optional(
+          Schema.Record({ key: Schema.String, value: Schema.Any }).annotations({
             description: 'Additional props for the popover.',
           }),
         ),
-      }),
+      }).pipe(
+        Schema.extend(
+          Schema.Union(
+            Schema.Struct({
+              variant: Schema.Literal('virtual'),
+              anchor: Schema.Any.annotations({ description: 'The DOM element to anchor the popover to.' }),
+            }),
+            Schema.Struct({
+              variant: Schema.optional(Schema.Literal('react')),
+              anchorId: Schema.String.annotations({
+                description: 'An id that can be used to determine whether to render the anchor subcomponent.',
+              }),
+            }),
+          ),
+        ),
+      ),
     }),
-    output: S.Void,
+    output: Schema.Void,
   }) {}
 
-  export const Toast = S.Struct({
-    id: S.String.annotations({ description: 'The id of the toast.' }),
-    title: S.optional(Label.annotations({ description: 'The title of the toast.' })),
-    description: S.optional(Label.annotations({ description: 'The description of the toast.' })),
-    icon: S.optional(S.String.annotations({ description: 'The icon of the toast.' })),
-    duration: S.optional(S.Number.annotations({ description: 'The duration of the toast.' })),
-    closeLabel: S.optional(Label.annotations({ description: 'The label of the close button.' })),
-    actionLabel: S.optional(Label.annotations({ description: 'The label of the action button.' })),
-    actionAlt: S.optional(Label.annotations({ description: 'The alt text of the action button.' })),
-    onAction: S.optional(
-      S.Any.annotations({ description: 'The action to perform when the action button is clicked.' }),
+  export const Toast = Schema.Struct({
+    id: Schema.String.annotations({ description: 'The id of the toast.' }),
+    title: Schema.optional(Label.annotations({ description: 'The title of the toast.' })),
+    description: Schema.optional(Label.annotations({ description: 'The description of the toast.' })),
+    icon: Schema.optional(Schema.String.annotations({ description: 'The icon of the toast.' })),
+    duration: Schema.optional(Schema.Number.annotations({ description: 'The duration of the toast.' })),
+    closeLabel: Schema.optional(Label.annotations({ description: 'The label of the close button.' })),
+    actionLabel: Schema.optional(Label.annotations({ description: 'The label of the action button.' })),
+    actionAlt: Schema.optional(Label.annotations({ description: 'The alt text of the action button.' })),
+    onAction: Schema.optional(
+      Schema.Any.annotations({ description: 'The action to perform when the action button is clicked.' }),
     ),
   });
 
-  export interface Toast extends Omit<S.Schema.Type<typeof Toast>, 'onAction'> {
+  export interface Toast extends Omit<Schema.Schema.Type<typeof Toast>, 'onAction'> {
     onAction?: () => void;
   }
 
-  export class AddToast extends S.TaggedClass<AddToast>()(UPDATE_LAYOUT, {
-    input: S.Struct({
-      part: S.Literal('toast').annotations({ description: 'Adding a toast.' }),
+  export class AddToast extends Schema.TaggedClass<AddToast>()(UPDATE_LAYOUT, {
+    input: Schema.Struct({
+      part: Schema.Literal('toast').annotations({ description: 'Adding a toast.' }),
       subject: Toast.annotations({ description: 'The toast to add.' }),
     }),
-    output: S.Void,
+    output: Schema.Void,
   }) {}
 
-  export class SwitchWorkspace extends S.TaggedClass<SwitchWorkspace>()(UPDATE_LAYOUT, {
-    input: S.Struct({
-      part: S.Literal('workspace').annotations({ description: 'Switching the workspace.' }),
-      subject: S.String.annotations({ description: 'The id of the workspace to switch to.' }),
+  export class SwitchWorkspace extends Schema.TaggedClass<SwitchWorkspace>()(UPDATE_LAYOUT, {
+    input: Schema.Struct({
+      part: Schema.Literal('workspace').annotations({ description: 'Switching the workspace.' }),
+      subject: Schema.String.annotations({ description: 'The id of the workspace to switch to.' }),
     }),
-    output: S.Void,
+    output: Schema.Void,
   }) {}
 
-  export class RevertWorkspace extends S.TaggedClass<RevertWorkspace>()(UPDATE_LAYOUT, {
-    input: S.Struct({
-      part: S.Literal('workspace').annotations({ description: 'Switching the workspace.' }),
-      options: S.Struct({
-        revert: S.Literal(true).annotations({ description: 'Revert to the previous workspace.' }),
+  export class RevertWorkspace extends Schema.TaggedClass<RevertWorkspace>()(UPDATE_LAYOUT, {
+    input: Schema.Struct({
+      part: Schema.Literal('workspace').annotations({ description: 'Switching the workspace.' }),
+      options: Schema.Struct({
+        revert: Schema.Literal(true).annotations({ description: 'Revert to the previous workspace.' }),
       }),
     }),
-    output: S.Void,
+    output: Schema.Void,
   }) {}
 
-  export class Open extends S.TaggedClass<Open>()(UPDATE_LAYOUT, {
-    input: S.Struct({
-      part: S.Literal('main').annotations({ description: 'Opening an item in the main content area.' }),
-      subject: S.Array(S.String.annotations({ description: 'Ids of the items to open.' })),
-      options: S.optional(
-        S.Struct({
-          state: S.optional(S.Literal(true).annotations({ description: 'The items are being added.' })),
-          variant: S.optional(S.String.annotations({ description: 'The variant of the item to open.' })),
-          key: S.optional(
-            S.String.annotations({ description: 'If provided, will replace item with a matching key (id prefix).' }),
+  export class Open extends Schema.TaggedClass<Open>()(UPDATE_LAYOUT, {
+    input: Schema.Struct({
+      part: Schema.Literal('main').annotations({ description: 'Opening an item in the main content area.' }),
+      subject: Schema.Array(Schema.String.annotations({ description: 'Ids of the items to open.' })),
+      options: Schema.optional(
+        Schema.Struct({
+          state: Schema.optional(Schema.Literal(true).annotations({ description: 'The items are being added.' })),
+          variant: Schema.optional(Schema.String.annotations({ description: 'The variant of the item to open.' })),
+          key: Schema.optional(
+            Schema.String.annotations({
+              description: 'If provided, will replace item with a matching key (id prefix).',
+            }),
           ),
-          scrollIntoView: S.optional(S.Boolean.annotations({ description: 'Scroll the items into view.' })),
-          pivotId: S.optional(S.String.annotations({ description: 'The id of the item to place new items next to.' })),
-          positioning: S.optional(
-            S.Union(
-              S.Literal('start').annotations({ description: 'The items are being added before the pivot item.' }),
-              S.Literal('end').annotations({ description: 'The items are being added after the pivot item.' }),
+          workspace: Schema.optional(Schema.String.annotations({ description: 'The workspace to open the items in.' })),
+          scrollIntoView: Schema.optional(Schema.Boolean.annotations({ description: 'Scroll the items into view.' })),
+          pivotId: Schema.optional(
+            Schema.String.annotations({ description: 'The id of the item to place new items next to.' }),
+          ),
+          positioning: Schema.optional(
+            Schema.Union(
+              Schema.Literal('start').annotations({ description: 'The items are being added before the pivot item.' }),
+              Schema.Literal('end').annotations({ description: 'The items are being added after the pivot item.' }),
             ),
           ),
         }),
       ),
     }),
-    output: S.Void,
+    output: Schema.Void,
   }) {}
 
-  export class Set extends S.TaggedClass<Set>()(UPDATE_LAYOUT, {
-    input: S.Struct({
-      part: S.Literal('main').annotations({ description: 'Setting items in the main content area.' }),
-      subject: S.Array(S.String.annotations({ description: 'Ids of the items to set.' })),
-      options: S.Struct({
-        override: S.Literal(true).annotations({ description: 'Override the current items in the main content area.' }),
+  export class Set extends Schema.TaggedClass<Set>()(UPDATE_LAYOUT, {
+    input: Schema.Struct({
+      part: Schema.Literal('main').annotations({ description: 'Setting items in the main content area.' }),
+      subject: Schema.Array(Schema.String.annotations({ description: 'Ids of the items to set.' })),
+      options: Schema.Struct({
+        override: Schema.Literal(true).annotations({
+          description: 'Override the current items in the main content area.',
+        }),
       }),
     }),
-    output: S.Void,
+    output: Schema.Void,
   }) {}
 
-  export class Close extends S.TaggedClass<Close>()(UPDATE_LAYOUT, {
-    input: S.Struct({
-      part: S.Literal('main').annotations({ description: 'Closing items in the main content area.' }),
-      subject: S.Array(S.String.annotations({ description: 'Ids of the items to close.' })),
-      options: S.Struct({
-        state: S.Literal(false).annotations({ description: 'The items are being removed.' }),
+  export class Close extends Schema.TaggedClass<Close>()(UPDATE_LAYOUT, {
+    input: Schema.Struct({
+      part: Schema.Literal('main').annotations({ description: 'Closing items in the main content area.' }),
+      subject: Schema.Array(Schema.String.annotations({ description: 'Ids of the items to close.' })),
+      options: Schema.Struct({
+        state: Schema.Literal(false).annotations({ description: 'The items are being removed.' }),
       }),
     }),
-    output: S.Void,
+    output: Schema.Void,
   }) {}
 
-  export class ScrollIntoView extends S.TaggedClass<ScrollIntoView>()(UPDATE_LAYOUT, {
-    input: S.Struct({
-      part: S.Literal('current').annotations({ description: 'Setting the current item' }),
-      subject: S.optional(S.String.annotations({ description: 'The id of the item to set as current.' })),
-      options: S.optional(
-        S.Record({ key: S.String, value: S.Any }).annotations({
+  export class ScrollIntoView extends Schema.TaggedClass<ScrollIntoView>()(UPDATE_LAYOUT, {
+    input: Schema.Struct({
+      part: Schema.Literal('current').annotations({ description: 'Setting the current item' }),
+      subject: Schema.optional(Schema.String.annotations({ description: 'The id of the item to set as current.' })),
+      options: Schema.optional(
+        Schema.Record({ key: Schema.String, value: Schema.Any }).annotations({
           description: 'Additional options for the scroll into view.',
         }),
       ),
     }),
-    output: S.Void,
+    output: Schema.Void,
   }) {}
 
-  export class Expose extends S.TaggedClass<Expose>()(UPDATE_LAYOUT, {
-    input: S.Struct({
-      part: S.Literal('navigation').annotations({ description: 'Exposing an item in the navigation area.' }),
-      subject: S.String.annotations({ description: 'The id of the item to expose.' }),
+  export class Expose extends Schema.TaggedClass<Expose>()(UPDATE_LAYOUT, {
+    input: Schema.Struct({
+      part: Schema.Literal('navigation').annotations({ description: 'Exposing an item in the navigation area.' }),
+      subject: Schema.String.annotations({ description: 'The id of the item to expose.' }),
     }),
-    output: S.Void,
+    output: Schema.Void,
   }) {}
 }

package/src/common/translations.ts

@@ -2,16 +2,16 @@
 // Copyright 2023 DXOS.org
 //
 
-import { Schema as S } from 'effect';
+import { Schema } from 'effect';
 
-export const ResourceKey = S.Union(S.String, S.Record({ key: S.String, value: S.Any }));
-export type ResourceKey = S.Schema.Type<typeof ResourceKey>;
+export const ResourceKey = Schema.Union(Schema.String, Schema.Record({ key: Schema.String, value: Schema.Any }));
+export type ResourceKey = Schema.Schema.Type<typeof ResourceKey>;
 
-export const ResourceLanguage = S.Record({ key: S.String, value: ResourceKey });
-export type ResourceLanguage = S.Schema.Type<typeof ResourceLanguage>;
+export const ResourceLanguage = Schema.Record({ key: Schema.String, value: ResourceKey });
+export type ResourceLanguage = Schema.Schema.Type<typeof ResourceLanguage>;
 
 /**
  * A resource is a collection of translations for a language.
  */
-export const Resource = S.Record({ key: S.String, value: ResourceLanguage });
-export type Resource = S.Schema.Type<typeof Resource>;
+export const Resource = Schema.Record({ key: Schema.String, value: ResourceLanguage });
+export type Resource = Schema.Schema.Type<typeof Resource>;

package/src/core/capabilities.ts

@@ -10,7 +10,7 @@ import { Effect } from 'effect';
 
 import { Trigger } from '@dxos/async';
 import { invariant } from '@dxos/invariant';
-import { create } from '@dxos/live-object';
+import { live } from '@dxos/live-object';
 import { log } from '@dxos/log';
 import { type MaybePromise } from '@dxos/util';
 
@@ -34,7 +34,8 @@ export const defineCapability = <T>(identifier: string) => {
 };
 
 /**
- * Functionality contributed to the application by a plugin module.
+ * A unique string identifier with a Typescript type associated with it.
+ * When a capability is contributed to the application an implementation of the interface is provided.
  */
 export type Capability<T> = {
   /**
@@ -95,8 +96,11 @@ export const lazy =
   };
 
 /**
- * Context which is passed to plugins, allowing them to interact with each other.
+ * Facilitates the dependency injection between [plugin modules](#pluginmodule) by allowing them contribute and request capabilities from each other.
+ * It tracks the capabilities that are contributed in an in-memory live object.
+ * This allows the application to subscribe to this state and incorporate plugins which are added dynamically.
  */
+// TOOD(burdon): Rename PluginContext.
 export class PluginsContext {
   private readonly _definedCapabilities = new Map<string, CapabilityImpl<unknown>[]>();
 
@@ -133,7 +137,7 @@ export class PluginsContext {
   }) {
     let current = this._definedCapabilities.get(interfaceDef.identifier);
     if (!current) {
-      const object = create<{ value: CapabilityImpl<unknown>[] }>({ value: [] });
+      const object = live<{ value: CapabilityImpl<unknown>[] }>({ value: [] });
       current = untracked(() => object.value);
       this._definedCapabilities.set(interfaceDef.identifier, current);
     }
@@ -175,7 +179,7 @@ export class PluginsContext {
   ): U[] {
     let current = this._definedCapabilities.get(interfaceDef.identifier);
     if (!current) {
-      const object = create<{ value: CapabilityImpl<unknown>[] }>({ value: [] });
+      const object = live<{ value: CapabilityImpl<unknown>[] }>({ value: [] });
       current = untracked(() => object.value);
       this._definedCapabilities.set(interfaceDef.identifier, current);
     }

package/src/core/events.ts

@@ -3,7 +3,10 @@
 //
 
 /**
- * An event which activates a plugin module.
+ * A unique string identifier representing an event.
+ * This is expected to be a URI, where initial parts are often the id of the plugin whose package defines the event.
+ *
+ * @example dxos.org/plugin/example/event/ready
  */
 export type ActivationEvent = {
   id: string;

package/src/core/manager.test.ts

@@ -11,7 +11,7 @@ import { raise } from '@dxos/debug';
 import { updateCounter } from '@dxos/echo-schema/testing';
 import { registerSignalsRuntime } from '@dxos/echo-signals';
 import { invariant } from '@dxos/invariant';
-import { create } from '@dxos/live-object';
+import { live } from '@dxos/live-object';
 
 import { contributes, defineCapability, type PluginsContext } from './capabilities';
 import { allOf, defineEvent, oneOf } from './events';
@@ -358,14 +358,14 @@ describe('PluginManager', () => {
         id,
         activatesOn: Events.Startup,
         activatesAfter: [stateEvent],
-        activate: () => contributes(Number, create({ number: 1 })),
+        activate: () => contributes(Number, live({ number: 1 })),
       }),
       defineModule({
         id: 'dxos.org/test/doubler',
         activatesOn: stateEvent,
         activate: (context) => {
           const counter = context.requestCapability(Number);
-          const state = create({ total: counter.number * 2 });
+          const state = live({ total: counter.number * 2 });
           const unsubscribe = effect(() => {
             state.total = counter.number * 2;
           });

package/src/core/manager.ts

@@ -6,7 +6,7 @@ import { untracked } from '@preact/signals-core';
 import { Array as A, Effect, Either, Match, pipe } from 'effect';
 
 import { Event } from '@dxos/async';
-import { create, type ReactiveObject } from '@dxos/live-object';
+import { live, type Live } from '@dxos/live-object';
 import { log } from '@dxos/log';
 import { type MaybePromise } from '@dxos/util';
 
@@ -49,7 +49,7 @@ export class PluginManager {
     reset: (id) => this._reset(id),
   });
 
-  private readonly _state: ReactiveObject<PluginManagerState>;
+  private readonly _state: Live<PluginManagerState>;
   private readonly _pluginLoader: PluginManagerOptions['pluginLoader'];
   private readonly _capabilities = new Map<string, AnyCapability[]>();
 
@@ -60,7 +60,7 @@ export class PluginManager {
     enabled = [],
   }: PluginManagerOptions) {
     this._pluginLoader = pluginLoader;
-    this._state = create({
+    this._state = live({
       plugins,
       core,
       enabled,
@@ -79,7 +79,7 @@ export class PluginManager {
    *
    * @reactive
    */
-  get plugins(): ReactiveObject<readonly Plugin[]> {
+  get plugins(): Live<readonly Plugin[]> {
     return this._state.plugins;
   }
 
@@ -88,7 +88,7 @@ export class PluginManager {
    *
    * @reactive
    */
-  get core(): ReactiveObject<readonly string[]> {
+  get core(): Live<readonly string[]> {
     return this._state.core;
   }
 
@@ -97,7 +97,7 @@ export class PluginManager {
    *
    * @reactive
    */
-  get enabled(): ReactiveObject<readonly string[]> {
+  get enabled(): Live<readonly string[]> {
     return this._state.enabled;
   }
 
@@ -106,7 +106,7 @@ export class PluginManager {
    *
    * @reactive
    */
-  get modules(): ReactiveObject<readonly PluginModule[]> {
+  get modules(): Live<readonly PluginModule[]> {
     return this._state.modules;
   }
 
@@ -115,7 +115,7 @@ export class PluginManager {
    *
    * @reactive
    */
-  get active(): ReactiveObject<readonly string[]> {
+  get active(): Live<readonly string[]> {
     return this._state.active;
   }
 
@@ -124,7 +124,7 @@ export class PluginManager {
    *
    * @reactive
    */
-  get eventsFired(): ReactiveObject<readonly string[]> {
+  get eventsFired(): Live<readonly string[]> {
     return this._state.eventsFired;
   }
 
@@ -133,7 +133,7 @@ export class PluginManager {
    *
    * @reactive
    */
-  get pendingReset(): ReactiveObject<readonly string[]> {
+  get pendingReset(): Live<readonly string[]> {
     return this._state.pendingReset;
   }
 

package/src/core/plugin.ts

@@ -42,7 +42,7 @@ interface PluginModuleInterface {
 
 /**
  * A unit of containment of modular functionality that can be provided to an application.
- * Plugins provide things like components, state, actions, etc. to the application.
+ * Activation of a module is async allowing for code to split and loaded lazily.
  */
 // NOTE: This is implemented as a class to prevent it from being proxied by PluginManager state.
 export class PluginModule implements PluginModuleInterface {
@@ -114,6 +114,7 @@ export type PluginMeta = {
 
 /**
  * A collection of modules that are be enabled/disabled as a unit.
+ * Plugins provide things such as components, state, actions, etc. to the application.
  */
 // NOTE: This is implemented as a class to prevent it from being proxied by PluginManager state.
 export class Plugin {

package/src/playground/generator/generator.ts

@@ -2,7 +2,7 @@
 // Copyright 2025 DXOS.org
 //
 
-import { Schema as S } from 'effect';
+import { Schema } from 'effect';
 
 import { Capabilities, Events } from '../../common';
 import { contributes, defineEvent, defineCapability, defineModule, definePlugin } from '../../core';
@@ -15,9 +15,9 @@ export const CountEvent = defineEvent('dxos.org/test/generator/count');
 export const createPluginId = (id: string) => `dxos.org/test/generator/${id}`;
 
 export const createGeneratorIntent = (id: string) => {
-  class Alert extends S.TaggedClass<Alert>()(`${createPluginId(id)}/action/alert`, {
-    input: S.Void,
-    output: S.Void,
+  class Alert extends Schema.TaggedClass<Alert>()(`${createPluginId(id)}/action/alert`, {
+    input: Schema.Void,
+    output: Schema.Void,
   }) {}
 
   return Alert as unknown as IntentSchema<any, any>;

package/src/playground/logger/schema.ts

@@ -2,11 +2,11 @@
 // Copyright 2025 DXOS.org
 //
 
-import { Schema as S } from 'effect';
+import { Schema } from 'effect';
 
-export class Log extends S.TaggedClass<Log>()('dxos.org/test/logger/log', {
-  input: S.Struct({
-    message: S.String,
+export class Log extends Schema.TaggedClass<Log>()('dxos.org/test/logger/log', {
+  input: Schema.Struct({
+    message: Schema.String,
   }),
-  output: S.Void,
+  output: Schema.Void,
 }) {}