@dxos/app-framework 0.7.4 → 0.7.5-main.9cb18ac

package/dist/lib/node/chunk-VWHAALIN.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/plugins/plugin-intent/IntentPlugin.tsx", "../../../src/plugins/plugin-intent/IntentContext.tsx", "../../../src/plugins/plugin-intent/intent-dispatcher.ts", "../../../src/plugins/plugin-intent/intent.ts", "../../../src/plugins/plugin-intent/meta.ts", "../../../src/plugins/plugin-intent/provides.ts", "../../../src/plugins/plugin-intent/index.ts"],
+  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { Effect } from 'effect';\nimport React from 'react';\n\nimport { create } from '@dxos/live-object';\n\nimport { IntentProvider } from './IntentContext';\nimport { createDispatcher, type AnyIntentResolver, type IntentContext } from './intent-dispatcher';\nimport IntentMeta from './meta';\nimport { type IntentPluginProvides, type ResolverDefinitions, parseIntentResolverPlugin } from './provides';\nimport { filterPlugins } from '../helpers';\nimport { type PluginDefinition } from '../plugin-host';\n\nconst defaultEffect = () => Effect.fail(new Error('Intent runtime not ready'));\nconst defaultPromise = () => Effect.runPromise(defaultEffect());\n\n/**\n * Allows plugins to register intent handlers and routes sent intents to the appropriate plugin.\n * Inspired by https://developer.android.com/reference/android/content/Intent.\n */\nexport const IntentPlugin = (): PluginDefinition<IntentPluginProvides> => {\n  const state = create<IntentContext>({\n    dispatch: defaultEffect,\n    dispatchPromise: defaultPromise,\n    undo: defaultEffect,\n    undoPromise: defaultPromise,\n    registerResolver: () => () => {},\n  });\n\n  return {\n    meta: IntentMeta,\n    ready: async ({ plugins }) => {\n      const resolvers = Object.fromEntries(\n        filterPlugins(plugins, parseIntentResolverPlugin).map((plugin): [string, AnyIntentResolver[]] => {\n          const resolvers = reduceResolvers(\n            plugin.provides.intent.resolvers({\n              plugins,\n              dispatch: (intent) => state.dispatch(intent),\n              dispatchPromise: (intent) => state.dispatchPromise(intent),\n              undo: () => state.undo(),\n              undoPromise: () => state.undoPromise(),\n              registerResolver: (id, resolver) => state.registerResolver(id, resolver),\n            }),\n          );\n          return [plugin.meta.id, resolvers];\n        }),\n      );\n      const { dispatch, dispatchPromise, undo, undoPromise, registerResolver } = createDispatcher(resolvers);\n\n      state.dispatch = dispatch;\n      state.dispatchPromise = dispatchPromise;\n      state.undo = undo;\n      state.undoPromise = undoPromise;\n      state.registerResolver = registerResolver;\n    },\n    provides: {\n      intent: state,\n      context: ({ children }) => <IntentProvider value={state}>{children}</IntentProvider>,\n    },\n  };\n};\n\nconst reduceResolvers = (\n  definitions: ResolverDefinitions,\n  resolvers: AnyIntentResolver[] = [],\n): AnyIntentResolver[] => {\n  if (Array.isArray(definitions)) {\n    return definitions.reduce((acc: AnyIntentResolver[], definition) => reduceResolvers(definition, acc), resolvers);\n  }\n\n  return [...resolvers, definitions];\n};\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { type Context, createContext, useContext, type Provider, useEffect } from 'react';\n\nimport { raise } from '@dxos/debug';\nimport { pick } from '@dxos/util';\n\nimport { type AnyIntentResolver, type IntentContext } from './intent-dispatcher';\n\nconst IntentContext: Context<IntentContext | undefined> = createContext<IntentContext | undefined>(undefined);\n\nexport const useIntentDispatcher = (): Pick<IntentContext, 'dispatch' | 'dispatchPromise'> => {\n  const context = useContext(IntentContext) ?? raise(new Error('IntentContext not found'));\n  return pick(context, ['dispatch', 'dispatchPromise']);\n};\n\nexport const useIntentResolver = (pluginId: string, resolver: AnyIntentResolver) => {\n  const { registerResolver } = useContext(IntentContext) ?? raise(new Error('IntentContext not found'));\n  useEffect(() => {\n    return registerResolver(pluginId, resolver);\n  }, [pluginId, resolver]);\n};\n\nexport const IntentProvider: Provider<IntentContext | undefined> = IntentContext.Provider;\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { Effect, Ref } from 'effect';\n\nimport { type MaybePromise, pick } from '@dxos/util';\n\nimport {\n  createIntent,\n  IntentAction,\n  type AnyIntent,\n  type AnyIntentChain,\n  type Intent,\n  type IntentChain,\n  type IntentData,\n  type IntentParams,\n  type IntentResultData,\n  type IntentSchema,\n  type Label,\n} from './intent';\n\nconst EXECUTION_LIMIT = 100;\nconst HISTORY_LIMIT = 100;\n\n/**\n * The return value of an intent effect.\n */\nexport type IntentEffectResult<Fields extends IntentParams> = {\n  /**\n   * The output of the action that was performed.\n   *\n   * If the intent is apart of a chain of intents, the data will be passed to the next intent.\n   */\n  data?: IntentResultData<Fields>;\n\n  /**\n   * If provided, the action will be undoable.\n   */\n  undoable?: {\n    /**\n     * Message to display to the user when indicating that the action can be undone.\n     */\n    message: Label;\n\n    /**\n     * Will be merged with the original intent data when firing the undo intent.\n     */\n    data?: Partial<IntentData<Fields>>;\n  };\n\n  /**\n   * An error that occurred while performing the action.\n   *\n   * If the intent is apart of a chain of intents and an error occurs, the chain will be aborted.\n   */\n  error?: Error;\n\n  /**\n   * Other intent chains to be triggered.\n   */\n  intents?: AnyIntentChain[];\n};\n\nexport type AnyIntentEffectResult = IntentEffectResult<any>;\n\n/**\n * The result of an intent dispatcher.\n */\nexport type IntentDispatcherResult<Fields extends IntentParams> = Pick<IntentEffectResult<Fields>, 'data' | 'error'>;\n\n/**\n * Determines the priority of the effect when multiple intent resolvers are matched.\n *\n * - `static` - The effect is selected in the order it was resolved.\n * - `hoist` - The effect is selected before `static` effects.\n * - `fallback` - The effect is selected after `static` effects.\n */\nexport type IntentDisposition = 'static' | 'hoist' | 'fallback';\n\n/**\n * The implementation of an intent effect.\n */\nexport type IntentEffectDefinition<Fields extends IntentParams> = (\n  data: IntentData<Fields>,\n  undo: boolean,\n) => MaybePromise<IntentEffectResult<Fields> | void> | Effect.Effect<IntentEffectResult<Fields> | void>;\n\n/**\n * Intent resolver to match intents to their effects.\n */\nexport type IntentResolver<Tag extends string, Fields extends IntentParams> = {\n  action: Tag;\n  disposition?: IntentDisposition;\n  // TODO(wittjosiah): Would be nice to make this a guard for intents with optional data.\n  filter?: (data: IntentData<Fields>) => boolean;\n  effect: IntentEffectDefinition<Fields>;\n};\n\nexport type AnyIntentResolver = IntentResolver<any, any>;\n\n/**\n * Creates an intent resolver to match intents to their effects.\n * @param schema Schema of the intent. Must be a tagged class with input and output schemas.\n * @param effect Effect to be performed when the intent is resolved.\n * @param params.disposition Determines the priority of the resolver when multiple are resolved.\n * @param params.filter Optional filter to determine if the resolver should be used.\n */\nexport const createResolver = <Tag extends string, Fields extends IntentParams>(\n  schema: IntentSchema<Tag, Fields>,\n  effect: IntentEffectDefinition<Fields>,\n  params: Pick<IntentResolver<Tag, Fields>, 'disposition' | 'filter'> = {},\n): IntentResolver<Tag, Fields> => ({\n  action: schema._tag,\n  effect,\n  ...params,\n});\n\n/**\n * Invokes intents and returns the result.\n */\nexport type PromiseIntentDispatcher = <Fields extends IntentParams>(\n  intent: IntentChain<any, any, any, Fields>,\n) => Promise<IntentDispatcherResult<Fields>>;\n\n/**\n * Creates an effect for intents.\n */\nexport type IntentDispatcher = <Fields extends IntentParams>(\n  intent: IntentChain<any, any, any, Fields>,\n  depth?: number,\n) => Effect.Effect<IntentDispatcherResult<Fields>, Error>;\n\ntype IntentResult<Tag extends string, Fields extends IntentParams> = IntentEffectResult<Fields> & {\n  _intent: Intent<Tag, Fields>;\n};\n\ntype AnyIntentResult = IntentResult<any, any>;\n\n/**\n * Invokes the most recent undoable intent with undo flags.\n */\nexport type PromiseIntentUndo = () => Promise<IntentDispatcherResult<any> | undefined>;\n\n/**\n * Creates an effect which undoes the last intent.\n */\nexport type IntentUndo = () => Effect.Effect<IntentDispatcherResult<any> | undefined, Error>;\n\n/**\n * Check if a chain of results is undoable.\n */\nconst isUndoable = (historyEntry: AnyIntentResult[]): boolean =>\n  historyEntry.length > 0 && historyEntry.every(({ undoable }) => !!undoable);\n\nexport type IntentContext = {\n  dispatch: IntentDispatcher;\n  dispatchPromise: PromiseIntentDispatcher;\n  undo: IntentUndo;\n  undoPromise: PromiseIntentUndo;\n  registerResolver: (id: string, resolver: AnyIntentResolver) => () => void;\n};\n\n/**\n * Sets of an intent dispatcher.\n *\n * @param resolvers An array of available intent resolvers.\n * @param params.historyLimit The maximum number of intent results to keep in history.\n * @param params.executionLimit The maximum recursion depth of intent chains.\n */\nexport const createDispatcher = (\n  resolvers: Record<string, AnyIntentResolver[]>,\n  { executionLimit = EXECUTION_LIMIT, historyLimit = HISTORY_LIMIT } = {},\n): IntentContext => {\n  const historyRef = Effect.runSync(Ref.make<AnyIntentResult[][]>([]));\n\n  const handleIntent = (intent: AnyIntent) => {\n    return Effect.gen(function* () {\n      const candidates = Object.entries(resolvers)\n        .filter(([id, _]) => (intent.plugin ? id === intent.plugin : true))\n        .flatMap(([_, resolvers]) => resolvers)\n        .filter((r) => r.action === intent.action)\n        .filter((r) => !r.filter || r.filter(intent.data))\n        .toSorted(({ disposition: a = 'static' }, { disposition: b = 'static' }) => {\n          return a === b ? 0 : a === 'hoist' || b === 'fallback' ? -1 : b === 'hoist' || a === 'fallback' ? 1 : 0;\n        });\n      if (candidates.length === 0) {\n        return {\n          _intent: intent,\n          error: new Error(`No resolver found for action: ${intent.action}`),\n        } satisfies AnyIntentResult;\n      }\n\n      const effect = candidates[0].effect(intent.data, intent.undo ?? false);\n      const result = Effect.isEffect(effect) ? yield* effect : yield* Effect.promise(async () => effect);\n      return { _intent: intent, ...result } satisfies AnyIntentResult;\n    });\n  };\n\n  const dispatch: IntentDispatcher = (intentChain, depth = 0) => {\n    return Effect.gen(function* () {\n      if (depth > executionLimit) {\n        yield* Effect.fail(\n          new Error('Intent execution limit exceeded. This is likely due to an infinite loop within intent resolvers.'),\n        );\n      }\n\n      const resultsRef = yield* Ref.make<AnyIntentResult[]>([]);\n      for (const intent of intentChain.all) {\n        const { data: prev } = (yield* resultsRef.get)[0] ?? {};\n        const result = yield* handleIntent({ ...intent, data: { ...intent.data, ...prev } });\n        yield* Ref.update(resultsRef, (results) => [result, ...results]);\n        if (result.error) {\n          break;\n        }\n        if (result.intents) {\n          for (const intent of result.intents) {\n            // Returned intents are dispatched but not yielded into results,\n            // as such they cannot be undone.\n            // TODO(wittjosiah): Use higher execution concurrency?\n            yield* dispatch(intent, depth + 1);\n          }\n        }\n      }\n\n      const results = yield* resultsRef.get;\n      const result = results[0];\n      if (result) {\n        yield* Ref.update(historyRef, (history) => {\n          const next = [...history, results];\n          if (next.length > historyLimit) {\n            next.splice(0, next.length - historyLimit);\n          }\n          return next;\n        });\n\n        if (result.undoable && isUndoable(results)) {\n          // TODO(wittjosiah): Is there a better way to handle showing undo for chains?\n          yield* dispatch(createIntent(IntentAction.ShowUndo, { message: result.undoable.message }));\n        }\n\n        return pick(result, ['data', 'error']);\n      } else {\n        return { data: {}, error: new Error('No results') };\n      }\n    });\n  };\n\n  const dispatchPromise: PromiseIntentDispatcher = (intentChain) => {\n    const program = dispatch(intentChain);\n    return Effect.runPromise(program);\n  };\n\n  const undo: IntentUndo = () => {\n    return Effect.gen(function* () {\n      const history = yield* historyRef.get;\n      const last = history.findLastIndex(isUndoable);\n      const result = last !== -1 ? history[last] : undefined;\n      if (result) {\n        const all = result.map(({ _intent, undoable }): AnyIntent => {\n          const data = _intent.data;\n          const undoData = undoable?.data ?? {};\n          return { ..._intent, data: { ...data, ...undoData }, undo: true } satisfies AnyIntent;\n        });\n        const intent = { first: all[0], last: all.at(-1)!, all } satisfies AnyIntentChain;\n        yield* Ref.update(historyRef, (h) => h.filter((_, index) => index !== last));\n        return yield* dispatch(intent);\n      }\n    });\n  };\n\n  const undoPromise: PromiseIntentUndo = () => {\n    const program = undo();\n    return Effect.runPromise(program);\n  };\n\n  const registerResolver = (id: string, resolver: AnyIntentResolver) => {\n    resolvers[id] = [...(resolvers[id] ?? []), resolver];\n    return () => {\n      resolvers[id] = resolvers[id].filter((r) => r !== resolver);\n    };\n  };\n\n  return { dispatch, dispatchPromise, undo, undoPromise, registerResolver };\n};\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { S } from '@dxos/echo-schema';\n\nimport { INTENT_PLUGIN } from './meta';\n\nexport type IntentParams = {\n  readonly input: S.Schema.All;\n  readonly output: S.Schema.All;\n};\n\nexport type IntentData<Fields extends IntentParams> =\n  S.Schema.Type<S.Struct<Fields>> extends { readonly input: any } ? S.Schema.Type<S.Struct<Fields>>['input'] : any;\n\nexport type IntentResultData<Fields extends IntentParams> =\n  S.Schema.Type<S.Struct<Fields>> extends { readonly output: any } ? S.Schema.Type<S.Struct<Fields>>['output'] : any;\n\nexport type IntentSchema<Tag extends string, Fields extends IntentParams> = S.TaggedClass<any, Tag, Fields>;\n\n/**\n * An intent is an abstract description of an operation to be performed.\n * Intents allow actions to be performed across plugins.\n */\nexport type Intent<Tag extends string, Fields extends IntentParams> = {\n  _schema: IntentSchema<Tag, Fields>;\n\n  /**\n   * The action to perform.\n   */\n  action: Tag;\n\n  /**\n   * Any data needed to perform the desired action.\n   */\n  data: IntentData<Fields>;\n\n  /**\n   * Plugin ID.\n   * If specified, the intent will be sent explicitly to the plugin.\n   * Otherwise, the intent will be sent to all plugins, in order and the first to resolve a non-null value will be used.\n   */\n  plugin?: string;\n\n  /**\n   * Whether or not the intent is being undone.\n   */\n  undo?: boolean;\n};\n\nexport type AnyIntent = Intent<any, any>;\n\n/**\n * Chain of intents to be executed together.\n * The result of each intent is merged into the next intent's input data.\n */\nexport type IntentChain<\n  FirstTag extends string,\n  LastTag extends string,\n  FirstFields extends IntentParams,\n  LastFields extends IntentParams,\n> = {\n  first: Intent<FirstTag, FirstFields>;\n  last: Intent<LastTag, LastFields>;\n  all: AnyIntent[];\n};\n\nexport type AnyIntentChain = IntentChain<any, any, any, any>;\n\n/**\n * Creates a typed intent.\n * @param schema Schema of the intent. Must be a tagged class with input and output schemas.\n * @param data Data fulfilling the input schema of the intent.\n * @param params.plugin Optional plugin ID to send the intent to.\n * @param params.undo Optional flag to indicate that the intent is being undone. Generally not set manually.\n */\nexport const createIntent = <Tag extends string, Fields extends IntentParams>(\n  schema: IntentSchema<Tag, Fields>,\n  data: IntentData<Fields> = {},\n  params: Pick<AnyIntent, 'plugin' | 'undo'> = {},\n): IntentChain<Tag, Tag, Fields, Fields> => {\n  // The output of validateSync breaks proxy objects so this is just used for validation.\n  // TODO(wittjosiah): Is there a better way to make theses types align?\n  const _ = S.validateSync(schema.fields.input as S.Schema<any, any, unknown>)(data);\n  const intent = {\n    ...params,\n    _schema: schema,\n    action: schema._tag,\n    data,\n  } satisfies Intent<Tag, Fields>;\n\n  return {\n    first: intent,\n    last: intent,\n    all: [intent],\n  };\n};\n\n// TODO(wittjosiah): Add a function for mapping the output of one intent to the input of another.\n\n/**\n * Chain two intents together.\n *\n * NOTE: Chaining of intents depends on the data inputs and outputs being structs.\n */\nexport const chain =\n  <\n    FirstTag extends string,\n    NextTag extends string,\n    FirstFields extends IntentParams,\n    LastFields extends IntentParams,\n    NextFields extends IntentParams,\n  >(\n    schema: IntentSchema<NextTag, NextFields>,\n    data: Omit<IntentData<NextFields>, keyof IntentResultData<LastFields>> = {},\n    params: Pick<AnyIntent, 'plugin' | 'undo'> = {},\n  ) =>\n  (\n    intent: IntentChain<FirstTag, any, FirstFields, LastFields>,\n  ): IntentChain<FirstTag, NextTag, FirstFields, NextFields> => {\n    const intents = 'all' in intent ? intent.all : [intent];\n    const first = intents[0];\n    const last = {\n      ...params,\n      _schema: schema,\n      action: schema._tag,\n      data,\n    } satisfies Intent<NextTag, NextFields>;\n\n    return {\n      first,\n      last,\n      all: [...intents, last],\n    };\n  };\n\n//\n// Intents\n//\n\n// NOTE: Should maintain compatibility with `i18next` (and @dxos/react-ui).\n// TODO(wittjosiah): Making this immutable breaks type compatibility.\nexport const Label = S.Union(\n  S.String,\n  S.mutable(S.Tuple(S.String, S.mutable(S.Struct({ ns: S.String, count: S.optional(S.Number) })))),\n);\nexport type Label = S.Schema.Type<typeof Label>;\n\nexport const INTENT_ACTION = `${INTENT_PLUGIN}/action`;\n\nexport namespace IntentAction {\n  /**\n   * Fired after an intent is dispatched if the intent is undoable.\n   */\n  export class ShowUndo extends S.TaggedClass<ShowUndo>()(`${INTENT_ACTION}/show-undo`, {\n    input: S.Struct({\n      message: Label,\n    }),\n    output: S.Void,\n  }) {}\n}\n", "//\n// Copyright 2023 DXOS.org\n//\n\nexport const INTENT_PLUGIN = 'dxos.org/plugin/intent';\n\nconst IntentMeta = {\n  id: INTENT_PLUGIN,\n};\n\nexport default IntentMeta;\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { type IntentContext, type AnyIntentResolver } from './intent-dispatcher';\nimport { type HostContext, type Plugin } from '../plugin-host';\n\ntype Context = HostContext & IntentContext;\n\nexport type ResolverDefinitions = AnyIntentResolver | AnyIntentResolver[] | ResolverDefinitions[];\n\nexport type IntentResolverProvides = {\n  intent: {\n    resolvers: (context: Context) => ResolverDefinitions;\n  };\n};\n\nexport type IntentPluginProvides = {\n  intent: IntentContext;\n};\n\nexport const parseIntentPlugin = (plugin: Plugin) =>\n  (plugin.provides as any).intent?.dispatch ? (plugin as Plugin<IntentPluginProvides>) : undefined;\n\nexport const parseIntentResolverPlugin = (plugin: Plugin) =>\n  (plugin.provides as any).intent?.resolvers ? (plugin as Plugin<IntentResolverProvides>) : undefined;\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { IntentPlugin } from './IntentPlugin';\n\nexport * from './intent';\nexport * from './intent-dispatcher';\nexport * from './provides';\n\nexport * from './IntentContext';\n\nexport default IntentPlugin;\n"],
+  "mappings": "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",
+  "names": ["import_react", "import_effect", "import_util", "IntentContext", "createContext", "undefined", "useIntentDispatcher", "context", "useContext", "raise", "Error", "pick", "useIntentResolver", "pluginId", "resolver", "registerResolver", "useEffect", "IntentProvider", "Provider", "INTENT_PLUGIN", "IntentMeta", "id", "createIntent", "schema", "data", "params", "_", "S", "validateSync", "fields", "input", "intent", "_schema", "action", "_tag", "first", "last", "all", "chain", "intents", "Label", "Union", "String", "mutable", "Tuple", "Struct", "ns", "count", "optional", "Number", "INTENT_ACTION", "IntentAction", "ShowUndo", "TaggedClass", "message", "output", "Void", "EXECUTION_LIMIT", "HISTORY_LIMIT", "createResolver", "effect", "isUndoable", "historyEntry", "length", "every", "undoable", "createDispatcher", "resolvers", "executionLimit", "historyLimit", "historyRef", "Effect", "runSync", "Ref", "make", "handleIntent", "gen", "candidates", "Object", "entries", "filter", "plugin", "flatMap", "r", "toSorted", "disposition", "a", "b", "_intent", "error", "undo", "result", "isEffect", "promise", "dispatch", "intentChain", "depth", "fail", "resultsRef", "prev", "get", "update", "results", "history", "next", "splice", "dispatchPromise", "program", "runPromise", "findLastIndex", "map", "undoData", "at", "h", "index", "undoPromise", "parseIntentPlugin", "provides", "parseIntentResolverPlugin", "defaultEffect", "defaultPromise", "IntentPlugin", "state", "create", "meta", "ready", "plugins", "fromEntries", "filterPlugins", "reduceResolvers", "children", "React", "value", "definitions", "Array", "isArray", "reduce", "acc", "definition"]
+}

