@dxos/plugin-masonry 0.8.4-main.21d9917

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "@dxos/plugin-masonry",
+  "version": "0.8.4-main.21d9917",
+  "description": "Masonry DXOS Surface plugin",
+  "homepage": "https://dxos.org",
+  "bugs": "https://github.com/dxos/dxos/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dxos/dxos"
+  },
+  "license": "MIT",
+  "author": "DXOS.org",
+  "sideEffects": true,
+  "type": "module",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/types/src/index.d.ts",
+      "browser": "./dist/lib/browser/index.mjs",
+      "node": "./dist/lib/node-esm/index.mjs"
+    },
+    "./types": {
+      "source": "./src/types/index.ts",
+      "types": "./dist/types/src/types/index.d.ts",
+      "browser": "./dist/lib/browser/types/index.mjs",
+      "node": "./dist/lib/node-esm/types/index.mjs"
+    }
+  },
+  "types": "dist/types/src/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "types": [
+        "dist/types/src/types/index.d.ts"
+      ]
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "@dxos/echo": "0.8.4-main.21d9917",
+    "@dxos/app-framework": "0.8.4-main.21d9917",
+    "@dxos/effect": "0.8.4-main.21d9917",
+    "@dxos/operation": "0.8.4-main.21d9917",
+    "@dxos/plugin-client": "0.8.4-main.21d9917",
+    "@dxos/plugin-search": "0.8.4-main.21d9917",
+    "@dxos/plugin-space": "0.8.4-main.21d9917",
+    "@dxos/react-ui-form": "0.8.4-main.21d9917",
+    "@dxos/react-ui-mosaic": "0.8.4-main.21d9917",
+    "@dxos/react-ui": "0.8.4-main.21d9917",
+    "@dxos/react-client": "0.8.4-main.21d9917",
+    "@dxos/react-ui-stack": "0.8.4-main.21d9917",
+    "@dxos/react-ui-masonry": "0.8.4-main.21d9917",
+    "@dxos/types": "0.8.4-main.21d9917",
+    "@dxos/util": "0.8.4-main.21d9917",
+    "@dxos/schema": "0.8.4-main.21d9917"
+  },
+  "devDependencies": {
+    "@types/react": "~19.2.7",
+    "@types/react-dom": "~19.2.3",
+    "effect": "3.19.11",
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3",
+    "vite": "7.1.9",
+    "@dxos/plugin-preview": "0.8.4-main.21d9917",
+    "@dxos/plugin-theme": "0.8.4-main.21d9917",
+    "@dxos/random": "0.8.4-main.21d9917",
+    "@dxos/ui-theme": "0.8.4-main.21d9917",
+    "@dxos/storybook-utils": "0.8.4-main.21d9917",
+    "@dxos/plugin-testing": "0.8.4-main.21d9917"
+  },
+  "peerDependencies": {
+    "effect": "3.19.11",
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3",
+    "@dxos/react-ui": "0.8.4-main.21d9917",
+    "@dxos/ui-theme": "0.8.4-main.21d9917"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/MasonryPlugin.tsx

@@ -0,0 +1,37 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Common, Plugin } from '@dxos/app-framework';
+import { Type } from '@dxos/echo';
+import { type CreateObject } from '@dxos/plugin-space/types';
+import { View } from '@dxos/schema';
+
+import { ReactSurface } from './capabilities';
+import { meta } from './meta';
+import { translations } from './translations';
+import { Masonry, MasonryAction } from './types';
+
+export const MasonryPlugin = Plugin.define(meta).pipe(
+  Common.Plugin.addTranslationsModule({ translations }),
+  Common.Plugin.addSurfaceModule({ activate: ReactSurface }),
+  Common.Plugin.addMetadataModule({
+    metadata: {
+      id: Type.getTypename(Masonry.Masonry),
+      metadata: {
+        icon: 'ph--wall--regular',
+        iconHue: 'green',
+        inputSchema: MasonryAction.MasonryProps,
+        createObject: ((props, { db }) =>
+          Effect.promise(async () => {
+            const { view } = await View.makeFromDatabase({ db, typename: props.typename });
+            return Masonry.make({ name: props.name, view });
+          })) satisfies CreateObject,
+      },
+    },
+  }),
+  Common.Plugin.addSchemaModule({ schema: [Masonry.Masonry] }),
+  Plugin.make,
+);

