@dxos/plugin-space 0.11.1 → 0.12.0-next-bbabc02363f18d7643ea4160e3a7a7809870fd0d

package/dist/lib/SpaceCapabilities.mjs

@@ -0,0 +1,55 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import * as Schema from "effect/Schema";
+import * as Capability from "@dxos/app-framework/Capability";
+import { meta } from "#meta";
+//#region src/types/SpaceCapabilities.ts
+var SpaceCapabilities_exports = /* @__PURE__ */ __exportAll({
+	CreateObjectEntry: () => CreateObjectEntry,
+	DefaultSpace: () => DefaultSpace,
+	EphemeralState: () => EphemeralState,
+	IdentitySpec: () => IdentitySpec,
+	OnCreateSpace: () => OnCreateSpace,
+	OnTypeAdded: () => OnTypeAdded,
+	Repair: () => Repair,
+	SettingsAtom: () => SettingsAtom,
+	SettingsSection: () => SettingsSection,
+	State: () => State,
+	StateSchema: () => StateSchema
+});
+var SettingsAtom = Capability.makeSingleton()(`${meta.profile.key}.capability.settings`);
+/** Schema for persisted space plugin state. */
+var StateSchema = Schema.mutable(Schema.Struct({
+	spaceNames: Schema.Record({
+		key: Schema.String,
+		value: Schema.String
+	}),
+	enabledEdgeReplication: Schema.Boolean
+}));
+/** Persisted state (stored in KVS/localStorage). */
+var State = Capability.makeSingleton()(`${meta.profile.key}.capability.state`);
+/** Transient/ephemeral state (not persisted). */
+var EphemeralState = Capability.makeSingleton()(`${meta.profile.key}.capability.ephemeralState`);
+/**
+* The default space as created by identity setup, so first-run seeding can order itself after it.
+*
+* Contributed only by `IdentityCreated`, so it is absent on every boot that does not create an
+* identity, and it holds the space as created rather than the live designation. Anything asking
+* "which space is the default right now" must use `AppSpace.getDefaultSpace`, which reads the
+* designation the user can change in settings.
+*/
+var DefaultSpace = Capability.makeSingleton()(`${meta.profile.key}.capability.defaultSpace`);
+var SettingsSection = Capability.makeSingleton()(`${meta.profile.key}.capability.settingsSection`);
+var OnCreateSpace = Capability.make()(`${meta.profile.key}.capability.onSpaceCreated`);
+var OnTypeAdded = Capability.make()(`${meta.profile.key}.capability.onTypeAdded`);
+var Repair = Capability.makeSingleton()(`${meta.profile.key}.capability.repair`);
+var CreateObjectEntry = Capability.make()(`${meta.profile.key}.capability.createObject`);
+/**
+* The identity rule for a type — how to key an object for duplicate detection and how to merge
+* two of them. Plugins that own a type contribute one (e.g. plugin-crm for Person); the type
+* article only offers its Duplicates tab for types that have one.
+*/
+var IdentitySpec = Capability.make()(`${meta.profile.key}.capability.identitySpec`);
+//#endregion
+export { CreateObjectEntry, DefaultSpace, EphemeralState, IdentitySpec, OnCreateSpace, OnTypeAdded, Repair, SettingsAtom, SettingsSection, State, StateSchema, SpaceCapabilities_exports as t };
+
+//# sourceMappingURL=SpaceCapabilities.mjs.map

