@dxos/app-framework 0.10.0 → 0.11.1

package/src/ui/components/Surface/types.ts

@@ -2,32 +2,18 @@
 // Copyright 2023 DXOS.org
 //
 
-import type { FC, PropsWithChildren, ReactNode, Ref } from 'react';
+import type { ComponentType, FC, PropsWithChildren, ReactNode } from 'react';
 
-import type { DXN } from '@dxos/keys';
 import { log } from '@dxos/log';
 import type { MakeOptional, Position } from '@dxos/util';
 
-/**
- * A typed role token. Carries a role NSID for runtime dispatch plus a phantom
- * data type so consumers using `type={SomeToken}` and providers using
- * `AppSurface.object(SomeToken, ...)` share a single type-level contract.
- *
- * Mint via {@link makeType}. The `role` field holds the bare NSID (e.g.
- * `org.dxos.role.article`) — the dispatch key, `data-role` attribute value,
- * and what `.role` comparisons inside matched components see.
- */
-export type RoleToken<TData> = {
-  readonly role: string;
-  /** Covariant phantom; never accessed at runtime. */
-  readonly _phantom?: TData;
-};
+import * as Role from '../../../common/Role';
 
 /**
- * One entry in a {@link SurfaceFilter} — a role NSID plus the guard that
- * validates the data shape when the Surface dispatcher is matching that role.
+ * One entry in a {@link Filter} — a role NSID plus the guard that validates the
+ * data shape when the Surface dispatcher is matching that role.
  */