package/src/capabilities/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+export * from './react-surface';

package/src/capabilities/react-surface/index.ts

@@ -0,0 +1,7 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Capability } from '@dxos/app-framework';
+
+export const ReactSurface = Capability.lazy('ReactSurface', () => import('./react-surface'));

package/src/capabilities/react-surface/react-surface.tsx

@@ -0,0 +1,31 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+import React from 'react';
+
+import { Capability, Common } from '@dxos/app-framework';
+import { Obj } from '@dxos/echo';
+import { View } from '@dxos/schema';
+
+import { MasonryContainer } from '../../components/MasonryContainer';
+import { meta } from '../../meta';
+import { Masonry } from '../../types';
+
+export default Capability.makeModule(() =>
+  Effect.succeed(
+    Capability.contributes(Common.Capability.ReactSurface, [
+      Common.createSurface({
+        id: meta.id,
+        role: ['article', 'section'],
+        filter: (data): data is { subject: Masonry.Masonry | View.View } =>
+          Obj.instanceOf(Masonry.Masonry, data.subject) || Obj.instanceOf(View.View, data.subject),
+        component: ({ data, role }) => {
+          const view = Obj.instanceOf(View.View, data.subject) ? data.subject : data.subject.view;
+          return <MasonryContainer view={view} role={role} />;
+        },
+      }),
+    ]),
+  ),
+);

package/src/components/MasonryContainer.stories.tsx

@@ -0,0 +1,78 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { type Meta, type StoryObj } from '@storybook/react-vite';
+import * as Effect from 'effect/Effect';
+import React from 'react';
+
+import { withPluginManager } from '@dxos/app-framework/testing';
+import { ClientPlugin } from '@dxos/plugin-client';
+import { PreviewPlugin } from '@dxos/plugin-preview';
+import { StorybookPlugin, corePlugins } from '@dxos/plugin-testing';
+import { faker } from '@dxos/random';
+import { Filter, useObject, useQuery, useSpaces } from '@dxos/react-client/echo';
+import { withTheme } from '@dxos/react-ui/testing';
+import { View } from '@dxos/schema';
+import { createObjectFactory } from '@dxos/schema/testing';
+import { Organization } from '@dxos/types';
+
+import { Masonry } from '../types';
+
+import { MasonryContainer } from './MasonryContainer';
+
+faker.seed(0);
+
+const StorybookMasonry = () => {
+  const spaces = useSpaces();
+  const space = spaces[spaces.length - 1];
+  const masonries = useQuery(space?.db, Filter.type(Masonry.Masonry));
+  const [masonry] = useObject(masonries.at(0));
+
+  return masonry ? <MasonryContainer view={masonry.view} role='story' /> : null;
+};
+
+const meta = {
+  title: 'plugins/plugin-masonry/Masonry',
+  component: StorybookMasonry,
+  render: () => <StorybookMasonry />,
+  decorators: [
+    withTheme,
+    withPluginManager({
+      plugins: [
+        ...corePlugins(),
+        StorybookPlugin({}),
+        ClientPlugin({
+          types: [Organization.Organization, View.View, Masonry.Masonry],
+          onClientInitialized: ({ client }) =>
+            Effect.gen(function* () {
+              yield* Effect.promise(() => client.halo.createIdentity());
+              const space = yield* Effect.promise(() => client.spaces.create());
+              yield* Effect.promise(() => space.waitUntilReady());
+              const { view } = yield* Effect.promise(() =>
+                View.makeFromDatabase({
+                  db: space.db,
+                  typename: Organization.Organization.typename,
+                }),
+              );
+              const masonry = Masonry.make({ view });
+              space.db.add(masonry);
+              const factory = createObjectFactory(space.db, faker as any);
+              yield* Effect.promise(() => factory([{ type: Organization.Organization, count: 64 }]));
+            }),
+        }),
+
+        PreviewPlugin(),
+      ],
+    }),
+  ],
+  parameters: {
+    layout: 'fullscreen',
+  },
+} satisfies Meta;
+
+export default meta;
+
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {};