package/dist/lib/node/index.cjs

@@ -29,28 +29,41 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var node_exports = {};
 __export(node_exports, {
   ActiveParts: () => ActiveParts,
-  ErrorBoundary: () => import_chunk_SOVLKUWI.ErrorBoundary,
+  ErrorBoundary: () => import_chunk_BW3RNEVI.ErrorBoundary,
   HostPlugin: () => HostPlugin,
-  IntentAction: () => import_chunk_QSVP5HOW.IntentAction,
-  IntentProvider: () => import_chunk_QSVP5HOW.IntentProvider,
+  INTENT_ACTION: () => import_chunk_VWHAALIN.INTENT_ACTION,
+  IntentAction: () => import_chunk_VWHAALIN.IntentAction,
+  IntentProvider: () => import_chunk_VWHAALIN.IntentProvider,
+  LAYOUT_ACTION: () => LAYOUT_ACTION,
+  LAYOUT_PLUGIN: () => LAYOUT_PLUGIN,
+  Label: () => import_chunk_VWHAALIN.Label,
   Layout: () => Layout,
   LayoutAction: () => LayoutAction,
+  NAVIGATION_ACTION: () => NAVIGATION_ACTION,
+  NAVIGATION_PLUGIN: () => NAVIGATION_PLUGIN,
   NavigationAction: () => NavigationAction,
   Plugin: () => Plugin,
   PluginProvider: () => PluginProvider,
   Resource: () => Resource,
   ResourceKey: () => ResourceKey,
   ResourceLanguage: () => ResourceLanguage,
+  SETTINGS_ACTION: () => import_chunk_FCMHRU3M.SETTINGS_ACTION,
+  SETTINGS_PLUGIN: () => import_chunk_FCMHRU3M.SETTINGS_PLUGIN,
   SLUG_COLLECTION_INDICATOR: () => SLUG_COLLECTION_INDICATOR,
   SLUG_ENTRY_SEPARATOR: () => SLUG_ENTRY_SEPARATOR,
   SLUG_KEY_VALUE_SEPARATOR: () => SLUG_KEY_VALUE_SEPARATOR,
   SLUG_LIST_SEPARATOR: () => SLUG_LIST_SEPARATOR,
   SLUG_PATH_SEPARATOR: () => SLUG_PATH_SEPARATOR,
-  SettingsAction: () => import_chunk_JZ2JVKRY.SettingsAction,
-  Surface: () => import_chunk_SOVLKUWI.Surface,
-  SurfaceProvider: () => import_chunk_SOVLKUWI.SurfaceProvider,
+  SettingsAction: () => import_chunk_FCMHRU3M.SettingsAction,
+  Surface: () => import_chunk_BW3RNEVI.Surface,
+  SurfaceProvider: () => import_chunk_BW3RNEVI.SurfaceProvider,
   Toast: () => Toast,
+  chain: () => import_chunk_VWHAALIN.chain,
   createApp: () => createApp,
+  createDispatcher: () => import_chunk_VWHAALIN.createDispatcher,
+  createIntent: () => import_chunk_VWHAALIN.createIntent,
+  createResolver: () => import_chunk_VWHAALIN.createResolver,
+  createSurface: () => import_chunk_BW3RNEVI.createSurface,
   defaultFileTypes: () => defaultFileTypes,
   definePlugin: () => import_chunk_QBM42OQ6.definePlugin,
   filterPlugins: () => import_chunk_QBM42OQ6.filterPlugins,
@@ -61,45 +74,41 @@ __export(node_exports, {
   isLayoutAdjustment: () => isLayoutAdjustment,
   isLayoutMode: () => isLayoutMode,
   isLayoutParts: () => isLayoutParts,
-  isObject: () => import_chunk_SOVLKUWI.isObject,
+  isObject: () => import_chunk_BW3RNEVI.isObject,
   openIds: () => openIds,
   parseFileManagerPlugin: () => parseFileManagerPlugin,
   parseGraphBuilderPlugin: () => parseGraphBuilderPlugin,
   parseGraphPlugin: () => parseGraphPlugin,
   parseGraphSerializerPlugin: () => parseGraphSerializerPlugin,
-  parseIntentPlugin: () => import_chunk_QSVP5HOW.parseIntentPlugin,
-  parseIntentResolverPlugin: () => import_chunk_QSVP5HOW.parseIntentResolverPlugin,
+  parseIntentPlugin: () => import_chunk_VWHAALIN.parseIntentPlugin,
+  parseIntentResolverPlugin: () => import_chunk_VWHAALIN.parseIntentResolverPlugin,
   parseLayoutPlugin: () => parseLayoutPlugin,
   parseMetadataRecordsPlugin: () => parseMetadataRecordsPlugin,
   parseMetadataResolverPlugin: () => parseMetadataResolverPlugin,
   parseNavigationPlugin: () => parseNavigationPlugin,
-  parsePluginHost: () => parsePluginHost,
-  parseRootSurfacePlugin: () => import_chunk_SOVLKUWI.parseRootSurfacePlugin,
-  parseSettingsPlugin: () => import_chunk_JZ2JVKRY.parseSettingsPlugin,
-  parseSurfacePlugin: () => import_chunk_SOVLKUWI.parseSurfacePlugin,
+  parseRootSurfacePlugin: () => import_chunk_BW3RNEVI.parseRootSurfacePlugin,
+  parseSettingsPlugin: () => import_chunk_FCMHRU3M.parseSettingsPlugin,
+  parseSurfacePlugin: () => import_chunk_BW3RNEVI.parseSurfacePlugin,
   parseTranslationsPlugin: () => parseTranslationsPlugin,
   partLength: () => partLength,
   resolvePlugin: () => import_chunk_QBM42OQ6.resolvePlugin,
-  useIntent: () => import_chunk_QSVP5HOW.useIntent,
-  useIntentDispatcher: () => import_chunk_QSVP5HOW.useIntentDispatcher,
-  useIntentResolver: () => import_chunk_QSVP5HOW.useIntentResolver,
+  useIntentDispatcher: () => import_chunk_VWHAALIN.useIntentDispatcher,
+  useIntentResolver: () => import_chunk_VWHAALIN.useIntentResolver,
   usePlugin: () => usePlugin,
   usePlugins: () => usePlugins,
   useResolvePlugin: () => useResolvePlugin,
   useResolvePlugins: () => useResolvePlugins,
-  useSurface: () => import_chunk_SOVLKUWI.useSurface,
-  useSurfaceRoot: () => import_chunk_SOVLKUWI.useSurfaceRoot
+  useSurfaceRoot: () => import_chunk_BW3RNEVI.useSurfaceRoot
 });
 module.exports = __toCommonJS(node_exports);
-var import_chunk_QSVP5HOW = require("./chunk-QSVP5HOW.cjs");
-var import_chunk_SOVLKUWI = require("./chunk-SOVLKUWI.cjs");
+var import_chunk_VWHAALIN = require("./chunk-VWHAALIN.cjs");
+var import_chunk_BW3RNEVI = require("./chunk-BW3RNEVI.cjs");
 var import_chunk_QBM42OQ6 = require("./chunk-QBM42OQ6.cjs");
-var import_chunk_JZ2JVKRY = require("./chunk-JZ2JVKRY.cjs");
-var import_zod = require("zod");
+var import_chunk_FCMHRU3M = require("./chunk-FCMHRU3M.cjs");
+var import_echo_schema = require("@dxos/echo-schema");
 var import_schema = require("@effect/schema");
-var import_zod2 = require("zod");
 var import_util = require("@dxos/util");
-var import_zod3 = require("zod");
+var import_zod = require("zod");
 var import_react = __toESM(require("react"));
 var import_local_storage = require("@dxos/local-storage");
 var import_react2 = __toESM(require("react"));
@@ -134,65 +143,116 @@ var parseFileManagerPlugin = (plugin) => {
 var parseGraphPlugin = (plugin) => plugin.provides.graph?.root ? plugin : void 0;
 var parseGraphBuilderPlugin = (plugin) => plugin.provides.graph?.builder ? plugin : void 0;
 var parseGraphSerializerPlugin = (plugin) => plugin.provides.graph?.serializer ? plugin : void 0;
-var Toast = import_zod.z.object({
-  id: import_zod.z.string(),
-  title: import_zod.z.string().optional(),
-  description: import_zod.z.string().optional(),
-  // TODO(wittjosiah): `icon` should be string to be parsed by an `Icon` component.
-  icon: import_zod.z.any().optional(),
-  duration: import_zod.z.number().optional(),
-  closeLabel: import_zod.z.string().optional(),
-  actionLabel: import_zod.z.string().optional(),
-  actionAlt: import_zod.z.string().optional(),
-  onAction: import_zod.z.function().optional()
+var Toast = import_echo_schema.S.Struct({
+  id: import_echo_schema.S.String,
+  title: import_echo_schema.S.optional(import_chunk_VWHAALIN.Label),
+  description: import_echo_schema.S.optional(import_chunk_VWHAALIN.Label),
+  icon: import_echo_schema.S.optional(import_echo_schema.S.String),
+  duration: import_echo_schema.S.optional(import_echo_schema.S.Number),
+  closeLabel: import_echo_schema.S.optional(import_chunk_VWHAALIN.Label),
+  actionLabel: import_echo_schema.S.optional(import_chunk_VWHAALIN.Label),
+  actionAlt: import_echo_schema.S.optional(import_chunk_VWHAALIN.Label),
+  // TODO(wittjosiah): Make class with customizable method?
+  onAction: import_echo_schema.S.optional(import_echo_schema.S.Any)
 });
-var LayoutMode = import_zod.z.union([
-  import_zod.z.literal("deck"),
-  import_zod.z.literal("solo"),
-  import_zod.z.literal("fullscreen")
-]);
-var isLayoutMode = (value) => LayoutMode.safeParse(value).success;
-var Layout = import_zod.z.object({
-  layoutMode: import_zod.z.union([
-    import_zod.z.literal("deck"),
-    import_zod.z.literal("solo"),
-    import_zod.z.literal("fullscreen")
-  ]),
-  sidebarOpen: import_zod.z.boolean(),
-  complementarySidebarOpen: import_zod.z.boolean(),
+var LayoutMode = import_echo_schema.S.Union(import_echo_schema.S.Literal("deck"), import_echo_schema.S.Literal("solo"), import_echo_schema.S.Literal("fullscreen"));
+var isLayoutMode = (value) => import_echo_schema.S.is(LayoutMode)(value);
+var Layout = import_echo_schema.S.mutable(import_echo_schema.S.Struct({
+  layoutMode: LayoutMode,
+  sidebarOpen: import_echo_schema.S.Boolean,
+  complementarySidebarOpen: import_echo_schema.S.Boolean,
   /**
-  * @deprecated
-  */
-  complementarySidebarContent: import_zod.z.any().optional().describe("DEPRECATED. Data to be passed to the complementary sidebar Surface."),
-  dialogOpen: import_zod.z.boolean(),
-  dialogContent: import_zod.z.any().optional().describe("Data to be passed to the dialog Surface."),
+   * @deprecated Data to be passed to the complementary sidebar Surface.
+   */
+  complementarySidebarContent: import_echo_schema.S.optional(import_echo_schema.S.Any),
+  dialogOpen: import_echo_schema.S.Boolean,
+  /**
+   * Data to be passed to the dialog Surface.
+   */
+  dialogContent: import_echo_schema.S.optional(import_echo_schema.S.Any),
   // TODO(wittjosiah): Custom properties?
-  dialogBlockAlign: import_zod.z.union([
-    import_zod.z.literal("start"),
-    import_zod.z.literal("center")
-  ]).optional(),
-  dialogType: import_zod.z.union([
-    import_zod.z.literal("default"),
-    import_zod.z.literal("alert")
-  ]).optional(),
-  popoverOpen: import_zod.z.boolean(),
-  popoverContent: import_zod.z.any().optional().describe("Data to be passed to the popover Surface."),
-  popoverAnchorId: import_zod.z.string().optional(),
-  toasts: import_zod.z.array(Toast),
-  scrollIntoView: import_zod.z.string().optional().describe("The identifier of a component to scroll into view when it is mounted.")
-});
+  dialogBlockAlign: import_echo_schema.S.optional(import_echo_schema.S.Literal("start", "center")),
+  dialogType: import_echo_schema.S.optional(import_echo_schema.S.Literal("default", "alert")),
+  popoverOpen: import_echo_schema.S.Boolean,
+  /**
+   * Data to be passed to the popover Surface.
+   */
+  popoverContent: import_echo_schema.S.optional(import_echo_schema.S.Any),
+  popoverAnchorId: import_echo_schema.S.optional(import_echo_schema.S.String),
+  toasts: import_echo_schema.S.mutable(import_echo_schema.S.Array(Toast)),
+  /**
+   * The identifier of a component to scroll into view when it is mounted.
+   */
+  scrollIntoView: import_echo_schema.S.optional(import_echo_schema.S.String)
+}));
 var parseLayoutPlugin = (plugin) => {
-  const { success } = Layout.safeParse(plugin.provides.layout);
+  const success = import_echo_schema.S.is(Layout)(plugin.provides.layout);
   return success ? plugin : void 0;
 };
 var LAYOUT_PLUGIN = "dxos.org/plugin/layout";
 var LAYOUT_ACTION = `${LAYOUT_PLUGIN}/action`;
 var LayoutAction;
 (function(LayoutAction2) {
-  LayoutAction2[LayoutAction2["SET_LAYOUT"] = `${LAYOUT_ACTION}/set-layout`] = "SET_LAYOUT";
-  LayoutAction2[LayoutAction2["SET_LAYOUT_MODE"] = `${LAYOUT_ACTION}/set-layout-mode`] = "SET_LAYOUT_MODE";
-  LayoutAction2[LayoutAction2["SCROLL_INTO_VIEW"] = `${LAYOUT_ACTION}/scroll-into-view`] = "SCROLL_INTO_VIEW";
-  LayoutAction2[LayoutAction2["UPDATE_PLANK_SIZE"] = `${LAYOUT_ACTION}/update-plank-size`] = "UPDATE_PLANK_SIZE";
+  class SetLayout extends import_echo_schema.S.TaggedClass()(`${LAYOUT_ACTION}/set-layout`, {
+    input: import_echo_schema.S.Struct({
+      /**
+      * Element to set the state of.
+      */
+      element: import_echo_schema.S.Literal("fullscreen", "sidebar", "complementary", "dialog", "popover", "toast"),
+      /**
+      * Whether the element is on or off.
+      *
+      * If omitted, the element's state will be toggled or set based on other provided data.
+      * For example, if `component` is provided, the state will be set to `true`.
+      */
+      state: import_echo_schema.S.optional(import_echo_schema.S.Boolean),
+      /**
+      * Component to render in the dialog or popover.
+      */
+      component: import_echo_schema.S.optional(import_echo_schema.S.String),
+      /**
+      * Data to be passed to the dialog or popover Surface.
+      */
+      subject: import_echo_schema.S.optional(import_echo_schema.S.Any),
+      /**
+      * Anchor ID for the popover.
+      */
+      anchorId: import_echo_schema.S.optional(import_echo_schema.S.String),
+      // TODO(wittjosiah): Custom properties?
+      /**
+      * Block alignment for the dialog.
+      */
+      dialogBlockAlign: import_echo_schema.S.optional(import_echo_schema.S.Literal("start", "center")),
+      /**
+      * Type of dialog.
+      */
+      dialogType: import_echo_schema.S.optional(import_echo_schema.S.Literal("default", "alert"))
+    }),
+    output: import_echo_schema.S.Void
+  }) {
+  }
+  LayoutAction2.SetLayout = SetLayout;
+  class SetLayoutMode extends import_echo_schema.S.TaggedClass()(`${LAYOUT_ACTION}/set-layout-mode`, {
+    input: import_echo_schema.S.Union(import_echo_schema.S.Struct({
+      layoutMode: LayoutMode
+    }), import_echo_schema.S.Struct({
+      revert: import_echo_schema.S.Literal(true)
+    })),
+    output: import_echo_schema.S.Void
+  }) {
+  }
+  LayoutAction2.SetLayoutMode = SetLayoutMode;
+  class ScrollIntoView extends import_echo_schema.S.TaggedClass()(`${LAYOUT_ACTION}/scroll-into-view`, {
+    input: import_echo_schema.S.Struct({
+      id: import_echo_schema.S.optional(import_echo_schema.S.String),
+      // TODO(wittjosiah): Factor out to thread scroll into view action?
+      cursor: import_echo_schema.S.optional(import_echo_schema.S.String),
+      ref: import_echo_schema.S.optional(import_echo_schema.S.String)
+    }),
+    output: import_echo_schema.S.Void
+  }) {
+  }
+  LayoutAction2.ScrollIntoView = ScrollIntoView;
 })(LayoutAction || (LayoutAction = {}));
 var parseMetadataRecordsPlugin = (plugin) => {
   return plugin.provides.metadata?.records ? plugin : void 0;
@@ -218,15 +278,15 @@ var LayoutCoordinateSchema = import_schema.Schema.mutable(import_schema.Schema.S
   part: LayoutPartSchema,
   entryId: import_schema.Schema.String
 }));
-var PartAdjustmentSchema = import_schema.Schema.Union(import_schema.Schema.Literal("increment-start"), import_schema.Schema.Literal("increment-end"), import_schema.Schema.Literal("solo"));
+var PartAdjustmentSchema = import_schema.Schema.Union(import_schema.Schema.Literal("increment-start"), import_schema.Schema.Literal("increment-end"), import_schema.Schema.Literal("pin-start"), import_schema.Schema.Literal("pin-end"), import_schema.Schema.Literal("close"), import_schema.Schema.Literal("solo"));
 var LayoutAdjustmentSchema = import_schema.Schema.mutable(import_schema.Schema.Struct({
   layoutCoordinate: LayoutCoordinateSchema,
   type: PartAdjustmentSchema
 }));
-var ActiveParts = import_zod2.z.record(import_zod2.z.string(), import_zod2.z.union([
-  import_zod2.z.string(),
-  import_zod2.z.array(import_zod2.z.string())
-]));
+var ActiveParts = import_schema.Schema.Record({
+  key: import_schema.Schema.String,
+  value: import_schema.Schema.Union(import_schema.Schema.String, import_schema.Schema.mutable(import_schema.Schema.Array(import_schema.Schema.String)))
+});
 var LocationProvidesSchema = import_schema.Schema.mutable(import_schema.Schema.Struct({
   location: import_schema.Schema.Struct({
     active: LayoutPartsSchema,
@@ -277,31 +337,71 @@ var NAVIGATION_PLUGIN = "dxos.org/plugin/navigation";
 var NAVIGATION_ACTION = `${NAVIGATION_PLUGIN}/action`;
 var NavigationAction;
 (function(NavigationAction2) {
-  NavigationAction2[NavigationAction2["OPEN"] = `${NAVIGATION_ACTION}/open`] = "OPEN";
-  NavigationAction2[NavigationAction2["ADD_TO_ACTIVE"] = `${NAVIGATION_ACTION}/add-to-active`] = "ADD_TO_ACTIVE";
-  NavigationAction2[NavigationAction2["SET"] = `${NAVIGATION_ACTION}/set`] = "SET";
-  NavigationAction2[NavigationAction2["ADJUST"] = `${NAVIGATION_ACTION}/adjust`] = "ADJUST";
-  NavigationAction2[NavigationAction2["CLOSE"] = `${NAVIGATION_ACTION}/close`] = "CLOSE";
-  NavigationAction2[NavigationAction2["EXPOSE"] = `${NAVIGATION_ACTION}/expose`] = "EXPOSE";
+  class Open extends import_schema.Schema.TaggedClass()(`${NAVIGATION_ACTION}/open`, {
+    input: import_schema.Schema.Struct({
+      activeParts: ActiveParts,
+      noToggle: import_schema.Schema.optional(import_schema.Schema.Boolean)
+    }),
+    output: import_schema.Schema.Struct({
+      open: import_schema.Schema.Array(import_schema.Schema.String)
+    })
+  }) {
+  }
+  NavigationAction2.Open = Open;
+  class AddToActive extends import_schema.Schema.TaggedClass()(`${NAVIGATION_ACTION}/add-to-active`, {
+    input: import_schema.Schema.Struct({
+      id: import_schema.Schema.String,
+      part: LayoutPartSchema,
+      scrollIntoView: import_schema.Schema.optional(import_schema.Schema.Boolean),
+      pivotId: import_schema.Schema.optional(import_schema.Schema.String),
+      positioning: import_schema.Schema.optional(import_schema.Schema.Literal("start", "end"))
+    }),
+    output: import_schema.Schema.Void
+  }) {
+  }
+  NavigationAction2.AddToActive = AddToActive;
+  class Set extends import_schema.Schema.TaggedClass()(`${NAVIGATION_ACTION}/set`, {
+    input: import_schema.Schema.Struct({
+      activeParts: ActiveParts
+    }),
+    output: import_schema.Schema.Void
+  }) {
+  }
+  NavigationAction2.Set = Set;
+  class Close extends import_schema.Schema.TaggedClass()(`${NAVIGATION_ACTION}/close`, {
+    input: import_schema.Schema.Struct({
+      activeParts: ActiveParts,
+      noToggle: import_schema.Schema.optional(import_schema.Schema.Boolean)
+    }),
+    output: import_schema.Schema.Void
+  }) {
+  }
+  NavigationAction2.Close = Close;
+  class Adjust extends import_schema.Schema.TaggedClass()(`${NAVIGATION_ACTION}/adjust`, {
+    input: LayoutAdjustmentSchema,
+    output: import_schema.Schema.Void
+  }) {
+  }
+  NavigationAction2.Adjust = Adjust;
+  class Expose extends import_schema.Schema.TaggedClass()(`${NAVIGATION_ACTION}/expose`, {
+    input: import_schema.Schema.Struct({
+      id: import_schema.Schema.String
+    }),
+    output: import_schema.Schema.Void
+  }) {
+  }
+  NavigationAction2.Expose = Expose;
 })(NavigationAction || (NavigationAction = {}));
-var ResourceKey = import_zod3.z.union([
-  import_zod3.z.string(),
-  import_zod3.z.record(import_zod3.z.any())
+var ResourceKey = import_zod.z.union([
+  import_zod.z.string(),
+  import_zod.z.record(import_zod.z.any())
 ]);
-var ResourceLanguage = import_zod3.z.record(ResourceKey);
-var Resource = import_zod3.z.record(ResourceLanguage);
+var ResourceLanguage = import_zod.z.record(ResourceKey);
+var Resource = import_zod.z.record(ResourceLanguage);
 var parseTranslationsPlugin = (plugin) => {
-  const { success } = import_zod3.z.array(Resource).safeParse(plugin.provides.translations);
+  const { success } = import_zod.z.array(Resource).safeParse(plugin.provides.translations);
   return success ? plugin : void 0;
 };
-var Plugin;
-(function(Plugin2) {
-  Plugin2.lazy = (p, props) => {
-    return () => p().then(({ default: definition }) => {
-      return definition(props);
-    });
-  };
-})(Plugin || (Plugin = {}));
 var __dxlog_file = "/home/runner/work/dxos/dxos/packages/sdk/app-framework/src/plugins/plugin-host/PluginContainer.tsx";
 var PluginContainer = ({ plugins: definitions, core, state, placeholder }) => {
   const [error, setError] = (0, import_react2.useState)();
@@ -352,7 +452,9 @@ var PluginContainer = ({ plugins: definitions, core, state, placeholder }) => {
           S: void 0,
           C: (f, a) => f(...a)
         });
-        await Promise.all(enabled.map((plugin) => plugin.ready?.(initialized)));
+        await Promise.all(enabled.map((plugin) => plugin.ready?.({
+          plugins: initialized
+        })));
         (0, import_log.log)("plugins ready", {
           plugins: initialized
         }, {
@@ -429,7 +531,6 @@ var useResolvePlugins = (predicate) => {
   ]);
 };
 var PluginProvider = PluginContext.Provider;
-var parsePluginHost = (plugin) => plugin.provides.plugins ? plugin : void 0;
 var HOST_PLUGIN = "dxos.org/plugin/host";
 var HostPlugin = ({ plugins, meta, core, defaults = [], fallback = DefaultFallback, placeholder = null }) => {
   const state = new import_local_storage.LocalStorageStore(HOST_PLUGIN, {
@@ -460,14 +561,13 @@ var HostPlugin = ({ plugins, meta, core, defaults = [], fallback = DefaultFallba
       name: "Plugin host"
     },
     provides: {
-      plugins: state.values,
       context: ({ children }) => {
         return /* @__PURE__ */ import_react.default.createElement(PluginProvider, {
           value: state.values
         }, children);
       },
       root: () => {
-        return /* @__PURE__ */ import_react.default.createElement(import_chunk_SOVLKUWI.ErrorBoundary, {
+        return /* @__PURE__ */ import_react.default.createElement(import_chunk_BW3RNEVI.ErrorBoundary, {
           fallback
         }, /* @__PURE__ */ import_react.default.createElement(PluginContainer, {
           plugins,
@@ -492,25 +592,33 @@ var DefaultFallback = ({ error }) => {
     }
   }, error.message), /* @__PURE__ */ import_react.default.createElement("pre", null, error.stack));
 };
+var Plugin;
+(function(Plugin2) {
+  Plugin2.lazy = (p, props) => {
+    return () => p().then(({ default: definition }) => {
+      return definition(props);
+    });
+  };
+})(Plugin || (Plugin = {}));
 var __dxlog_file2 = "/home/runner/work/dxos/dxos/packages/sdk/app-framework/src/App.tsx";
 var createApp = ({ meta, plugins, core, ...params }) => {
   const hostPlugin = HostPlugin({
     plugins: {
       ...plugins,
-      [import_chunk_QSVP5HOW.meta_default.id]: Plugin.lazy(() => import("./plugin-intent-FVFR2LKB.cjs")),
-      [import_chunk_JZ2JVKRY.meta_default.id]: Plugin.lazy(() => import("./plugin-settings-OZ6IKAE5.cjs")),
-      [import_chunk_SOVLKUWI.meta_default.id]: Plugin.lazy(() => import("./plugin-surface-YWDRXQTD.cjs"))
+      [import_chunk_VWHAALIN.meta_default.id]: Plugin.lazy(() => import("./plugin-intent-F3TQZIUR.cjs")),
+      [import_chunk_FCMHRU3M.meta_default.id]: Plugin.lazy(() => import("./plugin-settings-W6UHMH5M.cjs")),
+      [import_chunk_BW3RNEVI.meta_default.id]: Plugin.lazy(() => import("./plugin-surface-CCSIONYW.cjs"))
     },
     meta: [
-      import_chunk_QSVP5HOW.meta_default,
-      import_chunk_JZ2JVKRY.meta_default,
-      import_chunk_SOVLKUWI.meta_default,
+      import_chunk_VWHAALIN.meta_default,
+      import_chunk_FCMHRU3M.meta_default,
+      import_chunk_BW3RNEVI.meta_default,
       ...meta
     ],
     core: [
-      import_chunk_QSVP5HOW.meta_default.id,
-      import_chunk_JZ2JVKRY.meta_default.id,
-      import_chunk_SOVLKUWI.meta_default.id,
+      import_chunk_VWHAALIN.meta_default.id,
+      import_chunk_FCMHRU3M.meta_default.id,
+      import_chunk_BW3RNEVI.meta_default.id,
       ...core
     ],
     ...params
@@ -550,16 +658,24 @@ var createApp = ({ meta, plugins, core, ...params }) => {
   ActiveParts,
   ErrorBoundary,
   HostPlugin,
+  INTENT_ACTION,
   IntentAction,
   IntentProvider,
+  LAYOUT_ACTION,
+  LAYOUT_PLUGIN,
+  Label,
   Layout,
   LayoutAction,
+  NAVIGATION_ACTION,
+  NAVIGATION_PLUGIN,
   NavigationAction,
   Plugin,
   PluginProvider,
   Resource,
   ResourceKey,
   ResourceLanguage,
+  SETTINGS_ACTION,
+  SETTINGS_PLUGIN,
   SLUG_COLLECTION_INDICATOR,
   SLUG_ENTRY_SEPARATOR,
   SLUG_KEY_VALUE_SEPARATOR,
@@ -569,7 +685,12 @@ var createApp = ({ meta, plugins, core, ...params }) => {
   Surface,
   SurfaceProvider,
   Toast,
+  chain,
   createApp,
+  createDispatcher,
+  createIntent,
+  createResolver,
+  createSurface,
   defaultFileTypes,
   definePlugin,
   filterPlugins,
@@ -592,21 +713,18 @@ var createApp = ({ meta, plugins, core, ...params }) => {
   parseMetadataRecordsPlugin,
   parseMetadataResolverPlugin,
   parseNavigationPlugin,
-  parsePluginHost,
   parseRootSurfacePlugin,
   parseSettingsPlugin,
   parseSurfacePlugin,
   parseTranslationsPlugin,
   partLength,
   resolvePlugin,
-  useIntent,
   useIntentDispatcher,
   useIntentResolver,
   usePlugin,
   usePlugins,
   useResolvePlugin,
   useResolvePlugins,
-  useSurface,
   useSurfaceRoot
 });
 //# sourceMappingURL=index.cjs.map