@dxos/app-framework 0.6.5 → 0.6.6-staging.23d123d

package/dist/types/src/plugins/common/navigation.d.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { S } from '@dxos/echo-schema';
 import type { IntentData } from '../IntentPlugin';
 import type { Plugin } from '../PluginHost';
 export declare const SLUG_LIST_SEPARATOR = "+";
@@ -6,26 +7,78 @@ export declare const SLUG_ENTRY_SEPARATOR = "_";
 export declare const SLUG_KEY_VALUE_SEPARATOR = "-";
 export declare const SLUG_PATH_SEPARATOR = "~";
 export declare const SLUG_COLLECTION_INDICATOR = "";
-export declare const SLUG_SOLO_INDICATOR = "$";
-export declare const parseSlug: (slug: string) => {
-    id: string;
-    path: string[];
-    solo: boolean;
-};
+declare const LayoutEntrySchema: S.mutable<S.Struct<{
+    id: typeof S.String;
+    path: S.optional<typeof S.String>;
+}>>;
+export type LayoutEntry = S.Schema.Type<typeof LayoutEntrySchema>;
+declare const LayoutPartSchema: S.Union<[S.Literal<["sidebar"]>, S.Literal<["main"]>, S.Literal<["solo"]>, S.Literal<["complementary"]>, S.Literal<["fullScreen"]>]>;
+export type LayoutPart = S.Schema.Type<typeof LayoutPartSchema>;
+declare const LayoutPartsSchema: S.SchemaClass<{
+    main?: {
+        path?: string | undefined;
+        id: string;
+    }[] | undefined;
+    solo?: {
+        path?: string | undefined;
+        id: string;
+    }[] | undefined;
+    sidebar?: {
+        path?: string | undefined;
+        id: string;
+    }[] | undefined;
+    complementary?: {
+        path?: string | undefined;
+        id: string;
+    }[] | undefined;
+    fullScreen?: {
+        path?: string | undefined;
+        id: string;
+    }[] | undefined;
+}, {
+    main?: {
+        id: string;
+        path?: string | undefined;
+    }[] | undefined;
+    solo?: {
+        id: string;
+        path?: string | undefined;
+    }[] | undefined;
+    sidebar?: {
+        id: string;
+        path?: string | undefined;
+    }[] | undefined;
+    complementary?: {
+        id: string;
+        path?: string | undefined;
+    }[] | undefined;
+    fullScreen?: {
+        id: string;
+        path?: string | undefined;
+    }[] | undefined;
+}, never>;
+export type LayoutParts = S.Schema.Type<typeof LayoutPartsSchema>;
+declare const LayoutCoordinateSchema: S.mutable<S.Struct<{
+    part: S.Union<[S.Literal<["sidebar"]>, S.Literal<["main"]>, S.Literal<["solo"]>, S.Literal<["complementary"]>, S.Literal<["fullScreen"]>]>;
+    entryId: typeof S.String;
+}>>;
+export type LayoutCoordinate = S.Schema.Type<typeof LayoutCoordinateSchema>;
+declare const PartAdjustmentSchema: S.Union<[S.Literal<["increment-start"]>, S.Literal<["increment-end"]>, S.Literal<["solo"]>]>;
+export type PartAdjustment = S.Schema.Type<typeof PartAdjustmentSchema>;
+declare const LayoutAdjustmentSchema: S.mutable<S.Struct<{
+    layoutCoordinate: S.mutable<S.Struct<{
+        part: S.Union<[S.Literal<["sidebar"]>, S.Literal<["main"]>, S.Literal<["solo"]>, S.Literal<["complementary"]>, S.Literal<["fullScreen"]>]>;
+        entryId: typeof S.String;
+    }>>;
+    type: S.Union<[S.Literal<["increment-start"]>, S.Literal<["increment-end"]>, S.Literal<["solo"]>]>;
+}>>;
+export type LayoutAdjustment = S.Schema.Type<typeof LayoutAdjustmentSchema>;
+/** @deprecated */
 export declare const ActiveParts: z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+export type ActiveParts = z.infer<typeof ActiveParts>;
 /**
  * Basic state provided by a navigation plugin.
  */