package/src/components/MasonryContainer.tsx

@@ -0,0 +1,79 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import type * as Schema from 'effect/Schema';
+import React, { useEffect, useState } from 'react';
+
+import { Common } from '@dxos/app-framework';
+import { Surface, useCapabilities } from '@dxos/app-framework/react';
+import { Filter, Obj, type Ref, Type } from '@dxos/echo';
+import { useGlobalFilteredObjects } from '@dxos/plugin-search';
+import { useObject, useQuery } from '@dxos/react-client/echo';
+import { Masonry as MasonryComponent } from '@dxos/react-ui-masonry';
+import { Card } from '@dxos/react-ui-mosaic';
+import { type View, getTypenameFromQuery } from '@dxos/schema';
+
+export type MasonryContainerProps = {
+  view: View.View;
+  role?: string;
+};
+
+export const MasonryContainer = ({
+  view: viewOrRef,
+  role,
+}: {
+  view: View.View | Ref.Ref<View.View>;
+  role?: string;
+}) => {
+  const [view] = useObject(viewOrRef);
+  const schemas = useCapabilities(Common.Capability.Schema);
+  const db = view && Obj.getDatabase(view);
+  const typename = view?.query ? getTypenameFromQuery(view.query.ast) : undefined;
+
+  const [cardSchema, setCardSchema] = useState<Schema.Schema.AnyNoContext>();
+
+  useEffect(() => {
+    const staticSchema = schemas.flat().find((schema) => Type.getTypename(schema) === typename);
+    if (staticSchema) {
+      setCardSchema(() => staticSchema);
+    }
+    if (!staticSchema && typename && db) {
+      const query = db.schemaRegistry.query({ typename });
+      const unsubscribe = query.subscribe(
+        () => {
+          const [schema] = query.results;
+          if (schema) {
+            setCardSchema(schema);
+          }
+        },
+        { fire: true },
+      );
+      return unsubscribe;
+    }
+  }, [schemas, typename, db]);
+
+  const objects = useQuery(db, cardSchema ? Filter.type(cardSchema) : Filter.nothing());
+  const filteredObjects = useGlobalFilteredObjects(objects);
+
+  return (
+    <MasonryComponent.Root
+      items={filteredObjects}
+      render={Item as any}
+      classNames='is-full max-is-full bs-full max-bs-full overflow-y-auto p-4'
+    />
+  );
+};
+
+const Item = ({ data }: { data: any }) => {
+  return (
+    <Card.Root>
+      <Card.Toolbar>
+        <span />
+        <Card.Title>{Obj.getLabel(data)}</Card.Title>
+        <Card.Menu />
+      </Card.Toolbar>
+      <Surface role='card--content' limit={1} data={{ subject: data }} />
+    </Card.Root>
+  );
+};

package/src/index.ts

@@ -0,0 +1,7 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+export * from './meta';
+
+export * from './MasonryPlugin';

package/src/meta.ts

@@ -0,0 +1,19 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { type Plugin } from '@dxos/app-framework';
+import { trim } from '@dxos/util';
+
+export const meta: Plugin.Meta = {
+  id: 'dxos.org/plugin/masonry',
+  name: 'Masonry',
+  description: trim`
+    Responsive grid layout that displays query results in an adaptive masonry pattern.
+    Visualize collections of cards, images, or mixed content that automatically adjusts to available screen space.
+  `,
+  icon: 'ph--wall--regular',
+  iconHue: 'green',
+  source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-masonry',
+  screenshots: [],
+};