-export type SurfaceBinding = {
+export type Binding = {
   readonly role: string;
   readonly guard: (data: unknown) => boolean;
 };
@@ -37,53 +23,21 @@ export type SurfaceBinding = {
  * pairs so a provider can register against multiple roles while keeping the
  * role and its data shape in a single expression.
  */
-export type SurfaceFilter<TData> = {
-  readonly bindings: ReadonlyArray<SurfaceBinding>;
+export type Filter<TData> = {
+  readonly bindings: ReadonlyArray<Binding>;
   /** Covariant phantom; never accessed at runtime. */
   readonly _phantom?: TData;
 };
 
 /**
- * Narrow data type carried by a role token.
+ * Runtime guard for {@link Filter}. Distinguishes new-style filter bindings from
+ * legacy predicate filters.
  */
-export type TokenData<T> = T extends RoleToken<infer D> ? D : never;
-
-/**
- * Runtime guard for {@link SurfaceFilter}. Distinguishes new-style filter
- * bindings from legacy predicate filters.
- */
-export const isSurfaceFilter = (value: unknown): value is SurfaceFilter<any> =>
+export const isFilter = (value: unknown): value is Filter<any> =>
   typeof value === 'object' && value !== null && Array.isArray((value as { bindings?: unknown }).bindings);
 
 /**
- * Mints a typed role token. The NSID is validated at compile time via
- * {@link DXN.Name}: the final segment must be camelCase (no hyphens).
- * Dynamic NSIDs (template-literal / runtime strings) are validated at runtime.
- *
- * Identity is structural; all tokens with the same `role` string are
- * interchangeable at runtime.
- */
-export const makeType: {
-  <TData = unknown, T extends string = string>(
-    nsid: [DXN.Name<T>] extends [never] ? `Invalid NSID "${T}": final segment must be camelCase (no hyphens)` : T,
-  ): RoleToken<TData>;
-} = <TData>(nsid: string): RoleToken<TData> => {
-  // Runtime guard for dynamic NSIDs that bypass the compile-time DXN.Name<T> check.
-  if (
-    typeof nsid !== 'string' ||
-    !/^[a-zA-Z]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(\.[a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)+(\.[a-zA-Z][a-zA-Z0-9]{0,62})$/.test(
-      nsid,
-    )
-  ) {
-    throw new Error(
-      `Invalid role NSID: "${nsid}". Must be a dotted name with a camelCase final segment (no hyphens in the last segment).`,
-    );
-  }
-  return { role: nsid };
-};
-
-/**
- * Creates a {@link SurfaceFilter} from a role token and an optional guard.
+ * Creates a {@link Filter} from a role token and an optional guard.
  *
  * When `guard` is omitted the filter matches any data at the token's role
  * (role-only dispatch). Pass a guard to add runtime data-shape validation on
@@ -92,7 +46,7 @@ export const makeType: {
  * This is the framework-level primitive; `@dxos/app-toolkit` builds richer
  * domain-aware helpers (ECHO schema checks, literal matching, etc.) on top of it.
  */
-export const makeFilter = <TData>(token: RoleToken<TData>, guard?: (data: TData) => boolean): SurfaceFilter<TData> => {
+export const makeFilter = <TData>(token: Role.Role<TData>, guard?: (data: TData) => boolean): Filter<TData> => {
   const boundGuard =
     guard == null
       ? () => true
@@ -109,7 +63,7 @@ export const makeFilter = <TData>(token: RoleToken<TData>, guard?: (data: TData)
 
 /**
  * Typed Surface consumer props — carries the role/data-shape contract via a
- * {@link RoleToken}. The `type` prop is required; the string `role` prop has
+ * {@link Role.Role}. The `type` prop is required; the string `role` prop has
  * been removed from the consumer-facing API.
  */
 export type Props<T extends Record<string, any> = Record<string, unknown>> = {
@@ -128,16 +82,16 @@ export type Props<T extends Record<string, any> = Record<string, unknown>> = {
 
 /**
  * Typed Surface consumer props — carries the role/data-shape contract via a
- * {@link RoleToken}. Available as a typed overload of the Surface component so
+ * {@link Role.Role}. Available as a typed overload of the Surface component so
  * ad-hoc `type` fields on arbitrary spread props don't conflict with the
  * untyped consumer form.
  */
-export type TypedProps<TToken extends RoleToken<any>> = {
+export type TypedProps<TToken extends Role.Role<any>> = {
   fallback?: FC<{ error: Error; data?: any }>;
   placeholder?: ReactNode;
   id?: string;
   type: TToken;
-  data?: TokenData<TToken>;
+  data?: Role.Data<TToken>;
   limit?: number | undefined;
 } & {
   /**
@@ -163,7 +117,7 @@ export type CoreProps<T extends Record<string, any> = Record<string, unknown>> =
   /**
    * The role token defining how the data should be rendered.
    */
-  type: RoleToken<T>;
+  type: Role.Role<T>;
 
   /**
    * The data to be rendered by the surface.
@@ -177,7 +131,6 @@ export type CoreProps<T extends Record<string, any> = Record<string, unknown>> =
   limit?: number | undefined;
 }>;
 
-// TODO(burdon): Remove ref since relying on this would be error prone.
 export type ComponentProps<T extends Record<string, any> = Record<string, any>> = {
   /**
    * The resolved role NSID string (e.g. `org.dxos.role.article`). Present on
@@ -185,7 +138,6 @@ export type ComponentProps<T extends Record<string, any> = Record<string, any>>
    * by comparing against a token's `.role` (e.g. `role === AppSurface.Section.role`).
    */
   role: string;
-  ref?: Ref<HTMLElement>;
 } & PropsWithChildren<{
   id: string;
   data: T;
@@ -205,7 +157,7 @@ export type ComponentFunction<T extends Record<string, any> = Record<string, any
  *
  * The optional `filter` receives the consumer-supplied `role` as its second
  * argument so a single definition can encode role-specific guards (used by the
- * {@link SurfaceFilter}-based `create` overload).
+ * {@link Filter}-based `create` overload).
  *
  * @internal The `role` field is populated by the framework from the filter
  *   bindings and is not authored directly.
@@ -215,7 +167,9 @@ export type ReactDefinition<T extends Record<string, any> = any> = Readonly<{
   id: string;
   role: string | string[];
   position?: Position.Position;
-  component: ComponentFunction<T>;
+  component: ComponentType<any>;
+  /** Maps the surface props onto the component's props; see {@link TypedReactDefinition.props}. */
+  props?: (props: ComponentProps<T>) => Record<string, any>;
   filter?: (data: Record<string, unknown>, role?: string) => data is T;
 }>;
 
@@ -246,11 +200,35 @@ export type Definition<T extends Record<string, any> = any> = ReactDefinition<T>
 /**
  * Typed React surface definition — role is derived from the filter's bindings.
  */
-export type TypedReactDefinition<T extends Record<string, any> = any> = Readonly<{
+export type TypedReactDefinition<
+  T extends Record<string, any> = any,
+  P extends Record<string, any> = ComponentProps<T>,
+> = Readonly<{
   id: string;
-  filter: SurfaceFilter<T>;
-  component: ComponentFunction<T>;
+  filter: Filter<T>;
   position?: Position.Position;
+  /**
+   * Accepts any component type (not just a function) so a container re-exported through a
+   * `lazy()` barrel as `ComponentType<any>` can be registered without a cast.
+   */
+  component: ComponentType<P>;
+  /**
+   * Maps the surface props onto the component's own props, so a plain container can be registered
+   * directly instead of being wrapped in an adapter that unpacks `data`.
+   *
+   * Prefer this over an inline `component: ({ data }) => <Container … />`: the mapper's input type
+   * derives from the same `filter` that defines the surface's data shape, so the unpacking is
+   * checked against the filter rather than restated by hand.
+   *
+   * @example
+   * Surface.create({
+   *   id: 'defaultPluginSettings',
+   *   filter: AppSurface.settings(AppSurface.Article),
+   *   component: DefaultSettings,
+   *   props: ({ data: { subject } }) => ({ subject }),
+   * });
+   */
+  props?: (props: ComponentProps<T>) => P;
 }>;
 
 /**
@@ -258,13 +236,13 @@ export type TypedReactDefinition<T extends Record<string, any> = any> = Readonly
  */
 export type TypedWebComponentDefinition<T extends Record<string, any> = any> = Readonly<{
   id: string;
-  filter: SurfaceFilter<T>;
+  filter: Filter<T>;
   tagName: string;
   position?: Position.Position;
 }>;
 
 const expandBindings = <T extends Record<string, any>>(
-  filter: SurfaceFilter<T>,
+  filter: Filter<T>,
 ): { role: string | string[]; guard: (data: Record<string, unknown>, role?: string) => data is T } => {
   const bindings = filter.bindings;
   const roles = Array.from(new Set(bindings.map((binding) => binding.role)));
@@ -280,33 +258,31 @@ const expandBindings = <T extends Record<string, any>>(
 };
 
 /**
- * Validates that a surface or extension local ID follows NSID conventions:
- * each dot-separated segment must be alphanumeric, and the final segment must
- * be camelCase (no hyphens). This mirrors the rule enforced when the id is
- * appended to a plugin's NSID to form a full DXN path.
+ * Whether a surface or extension local ID follows NSID conventions: the final
+ * dot-separated segment must be camelCase (letters and digits only, starting
+ * with a letter — no hyphens or underscores). This mirrors the rule enforced
+ * when the id is appended to a plugin's NSID to form a full DXN path.
+ *
+ * A definition with an invalid id is dropped at dispatch rather than rejected
+ * here, so a single malformed contribution cannot crash plugin activation.
  *
  * @example Valid:   'about', 'integrationArticle', 'article.journal'
  * @example Invalid: 'integration-article', 'plugin-spec'
  */
-const validateLocalId = (id: string): void => {
-  const segments = id.split('.');
-  const finalSegment = segments[segments.length - 1];
-  if (!/^[a-zA-Z][a-zA-Z0-9]*$/.test(finalSegment)) {
-    throw new Error(
-      `Invalid surface id: "${id}". The final segment "${finalSegment}" must be camelCase (letters and digits only, starting with a letter — no hyphens or underscores).`,
-    );
-  }
-};
+export const isValidLocalId = (id: string): boolean => /^[a-zA-Z][a-zA-Z0-9]*$/.test(id.split('.').pop() ?? '');
 
 /**
  * Creates a React surface definition from a typed filter.
  */
-export function create<T extends Record<string, any> = any>(definition: TypedReactDefinition<T>): ReactDefinition<T>;
-export function create<T extends Record<string, any> = any>(definition: TypedReactDefinition<T>): ReactDefinition<T> {
-  validateLocalId(definition.id);
-  const { id, filter, component, position } = definition;
+export function create<T extends Record<string, any> = any, P extends Record<string, any> = ComponentProps<T>>(
+  definition: TypedReactDefinition<T, P>,
+): ReactDefinition<T>;
+export function create<T extends Record<string, any> = any, P extends Record<string, any> = ComponentProps<T>>(
+  definition: TypedReactDefinition<T, P>,
+): ReactDefinition<T> {
+  const { id, filter, component, props, position } = definition;
   const { role, guard } = expandBindings(filter);
-  return { kind: 'react', id, role, position, component, filter: guard };
+  return { kind: 'react', id, role, position, component, props, filter: guard };
 }
 
 /**
@@ -318,7 +294,6 @@ export function createWeb<T extends Record<string, any> = any>(
 export function createWeb<T extends Record<string, any> = any>(
   definition: TypedWebComponentDefinition<T>,
 ): WebComponentDefinition<T> {
-  validateLocalId(definition.id);
   const { id, filter, tagName, position } = definition;
   const { role, guard } = expandBindings(filter);
   return { kind: 'web-component', id, role, position, tagName, filter: guard };

package/src/ui/components/index.ts

@@ -3,5 +3,7 @@
 //
 
 export * from './App';
+export * from './HomeSection';
+export * from './NamePopover';
 export * from './PluginManager';
 export * from './Surface';

package/src/ui/hooks/useApp.tsx

@@ -19,7 +19,7 @@ import { ContextProtocolProvider } from '@dxos/web-context-react';
 import { ActivationEvents, Capabilities } from '../../common';
 import { PluginManagerContext } from '../../context';
 import { type ActivationEvent, type Plugin, PluginManager } from '../../core';
-import { App, PluginManagerProvider } from '../components';
+import { App, PluginManagerProvider, SurfaceManager, SurfaceManagerProvider } from '../components';
 
 const ENABLED_KEY = 'org.dxos.app-framework.enabled';
 
@@ -317,19 +317,23 @@ export const useApp = ({
   const progressRef = useRef(startupProgress);
   progressRef.current = startupProgress;
 
+  const surfaces = useMemo(() => new SurfaceManager(manager.capabilities), [manager]);
+
   return useCallback(
     () => (
       <ErrorBoundary name='app' FallbackComponent={fallback}>
         <PluginManagerProvider value={manager}>
           <ContextProtocolProvider value={manager} context={PluginManagerContext}>
             <RegistryContext.Provider value={manager.registry}>
-              <App ready={ready} error={error} debounce={debounce} progress={progressRef.current} />
+              <SurfaceManagerProvider value={surfaces}>
+                <App ready={ready} error={error} debounce={debounce} progress={progressRef.current} />
+              </SurfaceManagerProvider>
             </RegistryContext.Provider>
           </ContextProtocolProvider>
         </PluginManagerProvider>
       </ErrorBoundary>
     ),
-    [fallback, manager, ready, error],
+    [fallback, manager, surfaces, ready, error],
   );
 };
 

package/src/vite-plugin/boot-loader/loader-app/boot-loader.css

@@ -14,7 +14,7 @@ body {
 /*
  * Defaults match `@dxos/ui-theme`'s `--color-base-surface`, which resolves to
  * Tailwind's `neutral-50` / `neutral-950` in light / dark mode respectively
- * (see `packages/ui/ui-theme/src/css/theme/semantic.css`). Hosts can override
+ * (see `packages/ui/ui-theme/src/css/theme/surfaces.css`). Hosts can override
  * with the `--boot-loader-bg-*` / `--boot-loader-fg-*` custom properties on
  * `:root` if they need a different palette. Keeping the boot loader's
  * background identical to the app's `body` eliminates the flash on handoff

package/tsconfig.json

@@ -37,6 +37,9 @@
     {
       "path": "../../common/random"
     },
+    {
+      "path": "../../common/storybook-addon-logger"
+    },
     {
       "path": "../../common/storybook-utils"
     },

package/vite.config.ts

@@ -0,0 +1,26 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { defineConfig } from '../../../vite.base.config.ts';
+
+export default defineConfig({
+  entry: {
+    'vite-plugin': 'src/vite-plugin/index.ts',
+    'index': 'src/index.ts',
+    'core/activation-event': 'src/core/activation-event.ts',
+    'common/activation-events': 'src/common/activation-events.ts',
+    'common/capabilities': 'src/common/capabilities.ts',
+    'core/capability': 'src/core/capability.ts',
+    'core/plugin': 'src/core/plugin.ts',
+    'core/plugin-manager': 'src/core/plugin-manager.ts',
+    'core/url-loader': 'src/core/url-loader.ts',
+    'config': 'src/config/index.ts',
+    'cli': 'src/cli/index.ts',
+    'testing': 'src/testing/index.ts',
+    'testing/react': 'src/testing/react.tsx',
+    'ui': 'src/ui/index.ts',
+  },
+  jsx: 'react',
+  test: { node: { environment: 'jsdom' }, storybook: true },
+});

package/dist/lib/browser/capability-S44TE2H7.mjs

@@ -1,35 +0,0 @@
-import {
-  make,
-  make2
-} from "./chunk-SYXIYT6T.mjs";
-import "./chunk-Q2GLJTVV.mjs";
-import {
-  capabilities_exports
-} from "./chunk-NKVRSMFN.mjs";
-import "./chunk-VF37YTXJ.mjs";
-import "./chunk-YUVQIOTB.mjs";
-import "./chunk-LUH4Y5F2.mjs";
-import "./chunk-UGYCLOXE.mjs";
-import "./chunk-3NQLTQCP.mjs";
-import "./chunk-OO53M5UK.mjs";
-import {
-  capability_exports
-} from "./chunk-OPTS3ZSN.mjs";
-import "./chunk-J5LGTIGS.mjs";
-
-// src/plugin-process-manager/history/capability.ts
-import * as Effect from "effect/Effect";
-var capability_default = capability_exports.makeModule(Effect.fnUntraced(function* () {
-  const capabilities = yield* capability_exports.Service;
-  const undoRegistry = make(() => capabilities.getAll(capabilities_exports.UndoMapping).flat());
-  const invoker = yield* capability_exports.get(capabilities_exports.OperationInvoker);
-  const historyTracker = make2(invoker, undoRegistry);
-  return [
-    capability_exports.contributes(capabilities_exports.UndoRegistry, undoRegistry),
-    capability_exports.contributes(capabilities_exports.HistoryTracker, historyTracker)
-  ];
-}));
-export {
-  capability_default as default
-};
-//# sourceMappingURL=capability-S44TE2H7.mjs.map

package/dist/lib/browser/capability-S44TE2H7.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/plugin-process-manager/history/capability.ts"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { OperationInvoker } from '@dxos/operation';\n\nimport { Capabilities } from '../../common';\nimport { Capability } from '../../core';\nimport * as HistoryTracker from './history-tracker';\nimport * as UndoRegistry from './undo-registry';\n\n//\n// Capability Module - contributes both UndoRegistry and HistoryTracker.\n//\n\nexport default Capability.makeModule(\n  Effect.fnUntraced(function* () {\n    // Get the context for synchronous access in callbacks.\n    const capabilities = yield* Capability.Service;\n\n    // Create UndoRegistry.\n    const undoRegistry = UndoRegistry.make(() => capabilities.getAll(Capabilities.UndoMapping).flat());\n\n    // Create HistoryTracker (depends on UndoRegistry and OperationInvoker).\n    const invoker = yield* Capability.get(Capabilities.OperationInvoker);\n    // Cast to internal type - the factory always returns OperationInvokerInternal.\n    const historyTracker = HistoryTracker.make(invoker as OperationInvoker.OperationInvokerInternal, undoRegistry);\n\n    return [\n      Capability.contributes(Capabilities.UndoRegistry, undoRegistry),\n      Capability.contributes(Capabilities.HistoryTracker, historyTracker),\n    ];\n  }),\n);\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;AAIA,YAAYA,YAAY;AAaxB,IAAA,qBAAeC,mBAAWC,WACjBC,kBAAW,aAAA;AAEhB,QAAMC,eAAe,OAAOH,mBAAWI;AAGvC,QAAMC,eAA4BC,KAAK,MAAMH,aAAaI,OAAOC,qBAAaC,WAAW,EAAEC,KAAI,CAAA;AAG/F,QAAMC,UAAU,OAAOX,mBAAWY,IAAIJ,qBAAaK,gBAAgB;AAEnE,QAAMC,iBAAgCR,MAAKK,SAAsDN,YAAAA;AAEjG,SAAO;IACLL,mBAAWe,YAAYP,qBAAaQ,cAAcX,YAAAA;IAClDL,mBAAWe,YAAYP,qBAAaS,gBAAgBH,cAAAA;;AAExD,CAAA,CAAA;",
-  "names": ["Effect", "Capability", "makeModule", "fnUntraced", "capabilities", "Service", "undoRegistry", "make", "getAll", "Capabilities", "UndoMapping", "flat", "invoker", "get", "OperationInvoker", "historyTracker", "contributes", "UndoRegistry", "HistoryTracker"]
-}

package/dist/lib/browser/chunk-3NQLTQCP.mjs

@@ -1,47 +0,0 @@
-import {
-  __export
-} from "./chunk-J5LGTIGS.mjs";
-
-// src/core/activation-event.ts
-var activation_event_exports = {};
-__export(activation_event_exports, {
-  allOf: () => allOf,
-  eventKey: () => eventKey,
-  getEvents: () => getEvents,
-  isAllOf: () => isAllOf,
-  isOneOf: () => isOneOf,
-  make: () => make,
-  oneOf: () => oneOf
-});
-import { DXN } from "@dxos/keys";
-import { compositeKey } from "@dxos/util";
-var make = (nsid, specifier) => ({
-  id: DXN.make(nsid),
-  specifier
-});
-var eventKey = (event) => event.specifier ? compositeKey(event.id, event.specifier) : event.id;
-var oneOf = (...events) => ({
-  type: "one-of",
-  events
-});
-var allOf = (...events) => ({
-  type: "all-of",
-  events
-});
-var isOneOf = (events) => "type" in events && events.type === "one-of";
-var isAllOf = (events) => "type" in events && events.type === "all-of";
-var getEvents = (events) => "type" in events ? events.events : [
-  events
-];
-
-export {
-  make,
-  eventKey,
-  oneOf,
-  allOf,
-  isOneOf,
-  isAllOf,
-  getEvents,
-  activation_event_exports
-};
-//# sourceMappingURL=chunk-3NQLTQCP.mjs.map

package/dist/lib/browser/chunk-3NQLTQCP.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/core/activation-event.ts"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { DXN } from '@dxos/keys';\nimport { compositeKey } from '@dxos/util';\n\n/**\n * A unique DXN identifier representing an event.\n *\n * @example dxn:org.dxos.plugin.example.event.ready\n */\nexport type ActivationEvent = {\n  id: DXN.DXN;\n  specifier?: string;\n};\n\n/**\n * An activation event that can be a single event, or a combination of events.\n */\nexport type Events =\n  | ActivationEvent\n  | { type: 'one-of'; events: ActivationEvent[] }\n  | { type: 'all-of'; events: ActivationEvent[] };\n\n/**\n * Helper to define an activation event from an NSID.\n * Static NSID strings are validated at compile time via {@link DXN.Name}.\n */\nexport const make: {\n  <T extends string>(\n    nsid: [DXN.Name<T>] extends [never] ? `Invalid NSID \"${T}\": final segment must be camelCase (no hyphens)` : T,\n    specifier?: string,\n  ): ActivationEvent;\n} = (nsid: string, specifier?: string): ActivationEvent => ({\n  id: DXN.make(nsid),\n  specifier,\n});\n\n/**\n * Helper to create an activation event key.\n */\nexport const eventKey = (event: ActivationEvent) =>\n  event.specifier ? compositeKey(event.id, event.specifier) : event.id;\n\n/**\n * Helper to create an activation event that triggers when any of the given events are activated.\n */\nexport const oneOf = (...events: ActivationEvent[]) => ({ type: 'one-of' as const, events });\n\n/**\n * Helper to create an activation event that triggers when all of the given events are activated.\n */\nexport const allOf = (...events: ActivationEvent[]) => ({ type: 'all-of' as const, events });\n\n/**\n * Helper to check if an activation event is a one-of event.\n */\nexport const isOneOf = (events: Events): events is { type: 'one-of'; events: ActivationEvent[] } =>\n  'type' in events && events.type === 'one-of';\n\n/**\n * Helper to check if an activation event is an all-of event.\n */\nexport const isAllOf = (events: Events): events is { type: 'all-of'; events: ActivationEvent[] } =>\n  'type' in events && events.type === 'all-of';\n\n/**\n * Helper to get the events from an activation event.\n */\nexport const getEvents = (events: Events) => ('type' in events ? events.events : [events]);\n"],
-  "mappings": ";;;;;AAAA;;;;;;;;;;AAIA,SAASA,WAAW;AACpB,SAASC,oBAAoB;AAwBtB,IAAMC,OAKT,CAACC,MAAcC,eAAyC;EAC1DC,IAAIL,IAAIE,KAAKC,IAAAA;EACbC;AACF;AAKO,IAAME,WAAW,CAACC,UACvBA,MAAMH,YAAYH,aAAaM,MAAMF,IAAIE,MAAMH,SAAS,IAAIG,MAAMF;AAK7D,IAAMG,QAAQ,IAAIC,YAA+B;EAAEC,MAAM;EAAmBD;AAAO;AAKnF,IAAME,QAAQ,IAAIF,YAA+B;EAAEC,MAAM;EAAmBD;AAAO;AAKnF,IAAMG,UAAU,CAACH,WACtB,UAAUA,UAAUA,OAAOC,SAAS;AAK/B,IAAMG,UAAU,CAACJ,WACtB,UAAUA,UAAUA,OAAOC,SAAS;AAK/B,IAAMI,YAAY,CAACL,WAAoB,UAAUA,SAASA,OAAOA,SAAS;EAACA;;",
-  "names": ["DXN", "compositeKey", "make", "nsid", "specifier", "id", "eventKey", "event", "oneOf", "events", "type", "allOf", "isOneOf", "isAllOf", "getEvents"]
-}

package/dist/lib/browser/chunk-53HJHMS5.mjs

@@ -1,7 +0,0 @@
-// src/config/index.ts
-import { Config2 } from "@dxos/protocols";
-
-export {
-  Config2
-};
-//# sourceMappingURL=chunk-53HJHMS5.mjs.map

package/dist/lib/browser/chunk-53HJHMS5.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/config/index.ts"],
-  "sourcesContent": ["//\n// Copyright 2026 DXOS.org\n//\n\nexport { Config2 } from '@dxos/protocols';\n"],
-  "mappings": ";AAIA,SAASA,eAAe;",
-  "names": ["Config2"]
-}

package/dist/lib/browser/chunk-FJ4765WW.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/context.ts"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { createContext } from '@dxos/web-context';\n\nimport { type PluginManager } from './core';\n\nexport const PluginManagerContext = createContext<PluginManager.PluginManager>('org.dxos.app-framework.plugin-manager');\n"],
-  "mappings": ";AAIA,SAASA,qBAAqB;AAIvB,IAAMC,uBAAuBD,cAA2C,uCAAA;",
-  "names": ["createContext", "PluginManagerContext"]
-}

package/dist/lib/browser/chunk-J5LGTIGS.mjs

@@ -1,10 +0,0 @@
-var __defProp = Object.defineProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-
-export {
-  __export
-};
-//# sourceMappingURL=chunk-J5LGTIGS.mjs.map

package/dist/lib/browser/chunk-J5LGTIGS.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": [],
-  "sourcesContent": [],
-  "mappings": "",
-  "names": []
-}