package/dist/lib/SpaceCapabilities.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpaceCapabilities.mjs","names":[],"sources":["../../src/types/SpaceCapabilities.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport { type Atom } from '@effect-atom/atom';\nimport type * as Effect from 'effect/Effect';\nimport * as Schema from 'effect/Schema';\nimport type { ComponentType } from 'react';\n\nimport * as Capability from '@dxos/app-framework/Capability';\nimport { type Space } from '@dxos/client/echo';\nimport type * as Operation from '@dxos/compute/Operation';\nimport { type Collection, type Database, type Obj, type Type } from '@dxos/echo';\nimport { type PublicKey } from '@dxos/keys';\nimport { type Label } from '@dxos/ui-types/translations';\nimport { type ComplexMap, type Position } from '@dxos/util';\n\nimport { meta } from '#meta';\n\nimport * as Settings from './Settings';\nimport * as SpaceSchema from './SpaceSchema';\n\nexport const SettingsAtom = Capability.makeSingleton<Atom.Writable<Settings.Settings>>()(\n  `${meta.profile.key}.capability.settings`,\n);\n\n/** Schema for persisted space plugin state. */\nexport const StateSchema = Schema.mutable(\n  Schema.Struct({\n    spaceNames: Schema.Record({ key: Schema.String, value: Schema.String }),\n    enabledEdgeReplication: Schema.Boolean,\n  }),\n);\n\nexport type SpaceState = Schema.Schema.Type<typeof StateSchema>;\n\n/** Persisted state (stored in KVS/localStorage). */\nexport const State = Capability.makeSingleton<Atom.Writable<SpaceState>>()(`${meta.profile.key}.capability.state`);\n\n/**\n * A proposed merge awaiting confirmation. `preview` is detached (never added to the database),\n * so abandoning the review writes nothing. Keyed by the type article's URI so the companion\n * only shows a preview raised by the plank it is companion to.\n */\nexport type MergePreview = {\n  typeUri: string;\n  typename: string;\n  objectIds: string[];\n  preview: Obj.Unknown;\n};\n\n/** Ephemeral space plugin state (not persisted). */\nexport type SpaceEphemeralState = {\n  awaiting: string | undefined;\n  sdkMigrationRunning: Record<string, boolean>;\n  navigableCollections: boolean;\n  viewersByObject: Record<string, ComplexMap<PublicKey, SpaceSchema.ObjectViewerProps>>;\n  viewersByIdentity: ComplexMap<PublicKey, Set<string>>;\n  mergePreview: MergePreview | undefined;\n  /** Bumped when a merge commits, so an open duplicates review knows to rescan. */\n  lastMergeAt: number | undefined;\n};\n\n/** Transient/ephemeral state (not persisted). */\nexport const EphemeralState = Capability.makeSingleton<Atom.Writable<SpaceEphemeralState>>()(\n  `${meta.profile.key}.capability.ephemeralState`,\n);\n\n/**\n * The default space as created by identity setup, so first-run seeding can order itself after it.\n *\n * Contributed only by `IdentityCreated`, so it is absent on every boot that does not create an\n * identity, and it holds the space as created rather than the live designation. Anything asking\n * \"which space is the default right now\" must use `AppSpace.getDefaultSpace`, which reads the\n * designation the user can change in settings.\n */\nexport const DefaultSpace = Capability.makeSingleton<Space>()(`${meta.profile.key}.capability.defaultSpace`);\n\nexport type SettingsSection = { id: string; label: Label; position?: Position.Position };\nexport const SettingsSection = Capability.makeSingleton<SettingsSection>()(\n  `${meta.profile.key}.capability.settingsSection`,\n);\n\nexport type OnCreateSpace = (params: {\n  space: Space;\n  isDefault: boolean;\n  rootCollection: Collection.Collection;\n}) => Effect.Effect<void, Error, Operation.Service>;\nexport const OnCreateSpace = Capability.make<OnCreateSpace>()(`${meta.profile.key}.capability.onSpaceCreated`);\n\nexport type OnTypeAdded = (params: {\n  db: Database.Database;\n  type: Type.AnyEntity;\n  // TODO(wittjosiah): This is leaky.\n  show?: boolean;\n}) => Effect.Effect<void, Error, Operation.Service>;\nexport const OnTypeAdded = Capability.make<OnTypeAdded>()(`${meta.profile.key}.capability.onTypeAdded`);\n\n// TODO(wittjosiah): Replace with migrations, this is not a sustainable solution.\nexport type HandleRepair = (params: { space: Space; isDefault: boolean }) => Promise<void>;\nexport const Repair = Capability.makeSingleton<HandleRepair>()(`${meta.profile.key}.capability.repair`);\n\n/** Typed creation entry contributed per typename by plugins that support creating objects. */\nexport type CreateObjectEntry = Readonly<{\n  id: string;\n  createObject: SpaceSchema.CreateObject;\n  /**\n   * Effect Schema describing the create form inputs. To use a `Type.Type`\n   * entity as the form schema, extract its schema first via `Type.getSchema(...)`.\n   */\n  inputSchema?: Schema.Schema.AnyNoContext;\n  /**\n   * Optional custom React panel rendered in place of the default `inputSchema` form.\n   * Lets a plugin own the entire post-typename-selection flow (e.g. multi-stage forms).\n   * `onCreateObject` receives the collected data and triggers the same submit flow.\n   */\n  customPanel?: ComponentType<CreateObjectCustomPanelProps>;\n}>;\nexport const CreateObjectEntry = Capability.make<CreateObjectEntry>()(`${meta.profile.key}.capability.createObject`);\n\n/**\n * The identity rule for a type — how to key an object for duplicate detection and how to merge\n * two of them. Plugins that own a type contribute one (e.g. plugin-crm for Person); the type\n * article only offers its Duplicates tab for types that have one.\n */\nexport const IdentitySpec = Capability.make<import('@dxos/extractor').IdentitySpec<any>>()(\n  `${meta.profile.key}.capability.identitySpec`,\n);\n\n/** Props passed to a `CreateObjectEntry.customPanel`. */\nexport type CreateObjectCustomPanelProps = {\n  target: Database.Database | Collection.Collection;\n  initialFormValues?: Record<string, any>;\n  onCreateObject: (data: Record<string, any>) => void | Promise<void>;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAsBA,IAAa,eAAe,WAAW,cAAgD,CAAC,CACtF,GAAG,KAAK,QAAQ,IAAI,qBACtB;;AAGA,IAAa,cAAc,OAAO,QAChC,OAAO,OAAO;CACZ,YAAY,OAAO,OAAO;EAAE,KAAK,OAAO;EAAQ,OAAO,OAAO;CAAO,CAAC;CACtE,wBAAwB,OAAO;AACjC,CAAC,CACH;;AAKA,IAAa,QAAQ,WAAW,cAAyC,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,kBAAkB;;AA2BjH,IAAa,iBAAiB,WAAW,cAAkD,CAAC,CAC1F,GAAG,KAAK,QAAQ,IAAI,2BACtB;;;;;;;;;AAUA,IAAa,eAAe,WAAW,cAAqB,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,yBAAyB;AAG3G,IAAa,kBAAkB,WAAW,cAA+B,CAAC,CACxE,GAAG,KAAK,QAAQ,IAAI,4BACtB;AAOA,IAAa,gBAAgB,WAAW,KAAoB,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,2BAA2B;AAQ7G,IAAa,cAAc,WAAW,KAAkB,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,wBAAwB;AAItG,IAAa,SAAS,WAAW,cAA4B,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,mBAAmB;AAkBtG,IAAa,oBAAoB,WAAW,KAAwB,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,yBAAyB;;;;;;AAOnH,IAAa,eAAe,WAAW,KAAkD,CAAC,CACxF,GAAG,KAAK,QAAQ,IAAI,yBACtB"}

package/dist/lib/SpaceCapability.mjs

@@ -0,0 +1,15 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import { CreateObjectEntry } from "./SpaceCapabilities.mjs";
+import { CreateObjectRequested } from "./SpaceEvents.mjs";
+import * as Capability from "@dxos/app-framework/Capability";
+//#region src/types/SpaceCapability.ts
+var SpaceCapability_exports = /* @__PURE__ */ __exportAll({ createObject: () => createObject });
+/**
+* Module maker contributing a typed create-object entry. Gated by default on the create flow
+* opening (all consumers read the entries reactively); declare `activatesOn` to override.
+*/
+var createObject = Capability.moduleMaker("CreateObject", CreateObjectEntry, { activatesOn: CreateObjectRequested });
+//#endregion
+export { createObject, SpaceCapability_exports as t };
+
+//# sourceMappingURL=SpaceCapability.mjs.map

package/dist/lib/SpaceCapability.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpaceCapability.mjs","names":[],"sources":["../../src/types/SpaceCapability.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Capability from '@dxos/app-framework/Capability';\n\nimport * as SpaceCapabilities from './SpaceCapabilities';\nimport * as SpaceEvents from './SpaceEvents';\n\n/**\n * Module maker contributing a typed create-object entry. Gated by default on the create flow\n * opening (all consumers read the entries reactively); declare `activatesOn` to override.\n */\nexport const createObject = Capability.moduleMaker('CreateObject', SpaceCapabilities.CreateObjectEntry, {\n  activatesOn: SpaceEvents.CreateObjectRequested,\n});\n"],"mappings":";;;;;;;;;;AAeA,IAAa,eAAe,WAAW,YAAY,gBAAgB,mBAAqC,EACtG,aAAa,sBACf,CAAC"}

package/dist/lib/SpaceEvents.mjs

@@ -0,0 +1,24 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import { meta } from "#meta";
+import * as ActivationEvent from "@dxos/app-framework/ActivationEvent";
+//#region src/types/SpaceEvents.ts
+var SpaceEvents_exports = /* @__PURE__ */ __exportAll({
+	CreateObjectRequested: () => CreateObjectRequested,
+	SpaceCreated: () => SpaceCreated,
+	TypeAdded: () => TypeAdded
+});
+/** Runtime event: fired imperatively when a space is created. */
+var SpaceCreated = ActivationEvent.make(`${meta.profile.key}.event.spaceCreated`);
+/** Runtime event: fired imperatively when a type is added to a space. */
+var TypeAdded = ActivationEvent.make(`${meta.profile.key}.event.typeAdded`);
+/**
+* Demand signal: a create-object flow opened (dialog/panel mount, or a schema node's create
+* actions were computed). Activation policies park `CreateObjectEntry` providers on this so
+* their chunks load when the user first goes to create an object, not at startup. Consumers
+* read the entries reactively, so late contributions pop into the open picker.
+*/
+var CreateObjectRequested = ActivationEvent.make(`${meta.profile.key}.event.createObjectRequested`);
+//#endregion
+export { CreateObjectRequested, SpaceCreated, TypeAdded, SpaceEvents_exports as t };
+
+//# sourceMappingURL=SpaceEvents.mjs.map

package/dist/lib/SpaceEvents.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpaceEvents.mjs","names":[],"sources":["../../src/types/SpaceEvents.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as ActivationEvent from '@dxos/app-framework/ActivationEvent';\n\nimport { meta } from '#meta';\n\n/** Runtime event: fired imperatively when a space is created. */\nexport const SpaceCreated = ActivationEvent.make(`${meta.profile.key}.event.spaceCreated`);\n/** Runtime event: fired imperatively when a type is added to a space. */\nexport const TypeAdded = ActivationEvent.make(`${meta.profile.key}.event.typeAdded`);\n/**\n * Demand signal: a create-object flow opened (dialog/panel mount, or a schema node's create\n * actions were computed). Activation policies park `CreateObjectEntry` providers on this so\n * their chunks load when the user first goes to create an object, not at startup. Consumers\n * read the entries reactively, so late contributions pop into the open picker.\n */\nexport const CreateObjectRequested = ActivationEvent.make(`${meta.profile.key}.event.createObjectRequested`);\n"],"mappings":";;;;;;;;;;AASA,IAAa,eAAe,gBAAgB,KAAK,GAAG,KAAK,QAAQ,IAAI,oBAAoB;;AAEzF,IAAa,YAAY,gBAAgB,KAAK,GAAG,KAAK,QAAQ,IAAI,iBAAiB;;;;;;;AAOnF,IAAa,wBAAwB,gBAAgB,KAAK,GAAG,KAAK,QAAQ,IAAI,6BAA6B"}

package/dist/lib/SpaceForm.mjs

@@ -0,0 +1,13 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import * as TypeOptions from "@dxos/app-toolkit/TypeOptions";
+//#region src/types/SpaceForm.ts
+var SpaceForm_exports = /* @__PURE__ */ __exportAll({
+	TypeInputOptionsAnnotation: () => TypeInputOptionsAnnotation,
+	TypeInputOptionsAnnotationId: () => TypeInputOptionsAnnotationId
+});
+var TypeInputOptionsAnnotation = TypeOptions.TypeInputOptionsAnnotation;
+var TypeInputOptionsAnnotationId = TypeOptions.TypeInputOptionsAnnotationId;
+//#endregion
+export { TypeInputOptionsAnnotation, TypeInputOptionsAnnotationId, SpaceForm_exports as t };
+
+//# sourceMappingURL=SpaceForm.mjs.map

package/dist/lib/SpaceForm.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpaceForm.mjs","names":[],"sources":["../../src/types/SpaceForm.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as TypeOptions from '@dxos/app-toolkit/TypeOptions';\n\nexport type TypeInputOptions = TypeOptions.TypeInputOptions;\nexport const TypeInputOptionsAnnotation = TypeOptions.TypeInputOptionsAnnotation;\nexport const TypeInputOptionsAnnotationId = TypeOptions.TypeInputOptionsAnnotationId;\n"],"mappings":";;;;;;;AAOA,IAAa,6BAA6B,YAAY;AACtD,IAAa,+BAA+B,YAAY"}