package/src/translations.ts

@@ -0,0 +1,29 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { Type } from '@dxos/echo';
+import { type Resource } from '@dxos/react-ui';
+
+import { meta } from './meta';
+import { Masonry } from './types';
+
+export const translations = [
+  {
+    'en-US': {
+      [Type.getTypename(Masonry.Masonry)]: {
+        'typename label': 'Masonry',
+        'typename label_zero': 'Masonries',
+        'typename label_one': 'Masonry',
+        'typename label_other': 'Masonries',
+        'object name placeholder': 'New masonry',
+        'rename object label': 'Rename masonry',
+        'delete object label': 'Delete masonry',
+        'object deleted label': 'Masonry deleted',
+      },
+      [meta.id]: {
+        'plugin name': 'Masonry',
+      },
+    },
+  },
+] as const satisfies Resource[];

package/src/types/Masonry.ts

@@ -0,0 +1,61 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Schema from 'effect/Schema';
+
+import { Obj, Ref, Type } from '@dxos/echo';
+import { FormInputAnnotation, LabelAnnotation } from '@dxos/echo/internal';
+import { View, ViewAnnotation } from '@dxos/schema';
+
+export const Masonry = Schema.Struct({
+  name: Schema.String.pipe(Schema.optional),
+
+  view: Type.Ref(View.View).pipe(FormInputAnnotation.set(false)),
+
+  arrangement: Schema.Array(
+    Schema.Struct({
+      ids: Schema.Array(Obj.ID),
+      hidden: Schema.optional(Schema.Boolean),
+    }).pipe(Schema.mutable),
+  ).pipe(Schema.mutable, FormInputAnnotation.set(false), Schema.optional),
+  // TODO(wittjosiah): Consider Masonry supporting not being just a view but referencing arbitrary data directly.
+}).pipe(
+  Type.object({
+    typename: 'dxos.org/type/Masonry',
+    version: '0.2.0',
+  }),
+  LabelAnnotation.set(['name']),
+  ViewAnnotation.set(true),
+);
+
+export interface Masonry extends Schema.Schema.Type<typeof Masonry> {}
+
+type MakeProps = Omit<Partial<Obj.MakeProps<typeof Masonry>>, 'view'> & {
+  view: View.View;
+};
+
+/**
+ * Make a masonry as a view of a data set.
+ */
+export const make = ({ name, arrangement = [], view }: MakeProps): Masonry => {
+  return Obj.make(Masonry, { name, view: Ref.make(view), arrangement });
+};
+
+//
+// V1
+//
+
+export const MasonryV1 = Schema.Struct({
+  arrangement: Schema.Array(
+    Schema.Struct({
+      ids: Schema.Array(Obj.ID),
+      hidden: Schema.optional(Schema.Boolean),
+    }).pipe(Schema.mutable),
+  ).pipe(Schema.mutable, Schema.optional),
+}).pipe(
+  Type.object({
+    typename: 'dxos.org/type/Masonry',
+    version: '0.1.0',
+  }),
+);

package/src/types/MasonryAction.ts

@@ -0,0 +1,21 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Schema from 'effect/Schema';
+
+import { TypeInputOptionsAnnotation } from '@dxos/plugin-space/types';
+
+export const MasonryProps = Schema.Struct({
+  name: Schema.optional(Schema.String),
+  // TODO(wittjosiah): This should be a query input instead.
+  typename: Schema.String.pipe(
+    Schema.annotations({ title: 'Select card type' }),
+    TypeInputOptionsAnnotation.set({
+      location: ['database', 'runtime'],
+      kind: ['user'],
+      registered: ['registered'],
+    }),
+    Schema.optional,
+  ),
+});

package/src/types/index.ts

@@ -0,0 +1,6 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+export * as Masonry from './Masonry';
+export * as MasonryAction from './MasonryAction';