-export declare const Location: z.ZodObject<{
-    active: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>]>>;
-    closed: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
-}, "strip", z.ZodTypeAny, {
-    active?: string | Record<string, string | string[]> | undefined;
-    closed?: string | string[] | undefined;
-}, {
-    active?: string | Record<string, string | string[]> | undefined;
-    closed?: string | string[] | undefined;
-}>;
 export declare const Attention: z.ZodObject<{
     attended: z.ZodOptional<z.ZodSet<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
@@ -33,42 +86,107 @@ export declare const Attention: z.ZodObject<{
 }, {
     attended?: Set<string> | undefined;
 }>;
-export type ActiveParts = z.infer<typeof ActiveParts>;
-export type Location = z.infer<typeof Location>;
 export type Attention = z.infer<typeof Attention>;
-export type LayoutPart = 'sidebar' | 'main' | 'complementary';
-export type LayoutCoordinate = {
-    part: LayoutPart;
-    index: number;
-    partSize: number;
-    solo?: boolean;
-};
-export type NavigationAdjustmentType = `${'pin' | 'increment'}-${'start' | 'end'}`;
-export type NavigationAdjustment = {
-    layoutCoordinate: LayoutCoordinate;
-    type: NavigationAdjustmentType;
-};
-export declare const isActiveParts: (active: string | ActiveParts | undefined) => active is Record<string, string | string[]>;
-export declare const isAdjustTransaction: (data: IntentData | undefined) => data is NavigationAdjustment;
-export declare const firstMainId: (active: Location['active']) => string;
-export declare const activeIds: (active: string | ActiveParts | undefined) => Set<string>;
-export declare const isIdActive: (active: string | ActiveParts | undefined, id: string) => boolean;
 /**
  * Provides for a plugin that can manage the app navigation.
  */
-export type LocationProvides = {
-    location: Readonly<Location>;
-};
+declare const LocationProvidesSchema: S.mutable<S.Struct<{
+    location: S.Struct<{
+        active: S.SchemaClass<{
+            main?: {
+                path?: string | undefined;
+                id: string;
+            }[] | undefined;
+            solo?: {
+                path?: string | undefined;
+                id: string;
+            }[] | undefined;
+            sidebar?: {
+                path?: string | undefined;
+                id: string;
+            }[] | undefined;
+            complementary?: {
+                path?: string | undefined;
+                id: string;
+            }[] | undefined;
+            fullScreen?: {
+                path?: string | undefined;
+                id: string;
+            }[] | undefined;
+        }, {
+            main?: {
+                id: string;
+                path?: string | undefined;
+            }[] | undefined;
+            solo?: {
+                id: string;
+                path?: string | undefined;
+            }[] | undefined;
+            sidebar?: {
+                id: string;
+                path?: string | undefined;
+            }[] | undefined;
+            complementary?: {
+                id: string;
+                path?: string | undefined;
+            }[] | undefined;
+            fullScreen?: {
+                id: string;
+                path?: string | undefined;
+            }[] | undefined;
+        }, never>;
+        closed: S.Array$<typeof S.String>;
+    }>;
+}>>;
+export type LocationProvides = S.Schema.Type<typeof LocationProvidesSchema>;
 /**
  * Type guard for layout plugins.
  */
+export declare const isLayoutParts: (value: unknown) => value is {
+    main?: {
+        path?: string | undefined;
+        id: string;
+    }[] | undefined;
+    solo?: {
+        path?: string | undefined;
+        id: string;
+    }[] | undefined;
+    sidebar?: {
+        path?: string | undefined;
+        id: string;
+    }[] | undefined;
+    complementary?: {
+        path?: string | undefined;
+        id: string;
+    }[] | undefined;
+    fullScreen?: {
+        path?: string | undefined;
+        id: string;
+    }[] | undefined;
+};
+export declare const isLayoutAdjustment: (value: unknown) => value is {
+    type: "solo" | "increment-start" | "increment-end";
+    layoutCoordinate: {
+        part: "main" | "solo" | "sidebar" | "complementary" | "fullScreen";
+        entryId: string;
+    };
+};
 export declare const parseNavigationPlugin: (plugin: Plugin) => Plugin<LocationProvides> | undefined;
+/**
+ * Utilities.
+ */
+/** Extracts all unique IDs from the layout parts. */
+export declare const openIds: (layout: LayoutParts) => string[];
+export declare const firstIdInPart: (layout: LayoutParts | undefined, part: LayoutPart) => string | undefined;
+export declare const indexInPart: (layout: LayoutParts | undefined, layoutCoordinate: LayoutCoordinate | undefined) => number | undefined;
+export declare const partLength: (layout: LayoutParts | undefined, part: LayoutPart | undefined) => number;
 export declare enum NavigationAction {
     OPEN = "dxos.org/plugin/navigation/open",
     ADD_TO_ACTIVE = "dxos.org/plugin/navigation/add-to-active",
     SET = "dxos.org/plugin/navigation/set",
     ADJUST = "dxos.org/plugin/navigation/adjust",
-    CLOSE = "dxos.org/plugin/navigation/close"
+    CLOSE = "dxos.org/plugin/navigation/close",
+    EXPOSE = "dxos.org/plugin/navigation/expose"
 }
 /**
  * Expected payload for navigation actions.
@@ -84,18 +202,18 @@ export declare namespace NavigationAction {
      * Payload for adding an item to the active items.
      */
     type AddToActive = IntentData<{
+        part: LayoutPart;
         id: string;
         scrollIntoView?: boolean;
-        pivot?: {
-            id: string;
-            position: 'add-before' | 'add-after';
-        };
+        pivotId?: string;
+        positioning?: 'start' | 'end';
     }>;
     /**
      * A subtractive overlay to apply to `location.active` (i.e. the result is a subtraction from the previous active of the argument)
      */
     type Close = IntentData<{
         activeParts: ActiveParts;
+        noToggle?: boolean;
     }>;
     /**
      * The active parts to directly set, to be used when working with URLs or restoring a specific state.
@@ -106,6 +224,7 @@ export declare namespace NavigationAction {
     /**
      * An atomic transaction to apply to `location.active`, describing which element to (attempt to) move to which location.
      */
-    type Adjust = IntentData<NavigationAdjustment>;
+    type Adjust = IntentData<LayoutAdjustment>;
 }
+export {};
 //# sourceMappingURL=navigation.d.ts.map

package/dist/types/src/plugins/common/navigation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/common/navigation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/common/navigation.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/app-framework",
-  "version": "0.6.5",
+  "version": "0.6.6-staging.23d123d",
   "description": "A framework for building applications from composible plugins.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -23,22 +23,22 @@
     "@phosphor-icons/react": "^2.1.5",
     "@preact/signals-core": "^1.6.0",
     "zod": "^3.22.4",
-    "@dxos/app-graph": "0.6.5",
-    "@dxos/echo-schema": "0.6.5",
-    "@dxos/async": "0.6.5",
-    "@dxos/local-storage": "0.6.5",
-    "@dxos/debug": "0.6.5",
-    "@dxos/invariant": "0.6.5",
-    "@dxos/log": "0.6.5",
-    "@dxos/client-protocol": "0.6.5",
-    "@dxos/util": "0.6.5"
+    "@dxos/app-graph": "0.6.6-staging.23d123d",
+    "@dxos/async": "0.6.6-staging.23d123d",
+    "@dxos/client-protocol": "0.6.6-staging.23d123d",
+    "@dxos/debug": "0.6.6-staging.23d123d",
+    "@dxos/echo-schema": "0.6.6-staging.23d123d",
+    "@dxos/invariant": "0.6.6-staging.23d123d",
+    "@dxos/local-storage": "0.6.6-staging.23d123d",
+    "@dxos/log": "0.6.6-staging.23d123d",
+    "@dxos/util": "0.6.6-staging.23d123d"
   },
   "devDependencies": {
     "@types/react": "^18.0.21",
     "react": "~18.2.0"
   },
   "peerDependencies": {
-    "react": "*"
+    "react": "~18.2.0"
   },
   "publishConfig": {
     "access": "public"

package/project.json

@@ -11,7 +11,7 @@
     "compile": {
       "options": {
         "entryPoints": [
-          "packages/sdk/app-framework/src/index.ts"
+          "{projectRoot}/src/index.ts"
         ]
       }
     },

package/src/plugins/PluginHost/PluginContext.tsx

@@ -13,6 +13,11 @@ export type PluginContext = {
    */
   ready: boolean;
 
+  /**
+   * Core plugins.
+   */
+  core: string[];
+
   /**
    * Ids of plugins which are enabled on this device.
    */
@@ -26,6 +31,7 @@ export type PluginContext = {
   /**
    * All available plugins.
    */
+  // This is metadata rather then just ids because it includes plugins which have not been fully loaded yet.
   available: Plugin['meta'][];
 
   /**
@@ -37,6 +43,7 @@ export type PluginContext = {
 
 const PluginContext: Context<PluginContext> = createContext<PluginContext>({
   ready: false,
+  core: [],
   enabled: [],
   plugins: [],
   available: [],

package/src/plugins/PluginHost/PluginHost.tsx

@@ -42,6 +42,7 @@ export const PluginHost = ({
 }: BootstrapPluginsParams): PluginDefinition<PluginHostProvides> => {
   const state = new LocalStorageStore<PluginContext>(PLUGIN_HOST, {
     ready: false,
+    core,
     enabled: [...defaults],
     plugins: [],
     available: order.filter(({ id }) => !core.includes(id)),

package/src/plugins/common/graph.ts

@@ -2,15 +2,41 @@
 // Copyright 2023 DXOS.org
 //
 
-import type { Graph, GraphBuilder } from '@dxos/app-graph';
+import type { Graph, GraphBuilder, Node } from '@dxos/app-graph';
+import { type MaybePromise } from '@dxos/util';
 
 import type { Plugin } from '../PluginHost';
 
+// TODO(wittjosiah): Factor out.
+export type SerializedNode = {
+  name: string;
+  data: string;
+  type?: string;
+};
+
+// TODO(wittjosiah): Factor out.
+export type NodeSerializer<T = any> = {
+  inputType: string;
+  outputType: string;
+  disposition?: 'hoist' | 'fallback';
+
+  /**
+   * Takes a node and serializes it into a format that can be stored.
+   */
+  serialize: (node: Node<T>) => MaybePromise<SerializedNode>;
+
+  /**
+   * Takes a serialized node and deserializes it into the application.
+   */
+  deserialize: (data: SerializedNode, ancestors: unknown[]) => MaybePromise<T>;
+};
+
 /**
  * Provides for a plugin that exposes the application graph.
  */
 export type GraphProvides = {
   graph: Graph;
+  explore: GraphBuilder['explore'];
 };
 
 export type GraphBuilderProvides = {
@@ -19,6 +45,12 @@ export type GraphBuilderProvides = {
   };
 };
 
+export type GraphSerializerProvides = {
+  graph: {
+    serializer: (plugins: Plugin[]) => NodeSerializer[];
+  };
+};
+
 /**
  * Type guard for graph plugins.
  */
@@ -30,3 +62,9 @@ export const parseGraphPlugin = (plugin: Plugin) =>
  */
 export const parseGraphBuilderPlugin = (plugin: Plugin) =>
   (plugin.provides as any).graph?.builder ? (plugin as Plugin<GraphBuilderProvides>) : undefined;
+
+/**
+ * Type guard for graph serializer plugins.
+ */
+export const parseGraphSerializerPlugin = (plugin: Plugin) =>
+  (plugin.provides as any).graph?.serializer ? (plugin as Plugin<GraphSerializerProvides>) : undefined;

package/src/plugins/common/layout.ts

@@ -33,12 +33,16 @@ export type Toast = z.infer<typeof Toast>;
  * Generally only one dialog or popover should be open at a time, a layout plugin should manage this.
  * For other landmarks, such as toasts, rendering them in the layout prevents them from unmounting when navigating.
  */
+
+const LayoutMode = z.union([z.literal('deck'), z.literal('solo'), z.literal('fullscreen')]);
+export const isLayoutMode = (value: any): value is LayoutMode => LayoutMode.safeParse(value).success;
+export type LayoutMode = z.infer<typeof LayoutMode>;
+
 // TODO(wittjosiah): Replace Zod w/ Effect Schema to align with ECHO.
 export const Layout = z.object({
-  fullscreen: z.boolean(),
+  layoutMode: z.union([z.literal('deck'), z.literal('solo'), z.literal('fullscreen')]),
 
   sidebarOpen: z.boolean(),
-
   complementarySidebarOpen: z.boolean(),
   /**
    * @deprecated
@@ -89,13 +93,20 @@ export const parseLayoutPlugin = (plugin: Plugin) => {
 const LAYOUT_ACTION = 'dxos.org/plugin/layout';
 export enum LayoutAction {
   SET_LAYOUT = `${LAYOUT_ACTION}/set-layout`,
+  SET_LAYOUT_MODE = `${LAYOUT_ACTION}/set-layout-mode`,
   SCROLL_INTO_VIEW = `${LAYOUT_ACTION}/scroll-into-view`,
+  UPDATE_PLANK_SIZE = `${LAYOUT_ACTION}/update-plank-size`,
 }
 
 /**
  * Expected payload for layout actions.
  */
 export namespace LayoutAction {
+  export type SetLayoutMode = IntentData<{
+    layoutMode?: LayoutMode;
+    revert?: boolean;
+  }>;
+
   export type SetLayout = IntentData<{
     /**
      * Element to set the state of.